{"config":{"lang":["de"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"CityDoctor2","text":"

CityDoctor2 ist eine Qualit\u00e4tspr\u00fcfungssoftware f\u00fcr 3D Stadtmodelle im CityGML format. CityDoctor kann CityGML 1/2 Dokumente einlesen und seit Version 3.12 kann auch eingeschr\u00e4nkt CityGML 3 gelesen werden. Alle Pr\u00fcfergebnisse k\u00f6nnen in xml oder pdf Form ausgegeben werden. Zus\u00e4tzlich implementiert CityDoctor die QualityADE um Pr\u00fcfergebnisse direkt in CityGML zu speichern.

"},{"location":"R_GE_MS/","title":"R_GE_MS","text":""},{"location":"R_GE_MS/#anforderung","title":"Anforderung","text":"ID R_GE_MS Beschreibung Ein MultiSurface ist eine Sammlung von Polygonen ohne weitere Einschr\u00e4nkungen. Ein MultiSurface ist nur g\u00fcltig, wenn alle Polygone g\u00fcltig sind. Die Anforderungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_ALL m\u00fcssen erf\u00fcllt werden Fehlercode --"},{"location":"R_GE_MS/#prufung","title":"Pr\u00fcfung","text":"

Keine weiteren Pr\u00fcfungen notwendig

"},{"location":"R_GE_P_HOLE_OUTSIDE/","title":"R_GE_P_HOLE_OUTSIDE","text":""},{"location":"R_GE_P_HOLE_OUTSIDE/#anforderung","title":"Anforderung","text":"ID R_GE_P_HOLE_OUTSIDE Beschreibung Innerer Ring darf nicht komplett au\u00dferhalb des \u00e4u\u00dferen Rings sein. Fehlercode GE_P_HOLE_OUTSIDE

Beispiel:

"},{"location":"R_GE_P_HOLE_OUTSIDE/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_P_HOLE_OUTSIDE Anforderungs ID R_GE_P_HOLE_OUTSIDE Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL R_GE_P_NON_PLANAR, R_GE_P_ORIENTATION_RINGS_SAME Beschreibung Fehlercode GE_P_HOLE_OUTSIDE"},{"location":"R_GE_P_INNER_RINGS_NESTED/","title":"R_GE_P_INNER_RINGS_NESTED","text":""},{"location":"R_GE_P_INNER_RINGS_NESTED/#anforderung","title":"Anforderung","text":"ID R_GE_P_INNER_RINGS_NESTED Beschreibung Innere Ringe dr\u00fcfen nicht innerhalb eines anderen inneren Rings sein. Fehlercode GE_P_INNER_RINGS_NESTED

Beispiel:

"},{"location":"R_GE_P_INNER_RINGS_NESTED/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_P_INNER_RINGS_NESTED Anforderungs ID R_GE_P_INNER_RINGS_NESTED Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_NON_PLANAR, R_GE_P_ORIENTATION_RINGS_SAME Beschreibung Fehlercode GE_P_INNER_RINGS_NESTED"},{"location":"R_GE_P_INTERIOR_DISCONNECTED/","title":"R_GE_P_INTERIOR_DISCONNECTED","text":""},{"location":"R_GE_P_INTERIOR_DISCONNECTED/#anforderung","title":"Anforderung","text":"ID R_GE_P_INTERIOR_DISCONNECTED Beschreibung Die innere Fl\u00e4che eines Polygons muss verbunden sein. Parameter minVertexDistance Ein Punkt ber\u00fchrt eine Kante wenn der Abstand kleiner als minVertexDistance,siehe Vertex Anforderungen) Fehlercode GE_P_INTERIOR_DISCONNECTED

Beispiele:

"},{"location":"R_GE_P_INTERIOR_DISCONNECTED/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_P_INTERIOR_DISCONNECTED Anforderungs ID R_GE_P_INTERIOR_DISCONNECTED Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_NON_PLANAR, R_GE_P_ORIENTATION_RINGS_SAME Beschreibung Fehlercode GE_P_INTERIOR_DISCONNECTED"},{"location":"R_GE_P_INTERSECTING_RINGS/","title":"R_GE_P_INTERSECTING_RINGS","text":""},{"location":"R_GE_P_INTERSECTING_RINGS/#anforderung","title":"Anforderung","text":"ID R_GE_P_INTERSECTING_RINGS Beschreibung \u00c4u\u00dfere und innere Ring d\u00fcrfen sich nicht verschneiden Parameter minVertexDistance Zwei Ringe verschneiden sich nicht, wenn nur ein Punkt des einen Rings den Anderen ber\u00fchrt. Ein Punkt ber\u00fchrt eine Kante nur dann wenn der Abstand weniger als minVertexDistance ist. Punkte k\u00f6nnen als gleich angesehen werden, trotz (kleiner) Abst\u00e4nde, siehe Vertex Anforderungen Fehlercode GE_P_INTERSECTING_RINGS

Beispiele:

\u00c4u\u00dferer Ring verschneidet inneren Ring:

Zwei innere Rings verschneiden:

"},{"location":"R_GE_P_INTERSECTING_RINGS/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_P_INTERSECTING_RINGS Anforderungs ID R_GE_P_INTERSECTING_RINGS Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_NON_PLANAR, R_GE_P_HOLE_OUTSIDE, R_GE_P_INNER_RINGS_NESTED, R_GE_P_ORIENTATION_RINGS_SAME Beschreibung Wenn ein Punkt eines inneren Rings au\u00dferhalb des \u00e4u\u00dferen ist oder innerhalb eines anderen inneren Rings, ist das eine Verschneidung. Fehlercode GE_P_INTERSECTING_RINGS"},{"location":"R_GE_P_NON_PLANAR/","title":"R_GE_P_NON_PLANAR","text":""},{"location":"R_GE_P_NON_PLANAR/#anforderung","title":"Anforderung","text":"ID R_GE_P_NON_PLANAR Beschreibung Jedes Polygon muss Planar sein. Planrit\u00e4t ist erreicht wenn kein Punkt weiter als distanceTolerance von der Regressionsebene aller Punkte ist, sowie die Normalen jedes Dreicks des tessilierten Polygons keine gr\u00f6\u00dfere Winkelabweichung als angleTolerance haben. Parameter 1: type Der Typ der Panarit\u00e4tspr\u00fcfung kann ausgew\u00e4hlt werden. Muss eins von distance, angle, both sein. Parameter 2: distanceTolerance Toleranz der Distanz eines Punktens von der Regressionsebene Parameter 3: angleTolerance Toleranz des Winkels der Dreiecksnormalen Fehlercodes GE_P_NON_PLANAR_POLYGON_DISTANCE_PLANE, GE_P_NON_PLANAR_POLYGON_NORMALS_DEVIATION

Normalen Abweichung:

Warning

Das Ergebnis der Normalenpr\u00fcfung ist abh\u00e4ngig von dem Ergebnis der Tesselierung und damit nicht 100% zuverl\u00e4ssig.

"},{"location":"R_GE_P_NON_PLANAR/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_P_NON_PLANAR Anfoderungs ID R_GE_P_NON_PLANAR Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL Beschreibung Tesseliert um die Dreiecksnormalen zu berechnen. Erstellt eine Regressionsebene aus allen Polygonpunkten um den Abstand der Punkte zur Ebene zu berechnen Fehlercode GE_P_NON_PLANAR_POLYGON_DISTANCE_PLANE, GE_P_NON_PLANAR_POLYGON_NORMALS_DEVIATION"},{"location":"R_GE_P_ORIENTATION_RINGS_SAME/","title":"R_GE_P_ORIENTATION_RINGS_SAME","text":""},{"location":"R_GE_P_ORIENTATION_RINGS_SAME/#anforderung","title":"Anforderung","text":"ID R_GE_P_ORIENTATION_RINGS_SAME Beschreibung \u00c4u\u00dfere und innere Ringe d\u00fcrfen nicht die selbe Orientierung haben. Fehlercode GE_P_ORIENTATION_RINGS_SAME

Beispiel :

"},{"location":"R_GE_P_ORIENTATION_RINGS_SAME/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_P_ORIENTATION_RINGS_SAME Anforderungs ID R_GE_P_ORIENTATION_RINGS_SAME Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_NON_PLANAR Beschreibung Fehlercode GE_P_ORIENTATION_RINGS_SAME"},{"location":"R_GE_R_COLLAPSED_TO_LINE/","title":"R_GE_R_COLLAPSED_TO_LINE","text":""},{"location":"R_GE_R_COLLAPSED_TO_LINE/#anforderung","title":"Anforderung","text":"ID R_GE_R_COLLAPSED_TO_LINE Beschreibung Ein Spezialfall von Selbstverschneidung (R_GE_R_SELF_INTERSECTION): Der Ring ist eine Linie. Wenn der Ring zu ein Punkt darstellt, dann sollte GE_R_TOO_FEW_POINTS / GE_R_CONSECUTIVE_POINTS_SAME verwendet werden. Fehlercode GE_R_SELF_INTERSECTION, GE_R_COLLAPSED_TO_LINE, GE_R_TOO_FEW_POINTS, GE_R_CONSECUTIVE_POINTS_SAME"},{"location":"R_GE_R_COLLAPSED_TO_LINE/#prufung","title":"Pr\u00fcfung","text":"ID GE_R_COLLAPSED_TO_LINE Anforderungs ID R_GE_R_COLLAPSED_TO_LINE Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_TOO_FEW_POINTS, R_GE_R_CONSECUTIVE_POINTS_SAME, R_GE_R_NOT_CLOSED Beschreibung Ring als ein Punkt kann nicht passieren, wegen den Vorbedingungen. Ist eigentlich eine Selbstverschneidung Fehlercode GE_R_COLLAPSED_TO_LINE"},{"location":"R_GE_R_CONSECUTIVE_POINTS_SAME/","title":"R_GE_R_CONSECUTIVE_POINTS_SAME","text":""},{"location":"R_GE_R_CONSECUTIVE_POINTS_SAME/#anforderung","title":"Anforderung","text":"ID R_GE_R_CONSECUTIVE_POINTS_SAME Beschreibung Punkte innerhalb eines Rings sollen sich nicht wiederholen (ausgenommen der erste und der letzte im Fall von GML, siehe R_GE_R_NOT_CLOSED. Dieser Fehler ist oft der Fall wenn zwei Punkte an der selben Stelle sind. Parameter minVertexDistance Punkte k\u00f6nnen als gleich angesehen werden, trotz (kleiner) Abst\u00e4nde, siehe Vertex Anforderungen Fehlercode GE_R_CONSECUTIVE_POINTS_SAME

Zum Beispiel dieser Ring ist fehlerhaft: 

<gml:LinearRing>\n<gml:pos>0.0 0.0 0.0</gml:pos>\n<gml:pos>1.0 0.0 0.0</gml:pos>  <gml:pos>1.0 0.0 0.0</gml:pos>\n<gml:pos>1.0 1.0 0.0</gml:pos>      <gml:pos>0.0 1.0 0.0</gml:pos>  <gml:pos>0.0 0.0 0.0</gml:pos>\n</gml:LinearRing>\n

Dieser Ring ist auch Fehlerhaft mit dem Parameter minVertexDistance = 0.1 

<gml:LinearRing>\n<gml:pos>0.0 0.0 0.0</gml:pos>\n<gml:pos>0.05 0.0 0.0</gml:pos>\n<gml:pos>1.0 0.0 0.0</gml:pos>  <gml:pos>1.0 1.0 0.0</gml:pos>      <gml:pos>0.0 1.0 0.0</gml:pos>  <gml:pos>0.0 0.0 0.0</gml:pos>\n</gml:LinearRing>\n

Das n\u00e4chste Beispiel zeigt einen fehlerhaften Ring mit einem Punkt, der zwei mal vorkommt aber die Wiederholung nicht aufeinanderfolgend ist. Dies resultiert in einer Selbstverschneidung, dies ist mit dieser Anforderung nicht abgedeckt.

<gml:LinearRing>\n<gml:pos>0.0 0.0 0.0</gml:pos>\n<gml:pos>1.0 0.0 0.0</gml:pos>  <gml:pos>1.0 1.0 0.0</gml:pos>  <gml:pos>1.0 0.0 0.0</gml:pos>  <gml:pos>0.0 1.0 0.0</gml:pos>  <gml:pos>0.0 0.0 0.0</gml:pos>\n</gml:LinearRing>\n
"},{"location":"R_GE_R_CONSECUTIVE_POINTS_SAME/#prufungen","title":"Pr\u00fcfungen","text":"ID C_GE_R_CONSECUTIVE_POINTS_SAME Anforderungs ID R_GE_R_CONSECUTIVE_POINTS_SAME Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_NOT_CLOSED, R_GE_R_TOO_FEW_POINTS Beschreibung Pr\u00fcft ob sich ein Punkt wiederholt Fehlercode GE_R_CONSECUTIVE_POINTS_SAME ID C_GE_R_DUPLICATE_POINT Anforderungs ID R_GE_R_CONSECUTIVE_POINTS_SAME, GE-gml:LR-0004 (teilweise) Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_NOT_CLOSED, R_GE_R_TOO_FEW_POINTS Beschreibung Erkennt aufeinanderfolgende als auch andere wiederholende Punkte. Fehlercode GE_R_CONSECUTIVE_POINTS_SAME, GE_R_SELF_INTERSECTION"},{"location":"R_GE_R_NOT_CLOSED/","title":"R_GE_R_NOT_CLOSED","text":""},{"location":"R_GE_R_NOT_CLOSED/#anforderung","title":"Anforderung","text":"ID R_GE_R_NOT_CLOSED Beschreibung Der erste und letzte Punkt m\u00fcssen in GML der gleiche sein. Parameter minVertexDistance Punkte k\u00f6nnen als gleich angesehen werden, trotz (kleiner) Abst\u00e4nde, siehe Vertex Anforderungen Fehlercode GE_R_NOT_CLOSED

Zum Beispiel dieser Ring ist fehlerhaft: 

<gml:LinearRing>\n<gml:pos>0.0 0.0 0.0</gml:pos>\n<gml:pos>1.0 0.0 0.0</gml:pos>  <gml:pos>1.0 1.0 0.0</gml:pos>\n<gml:pos>0.0 1.0 0.0</gml:pos>\n</gml:LinearRing>\n
OK mit Parameter minVertexDistance = 0.1: 
<gml:LinearRing>\n<gml:pos>0.0 0.0 0.0</gml:pos>\n<gml:pos>1.0 0.0 0.0</gml:pos>  <gml:pos>1.0 1.0 0.0</gml:pos>\n<gml:pos>0.0 1.0 0.0</gml:pos>\n<gml:pos>0.0 0.0 0.05</gml:pos>\n</gml:LinearRing>\n

"},{"location":"R_GE_R_NOT_CLOSED/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_R_NOT_CLOSED Anforderungs ID R_GE_R_NOT_CLOSED Vorbedingungen R_SC_SCHEMA_VALIDATION Beschreibung Der erste und letzte Punkt sollen der gleiche sein. Fehlercode GE_R_NOT_CLOSED"},{"location":"R_GE_R_SELF_INTERSECTION/","title":"R_GE_R_SELF_INTERSECTION","text":""},{"location":"R_GE_R_SELF_INTERSECTION/#anforderung","title":"Anforderung","text":"ID R_GE_R_SELF_INTERSECTION Beschreibung Ein Ring soll einfach sein, also sich nicht selbstverschneiden. Die Selbstverschneidung kann an einem konkreten Punkt sein, oder auch nicht. Parameter minVertexDistance Punkte k\u00f6nnen als gleich angesehen werden, trotz (kleiner) Abst\u00e4nde, siehe Vertex Anforderungen. Dieser Parameter wird auch dazu verwendet um zu bestimmen wann ein Punkt eine Kante ber\u00fchrt. Fehlercode GE_R_SELF_INTERSECTION

Beispiele f\u00fcr Selbstverschneidungen:

Schleife:

Punkt ber\u00fchrt Kante mit Parameter minVertexDistance:

Doppelte Punkte:

Doppelte Kante (Gleich wie doppelte Punkte):

"},{"location":"R_GE_R_SELF_INTERSECTION/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_R_SELF_INTERSECTION Anforderungs ID R_GE_R_SELF_INTERSECTION Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_TOO_FEW_POINTS, R_GE_R_CONSECUTIVE_POINTS_SAME, R_GE_R_NOT_CLOSED Beschreibung Erkennt doppelte Punkte und Selbstverschneidende Kanten. Fehlercodes GE_R_SELF_INTERSECTION ID C_GE_R_DUPLICATE_POINT Anforderungs ID R_GE_R_CONSECUTIVE_POINTS_SAME, R_GE_R_SELF_INTERSECTION (teilweise) Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_TOO_FEW_POINTS, R_GE_R_NOT_CLOSED Beschreibung Erkennt wiederholende und nicht wiederholende doppelte Punkte. Letzteres ist eine Selbstverschneidung. Fehlercodes GE_R_CONSECUTIVE_POINTS_SAME, GE_R_SELF_INTERSECTION"},{"location":"R_GE_R_TOO_FEW_POINTS/","title":"R_GE_R_TOO_FEW_POINTS","text":""},{"location":"R_GE_R_TOO_FEW_POINTS/#anforderung","title":"Anforderung","text":"ID R_GE_R_TOO_FEW_POINTS Beschreibung Ein Ring muss mindestens 3 Punkte haben. F\u00fcr GML Ringe diese Anfoderung ignoriert die Tatsache, dass der erste und der letzte Punkt gleich sind (siehe R_GE_R_NOT_CLOSED). Ein GML Ring ist nach dieser Anfoderung valide, wenn er mindestens 3 unterschiedliche Punkte enth\u00e4lt aber er ist dann nicht geschlossen (Die Anfoderung R_GE_R_NOT_CLOSED ist nicht erf\u00fcllt). Parameter minVertexDistance Punkte k\u00f6nnen als gleich angesehen werden, trotz (kleiner) Abst\u00e4nde, siehe Vertex Anforderungen Fehlercode GE_R_TOO_FEW_POINTS

Zum Beispiel, dieser Ring ist fehlerhaft: 

<gml:LinearRing>\n<gml:pos>0.0 0.0 0.0</gml:pos>\n<gml:pos>1.0 0.0 0.0</gml:pos>  <gml:pos>0.0 0.0 0.0</gml:pos>\n</gml:LinearRing>\n
Valide Ringe:

<gml:LinearRing> <!-- (1)! -->\n<gml:pos>0.0 0.0 0.0</gml:pos> <gml:pos>1.0 0.0 0.0</gml:pos>  <gml:pos>0.0 1.0 0.0</gml:pos>\n</gml:LinearRing>\n
  1. Dieser Ring ist nicht geschlossen und wird daher vorher ausgeschlossen, h\u00e4tte aber genug unterschiedliche Punkte, um dieser Anfoderung zu gen\u00fcgen.
<gml:LinearRing>\n<gml:pos>0.0 0.0 0.0</gml:pos>\n<gml:pos>1.0 0.0 0.0</gml:pos>  <gml:pos>0.0 1.0 0.0</gml:pos>\n<gml:pos>0.0 0.0 0.0</gml:pos>\n</gml:LinearRing>\n
"},{"location":"R_GE_R_TOO_FEW_POINTS/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_R_TOO_FEW_POINTS Anfoderungs ID R_GE_R_TOO_FEW_POINTS Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_NOT_CLOSED Beschreibung Ring muss mindestens 3 unterschiedliche Punkte beinhalten Fehlercode GE_R_TOO_FEW_POINTS"},{"location":"R_GE_SO/","title":"R_GE_SO","text":""},{"location":"R_GE_SO/#anforderung","title":"Anforderung","text":"ID R_GE_SO Beschreibung Ein Solid ist eine Sammlung von Polygonen mit Einschr\u00e4nkungen. Die Geometrie muss 'wasserdicht' sein. Siehe Definition von Solids in Appendix A aus dem CityGML QIE. Ein Solid ist g\u00fcltig, wenn die Anforderungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_ALL, R_GE_S_ALL erf\u00fcllt sind. Fehlercode --"},{"location":"R_GE_SO/#prufung","title":"Pr\u00fcfung","text":"

keine weitere Pr\u00fcfung notwendig

"},{"location":"R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION/","title":"R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION","text":""},{"location":"R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION/#anforderung","title":"Anforderung","text":"ID R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION Beschreibung Alle Polygone haben die falsche Orientierung (definiert in R_GE_S_POLYGON_WRONG_ORIENTATION), so dass alle Polygone nach innen zeigen. Fehlercode GE_S_ALL_POLYGONS_WRONG_ORIENTATION"},{"location":"R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_S_ALL_POLYGONS_WRONG_ORIENTATION Anforderungs ID R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION Vorbedingung R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_ALL, R_GE_S_TOO_FEW_POLYGONS, R_GE_S_NOT_CLOSED, R_GE_S_NON_MANIFOLD_VERTEX, R_GE_S_NON_MANIFOLD_EDGE, R_GE_S_MULTIPLE_CONNECTED_COMPONENTS, R_GE_S_SELF_INTERSECTION, R_GE_S_POLYGON_WRONG_ORIENTATION Beschreibung Fehlercode GE_S_ALL_POLYGONS_WRONG_ORIENTATION"},{"location":"R_GE_S_MULTIPLE_CONNECTED_COMPONENTS/","title":"R_GE_S_MULTIPLE_CONNECTED_COMPONENTS","text":""},{"location":"R_GE_S_MULTIPLE_CONNECTED_COMPONENTS/#anforderung","title":"Anforderung","text":"ID R_GE_S_MULTIPLE_CONNECTED_COMPONENTS Beschreibung 1+ Polygone ist nicht mit der selben H\u00fclle verbuden. Fehlercode GE_S_MULTIPLE_CONNECTED_COMPONENTS"},{"location":"R_GE_S_MULTIPLE_CONNECTED_COMPONENTS/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_S_MULTIPLE_CONNECTED_COMPONENTS Anforderungs ID R_GE_S_MULTIPLE_CONNECTED_COMPONENTS Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_ALL, R_GE_S_TOO_FEW_POLYGONS Beschreibung Erstelle einen doppelten Graphen (Polygone werden Knoten, Polygone, die eine Kante teilen werden im Graph verbunden). Wenn der Graph nicht verbunden ist, gibt es mehrere verbundene Komponenten. Fehlercode GE_S_MULTIPLE_CONNECTED_COMPONENTS"},{"location":"R_GE_S_NON_MANIFOLD_EDGE/","title":"R_GE_S_NON_MANIFOLD_EDGE","text":""},{"location":"R_GE_S_NON_MANIFOLD_EDGE/#anforderung","title":"Anforderung","text":"ID R_GE_S_NON_MANIFOLD_EDGE Beschreibung Jede kannte sollte genau 2 Polygone begrenzen. Fehlercode GE_S_NON_MANIFOLD_EDGE Kommentar Diese Anforderung ist \u00e4hnlich zu GE_S_NOT_CLOSED: Wenn eine Kante mehr als 2 Polygon begrenzt, dann ist es ein GS_S_NON_MANIFOLD_EDGE Fehler. Wenn eine Kante nur ein Polygon begrenzt, ist es ein GE_S_NOT_CLOSED Fehler (ein Loch im Solid)"},{"location":"R_GE_S_NON_MANIFOLD_EDGE/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_S_NON_MANIFOLD_EDGE Anforderungs ID R_GE_S_NON_MANIFOLD_EDGE Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_ALL R_GE_S_TOO_FEW_POLYGONS Beschreibung Fehlercode GE_S_NON_MANIFOLD_EDGE"},{"location":"R_GE_S_NON_MANIFOLD_VERTEX/","title":"R_GE_S_NON_MANIFOLD_VERTEX","text":""},{"location":"R_GE_S_NON_MANIFOLD_VERTEX/#anforderung","title":"Anforderung","text":"ID R_GE_S_NON_MANIFOLD_VERTEX Beschreibung Jedes Polygon das an einem Punkt eines Solids anliegt muss \u00fcber Kanten mit den anderen anliegenden Polygonen verbunden sein. Alle Punkte und anliegende Polygone m\u00fcssen ein 'Regenschirm' erzeugen. Fehlercode GE_S_NON_MANIFOLD_VERTEX"},{"location":"R_GE_S_NON_MANIFOLD_VERTEX/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_S_NON_MANIFOLD_VERTEX Anforderungs ID R_GE_S_NON_MANIFOLD_VERTEX Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_ALL, R_GE_S_TOO_FEW_POLYGONS Beschreibung Fehlercode GE_S_NON_MANIFOLD_VERTEX"},{"location":"R_GE_S_NOT_CLOSED/","title":"R_GE_S_NOT_CLOSED","text":""},{"location":"R_GE_S_NOT_CLOSED/#anforderung","title":"Anforderung","text":"ID R_GE_S_NOT_CLOSED Beschreibung Die H\u00fclle darf keine L\u00f6cher haben, sie muss Wasserdicht sein. Fehlercode GE_S_NOT_CLOSED"},{"location":"R_GE_S_NOT_CLOSED/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_S_NOT_CLOSED Anforderungs ID R_GE_S_NOT_CLOSED Vorbedingung R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_ALL, R_GE_S_TOO_FEW_POLYGONS Beschreibung Fehlercode GE_S_NOT_CLOSED

Die Pr\u00fcfung sucht alle Kanten und ordnet sie den jeweiligen Gegenkanten zu. Falls eine Kante keine Gegenkante hat so wird hier ein Loch in der H\u00fclle erkannt und ein Fehler herausgegeben.

"},{"location":"R_GE_S_POLYGON_WRONG_ORIENTATION/","title":"R_GE_S_POLYGON_WRONG_ORIENTATION","text":""},{"location":"R_GE_S_POLYGON_WRONG_ORIENTATION/#anforderung","title":"Anforderung","text":"ID R_GE_S_POLYGON_WRONG_ORIENTATION Beschreibung Ein Polygon muss so orientiert sein, dass die Normale des \u00e4u\u00dferen Ring nach au\u00dfen zeigt. The points are ordered counter-clockwise. Fehlercode GE_S_POLYGON_WRONG_ORIENTATION"},{"location":"R_GE_S_POLYGON_WRONG_ORIENTATION/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_S_POLYGON_WRONG_ORIENTATION Anforderungs ID R_GE_S_POLYGON_WRONG_ORIENTATION Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_ALL, R_GE_S_TOO_FEW_POLYGONS, R_GE_S_NOT_CLOSED, R_GE_S_NON_MANIFOLD_EDGE Beschreibung Fehlercode GE_S_POLYGON_WRONG_ORIENTATION"},{"location":"R_GE_S_SELF_INTERSECTION/","title":"R_GE_S_SELF_INTERSECTION","text":""},{"location":"R_GE_S_SELF_INTERSECTION/#anforderung","title":"Anforderung","text":"ID R_GE_S_SELF_INTERSECTION Beschreibung Der Solid darf sich nicht selbstverschneiden Fehlercode GE_S_SELF_INTERSECTION

Beispiel (links = OK, rechts = Fehlerhaft):

"},{"location":"R_GE_S_SELF_INTERSECTION/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_S_SELF_INTERSECTION Anforderungs ID R_GE_S_SELF_INTERSECTION Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_ALL, R_GE_S_TOO_FEW_POLYGONS, R_GE_S_NOT_CLOSED, R_GE_S_NON_MANIFOLD_VERTEX, R_GE_S_NON_MANIFOLD_EDGE, R_GE_S_MULTIPLE_CONNECTED_COMPONENTS, R_GE_S_POLYGON_WRONG_ORIENTATION Beschreibung Fehlercode GE_S_SELF_INTERSECTION"},{"location":"R_GE_S_TOO_FEW_POLYGONS/","title":"R_GE_S_TOO_FEW_POLYGONS","text":""},{"location":"R_GE_S_TOO_FEW_POLYGONS/#anforderung","title":"Anforderung","text":"ID R_GE_S_TOO_FEW_POLYGONS Beschreibung Solids m\u00fcssen mindestens 4 Polygone haben. Fehlercode GE_S_TOO_FEW_POLYGONS"},{"location":"R_GE_S_TOO_FEW_POLYGONS/#prufung","title":"Pr\u00fcfung","text":"ID C_GE_S_TOO_FEW_POLYGONS Anforderungs ID R_GE_S_TOO_FEW_POLYGONS Vorbedingungen R_SC_SCHEMA_VALIDATION, R_GE_R_ALL, R_GE_P_ALL Beschreibung Fehlercode GE_S_TOO_FEW_POLYGONS"},{"location":"basic/","title":"Validierung von 3D Stadtmodellen in CityGML","text":""},{"location":"basic/#begriffe-und-definitionen","title":"Begriffe und Definitionen","text":"

nach CityGML Quality Interoperability Experiment, chapter 3

Validierung 

Prozess des validierens einer CityGML Datei nach spezifizierten Anforderungen. Eine valide Datei entspricht allen Anforderungen.\n

Anforderungen 

Regeln und Einschr\u00e4nkungen, die die Datenstruktur eindeutig definieren. Anforderungen k\u00f6nnen von dem CityGML Standard Dokument abgleitet werden oder gesondert, als Anforderung an den CityGML Standard, definiert werden um Mehrdeutigkeiten des Standards zu verhindern oder zus\u00e4tzliche nutzerabh\u00e4ngige Anforderungen zu definieren.\n

Pr\u00fcfung 

Algorithmische Implementation um eine Anforderung innerhalb eines Validerungsprogramms zu pr\u00fcfen.\n

Fehler 

Ergebnis einer Pr\u00fcfung im Falle einer Nichtkonformit\u00e4t von Anforderungen.\n

Validierungsplan 

Strukturierte Liste von Anforderungen, \u00fcberlicherweise angepasst an den konkreten Fall.\n

"},{"location":"basic/#zusatzliche-defintionen","title":"Zus\u00e4tzliche Defintionen:","text":"

XSD valide 

Eine CityGML Datei XSD valide wenn sie dem CityGML XML Schema entspricht.\n

"},{"location":"firstRun/","title":"Erster Start","text":""},{"location":"firstRun/#start","title":"Start","text":"

Nach dem entpacken der Zip Datei sollte je nach Version (GUI oder Batch) eine Struktur \u00e4hnlich diesem Bild rauskommen (Beispiel CityDoctorGUI):

Um CityDoctor zu starten kann die start.bat verwendet werden.

Die .bat Datei enth\u00e4lt dabei nur den Befehl: 

java -classpath libs/*;plugins/*;CityDoctorGUI-3.12.0.jar de.hft.stuttgart.citydoctor2.gui.MainWindow\n

Note

Der Befehl hat sich \u00fcber die Versionshistorie von CityDoctor ver\u00e4ndert.

F\u00fcr die Batch Version ist der Befehl analog und kann entsprechend f\u00fcr andere Betriebsysteme angepasst werden.

Note

F\u00fcr Linux oder Mac kann dieser Befehl auch verwendet werden, es muss nur das \";\" durch \":\" ersetzt werden. Der Rest bleibt gleich.

"},{"location":"geometric/","title":"Geometrieanforderungen","text":""},{"location":"geometric/#fehlercodes-for-geometrische-fehler","title":"Fehlercodes for geometrische Fehler","text":"

Die Fehlercodes wurden \u00fcbernommen aus dem CityGML Quality Interoperability Experiment, chapter 7.5.

Note

Die Anforderungen wurden in CityDoctor umbenannt um einen auch von Menschen zu verstehenden Begriff, analog zu den Fehlercodes, darzustellen.

Alle geometrischen Fehler sind in dem \"GE\" Definitionsbereich. Da geometrische Validierung basierend auf den Primitiven auf drei verschiedenen Ebenen ausgef\u00fchrt wird enth\u00e4lt jede Anforderung eine Ebene:

Fehlercodes folgen dem selben Namensschema wie die Anforderungen, siehe auch Grundbegriffe. Jede Verletzung einer Anforderung muss in einem Fehler enden, der einen entsprechenden Fehlercode beinhaltet. Jeder Fehler kann (und sollte) zus\u00e4tzliche Informationen beinhalten (z.B. Wenn ein Ring nicht geschlossen ist, dann sollte die ID des Rings mitgegeben werden).

"},{"location":"geometric/#vertex-punkt-anforderungen","title":"Vertex (Punkt) Anforderungen","text":"

Zwei Punkte A und B sind gleich wenn die Euclidische-Distanz zwischen den beiden Punkten kleiner als eine definierte Gr\u00f6\u00dfe ist (minVertexDistance). Diese definierte Gr\u00f6\u00dfe findet auch in vielen Anforderungen wieder Anwendung, zum Beispiel ber\u00fchrt ein Punkt eine Kante wenn der Abstand des Punktes kleiner ist als minVertexDistance. In den folgenden Anforderungen wird die Gr\u00f6\u00dfe verwendet:

Die folgenden Anforderungen wurden auf den drei geometrischen Ebenen definiert (nach Ledoux (2013)):

"},{"location":"geometric/#linear-ring","title":"Linear Ring","text":"Anforderungs ID Beschreibung Fehlercode Bekannte Pr\u00fcfungen R_GE_R_TOO_FEW_POINTS Zu wenig Punkte in einem Ring GE_R_TOO_FEW_POINTS C_GE_R_TOO_FEW_POINTS R_GE_R_CONSECUTIVE_POINTS_SAME 2 aufeinanderfolgende Punkte sind gleich GE_R_CONCECUTIVE_POINTS_SAME C_GE_R_CONCECUTIVE_POINTS_SAME, C_GE_R_DUPLICATE_POINT R_GE_R_NOT_CLOSED Der erste und letzte Punkt sind nicht gleich GE_R_NOT_CLOSED C_GE_R_NOT_CLOSED R_GE_R_SELF_INTERSECTION Selbstverschneidung z.B. eine Schleife GE_R_SELF_INTERSECTION C_GE_R_SELF_INTERSECTION, C_GE_R_DUPLICATE_POINT R_GE_R_COLLAPSED_TO_LINE Momentan nicht in Benutzung, da redundant mit R_GE_R_SELF_INTERSECTION Ring ist ein Punkt oder eine Linie GE_R_COLLAPSED_TO_LINE C_GE_R_COLLAPSED_TO_LINE R_GE_R_ALL Container f\u00fcr: R_GE_R_TOO_FEW_POINTS, R_GE_R_CONSECUTIVE_POINTS_SAME, R_GE_R_NOT_CLOSED, R_GE_R_SELF_INTERSECTION -- --"},{"location":"geometric/#polygon","title":"Polygon","text":"Anforderungs ID Beschreibung Fehlercode Bekannte Pr\u00fcfungen R_GE_P_INTERSECTING_RINGS 2+ Ringe schneiden sich GE_P_INTERSECTING_RINGS C_GE_P_INTERSECTING_RINGS R_GE_P_NON_PLANAR Nicht planares Polygon, sowohl Distanz als auch Fl\u00e4chennormale Abweichungen GE_P_NON_PLANAR_POLYGON_DISTANCE_PLANE, GE_P_NON_PLANAR_POLYGON_NORMALS_DEVIATION C_GE_P_NON_PLANAR R_GE_P_INTERIOR_DISCONNECTED Innenfl\u00e4che ist nicht verbunden GE_P_INTERIOR_DISCONNECTED C_GE_P_INTERIOR_DISCONNECTED R_GE_P_HOLE_OUTSIDE 1+ inneren Ringe ist komplett au\u00dferhalb des Polygons GE_P_HOLE_OUTSIDE C_GE_P_HOLE_OUTSIDE R_GE_P_INNER_RINGS_NESTED Innerer Ring ist komplett innerhalb eines anderen inneren Rings GE_P_INNER_RINGS_NESTED C_GE_P_INNER_RINGS_NESTED R_GE_P_ORIENTATION_RINGS_SAME \u00c4u\u00dferer Ring und innerer Ring haben die selbe Orientation GE_P_ORIENTATION_RINGS_SAME C_GE_P_ORIENTATION_RINGS_SAME R_GE_P_ALL Container f\u00fcr: R_GE_P_INTERSECTING_RINGS, R_GE_P_NON_PLANAR, R_GE_P_INTERIOR_DISCONNECTED, R_GE_P_HOLE_OUTSIDE, R_GE_P_INNER_RINGS_NESTED, R_GE_P_ORIENTATION_RINGS_SAME, R_GE_R_ALL -- --"},{"location":"geometric/#solid-hulle-shell","title":"Solid / H\u00fclle (Shell)","text":"Anforderungs ID Beschreibung Fehlercode Bekannte Pr\u00fcfungen R_GE_S_TOO_FEW_POLYGONS <4 Polygone GE_S_TOO_FEW_POLYGONS C_GE_S_TOO_FEW_POLYGONS R_GE_S_NOT_CLOSED Die H\u00fclle ist nicht wasserdicht / hat 1+ L\u00f6cher GE_S_NOT_CLOSED C_GE_S_NOT_CLOSED R_GE_S_NON_MANIFOLD_VERTEX Jedes Polygon, das an einem Punkt anliegt muss \u00fcber Kanten mit den Anderen verbunden sein GE_S_NON_MANIFOLD_VERTEX C_GE_S_NON_MANIFOLD_VERTEX R_GE_S_NON_MANIFOLD_EDGE An jeder Kante d\u00fcrfen nur 2 Polygon anliegen GE_S_NON_MANIFOLD_EDGE C_GE_S_NON_MANIFOLD_EDGE R_GE_S_MULTIPLE_CONNECTED_COMPONENTS Alle Polygone m\u00fcssen \u00fcber Punkte und Kanten verbunden sein GE_S_MULTIPLE_CONNECTED_COMPONENTS C_GE_S_MULTIPLE_CONNECTED_COMPONENTS R_GE_S_SELF_INTERSECTION Die H\u00fclle selbstverschneidet sich GE_S_SELF_INTERSECTION C_GE_S_SELF_INTERSECTION R_GE_S_POLYGON_WRONG_ORIENTATION Die Orientierung eines Polygons ist falsch GE_S_POLYGON_WRONG_ORIENTATION C_GE_S_POLYGON_WRONG_ORIENTATION R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION Alle Polygone zeigen in die falsche Richtung GE_S_ALL_POLYGONS_WRONG_ORIENTATION C_GE_S_ALL_POLYGONS_WRONG_ORIENTATION R_GE_S_ALL Container f\u00fcr: R_GE_S_TOO_FEW_POLYGONS, R_GE_S_NOT_CLOSED, R_GE_S_NON_MANIFOLD_VERTEX, R_GE_S_NON_MANIFOLD_EDGE, R_GE_S_MULTIPLE_CONNECTED_COMPONENTS, R_GE_S_SELF_INTERSECTION, R_GE_S_POLYGON_WRONG_ORIENTATION, R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION -- --"},{"location":"geometric/#parameter-uberblick","title":"Parameter \u00dcberblick","text":"Name Beschreibung Verwendet in Einheit minVertexDistance Minimale Abstand zwischen zwei Punkten bevor sie als der selbe Punkt angesehen werden R_GE_R_CONSECUTIVE_POINTS_SAME, R_GE_R_NOT_CLOSED, R_GE_R_SELF_INTERSECTION, R_GE_P_INTERIOR_DISCONNECTED Meter type Planarit\u00e4tspr\u00fcfungsart, kann distance, angle, both sein R_GE_P_NON_PLANAR - distanceTolerance Maximale Distanz eines Punktes von der Ausgleichsebene eines Polygons bevor es als Fehler angesehen wird R_GE_P_NON_PLANAR Meter angleTolerance Maximale Differenz im Winkel von angrenzenden Dreiecken einer Triangulierung bevor ein Polygon nicht mehr als Planar angesehen wird R_GE_P_NON_PLANAR Radiant"},{"location":"geometric/#abhangigkeitsbaum","title":"Abh\u00e4ngigkeitsbaum","text":"

Dies ist die Reihenfolge in der die Pr\u00fcfungen ausgef\u00fchrt werden. Wenn eine abh\u00e4ngige Pr\u00fcfung einen Fehler geworfen hat oder nicht ausgef\u00fchrt wurde, so wird die darauffolgende Pr\u00fcfung auch nicht ausgef\u00fchrt.

graph TD;\n  X0001[R_SC_SCHEMA_VALIDATION]\n  R0001[R_GE_R_TOO_FEW_POINTS]\n  R0002[R_GE_R_CONSECUTIVE_POINTS_SAME]\n  R0003[R_GE_R_NOT_CLOSED]\n  R0004[R_GE_R_SELF_INTERSECTION]\n  P0001[R_GE_P_INTERSECTING_RINGS]\n  P0002[R_GE_P_NON_PLANAR]\n  P0003[R_GE_P_INTERIOR_DISCONNECTED]\n  P0004[R_GE_P_HOLE_OUTSIDE]\n  P0005[R_GE_P_INNER_RINGS_NESTED]\n  P0006[R_GE_P_ORIENTATION_RINGS_SAME]\n\n  S0001[R_GE_S_TOO_FEW_POLYGONS]\n  S0002[R_GE_S_NOT_CLOSED]\n  S0003[R_GE_S_NON_MANIFOLD_VERTEX]\n  S0004[R_GE_S_NON_MANIFOLD_EDGE]\n  S0005[R_GE_S_MULTIPLE_CONNECTED_COMPONENTS]\n  S0006[R_GE_S_SELF_INTERSECTION]\n  S0007[R_GE_S_POLYGON_WRONG_ORIENTATION]\n  S0008[R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION]\n\n  X0001-->R0003;\n  R0003-->R0001;\n  R0001-->R0002;\n  R0002-->R0004;\n  R0004-->P0002;\n  P0002-->P0006;\n  P0006-->P0003;\n  P0006-->P0004;\n  P0006-->P0005;\n  P0004-->P0001;\n  P0005-->P0001;\n  P0001-->S0001;\n  P0003-->S0001;\n  S0001-->S0002;\n  S0001-->S0004;\n  S0001-->S0003;\n  S0001-->S0005;\n  S0002-->S0007;\n  S0004-->S0007;\n  S0007-->S0006;\n  S0003-->S0006;\n  S0005-->S0006;\n  S0006-->S0008;
"},{"location":"geometric/#multisurface-und-solid-geometrie","title":"Multisurface und Solid Geometrie","text":"

Um die Definition eines Validierungsplans zu vereinfachen werden zwei neue Anfoderungen zus\u00e4tzlich eingef\u00fchrt. Diese Anforderungen dienen lediglich zur Gruppierung von den vorhandenen Anforderungen und ben\u00f6tigen keine zus\u00e4tzlichen Pr\u00fcfungen.

Anforderungs ID Beschreibung Abh\u00e4ngigkeiten Fehlercode Bekannte Pr\u00fcfungen R_GE_MS Valide Multisurface-Geometrie R_SC-SCHEMA-VALIDATION, R_GE_P_ALL -- -- R_GE_SO Valide H\u00fcllengeometrie R_SC-SCHEMA-VALIDATION, R_GE_S_ALL -- --"},{"location":"requiredSoftware/","title":"Ben\u00f6tigte Software","text":""},{"location":"requiredSoftware/#java","title":"Java","text":"

Vor der CityDoctor Version 3.12.x wird Java 8 entweder als JDK oder als JRE ben\u00f6tigt. Ab der Version 3.12.x wird Java 17 ben\u00f6tigt.

Warning

Es wichtig, dass die installierte Java Version die JavaFX Bibliotheken mit einschlie\u00dft. Diese werden f\u00fcr die grafische Oberfl\u00e4che ben\u00f6tigt.

Die Liberica JRE oder JDK hat sich f\u00fcr einen Einsatz mit CityDoctor bew\u00e4hrt.

Note

Die Liberica Distribution ist zu 100% frei und OpenSource.

Note

F\u00fcr die Entwicklung mit CityDoctor wird eine JDK ben\u00f6tigt.

"},{"location":"requiredSoftware/#citydoctor2","title":"CityDoctor2","text":"

CityDoctor kann von verschiedenen Seiten heruntergeladen werden. Die aktuellste Stelle ist ein gitlab Repository. Alternativ werden Releases auch auf der CityDoctor Homepage der BHT gelistet. Es gibt dabei immer zwei Versionen:

Note

Es gibt manchmal Spezialversionen die Testweise erstellt worden sind um verschiedene Auslieferungsm\u00f6glichkeiten zu testen. Bsp: CityDoctorGUI-x.x.x-win.zip beinhaltet die JavaFX Bibliotheken sodass eine Java Umgebung ohne JavaFX auch verwendet werden kann.

"},{"location":"requirements/","title":"Anforderungen und Pr\u00fcfungen f\u00fcr die Validierung von CityGML-Modellen","text":"

Die Anforderungen sind die Grundbausteine f\u00fcr ein Validierungsplan um CityGML-Modelle zu validieren. F\u00fcr Namenskonventionen und Definitionen, siehe Grundbegriffe.

Eine Anforderung kann durch einen oder mehrere Pr\u00fcfungen validiert werden. Eine Pr\u00fcfung validiert ein oder mehrere Anforderungen bei einem Modell. Jede Pr\u00fcfung kann Vorbedingungen haben. Wenn diese Vorbedingungen nicht erf\u00fcllt sind wird die Pr\u00fcfung nicht ausgef\u00fchrt.

Unterschieden wird dabei zwischen:

"},{"location":"schemaRequirements/","title":"Schemaanforderungen","text":""},{"location":"schemaRequirements/#r_sc_schema_validation","title":"R_SC_SCHEMA_VALIDATION","text":""},{"location":"schemaRequirements/#anforderung","title":"Anforderung","text":"ID R_SC_SCHEMA_VALIDATION Beschreibung Eine grundlengende Anforderung ist, dass jedes CityGML Dokument wohl definiert sein muss und XSD valide ist. Fehlercode SC-SCHEMA-NOT-VALID"},{"location":"schemaRequirements/#prufung","title":"Pr\u00fcfung","text":"ID SC_SCHEMA_VALIDATION Anforderungs ID R_SC_SCHEMA_VALIDATION Vorbedingungen keine Beschreibung Werkzeuge um eine XSD Validierung durchzuf\u00fchren sind verf\u00fcgbar und geben verl\u00e4ssliche Ergebnisse Fehlercode SC_SCHEMA_NOT_VALID"},{"location":"semantic/","title":"Semantische Anforderungen","text":"

Die semantischen Anforderungen sind meistens auf Attributbasis. Daraus ergeben sich 3 Fehlerzust\u00e4nde f\u00fcr ein Attribut:

Warning

SE_ATTRIBUTE_INVALID: ist noch nicht in CityDoctor und der QualityADE umgesetzt ist aber geplant in einer neuen Version zu unterst\u00fctzen.

"},{"location":"semantic/#schematron","title":"Schematron","text":"

In CityDoctor wurde das XML Validierungssystem Schematron integriert um flexibel Attributpr\u00fcfungen anzupassen und zu unterst\u00fctzen.

Hier ist ein Beispiel f\u00fcr eine Schematron Datei die CityDoctor integrieren kann:

<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<schema xmlns=\"http://purl.oclc.org/dsdl/schematron\" queryBinding=\"xslt2\">\n<ns prefix=\"gml\" uri=\"http://www.opengis.net/gml\"/>\n<ns prefix=\"bldg\" uri=\"http://www.opengis.net/citygml/building/2.0\"/>\n<pattern>\n<rule context=\"//*:Building\">\n<assert test=\"count(descendant::*:lod1Solid) &gt; 0 or count(descendant::*:lod2Solid) &gt; 0 or count(descendant::*:lod3Solid) &gt; 0 or count(descendant::*:lod4Solid) &gt; 0\"><value-of select=\"@gml:id | @id\"/>||||SE_ATTRIBUTE_MISSING||any solid||false</assert>\n</rule>\n<rule context=\"//*:BuildingPart\">\n<assert test=\"count(*:lod1Solid) = 1 or count(*:lod2Solid) = 1 or count(*:lod3Solid) = 1 or count(*:lod4Solid) = 1\"><value-of select=\"ancestor::*:Building/@*:id\"/>||<value-of select=\"@gml:id | @id\"/>||SE_ATTRIBUTE_MISSING||any solid||false</assert>\n</rule>\n</pattern>\n</schema>

Diese Datei pr\u00fcft, dass alle Buildings in sich selbst oder in einem ihrer Unterelementen ein Solid beliebigen LODSs vorhanden ist. Au\u00dferdem stellt die Datei sicher, dass jedes BuildingPart ein Solid enth\u00e4lt. Wenn dies nicht der Fall ist wird eine Fehlermeldung ausgegeben. Die Fehlermeldung ist dabei so formattiert, dass CityDoctor sie interpretieren und in das interne Datenmodell einbinden kann.

"},{"location":"semantic/#fehlerformat","title":"Fehlerformat","text":"

Das Fehlerformat ist ein CSV-Format mit || als Trennzeichen

parent id||child id||error code||error type||is generic attribute\n
Die Fehlermeldung besteht aus den folgenden Teilen:

"},{"location":"userInterface/","title":"Nutzeroberfl\u00e4che","text":""},{"location":"userInterface/#citydoctor","title":"CityDoctor","text":"

In der oberen Leiste sind folgende Schaltfl\u00e4chen in Reihenfolge:

Warning

Das Anzeigen der Globalen Ansicht kann bei gro\u00dfen CityGML Dateien (> 100mb je nach System) zu abst\u00fcrzen f\u00fchren. Das Anzeigen kann kurz dauern.

"},{"location":"userInterface/#laden","title":"Laden","text":"

\u00dcber die Schaltfl\u00e4che Laden wird der Dialog zum laden einer CityGML Datei ge\u00f6ffnet.

In der Datei Leiste kann ein Dateipfad eingetragen werden oder \u00fcber die Schaltfl\u00e4che Ausw\u00e4hlen ausgew\u00e4hlt werden.

Au\u00dferdem k\u00f6nnen weitere Einstellungen f\u00fcr das Lesen der Datei angegeben werden.

Beim Laden wird der Fortschritt ungef\u00e4hr durch den Ladebalken repr\u00e4sentiert.

Note

Dateien k\u00f6nnen auch direkt per Drag and Drop vom Dateimanager in die GUI gezogen werden ohne den Laden Dialog zu verwenden. Dabei werden die Default Werte angenommen (8 Nachkommastellen, keine XML-Validierung)

Nach dem Laden einer CityGML Datei werden die Elemente in den einzelnen Tabs angezeigt. Durch ausw\u00e4hlen eines Elements wird das in der Ansicht angezeigt.

Note

Durch Ausw\u00e4hlen des obersten Elements eines Reiters werden alle Elemente innerhalb diese Reiters angezeigt. Wie obige Warnung schon besagt, gilt auch hier, dass gr\u00f6\u00dfere Datenmengen zu Abst\u00fcrzen f\u00fchren.

"},{"location":"userInterface/#prufen","title":"Pr\u00fcfen","text":"

Im Pr\u00fcfdialog kann der Validierungsplan angepasst werden. Hier werden neben den Verf\u00fcgbaren Pr\u00fcfungen auch die globalen Parameter angezeigt.

Ver\u00e4ndert k\u00f6nnen die Parameter mit einem Doppelklick in die Wert Spalte. Die Einheit ist dabei fest.

Note

Der Parameter numberOfRoundingPlaces kann nicht ver\u00e4ndert werden. Er wurde beim Laden der Datei festgelegt.

Falls Pr\u00fcfungen nicht ausgef\u00fchrt werden sollen k\u00f6nnen sie in der Spalte Aktiv deaktiviert werden.

Warning

Wenn Pr\u00fcfungen deaktiviert wurden die andere aktiven Pr\u00fcfungen aber als Abh\u00e4ngigkeit ben\u00f6tigen werden sie bei der Pr\u00fcfung wieder aktiviert um die Stabilit\u00e4t zu gew\u00e4hrleisten. Siehe Anforderungen.

In dem Feld Schematron Datei kann ein Pfad zu einer Schematron Datei eingetragen werden. In dieser Datei k\u00f6nnen flexible Regeln f\u00fcr die semantischen Anforderungen festgelegt werden. Siehe Semantische Pr\u00fcfungen

\u00dcber die beiden Schaltfl\u00e4chen oben rechts kann der Pr\u00fcfplan gespeichert und geladen werden.

Nach der Pr\u00fcfung werden fehlerhafte Elemente rot und fehlerfreie Elemente gr\u00fcn eingef\u00e4rbt. Bei der Auswahl eines Elements das fehler beinhaltet werden die Fehler in dem unteren Tab Fehler angezeigt. Dort kann der Fehler ausgew\u00e4hlt werden um ihn in CityDoctor anzuzeigen und weitere Informationen zu erhalten.

Die Elemente k\u00f6nnen mit dem Dropdown-Men\u00fc gefiltert werden um nur fehlerhafte Elemente anzuzeigen.

"},{"location":"userInterface/#prufberichte","title":"Pr\u00fcfberichte","text":"

In diesem Dialog gibt es nochmal eine \u00dcbersicht \u00fcber die Fehler in Bildform und die M\u00f6glichkeit einen xml oder pdf Bericht zu schreiben.

"},{"location":"validationPlan/","title":"Validierungsplan","text":"

der Validierungsplan f\u00fcr CityDoctor wird in YAML angegeben.

F\u00fcr die Version 3.12.x sieht ein Beispiel so aus: 

globalParameters:\nnumberOfRoundingPlaces: 8\n# in m\nminVertexDistance: 0.0001\nschematronPath: 'checkForSolid.xml'\nuseStreaming: true # (1)!\nrequirements:\nR_GE_R_TOO_FEW_POINTS:\nenabled: true\nR_GE_R_NOT_CLOSED:\nenabled: true\nR_GE_R_CONSECUTIVE_POINTS_SAME:\nenabled: true\nR_GE_R_SELF_INTERSECTION:\nenabled: true\nR_GE_S_MULTIPLE_CONNECTED_COMPONENTS:\nenabled: true\nR_GE_P_INTERIOR_DISCONNECTED:\nenabled: true\nR_GE_P_INTERSECTING_RINGS:\nenabled: true\nR_GE_P_NON_PLANAR:\nenabled: true\nparameters:\n# one of (\"distance\", \"angle\", \"both\")\ntype: distance\n# in m\ndistanceTolerance: 0.01\n# in degree\nangleTolerance: 1\nR_GE_P_HOLE_OUTSIDE:\nenabled: true\nR_GE_P_ORIENTATION_RINGS_SAME:\nenabled: true\nR_GE_P_INNER_RINGS_NESTED:\nenabled: true\nR_GE_S_TOO_FEW_POLYGONS:\nenabled: true\nR_GE_S_NOT_CLOSED:\nenabled: true\nR_GE_S_NON_MANIFOLD_EDGE:\nenabled: true\nR_GE_S_POLYGON_WRONG_ORIENTATION:\nenabled: true\nR_GE_S_ALL_POLYGONS_WRONG_ORIENTATION:\nenabled: true\nR_GE_S_NON_MANIFOLD_VERTEX:\nenabled: true\nR_GE_S_SELF_INTERSECTION:\nenabled: true\nR_SE_BS_IS_WALL:\nenabled: false\nparameters:\nlowerAngle: '45'\nupperAngle: '135'\nR_SE_BS_IS_FLOOR:\nenabled: false\nR_SE_BS_GROUND_UNFRAGMENTED:\nenabled: false\nR_SE_BS_IS_GROUND:\nenabled: false\nR_SE_BS_IS_CEILING:\nenabled: false\n

  1. Der Parameter useStreaming ist ein Schalter um eine Datei St\u00fcck f\u00fcr St\u00fcck einzulesen anstelle erst die komplette Datei zu lesen bevor die Pr\u00fcfung stattfindet. Mit dieser Einstellung k\u00f6nnen auch Dateien > 2GB ohne gro\u00dfe RAM Anforderungen gepr\u00fcft werden.

In dem Validierungsplan finden sich die selben Einstellungen wieder, die in der grafischen Oberfl\u00e4che auch aufgelistet sind.

Unter requirements sind alle Anforderungen gelistet die gepr\u00fcft werden sollen. Dabei sind die semantischen Pr\u00fcfungen standardm\u00e4\u00dfig deaktiviert.

"}]}