<h1id="validierung-von-3d-stadtmodellen-in-citygml">Validierung von 3D Stadtmodellen in CityGML<aclass="headerlink"href="#validierung-von-3d-stadtmodellen-in-citygml"title="Permanent link">#</a></h1>
<h2id="begriffe-und-definitionen">Begriffe und Definitionen<aclass="headerlink"href="#begriffe-und-definitionen"title="Permanent link">#</a></h2>
<h1id="validation-of-3d-city-models-encoded-in-citygml">Validation of 3D city models encoded in CityGML<aclass="headerlink"href="#validation-of-3d-city-models-encoded-in-citygml"title="Permanent link">#</a></h1>
<h2id="terms-and-definitions">Terms and definitions<aclass="headerlink"href="#terms-and-definitions"title="Permanent link">#</a></h2>
<p>as defined in<ahref="http://mail.opengeospatial.org/lists/lt.php?id=fR4CDVYeAlJfHwhTCwA">CityGML Quality Interoperability Experiment, chapter 3</a></p>
<p><strong>Validation</strong></p>
<blockquote>
<p>Prozess des validierens einer CityGML Datei nach spezifizierten Anforderungen. Eine valide Datei entspricht allen Anforderungen.</p>
<p>Process of validating a CityGML data set against a specified set of requirements. A valid data set is conformant to these requirements.</p>
</blockquote>
<p><strong>Anforderungen</strong></p>
<p><strong>Requirements</strong></p>
<blockquote>
<p>Regeln und Einschränkungen, die die Datenstruktur eindeutig definieren. Anforderungen können 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ätzliche nutzerabhängige Anforderungen zu definieren.</p>
<p>Rules and restrictions to define data structure and content unambiguously. Requirements can be derived from the CityGML Standard document or be defined separately as refinement of the CityGML standard to avoid ambiguities of the standard and/or specify further requirements (user/application dependent).</p>
</blockquote>
<p><strong>Prüfung</strong></p>
<p><strong>Check</strong></p>
<blockquote>
<p>Algorithmische Implementation um eine Anforderung innerhalb eines Validerungsprogramms zu prüfen.</p>
<p>Algorithmic implementation to check if a requirement is met in a validation software. </p>
</blockquote>
<p><strong>Fehler</strong></p>
<p><strong>Error</strong></p>
<blockquote>
<p>Ergebnis einer Prüfung im Falle einer Nichtkonformität von Anforderungen.</p>
<p>Result of a check in case of non-conformance.</p>
</blockquote>
<p><strong>Validierungsplan</strong></p>
<p><strong>Validation plan</strong></p>
<blockquote>
<p>Strukturierte Liste von Anforderungen, überlicherweise angepasst an den konkreten Fall.</p>
<p>Structured list of requirements, usually depending on use case.</p>
<h2id="fehlercodes-for-geometrische-fehler">Fehlercodes for geometrische Fehler<aclass="headerlink"href="#fehlercodes-for-geometrische-fehler"title="Permanent link">#</a></h2>
<p>Die Fehlercodes wurden übernommen aus dem<ahref="http://mail.opengeospatial.org/lists/lt.php?id=fR4CDVYeAlJfHwhTCwA">CityGML Quality Interoperability Experiment, chapter 7.5</a>.</p>
<h2id="error-codes-for-geometric-errors">Error codes for geometric errors<aclass="headerlink"href="#error-codes-for-geometric-errors"title="Permanent link">#</a></h2>
<p>as defined in the<ahref="http://mail.opengeospatial.org/lists/lt.php?id=fR4CDVYeAlJfHwhTCwA">CityGML Quality Interoperability Experiment, chapter 7.5</a>.</p>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>Die Anforderungen wurden in CityDoctor umbenannt um einen auch von Menschen zu verstehenden Begriff, analog zu den Fehlercodes, darzustellen.</p>
<p>The requirements were renamed in CityDoctor to be more human readable. The were renamed according to the error codes.</p>
</div>
<p>Alle geometrischen Fehler sind in dem "GE" Definitionsbereich. Da geometrische Validierung basierend auf den Primitiven auf drei verschiedenen Ebenen ausgeführt wird enthält jede Anforderung eine Ebene:</p>
<p>All the geometric errors are in the "GE" domain. Also, since the geometric validation is performed at 3 different
levels (based on the primitives), the requirements also contain the level:</p>
<ul>
<li>Ring: R</li>
<li>Polygon: P</li>
<li>Hülle (Shell): S</li>
<li>Shell: S</li>
</ul>
<p>Fehlercodes folgen dem selben Namensschema wie die Anforderungen, siehe auch <ahref="../basic/">Grundbegriffe</a>. Jede Verletzung einer Anforderung muss in einem Fehler enden, der einen entsprechenden Fehlercode beinhaltet.
Jeder Fehler kann (und sollte) zusätzliche Informationen beinhalten (z.B. Wenn ein Ring nicht geschlossen ist, dann sollte die ID des Rings mitgegeben werden).</p>
<p>Zwei Punkte A und B sind gleich wenn die Euclidische-Distanz zwischen den beiden Punkten kleiner als eine definierte Größe ist (<em>minVertexDistance</em>). Diese definierte Größe findet auch in vielen Anforderungen wieder Anwendung, zum Beispiel berührt ein Punkt eine Kante wenn der Abstand des Punktes kleiner ist als <em>minVertexDistance</em>. In den folgenden Anforderungen wird die Größe verwendet:</p>
<p>Error codes follow the same system as the requirements mentioned <ahref="../basic/">fundamentals</a>. A violation of each respective data quality requirement should result in an error which must
be reported with an error code according to the requirement ID.
For each error code, extra information can (and should) be returned. For instance: if a ring is not closed (GE_R_NOT_CLOSED) then the ID of the ring (e.g., its
position (first, second..) in the polygon) should be returned;
if a polygon is not planar (GE_P_NON_PLANAR_POLYGON_DISTANCE_PLANE) then the ID of the
polygon and the max. deviation from the reference plane should be returned; or
if a shell is not 'watertight' (GE_S_NOT_CLOSED) then the location of the hole(s) should be returned.</p>
<p>Vertices A and B are the same if the euclidean distance between them is smaller than (<em>minVertexDistance</em>). It is also used to check whether a point is touching an edge. If a point is within <em>minVertexDistance</em> distance to an edge it is considered touching. This parameter is used in multiple checks with the same value:</p>
<ul>
<li>R_GE_R_CONSECUTIVE_POINTS_SAME</li>
<li>R_GE_R_NOT_CLOSED</li>
<li>R_GE_R_SELF_INTERSECTION</li>
<li>R_GE_P_INTERIOR_DISCONNECTED</li>
</ul>
<p>Die folgenden Anforderungen wurden auf den drei geometrischen Ebenen definiert<ahref="https://doi.org/10.1111/mice.12043">(nach Ledoux (2013))</a>:</p>
<p>The following requirements are defined for the three respective geometric levels<ahref="https://doi.org/10.1111/mice.12043">(adopted from Ledoux (2013))</a>:</p>
<p>Dies ist die Reihenfolge in der die Prüfungen ausgeführt werden. Wenn eine abhängige Prüfung einen Fehler geworfen hat oder nicht ausgeführt wurde, so wird die darauffolgende Prüfung auch nicht ausgeführt.</p>
<p>This is the order the checks will be executed. If one of the depending checks is not executed or has reported an error the following check will not be executed.</p>
<divclass="mermaid">graph TD;
X0001[R_SC_SCHEMA_VALIDATION]
R0001[R_GE_R_TOO_FEW_POINTS]
...
...
@@ -732,28 +738,28 @@ Jeder Fehler kann (und sollte) zusätzliche Informationen beinhalten (z.B. Wenn
S0006-->S0008;
</div>
<h2id="multisurface-und-solid-geometrie">Multisurface und Solid Geometrie<aclass="headerlink"href="#multisurface-und-solid-geometrie"title="Permanent link">#</a></h2>
<p>Um die Definition eines Validierungsplans zu vereinfachen werden zwei neue Anfoderungen zusätzlich eingeführt. Diese Anforderungen dienen lediglich zur Gruppierung von den vorhandenen Anforderungen und benötigen keine zusätzlichen Prüfungen.</p>
<p>In order to simplify the definition of a validation plan, two requirement will be introduced in addition to the CityGML QIE: valid MultiSurface and valid Solid geometry. These requirements are just a collection of the linear ring, polygon and shell requirements. No extra check is required.</p>
<p><strong>Entwicklung eines Systems zur automatisierten Reparatur virtueller Stadtmodelle</strong></p>
<p>CityDoctor2 ist eine Qualitätsprüfungssoftware für 3D Stadtmodelle im CityGML format. CityDoctor kann CityGML 1/2 Dokumente einlesen und seit Version 3.12 kann auch eingeschränkt CityGML 3 gelesen werden. Alle Prüfergebnisse können in xml oder pdf Form ausgegeben werden. Zusätzlich implementiert CityDoctor die <ahref="https://transfer.hft-stuttgart.de/gitlab/citydoctor/qualityade">QualityADE</a>um Prüfergebnisse direkt in CityGML zu speichern.</p>
<p><strong> Development of a automatic repair system for virtual city models</strong></p>
<p>CityDoctor2 is a quality check software for 3D city models in CityGML format. CityDoctor can read CityGML 1/2 documents and since version 3.12 can also read CityGML 3 with restrictions. All check results can be output in xml or pdf form. Additionally CityDoctor implements the <ahref="https://transfer.hft-stuttgart.de/gitlab/citydoctor/qualityade">QualityADE</a>to save test results directly into CityGML.</p>
<p>Der Validierungsteil von CityDoctor ist frei verfügbar und <ahref="https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctor2">OpenSource</a></p>
<p>The validation part of CityDoctor is freely available and <ahref="https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctor2">open source</a></p>
<h2id="versionen-ab-3130">Versionen ab 3.13.0<aclass="headerlink"href="#versionen-ab-3130"title="Permanent link">#</a></h2>
<p>Ab Version 3.13.0 wurde ein Repository auf dem Transferportal der Hochschule erstellt, das fortan als Ablageort für fertige Releases verwendet wird:<br/>
<h2id="versions-from-3130">Versions from 3.13.0<aclass="headerlink"href="#versions-from-3130"title="Permanent link">#</a></h2>
<p>Starting with version 3.13.0, a repository was created on the university's transferportal, which will henceforth be used as a repository for finished releases:
<p>Die Versionen sind dort unterteilt zwischen CityDoctorValidation und CityDoctorGUI und unter diesen Ordnern gibt es die entsprechenden Versionsordner.</p>
<p>Für jede CityDoctor Variante (CityDoctorValidation oder CityDoctorGUI) werden vier verschiedene Versionen zum Download bereitgestellt.
Es werden in verschiedenen Versionen Java Runtimes der Liberica Distribution mitgeliefert. </p>
<p>The versions are divided there between CityDoctorValidation and CityDoctorGUI and under these folders there are the corresponding version folders.</p>
<p>For each CityDoctor variant (CityDoctorValidation or CityDoctorGUI) four different versions are provided for download.
Java runtimes of the Liberica distribution are included in different versions. </p>
<table>
<thead>
<tr>
<th>Version</th>
<th>Beschreibung</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>CityDoctor*-no-runtime.zip</td>
<td>Diese Version beinhaltet keine Runtime für Java. Falls auf Ihrem PC schon ein Java der Version 17 installiert ist (siehe <ahref="./#java">Java</a>), dann ist diese Version zu bevorzugen.</td>
<td>This version does not include a runtime for Java. If you already have a Java version 17 installed on your PC use this. See <ahref="./#java">Java</a></td>
</tr>
<tr>
<td>CityDoctor*-win.zip</td>
<td>Beinhaltet eine Windows Java Runtime zum ausführen von CityDoctor, kein Java muss installiert sein.</td>
<td>Includes a Windows Java Runtime to run CityDoctor, no Java needs to be installed.</td>
</tr>
<tr>
<td>CityDoctor*-lin.zip</td>
<td>Beinhaltet eine Linux Java Runtime zum ausführen von CityDoctor</td>
<td>Includes a Linux Java Runtime to run CityDoctor</td>
</tr>
<tr>
<td>CityDoctor*-mac.zip</td>
<td>Beinhaltet eine Mac Java Runtime zum ausführen von CityDoctor</td>
<td>Includes a Mac Java Runtime to run CityDoctor</td>
</tr>
</tbody>
</table>
<h2id="versionen-bis-312x">Versionen bis 3.12.x<aclass="headerlink"href="#versionen-bis-312x"title="Permanent link">#</a></h2>
<p>CityDoctor kann von verschiedenen Seiten heruntergeladen werden. Die aktuellste Stelle ist ein<ahref="https://gitlab.com/volkercoors/CiD4Sim/-/tree/master/CityDoctorExtension">gitlab Repository</a>. Alternativ werden Releases auch auf der<ahref="https://projekt.bht-berlin.de/citydoctor2/downloads/">CityDoctor Homepage der BHT</a> gelistet. Es gibt dabei immer zwei Versionen:</p>
<h2id="versions-until-312x">Versions until 3.12.x<aclass="headerlink"href="#versions-until-312x"title="Permanent link">#</a></h2>
<p>CityDoctor can be downloaded from various sites. The most recent place is a<ahref="https://gitlab.com/volkercoors/CiD4Sim/-/tree/master/CityDoctorExtension">gitlab repository</a>. Alternatively, releases are also listed on the<ahref="https://projekt.bht-berlin.de/citydoctor2/downloads/">CityDoctor homepage of the BHT</a>. There are always two versions:</p>
<ul>
<li><strong>CityDoctorGUI-3.x.x.zip:</strong>Das ist die grafische Oberfläche inklusive der Prüfungen. Geeignet für den Endnutzer auf einem Desktop PC.</li>
<li><strong>CityDoctorValidation-3.x.x.zip:</strong>Das ist die Batch-Version die für die Integration in Servern oder anderen bestehenden Systemen geeignet ist und hat keine grafische Oberfläche sondern arbeitet Dateibasiert als Prozess.</li>
<li><strong>CityDoctorGUI-3.x.x.zip:</strong>This is the graphical interface including the checks. Suitable for the end user on a desktop PC.</li>
<li><strong>CityDoctorValidation-3.x.x.zip:</strong>This is the batch version suitable for integration into servers or other existing systems and has no graphical interface but works file-based as a process.</li>
</ul>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>Es gibt manchmal Spezialversionen die Testweise erstellt worden sind um verschiedene Auslieferungsmöglichkeiten zu testen. Bsp: CityDoctorGUI-x.x.x-win.zip beinhaltet die JavaFX Bibliotheken sodass eine Java Umgebung ohne JavaFX auch verwendet werden kann.</p>
<p>There are sometimes specialversions that have been created for testing different delivery options. Example: CityDoctorGUI-x.x.x-win.zip contains the JavaFX libraries so that a Java environment without JavaFX can also be used.</p>
<h1id="anforderungen-und-prufungen-fur-die-validierung-von-citygml-modellen">Anforderungen und Prüfungen für die Validierung von CityGML-Modellen<aclass="headerlink"href="#anforderungen-und-prufungen-fur-die-validierung-von-citygml-modellen"title="Permanent link">#</a></h1>
<p>Die Anforderungen sind die Grundbausteine für ein Validierungsplan um CityGML-Modelle zu validieren. Für Namenskonventionen und Definitionen, siehe <ahref="../basic/">Grundbegriffe</a>. </p>
<p>Eine Anforderung kann durch einen oder mehrere Prüfungen validiert werden. Eine Prüfung validiert ein oder mehrere Anforderungen bei einem Modell. Jede Prüfung kann Vorbedingungen haben. Wenn diese Vorbedingungen nicht erfüllt sind wird die Prüfung nicht ausgeführt.</p>
<p>Unterschieden wird dabei zwischen:</p>
<p>The requirements are the basic building blocks for a validation plan to validate CityGML models. For naming conventions and definitions, see <ahref="../basic/">fundamentals</a>. </p>
<p>A requirement can be validated by one or more checks. A check validates one or more requirements on a model. Each check can have preconditions. If these preconditions are not met, the check is not executed.
{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"CityDoctor2","text":"<p>Entwicklung eines Systems zur automatisierten Reparatur virtueller Stadtmodelle </p> <p>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.</p> <p></p>"},{"location":"#lizenzen-versionen","title":"Lizenzen / Versionen","text":""},{"location":"#citydoctorvalidation","title":"CityDoctorValidation","text":"<p>Der Validierungsteil von CityDoctor ist frei verf\u00fcgbar und OpenSource</p>"},{"location":"#citydoctorgui","title":"CityDoctorGUI","text":"<p>Die grafische Oberfl\u00e4che ist frei aber nicht OpenSource (siehe Installation)</p>"},{"location":"#citydoctorhealer","title":"CityDoctorHealer","text":"<p>Der Teil zust\u00e4ndig f\u00fcr die Reparatur ist nur in Absprache mit uns zu erhalten. Mail an: </p>"},{"location":"#projekt","title":"Projekt","text":"<p>Projektlaufzeit: 01.11.2018 - 31.12.2021</p>"},{"location":"#partner","title":"Partner","text":"<p>Projektverantwortliche: Prof. Dr. Margitta Pries</p> <p>Verbundpartner: Prof. Dr.-Ing. Volker Coors</p> <p>Kooperationspartner: 3DIS GmbH 3dpartzz GmbH con terra GmbH Geoplex GIS GmbH Mark Wewetzer M.O.S.S. Computer Grafik Systeme GmbH Steinbeis - Transferzentrum Virtual City Systems</p> <p>Assoziative Partner: Landesamt f\u00fcr Geoinformation und Landentwicklung Baden-W\u00fcrttemberg </p> <p>Mittelgeber: Bundesministerium f\u00fcr Bildung und Forschung </p> <p>Projekttr\u00e4ger: VDI Technologiezentrum </p> <p></p>"},{"location":"R_GE_MS/","title":"R_GE_MS","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_MS_0001</p>"},{"location":"R_GE_P_HOLE_OUTSIDE/","title":"R_GE_P_HOLE_OUTSIDE","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_PO_0004</p>"},{"location":"R_GE_P_INNER_RINGS_NESTED/","title":"R_GE_P_INNER_RINGS_NESTED","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_PO_0005</p>"},{"location":"R_GE_P_INTERIOR_DISCONNECTED/","title":"R_GE_P_INTERIOR_DISCONNECTED","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_PO_0003 </p>"},{"location":"R_GE_P_INTERSECTING_RINGS/","title":"R_GE_P_INTERSECTING_RINGS","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_PO_0001</p>"},{"location":"R_GE_P_NON_PLANAR/","title":"R_GE_P_NON_PLANAR","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_PO_0002 </p>"},{"location":"R_GE_P_ORIENTATION_RINGS_SAME/","title":"R_GE_P_ORIENTATION_RINGS_SAME","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_PO_0006 </p>"},{"location":"R_GE_R_COLLAPSED_TO_LINE/","title":"R_GE_R_COLLAPSED_TO_LINE","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_LR_0005</p>"},{"location":"R_GE_R_CONSECUTIVE_POINTS_SAME/","title":"R_GE_R_CONSECUTIVE_POINTS_SAME","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_LR_0002</p>"},{"location":"R_GE_R_NOT_CLOSED/","title":"R_GE_R_NOT_CLOSED","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_LR_0003</p>"},{"location":"R_GE_R_SELF_INTERSECTION/","title":"R_GE_R_SELF_INTERSECTION","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_LR_0004</p>"},{"location":"R_GE_R_TOO_FEW_POINTS/","title":"R_GE_R_TOO_FEW_POINTS","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_LR_0001</p>"},{"location":"R_GE_SO/","title":"R_GE_SO","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0009</p>"},{"location":"R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION/","title":"R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0008</p>"},{"location":"R_GE_S_MULTIPLE_CONNECTED_COMPONENTS/","title":"R_GE_S_MULTIPLE_CONNECTED_COMPONENTS","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0005</p>"},{"location":"R_GE_S_NON_MANIFOLD_EDGE/","title":"R_GE_S_NON_MANIFOLD_EDGE","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0004</p>"},{"location":"R_GE_S_NON_MANIFOLD_VERTEX/","title":"R_GE_S_NON_MANIFOLD_VERTEX","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0003</p>"},{"location":"R_GE_S_NOT_CLOSED/","title":"R_GE_S_NOT_CLOSED","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0002</p>"},{"location":"R_GE_S_POLYGON_WRONG_ORIENTATION/","title":"R_GE_S_POLYGON_WRONG_ORIENTATION","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0007</p>"},{"location":"R_GE_S_SELF_INTERSECTION/","title":"R_GE_S_SELF_INTERSECTION","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0006</p>"},{"location":"R_GE_S_TOO_FEW_POLYGONS/","title":"R_GE_S_TOO_FEW_POLYGONS","text":"<p>siehe https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0001</p>"},{"location":"basic/","title":"Validierung von 3D Stadtmodellen in CityGML","text":""},{"location":"basic/#begriffe-und-definitionen","title":"Begriffe und Definitionen","text":"<p>nach CityGML Quality Interoperability Experiment, chapter 3</p> <p>Validierung</p> <p>Prozess des validierens einer CityGML Datei nach spezifizierten Anforderungen. Eine valide Datei entspricht allen Anforderungen.</p> <p>Anforderungen</p> <p>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.</p> <p>Pr\u00fcfung</p> <p>Algorithmische Implementation um eine Anforderung innerhalb eines Validerungsprogramms zu pr\u00fcfen.</p> <p>Fehler</p> <p>Ergebnis einer Pr\u00fcfung im Falle einer Nichtkonformit\u00e4t von Anforderungen.</p> <p>Validierungsplan</p> <p>Strukturierte Liste von Anforderungen, \u00fcberlicherweise angepasst an den konkreten Fall.</p>"},{"location":"basic/#zusatzliche-defintionen","title":"Zus\u00e4tzliche Defintionen:","text":"<p>XSD valide</p> <p>Eine CityGML Datei XSD valide wenn sie dem CityGML XML Schema entspricht.</p>"},{"location":"firstRun/","title":"Erster Start","text":""},{"location":"firstRun/#start","title":"Start","text":"<p>Nach dem entpacken der Zip Datei sollte je nach Version (GUI oder Batch) eine Struktur \u00e4hnlich diesem Bild rauskommen (Beispiel CityDoctorGUI): </p> <p>Um CityDoctor zu starten kann die start.bat verwendet werden.</p> <p>Die .bat Datei enth\u00e4lt dabei nur den Befehl:</p> <pre><code>java -classpath libs/*;plugins/*;CityDoctorGUI-3.12.0.jar de.hft.stuttgart.citydoctor2.gui.MainWindow\n</code></pre> <p>Note</p> <p>Der Befehl hat sich \u00fcber die Versionshistorie von CityDoctor ver\u00e4ndert.</p> <p>F\u00fcr die Batch Version ist der Befehl analog und kann entsprechend f\u00fcr andere Betriebsysteme angepasst werden.</p> <p>Note</p> <p>F\u00fcr Linux oder Mac kann dieser Befehl auch verwendet werden, es muss nur das \";\" durch \":\" ersetzt werden. Der Rest bleibt gleich.</p>"},{"location":"geometric/","title":"Geometrieanforderungen","text":""},{"location":"geometric/#fehlercodes-for-geometrische-fehler","title":"Fehlercodes for geometrische Fehler","text":"<p>Die Fehlercodes wurden \u00fcbernommen aus dem CityGML Quality Interoperability Experiment, chapter 7.5.</p> <p>Note</p> <p>Die Anforderungen wurden in CityDoctor umbenannt um einen auch von Menschen zu verstehenden Begriff, analog zu den Fehlercodes, darzustellen.</p> <p>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:</p> <ul> <li>Ring: R</li> <li>Polygon: P</li> <li>H\u00fclle (Shell): S</li> </ul> <p>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).</p>"},{"location":"geometric/#vertex-punkt-anforderungen","title":"Vertex (Punkt) Anforderungen","text":"<p>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:</p> <ul> <li>R_GE_R_CONSECUTIVE_POINTS_SAME</li> <li>R_GE_R_NOT_CLOSED</li> <li>R_GE_R_SELF_INTERSECTION</li> <li>R_GE_P_INTERIOR_DISCONNECTED</li> </ul> <p>Die folgenden Anforderungen wurden auf den drei geometrischen Ebenen definiert (nach Ledoux (2013)):</p>"},{"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":"<p>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.</p> <pre><code>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; \n</code></pre>"},{"location":"geometric/#multisurface-und-solid-geometrie","title":"Multisurface und Solid Geometrie","text":"<p>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.</p> 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/#versionen-ab-3130","title":"Versionen ab 3.13.0","text":"<p>Ab Version 3.13.0 wurde ein Repository auf dem Transferportal der Hochschule erstellt, das fortan als Ablageort f\u00fcr fertige Releases verwendet wird: https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctorreleases</p> <p>Die Versionen sind dort unterteilt zwischen CityDoctorValidation und CityDoctorGUI und unter diesen Ordnern gibt es die entsprechenden Versionsordner.</p>"},{"location":"requiredSoftware/#releaseversionen","title":"Releaseversionen","text":"<p>F\u00fcr jede CityDoctor Variante (CityDoctorValidation oder CityDoctorGUI) werden vier verschiedene Versionen zum Download bereitgestellt. Es werden in verschiedenen Versionen Java Runtimes der Liberica Distribution mitgeliefert. </p> Version Beschreibung CityDoctor*-no-runtime.zip Diese Version beinhaltet keine Runtime f\u00fcr Java. Falls auf Ihrem PC schon ein Java der Version 17 installiert ist (siehe Java), dann ist diese Version zu bevorzugen. CityDoctor*-win.zip Beinhaltet eine Windows Java Runtime zum ausf\u00fchren von CityDoctor, kein Java muss installiert sein. CityDoctor*-lin.zip Beinhaltet eine Linux Java Runtime zum ausf\u00fchren von CityDoctor CityDoctor*-mac.zip Beinhaltet eine Mac Java Runtime zum ausf\u00fchren von CityDoctor"},{"location":"requiredSoftware/#versionen-bis-312x","title":"Versionen bis 3.12.x","text":"<p>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:</p> <ul> <li>CityDoctorGUI-3.x.x.zip: Das ist die grafische Oberfl\u00e4che inklusive der Pr\u00fcfungen. Geeignet f\u00fcr den Endnutzer auf einem Desktop PC.</li> <li>CityDoctorValidation-3.x.x.zip: Das ist die Batch-Version die f\u00fcr die Integration in Servern oder anderen bestehenden Systemen geeignet ist und hat keine grafische Oberfl\u00e4che sondern arbeitet Dateibasiert als Prozess.</li> </ul> <p>Note</p> <p>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.</p>"},{"location":"requiredSoftware/#java","title":"Java","text":"<p>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.</p> <p>Warning</p> <p>Es wichtig, dass die installierte Java Version die JavaFX Bibliotheken mit einschlie\u00dft. Diese werden f\u00fcr die grafische Oberfl\u00e4che ben\u00f6tigt.</p> <p>Die Liberica JRE oder JDK hat sich f\u00fcr einen Einsatz mit CityDoctor bew\u00e4hrt.</p> <p>Note</p> <p>Die Liberica Distribution ist zu 100% frei und OpenSource.</p> <p>Note</p> <p>F\u00fcr die Entwicklung mit CityDoctor wird eine JDK ben\u00f6tigt.</p>"},{"location":"requirements/","title":"Anforderungen und Pr\u00fcfungen f\u00fcr die Validierung von CityGML-Modellen","text":"<p>Die Anforderungen sind die Grundbausteine f\u00fcr ein Validierungsplan um CityGML-Modelle zu validieren. F\u00fcr Namenskonventionen und Definitionen, siehe Grundbegriffe. </p> <p>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.</p> <p>Unterschieden wird dabei zwischen:</p> <ul> <li>Schemaanforderungen</li> <li>Geometrieanforderungen</li> <li>Semantische Anforderungen</li> </ul>"},{"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":"<p>Die semantischen Anforderungen sind meistens auf Attributbasis. Daraus ergeben sich 3 Fehlerzust\u00e4nde f\u00fcr ein Attribut:</p> <ul> <li>SE_ATTRIBUTE_WRONG_VALUE: Wenn ein Attribut ein falschen Wert hat.</li> <li>SE_ATTRIBUTE_MISSING: Wenn ein Attribut fehlt, aber vorhanden sein sollte.</li> <li>SE_ATTRIBUTE_INVALID: Wenn ein Attribut vorhanden ist aber verboten ist.</li> </ul> <p>Warning</p> <p>SE_ATTRIBUTE_INVALID: ist noch nicht in CityDoctor und der QualityADE umgesetzt ist aber geplant in einer neuen Version zu unterst\u00fctzen.</p>"},{"location":"semantic/#schematron","title":"Schematron","text":"<p>In CityDoctor wurde das XML Validierungssystem Schematron integriert um flexibel Attributpr\u00fcfungen anzupassen und zu unterst\u00fctzen. </p> <p>Hier ist ein Beispiel f\u00fcr eine Schematron Datei die CityDoctor integrieren kann:</p>"},{"location":"semantic/#citydoctor-3130","title":"CityDoctor >= 3.13.0","text":"<pre><code><?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\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</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</assert>\n </rule>\n </pattern>\n</schema> \n\n</code></pre>"},{"location":"semantic/#citydoctor-3130_1","title":"CityDoctor < 3.13.0","text":"<pre><code><?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\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> \n</code></pre> <p>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.</p>"},{"location":"semantic/#fehlerformat","title":"Fehlerformat","text":"<p>Das Fehlerformat ist ein CSV-Format mit || als Trennzeichen</p> <pre><code>parent id||child id||error code||error type||is generic attribute\n</code></pre> <p>Die Fehlermeldung besteht aus den folgenden Teilen:</p> <ul> <li>Die <code>parent id</code> ist die gml id des obersten Elements z.B. Building oder Bridge. </li> <li>Falls der Fehler in einem Unterelement aufgetreten ist so kann diese ID in dem Feld f\u00fcr die <code>child id</code> eingetragen werden.</li> <li>Im Feld <code>error type</code> ist einer der 3 Fehlertypen einzutragen: <code>SE_ATTRIBUTE_WRONG_VALUE, SE_ATTRIBUTE_MISSING, SE_ATTRIBUTE_INVALID</code>.</li> </ul> <p>note Nur in CityDoctor < 3.13.0: * Um ein generisches Attribut mit dem Namen <code>measuredHeight</code> von dem nicht generischen Attribut zu unterscheiden ist im letzten Feld vorgesehen <code>true</code> einzutragen wenn es sich um ein generisches Attribut handelt ansonsten <code>false</code>. </p>"},{"location":"userInterface/","title":"Nutzeroberfl\u00e4che","text":""},{"location":"userInterface/#citydoctor","title":"CityDoctor","text":"<p>In der oberen Leiste sind folgende Schaltfl\u00e4chen in Reihenfolge:</p> <ul> <li>Laden: \u00d6ffnet den Dialog zum laden einer CityGML Datei</li> <li>Pr\u00fcfen: \u00d6ffnet den Dialog zum pr\u00fcfen einer geladenen CityGML</li> <li>Pr\u00fcfberichte: \u00d6ffnet den Dialog zum schreiben eines Pr\u00fcfprotokolls in xml oder pdf Form</li> <li>Gitternetz: Zeigt/Versteckt das Gitternetz anstatt gef\u00fcllter Polygone</li> <li>R\u00fcckseiten: Zeigt/Versteckt R\u00fcckseiten von Polygonen</li> <li>Globale Ansicht: L\u00e4dt alle Elemente einer CityGML in die Ansicht</li> <li>LODs: Schaltet einzelne LODs von der Ansicht an oder aus</li> <li>Speichern: Speichert eine CityGML Datei zur\u00fcck, falls die Datei gepr\u00fcft wurde wird die QualityADE mitgeschrieben.</li> <li>About: \u00d6ffnet den Dialog mit Informationen zu dem Projekt CityDoctor2</li> <li>Ansichten: Wechselt verschiedene Ansichten. F\u00fcr die Pr\u00fcfung gibt es nur eine.</li> <li>Sprache: Hier kann die Sprache eingestellt werden (Deutsch/Englisch)</li> </ul> <p>Warning</p> <p>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.</p>"},{"location":"userInterface/#laden","title":"Laden","text":"<p>\u00dcber die Schaltfl\u00e4che Laden wird der Dialog zum laden einer CityGML Datei ge\u00f6ffnet.</p> <p></p> <p>In der Datei Leiste kann ein Dateipfad eingetragen werden oder \u00fcber die Schaltfl\u00e4che Ausw\u00e4hlen ausgew\u00e4hlt werden.</p> <p>Au\u00dferdem k\u00f6nnen weitere Einstellungen f\u00fcr das Lesen der Datei angegeben werden.</p> <ul> <li>NumberOfRoundingPlaces: Auf wie viele Nachkommastellen werden die eingelesenen Werte gerundet.</li> <li>XML-Validierung: F\u00fchrt eine XML Validierung durch. Fehler werden dabei direkt beim einlesen festgestellt und das Einlesen wird abgebrochen.</li> <li>Speicherverbrauch: Spart RAM um gr\u00f6\u00dfere Dateien in der GUI zu erm\u00f6glichen. Kostet geringf\u00fcgig Performance bei der Pr\u00fcfung.</li> </ul> <p>Beim Laden wird der Fortschritt ungef\u00e4hr durch den Ladebalken repr\u00e4sentiert.</p> <p>Note</p> <p>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)</p> <p>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.</p> <p></p> <p>Note</p> <p>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.</p>"},{"location":"userInterface/#prufen","title":"Pr\u00fcfen","text":"<p>Im Pr\u00fcfdialog kann der Validierungsplan angepasst werden. Hier werden neben den Verf\u00fcgbaren Pr\u00fcfungen auch die globalen Parameter angezeigt.</p> <p>Ver\u00e4ndert k\u00f6nnen die Parameter mit einem Doppelklick in die Wert Spalte. Die Einheit ist dabei fest.</p> <p>Note</p> <p>Der Parameter numberOfRoundingPlaces kann nicht ver\u00e4ndert werden. Er wurde beim Laden der Datei festgelegt.</p> <p>Falls Pr\u00fcfungen nicht ausgef\u00fchrt werden sollen k\u00f6nnen sie in der Spalte Aktiv deaktiviert werden.</p> <p>Warning</p> <p>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.</p> <p>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</p> <p>\u00dcber die beiden Schaltfl\u00e4chen oben rechts kann der Pr\u00fcfplan gespeichert und geladen werden.</p> <p>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.</p> <p></p> <p>Die Elemente k\u00f6nnen mit dem Dropdown-Men\u00fc gefiltert werden um nur fehlerhafte Elemente anzuzeigen.</p>"},{"location":"userInterface/#prufberichte","title":"Pr\u00fcfberichte","text":"<p>In diesem Dialog gibt es nochmal eine \u00dcbersicht \u00fcber die Fehler in Bildform und die M\u00f6glichkeit einen xml oder pdf Bericht zu schreiben.</p> <p></p>"},{"location":"validationPlan/","title":"Validierungsplan","text":"<p>der Validierungsplan f\u00fcr CityDoctor wird in YAML angegeben.</p> <p>F\u00fcr die Version 3.12.x sieht ein Beispiel so aus:</p> <pre><code>globalParameters:\n numberOfRoundingPlaces: 8\n # in m\n minVertexDistance: 0.0001\n schematronPath: 'checkForSolid.xml'\nuseStreaming: true # (1)!\nrequirements:\n R_GE_R_TOO_FEW_POINTS:\n enabled: true\n R_GE_R_NOT_CLOSED:\n enabled: true\n R_GE_R_CONSECUTIVE_POINTS_SAME:\n enabled: true\n R_GE_R_SELF_INTERSECTION:\n enabled: true\n R_GE_S_MULTIPLE_CONNECTED_COMPONENTS:\n enabled: true\n R_GE_P_INTERIOR_DISCONNECTED:\n enabled: true\n R_GE_P_INTERSECTING_RINGS:\n enabled: true\n R_GE_P_NON_PLANAR:\n enabled: true\n parameters:\n # one of (\"distance\", \"angle\", \"both\")\n type: distance\n # in m\n distanceTolerance: 0.01\n # in degree\n angleTolerance: 1\n R_GE_P_HOLE_OUTSIDE:\n enabled: true\n R_GE_P_ORIENTATION_RINGS_SAME:\n enabled: true\n R_GE_P_INNER_RINGS_NESTED:\n enabled: true\n R_GE_S_TOO_FEW_POLYGONS:\n enabled: true\n R_GE_S_NOT_CLOSED:\n enabled: true\n R_GE_S_NON_MANIFOLD_EDGE:\n enabled: true\n R_GE_S_POLYGON_WRONG_ORIENTATION:\n enabled: true\n R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION:\n enabled: true\n R_GE_S_NON_MANIFOLD_VERTEX:\n enabled: true\n R_GE_S_SELF_INTERSECTION:\n enabled: true\n R_SE_BS_IS_WALL:\n enabled: false\n parameters:\n lowerAngle: '45'\n upperAngle: '135'\n R_SE_BS_IS_FLOOR:\n enabled: false\n R_SE_BS_GROUND_UNFRAGMENTED:\n enabled: false\n R_SE_BS_IS_GROUND:\n enabled: false\n R_SE_BS_IS_CEILING:\n enabled: false\n</code></pre> <ol> <li>Der Parameter <code>useStreaming</code> 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.</li> </ol> <p>In dem Validierungsplan finden sich die selben Einstellungen wieder, die in der grafischen Oberfl\u00e4che auch aufgelistet sind.</p> <p>Unter requirements sind alle Anforderungen gelistet die gepr\u00fcft werden sollen. Dabei sind die semantischen Pr\u00fcfungen standardm\u00e4\u00dfig deaktiviert. </p>"}]}
\ No newline at end of file
{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"CityDoctor2","text":"<p> Development of a automatic repair system for virtual city models </p> <p>CityDoctor2 is a quality check software for 3D city models in CityGML format. CityDoctor can read CityGML 1/2 documents and since version 3.12 can also read CityGML 3 with restrictions. All check results can be output in xml or pdf form. Additionally CityDoctor implements the QualityADE to save test results directly into CityGML.</p> <p></p>"},{"location":"#licence-versions","title":"Licence / Versions","text":""},{"location":"#citydoctorvalidation","title":"CityDoctorValidation","text":"<p>The validation part of CityDoctor is freely available and open source</p>"},{"location":"#citydoctorgui","title":"CityDoctorGUI","text":"<p>The graphical interface is free but not open source (see Installation)</p>"},{"location":"#citydoctorhealer","title":"CityDoctorHealer","text":"<p>The part responsible for the repair can be obtained only in consultation with us. Mail to: </p>"},{"location":"#projekt","title":"Projekt","text":"<p>Project duration: 01.11.2018 - 31.12.2021</p>"},{"location":"#partner","title":"Partner","text":"<p>Project responsible: Prof. Dr. Margitta Pries</p> <p>Collaboration partner: Prof. Dr.-Ing. Volker Coors</p> <p>Cooperation partner: 3DIS GmbH 3dpartzz GmbH con terra GmbH Geoplex GIS GmbH Mark Wewetzer M.O.S.S. Computer Grafik Systeme GmbH Steinbeis - Transferzentrum Virtual City Systems</p> <p>Associative partner: Landesamt f\u00fcr Geoinformation und Landentwicklung Baden-W\u00fcrttemberg </p> <p>Funder: Bundesministerium f\u00fcr Bildung und Forschung </p> <p>Project sponsor: VDI Technologiezentrum </p> <p></p>"},{"location":"R_GE_MS/","title":"R_GE_MS","text":"<p>see https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_MS_0001</p>"},{"location":"R_GE_P_HOLE_OUTSIDE/","title":"R_GE_P_HOLE_OUTSIDE","text":"<p>see https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_PO_0004</p>"},{"location":"R_GE_P_INNER_RINGS_NESTED/","title":"R_GE_P_INNER_RINGS_NESTED","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_PO_0005</p>"},{"location":"R_GE_P_INTERIOR_DISCONNECTED/","title":"R_GE_P_INTERIOR_DISCONNECTED","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_PO_0003 </p>"},{"location":"R_GE_P_INTERSECTING_RINGS/","title":"R_GE_P_INTERSECTING_RINGS","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_PO_0001</p>"},{"location":"R_GE_P_NON_PLANAR/","title":"R_GE_P_NON_PLANAR","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_PO_0002 </p>"},{"location":"R_GE_P_ORIENTATION_RINGS_SAME/","title":"R_GE_P_ORIENTATION_RINGS_SAME","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_PO_0006 </p>"},{"location":"R_GE_R_COLLAPSED_TO_LINE/","title":"R_GE_R_COLLAPSED_TO_LINE","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_LR_0005</p>"},{"location":"R_GE_R_CONSECUTIVE_POINTS_SAME/","title":"R_GE_R_CONSECUTIVE_POINTS_SAME","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_LR_0002</p>"},{"location":"R_GE_R_NOT_CLOSED/","title":"R_GE_R_NOT_CLOSED","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_LR_0003</p>"},{"location":"R_GE_R_SELF_INTERSECTION/","title":"R_GE_R_SELF_INTERSECTION","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_LR_0004</p>"},{"location":"R_GE_R_TOO_FEW_POINTS/","title":"R_GE_R_TOO_FEW_POINTS","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_LR_0001</p>"},{"location":"R_GE_SO/","title":"R_GE_SO","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0009</p>"},{"location":"R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION/","title":"R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0008</p>"},{"location":"R_GE_S_MULTIPLE_CONNECTED_COMPONENTS/","title":"R_GE_S_MULTIPLE_CONNECTED_COMPONENTS","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0005</p>"},{"location":"R_GE_S_NON_MANIFOLD_EDGE/","title":"R_GE_S_NON_MANIFOLD_EDGE","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0004</p>"},{"location":"R_GE_S_NON_MANIFOLD_VERTEX/","title":"R_GE_S_NON_MANIFOLD_VERTEX","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0003</p>"},{"location":"R_GE_S_NOT_CLOSED/","title":"R_GE_S_NOT_CLOSED","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0002</p>"},{"location":"R_GE_S_POLYGON_WRONG_ORIENTATION/","title":"R_GE_S_POLYGON_WRONG_ORIENTATION","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0007</p>"},{"location":"R_GE_S_SELF_INTERSECTION/","title":"R_GE_S_SELF_INTERSECTION","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0006</p>"},{"location":"R_GE_S_TOO_FEW_POLYGONS/","title":"R_GE_S_TOO_FEW_POLYGONS","text":"<p>siehe https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0001</p>"},{"location":"basic/","title":"Validation of 3D city models encoded in CityGML","text":""},{"location":"basic/#terms-and-definitions","title":"Terms and definitions","text":"<p>as defined in CityGML Quality Interoperability Experiment, chapter 3</p> <p>Validation</p> <p>Process of validating a CityGML data set against a specified set of requirements. A valid data set is conformant to these requirements.</p> <p>Requirements</p> <p>Rules and restrictions to define data structure and content unambiguously. Requirements can be derived from the CityGML Standard document or be defined separately as refinement of the CityGML standard to avoid ambiguities of the standard and/or specify further requirements (user/application dependent).</p> <p>Check</p> <p>Algorithmic implementation to check if a requirement is met in a validation software. </p> <p>Error</p> <p>Result of a check in case of non-conformance.</p> <p>Validation plan</p> <p>Structured list of requirements, usually depending on use case.</p>"},{"location":"basic/#additional-defintions","title":"Additional defintions","text":"<p>XSD valid</p> <p>A CityGML is conform to the schema or XSD valid if it validates against the CityGML XML schema.</p>"},{"location":"firstRun/","title":"First run","text":""},{"location":"firstRun/#start","title":"Start","text":"<p>After extracting the zip file the file structure should be similar to the example image, depending on the version (GUI or batch). </p> <p>To start CityDoctor the start.bat or start.sh should be used. It is possible to use the command in your own start scripts as needed.</p> <p>The .bat/.sh file only contains the following command (example for windows and the GUI version):</p> <pre><code>java -classpath app/*;plugins/* de.hft.stuttgart.citydoctor2.gui.CityDoctorGUIStarter\n</code></pre> <p>Note</p> <p>The exact command has changed over the development history of CityDoctor.</p> <p>For the batch version the command is similar and can be adapted for other operating systems.</p> <p>Note</p> <p>The command can also be used for Linux and Mac but the \";\" has to be replaced by \":\".</p>"},{"location":"geometric/","title":"Geometry Requirements","text":""},{"location":"geometric/#error-codes-for-geometric-errors","title":"Error codes for geometric errors","text":"<p>as defined in the CityGML Quality Interoperability Experiment, chapter 7.5.</p> <p>Note</p> <p>The requirements were renamed in CityDoctor to be more human readable. The were renamed according to the error codes.</p> <p>All the geometric errors are in the \"GE\" domain. Also, since the geometric validation is performed at 3 different levels (based on the primitives), the requirements also contain the level:</p> <ul> <li>Ring: R</li> <li>Polygon: P</li> <li>Shell: S</li> </ul> <p>Error codes follow the same system as the requirements mentioned fundamentals. A violation of each respective data quality requirement should result in an error which must be reported with an error code according to the requirement ID. For each error code, extra information can (and should) be returned. For instance: if a ring is not closed (GE_R_NOT_CLOSED) then the ID of the ring (e.g., its position (first, second..) in the polygon) should be returned; if a polygon is not planar (GE_P_NON_PLANAR_POLYGON_DISTANCE_PLANE) then the ID of the polygon and the max. deviation from the reference plane should be returned; or if a shell is not 'watertight' (GE_S_NOT_CLOSED) then the location of the hole(s) should be returned.</p>"},{"location":"geometric/#vertex-requirement","title":"Vertex Requirement","text":"<p>Vertices A and B are the same if the euclidean distance between them is smaller than (minVertexDistance). It is also used to check whether a point is touching an edge. If a point is within minVertexDistance distance to an edge it is considered touching. This parameter is used in multiple checks with the same value:</p> <ul> <li>R_GE_R_CONSECUTIVE_POINTS_SAME</li> <li>R_GE_R_NOT_CLOSED</li> <li>R_GE_R_SELF_INTERSECTION</li> <li>R_GE_P_INTERIOR_DISCONNECTED</li> </ul> <p>The following requirements are defined for the three respective geometric levels (adopted from Ledoux (2013)):</p>"},{"location":"geometric/#linear-ring","title":"Linear Ring","text":"Requirement ID Description Error code Known checks R_GE_R_TOO_FEW_POINTS too few points GE_R_TOO_FEW_POINTS C_GE_R_TOO_FEW_POINTS R_GE_R_CONSECUTIVE_POINTS_SAME 2 consecutive points are the same GE_R_CONCECUTIVE_POINTS_SAME C_GE_R_CONCECUTIVE_POINTS_SAME, C_GE_R_DUPLICATE_POINT R_GE_R_NOT_CLOSED first-last points are not the same GE_R_NOT_CLOSED C_GE_R_NOT_CLOSED R_GE_R_SELF_INTERSECTION self-intersects, i.e., a bowtie GE_R_SELF_INTERSECTION C_GE_R_SELF_INTERSECTION, C_GE_R_DUPLICATE_POINT R_GE_R_COLLAPSED_TO_LINE Currently not in use as it is redundant with R_GE_R_SELF_INTERSECTION is point or line GE_R_COLLAPSED_TO_LINE C_GE_R_COLLAPSED_TO_LINE R_GE_R_ALL Container for: 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":"Requirement ID Description Error code Known checks R_GE_P_INTERSECTING_RINGS 2+ rings intersect GE_P_INTERSECTING_RINGS C_GE_P_INTERSECTING_RINGS R_GE_P_NON_PLANAR Non planar polygon, both distance and normal deviation GE_P_NON_PLANAR_POLYGON_DISTANCE_PLANE, GE_P_NON_PLANAR_POLYGON_NORMALS_DEVIATION C_GE_P_NON_PLANAR R_GE_P_INTERIOR_DISCONNECTED interior is not connected GE_P_INTERIOR_DISCONNECTED C_GE_P_INTERIOR_DISCONNECTED R_GE_P_HOLE_OUTSIDE 1 or more interior rings are located outside the exterior ring GE_P_HOLE_OUTSIDE C_GE_P_HOLE_OUTSIDE R_GE_P_INNER_RINGS_NESTED interior ring is located inside other GE_P_INNER_RINGS_NESTED C_GE_P_INNER_RINGS_NESTED R_GE_P_ORIENTATION_RINGS_SAME exterior and interior rings have same orientation GE_P_ORIENTATION_RINGS_SAME C_GE_P_ORIENTATION_RINGS_SAME R_GE_P_ALL Container for: 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-shell","title":"Solid / Shell","text":"Requirement ID Description Error code Known checks R_GE_S_TOO_FEW_POLYGONS <4 polygons GE_S_TOO_FEW_POLYGONS C_GE_S_TOO_FEW_POLYGONS R_GE_S_NOT_CLOSED there is 1+ hole(s) on the surface GE_S_NOT_CLOSED C_GE_S_NOT_CLOSED R_GE_S_NON_MANIFOLD_VERTEX Each shell must be simple GE_S_NON_MANIFOLD_VERTEX C_GE_S_NON_MANIFOLD_VERTEX R_GE_S_NON_MANIFOLD_EDGE Each edge of a shell should have exactly 2 incident polygons. GE_S_NON_MANIFOLD_EDGE C_GE_S_NON_MANIFOLD_EDGE R_GE_S_MULTIPLE_CONNECTED_COMPONENTS 1+ polygons not connected to main shell GE_S_MULTIPLE_CONNECTED_COMPONENTS C_GE_S_MULTIPLE_CONNECTED_COMPONENTS R_GE_S_SELF_INTERSECTION Solid self intersects GE_S_SELF_INTERSECTION C_GE_S_SELF_INTERSECTION R_GE_S_POLYGON_WRONG_ORIENTATION orientation of a polygon not correct GE_S_POLYGON_WRONG_ORIENTATION C_GE_S_POLYGON_WRONG_ORIENTATION R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION normals all pointing in wrong direction GE_S_ALL_POLYGONS_WRONG_ORIENTATION C_GE_S_ALL_POLYGONS_WRONG_ORIENTATION R_GE_S_ALL Container for: 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 Description Used in Unit minVertexDistance The minimum distance between two points before they are considered the same point R_GE_R_CONSECUTIVE_POINTS_SAME, R_GE_R_NOT_CLOSED, R_GE_R_SELF_INTERSECTION, R_GE_P_INTERIOR_DISCONNECTED Meter type Planar check type, can be distance, angle, both sein R_GE_P_NON_PLANAR - distanceTolerance Distance from the regression plane before a point is considered not in plane R_GE_P_NON_PLANAR Meter angleTolerance Difference in normal vectors before a plane is not considered planar R_GE_P_NON_PLANAR Radiant"},{"location":"geometric/#abhangigkeitsbaum","title":"Abh\u00e4ngigkeitsbaum","text":"<p>This is the order the checks will be executed. If one of the depending checks is not executed or has reported an error the following check will not be executed.</p> <pre><code>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; \n</code></pre>"},{"location":"geometric/#multisurface-und-solid-geometrie","title":"Multisurface und Solid Geometrie","text":"<p>In order to simplify the definition of a validation plan, two requirement will be introduced in addition to the CityGML QIE: valid MultiSurface and valid Solid geometry. These requirements are just a collection of the linear ring, polygon and shell requirements. No extra check is required.</p> Requirement ID Description Dependencies Error code Known checks R_GE_MS valid multisurface geometry R_SC-SCHEMA-VALIDATION, R_GE_P_ALL -- -- R_GE_SO valid solid geometry R_SC-SCHEMA-VALIDATION, R_GE_S_ALL -- --"},{"location":"requiredSoftware/","title":"Required Software","text":""},{"location":"requiredSoftware/#versions-from-3130","title":"Versions from 3.13.0","text":"<p>Starting with version 3.13.0, a repository was created on the university's transfer portal, which will henceforth be used as a repository for finished releases: https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctorreleases</p> <p>The versions are divided there between CityDoctorValidation and CityDoctorGUI and under these folders there are the corresponding version folders.</p>"},{"location":"requiredSoftware/#release-versions","title":"Release Versions","text":"<p>For each CityDoctor variant (CityDoctorValidation or CityDoctorGUI) four different versions are provided for download. Java runtimes of the Liberica distribution are included in different versions. </p> Version Description CityDoctor*-no-runtime.zip This version does not include a runtime for Java. If you already have a Java version 17 installed on your PC use this. See Java CityDoctor*-win.zip Includes a Windows Java Runtime to run CityDoctor, no Java needs to be installed. CityDoctor*-lin.zip Includes a Linux Java Runtime to run CityDoctor CityDoctor*-mac.zip Includes a Mac Java Runtime to run CityDoctor"},{"location":"requiredSoftware/#versions-until-312x","title":"Versions until 3.12.x","text":"<p>CityDoctor can be downloaded from various sites. The most recent place is a gitlab repository. Alternatively, releases are also listed on the CityDoctor homepage of the BHT. There are always two versions:</p> <ul> <li>CityDoctorGUI-3.x.x.zip: This is the graphical interface including the checks. Suitable for the end user on a desktop PC.</li> <li>CityDoctorValidation-3.x.x.zip: This is the batch version suitable for integration into servers or other existing systems and has no graphical interface but works file-based as a process.</li> </ul> <p>Note</p> <p>There are sometimes special versions that have been created for testing different delivery options. Example: CityDoctorGUI-x.x.x-win.zip contains the JavaFX libraries so that a Java environment without JavaFX can also be used.</p>"},{"location":"requiredSoftware/#java","title":"Java","text":"<p>Before CityDoctor version 3.12.x Java 8 is required either as JDK or as JRE. From version 3.12.x Java 17 is required.</p> <p>Warning</p> <p>It is important that the installed Java version includes the JavaFX libraries. These are needed for the graphical user interface.</p> <p>The Liberica JRE oder JDK has proven itself for use with CityDoctor.</p> <p>Note</p> <p>The Liberica distribution is 100% free and open source.</p> <p>Note</p> <p>For the development with CityDoctor a JDK is required.</p>"},{"location":"requirements/","title":"Anforderungen und Pr\u00fcfungen f\u00fcr die Validierung von CityGML-Modellen","text":"<p>The requirements are the basic building blocks for a validation plan to validate CityGML models. For naming conventions and definitions, see fundamentals. </p> <p>A requirement can be validated by one or more checks. A check validates one or more requirements on a model. Each check can have preconditions. If these preconditions are not met, the check is not executed. A distinction is made between:</p> <ul> <li>Schema Requirements</li> <li>Geometry Requirements</li> <li>Semantic Requirements</li> </ul>"},{"location":"schemaRequirements/","title":"Schema Requirements","text":""},{"location":"schemaRequirements/#r_sc_schema_validation","title":"R_SC_SCHEMA_VALIDATION","text":""},{"location":"schemaRequirements/#anforderung","title":"Anforderung","text":"ID R_SC_SCHEMA_VALIDATION Description A basic requirement is that each CityGML document must be well defined and XSD valid. Error code SC-SCHEMA-NOT-VALID"},{"location":"schemaRequirements/#prufung","title":"Pr\u00fcfung","text":"ID SC_SCHEMA_VALIDATION Anforderungs ID R_SC_SCHEMA_VALIDATION Requirements none Description Tools to perform XSD validation are available and give reliable results Error code SC_SCHEMA_NOT_VALID"},{"location":"semantic/","title":"Semantic Requirements","text":"<p>The semantic requirements are mostly attribute based. This results in 3 error states for an attribute:</p> <ul> <li>SE_ATTRIBUTE_WRONG_VALUE: If an attribute has a wrong value.</li> <li>SE_ATTRIBUTE_MISSING: If an attribute is missing but should be present.</li> <li>SE_ATTRIBUTE_INVALID: If an attribute is present but forbidden.</li> </ul>"},{"location":"semantic/#schematron","title":"Schematron","text":"<p>In CityDoctor wurde das XML Validierungssystem Schematron integriert um flexibel Attributpr\u00fcfungen anzupassen und zu unterst\u00fctzen. </p> <p>Hier ist ein Beispiel f\u00fcr eine Schematron Datei die CityDoctor integrieren kann:</p>"},{"location":"semantic/#citydoctor-3130","title":"CityDoctor >= 3.13.0","text":"<pre><code><?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\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</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</assert>\n </rule>\n </pattern>\n</schema> \n\n</code></pre>"},{"location":"semantic/#citydoctor-3130_1","title":"CityDoctor < 3.13.0","text":"<pre><code><?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\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> \n</code></pre> <p>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.</p>"},{"location":"semantic/#fehlerformat","title":"Fehlerformat","text":"<p>Das Fehlerformat ist ein CSV-Format mit || als Trennzeichen</p> <pre><code>parent id||child id||error code||error type||is generic attribute\n</code></pre> <p>Die Fehlermeldung besteht aus den folgenden Teilen:</p> <ul> <li>Die <code>parent id</code> ist die gml id des obersten Elements z.B. Building oder Bridge. </li> <li>Falls der Fehler in einem Unterelement aufgetreten ist so kann diese ID in dem Feld f\u00fcr die <code>child id</code> eingetragen werden.</li> <li>Im Feld <code>error type</code> ist einer der 3 Fehlertypen einzutragen: <code>SE_ATTRIBUTE_WRONG_VALUE, SE_ATTRIBUTE_MISSING, SE_ATTRIBUTE_INVALID</code>.</li> </ul> <p>note Nur in CityDoctor < 3.13.0: * Um ein generisches Attribut mit dem Namen <code>measuredHeight</code> von dem nicht generischen Attribut zu unterscheiden ist im letzten Feld vorgesehen <code>true</code> einzutragen wenn es sich um ein generisches Attribut handelt ansonsten <code>false</code>. </p>"},{"location":"userInterface/","title":"User interface","text":""},{"location":"userInterface/#citydoctor","title":"CityDoctor","text":"<p>In the upper bar the following buttons are in order:</p> <ul> <li>Load: Opens the dialog for loading a CityGML file</li> <li>Validation: Opens the dialog to check a loaded CityGML</li> <li>Validation results: Opens the dialog for writing a test protocol in xml or pdf form</li> <li>Grid: Shows/hides the grid instead of filled polygons</li> <li>Backsides: Shows/hides backs of polygons</li> <li>Global View: Loads all elements of a CityGML into the view</li> <li>LODs: Turns individual LODs on or off from the view</li> <li>Save: Saves a CityGML file back, if the file was checked the QualityADE is written too.</li> <li>About: Opens the dialog with information about the project CityDoctor2</li> <li>View: Switches different views. There is only one for the validation part.</li> <li>Language: Here you can set the language (German/English)</li> </ul> <p>Warning</p> <p>Displaying the Global View can cause crashes with large CityGML files (> 100mb depending on the system). The display may take a short time.</p>"},{"location":"userInterface/#load","title":"Load","text":"<p>The Load button opens the dialog for loading a CityGML file.</p> <p></p> <p>In the file bar a file path can be entered or selected via the Select button.</p> <p>In addition, other settings for reading the file can be specified.</p> <ul> <li>NumberOfRoundingPlaces: To how many decimal places are the read-in values rounded?</li> <li>XML-Validierung: Performs an XML validation. Errors are detected directly during the import and the import is aborted.</li> <li>Low Memory Consumption Mode : Saves RAM to allow larger files in the GUI. Slight performance costs during the validation process.</li> </ul> <p>When loading, the progress is approximately represented by the loading bar.</p> <p>Note</p> <p>Files can also be dragged and dropped directly from the file manager into the GUI without using the load dialog. The default values are assumed (8 decimal places, no XML validation).</p> <p>After loading a CityGML file, the elements are displayed in the individual tabs. Selecting an element will display it in the view.</p> <p></p> <p>Note</p> <p>By selecting the top element of a tab, all elements within this tab are displayed. As the above warning states, larger amounts of data will cause crashes.</p>"},{"location":"userInterface/#validation","title":"Validation","text":"<p>The validation plan can be customized in the check dialog. In addition to the available checks, the global parameters are also displayed here.</p> <p>The parameters can be changed with a double click in the value column. The unit is fixed.</p> <p>Note</p> <p>The numberOfRoundingPlaces parameter cannot be changed. It was set when the file was loaded.</p> <p>If checks should not be executed, they can be deactivated in the Active column.</p> <p>Warning</p> <p>If checks are disabled but other active checks need them as dependencies, they will be re-enabled during the check to ensure stability. See Requirements.</p> <p>In the Schematron file field, a path to a Schematron file can be entered. In this file flexible rules for the semantic requirements can be defined. See Semantic Requirements</p> <p>The test plan can be saved and loaded via the two buttons at the top right.</p> <p>After the check, elements with errors are colored red and elements without errors are colored green. When selecting an element that contains errors, the errors are displayed in the lower tab Errors. There you can select the error to display it in CityDoctor and get more information.</p> <p></p> <p>The elements can be filtered with the dropdown menu to show only faulty elements.</p>"},{"location":"userInterface/#validation-reports","title":"Validation reports","text":"<p>In this dialog there is again an overview of the errors in image form and the possibility to write an xml or pdf report.</p> <p></p>"},{"location":"validationPlan/","title":"Validation Plan","text":"<p>the validation plan for CityDoctor is specified in YAML.</p> <p>For version 3.12.x and later, an example looks like this:</p> <pre><code>globalParameters:\n numberOfRoundingPlaces: 8\n # in m\n minVertexDistance: 0.0001\n schematronPath: 'checkForSolid.xml'\nuseStreaming: true # (1)!\nrequirements:\n R_GE_R_TOO_FEW_POINTS:\n enabled: true\n R_GE_R_NOT_CLOSED:\n enabled: true\n R_GE_R_CONSECUTIVE_POINTS_SAME:\n enabled: true\n R_GE_R_SELF_INTERSECTION:\n enabled: true\n R_GE_S_MULTIPLE_CONNECTED_COMPONENTS:\n enabled: true\n R_GE_P_INTERIOR_DISCONNECTED:\n enabled: true\n R_GE_P_INTERSECTING_RINGS:\n enabled: true\n R_GE_P_NON_PLANAR:\n enabled: true\n parameters:\n # one of (\"distance\", \"angle\", \"both\")\n type: distance\n # in m\n distanceTolerance: 0.01\n # in degree\n angleTolerance: 1\n R_GE_P_HOLE_OUTSIDE:\n enabled: true\n R_GE_P_ORIENTATION_RINGS_SAME:\n enabled: true\n R_GE_P_INNER_RINGS_NESTED:\n enabled: true\n R_GE_S_TOO_FEW_POLYGONS:\n enabled: true\n R_GE_S_NOT_CLOSED:\n enabled: true\n R_GE_S_NON_MANIFOLD_EDGE:\n enabled: true\n R_GE_S_POLYGON_WRONG_ORIENTATION:\n enabled: true\n R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION:\n enabled: true\n R_GE_S_NON_MANIFOLD_VERTEX:\n enabled: true\n R_GE_S_SELF_INTERSECTION:\n enabled: true\n R_SE_BS_IS_WALL:\n enabled: false\n parameters:\n lowerAngle: '45'\n upperAngle: '135'\n R_SE_BS_IS_FLOOR:\n enabled: false\n R_SE_BS_GROUND_UNFRAGMENTED:\n enabled: false\n R_SE_BS_IS_GROUND:\n enabled: false\n R_SE_BS_IS_CEILING:\n enabled: false\n</code></pre> <ol> <li>The parameter <code>useStreaming</code> is a switch to read a file piece by piece instead of reading the complete file before the check takes place. With this setting also files > 2GB can be checked without large RAM requirements.</li> </ol> <p>In the validation plan you will find the same settings that are listed in the graphical user interface.</p> <p>All requirements that are to be checked are listed under requirements. The semantic checks are deactivated by default. </p>"}]}
<p>The semantic requirements are mostly attribute based. This results in 3 error states for an attribute:</p>
<ul>
<li><strong>SE_ATTRIBUTE_WRONG_VALUE:</strong>Wenn ein Attribut ein falschen Wert hat.</li>
<li><strong>SE_ATTRIBUTE_MISSING:</strong>Wenn ein Attribut fehlt, aber vorhanden sein sollte.</li>
<li><strong>SE_ATTRIBUTE_INVALID:</strong>Wenn ein Attribut vorhanden ist aber verboten ist.</li>
<li><strong>SE_ATTRIBUTE_WRONG_VALUE:</strong>If an attribute has a wrong value.</li>
<li><strong>SE_ATTRIBUTE_MISSING:</strong>If an attribute is missing but should be present.</li>
<li><strong>SE_ATTRIBUTE_INVALID:</strong>If an attribute is present but forbidden.</li>
</ul>
<divclass="admonition warning">
<pclass="admonition-title">Warning</p>
<p><strong>SE_ATTRIBUTE_INVALID:</strong> ist noch nicht in CityDoctor und der QualityADE umgesetzt ist aber geplant in einer neuen Version zu unterstützen.</p>
<p>In CityDoctor wurde das <ahref="https://de.wikipedia.org/wiki/Schematron">XML Validierungssystem Schematron</a> integriert um flexibel Attributprüfungen anzupassen und zu unterstützen. </p>
<p>Hier ist ein Beispiel für eine Schematron Datei die CityDoctor integrieren kann:</p>
<p>In der oberen Leiste sind folgende Schaltflächen in Reihenfolge:</p>
<p>In the upper bar the following buttons are in order:</p>
<ul>
<li><strong>Laden:</strong>Öffnet den Dialog zum laden einer CityGML Datei</li>
<li><strong>Prüfen:</strong>Öffnet den Dialog zum prüfen einer geladenen CityGML</li>
<li><strong>Prüfberichte:</strong> Öffnet den Dialog zum schreiben eines Prüfprotokolls in xml oder pdf Form</li>
<li><strong>Gitternetz:</strong>Zeigt/Versteckt das Gitternetz anstatt gefüllter Polygone</li>
<li><strong>Rückseiten:</strong>Zeigt/Versteckt Rückseiten von Polygonen</li>
<li><strong>Globale Ansicht:</strong> Lädt alle Elemente einer CityGML in die Ansicht</li>
<li><strong>LODs:</strong>Schaltet einzelne LODs von der Ansicht an oder aus</li>
<li><strong>Speichern:</strong> Speichert eine CityGML Datei zurück, falls die Datei geprüft wurde wird die QualityADE mitgeschrieben.</li>
<li><strong>About:</strong>Öffnet den Dialog mit Informationen zu dem Projekt CityDoctor2</li>
<li><strong>Ansichten:</strong>Wechselt verschiedene Ansichten. Für die Prüfung gibt es nur eine.</li>
<li><strong>Sprache:</strong> Hier kann die Sprache eingestellt werden (Deutsch/Englisch)</li>
<li><strong>Load:</strong>Opens the dialog for loading a CityGML file</li>
<li><strong>Validation:</strong>Opens the dialog to check a loaded CityGML</li>
<li><strong>Validation results:</strong> Opens the dialog for writing a test protocol in xml or pdf form</li>
<li><strong>Grid:</strong>Shows/hides the grid instead of filled polygons</li>
<li><strong>Backsides:</strong>Shows/hides backs of polygons</li>
<li><strong>Global View:</strong> Loads allelements of a CityGML into the view</li>
<li><strong>LODs:</strong>Turns individual LODs on or off from the view</li>
<li><strong>Save:</strong> Saves a CityGML file back, if the file was checked the QualityADE is written too.</li>
<li><strong>About:</strong>Opens the dialog with information about the project CityDoctor2</li>
<li><strong>View:</strong>Switches different views. There is only one for the validation part.</li>
<li><strong>Language:</strong> Here you can set the language (German/English)</li>
</ul>
<divclass="admonition warning">
<pclass="admonition-title">Warning</p>
<p>Das Anzeigen der Globalen Ansicht kann bei großen CityGML Dateien (> 100mb je nach System) zu abstürzen führen. Das Anzeigen kann kurz dauern.</p>
<p>Displaying the Global View can cause crashes with large CityGML files (> 100mb depending on the system). The display may take a short time.</p>
<p>The Load button opens the dialog for loading a CityGML file.</p>
<p><imgalt="open"src="../img/open.png"/></p>
<p>In der Datei Leiste kann ein Dateipfad eingetragen werden oder über die Schaltfläche <strong>Auswählen</strong>ausgewählt werden.</p>
<p>Außerdem können weitere Einstellungen für das Lesen der Datei angegeben werden.</p>
<p>In the file bar a file path can be entered or selected via the <strong>Select</strong>button.</p>
<p>In addition, other settings for reading the file can be specified.</p>
<ul>
<li><strong>NumberOfRoundingPlaces:</strong>Auf wie viele Nachkommastellen werden die eingelesenen Werte gerundet.</li>
<li><strong>XML-Validierung:</strong>Führt eine XML Validierung durch. Fehler werden dabei direkt beim einlesen festgestellt und das Einlesen wird abgebrochen.</li>
<li><strong>Speicherverbrauch:</strong> Spart RAM um größere Dateien in der GUI zu ermöglichen. Kostet geringfügig Performance bei der Prüfung.</li>
<li><strong>NumberOfRoundingPlaces:</strong>To how many decimal places are the read-in values rounded?</li>
<li><strong>XML-Validierung:</strong>Performs an XML validation. Errors are detected directly during the import and the import is aborted.</li>
<li><strong>Low Memory Consumption Mode :</strong> Saves RAM to allow larger files in the GUI. Slight performance costs during the validation process.</li>
</ul>
<p>Beim Laden wird der Fortschritt ungefähr durch den Ladebalken repräsentiert.</p>
<p>When loading, the progress is approximately represented by the loading bar.</p>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>Dateien können 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)</p>
<p>Files can also be dragged and dropped directly from the file manager into the GUI without using the load dialog. The default values are assumed (8 decimal places, no XML validation).</p>
</div>
<p>Nach dem Laden einer CityGML Datei werden die Elemente in den einzelnen Tabs angezeigt. Durch auswählen eines Elements wird das in der Ansicht angezeigt.</p>
<p>After loading a CityGML file, the elements are displayed in the individual tabs. Selecting an element will display it in the view.</p>
<p>Durch Auswählen des obersten Elements eines Reiters werden alle Elemente innerhalb diese Reiters angezeigt. Wie obige Warnung schon besagt, gilt auch hier, dass größere Datenmengen zu Abstürzen führen.</p>
<p>By selecting the top element of a tab, allelements within this tab are displayed. As the above warning states, larger amounts of data will cause crashes.</p>
<p>Im Prüfdialog kann der Validierungsplan angepasst werden. Hier werden neben den Verfügbaren Prüfungen auch die globalen Parameter angezeigt.</p>
<p>Verändert können die Parameter mit einem Doppelklick in die Wert Spalte. Die Einheit ist dabei fest.</p>
<p>The validation plan can be customized in the check dialog. In addition to the available checks, the global parameters are also displayed here.</p>
<p>The parameters can be changed with a double click in the value column. The unit is fixed.</p>
<divclass="admonition note">
<pclass="admonition-title">Note</p>
<p>Der Parameter numberOfRoundingPlaces kann nicht verändert werden. Er wurde beim Laden der Datei festgelegt.</p>
<p>The numberOfRoundingPlaces parameter cannot be changed. It was set when the file was loaded.</p>
</div>
<p>Falls Prüfungen nicht ausgeführt werden sollen können sie in der Spalte Aktiv deaktiviert werden.</p>
<p>If checks should not be executed, they can be deactivated in the Active column.</p>
<divclass="admonition warning">
<pclass="admonition-title">Warning</p>
<p>Wenn Prüfungen deaktiviert wurden die andere aktiven Prüfungen aber als Abhängigkeit benötigen werden sie bei der Prüfung wieder aktiviert um die Stabilität zu gewährleisten. Siehe <ahref="../requirements/">Anforderungen</a>.</p>
<p>If checks are disabled but other active checks need them as dependencies, they will be re-enabled during the check to ensure stability. See <ahref="../requirements/">Requirements</a>.</p>
</div>
<p>In dem Feld Schematron Datei kann ein Pfad zu einer Schematron Datei eingetragen werden. In dieser Datei können flexible Regeln für die semantischen Anforderungen festgelegt werden. Siehe <ahref="../semantic/">Semantische Prüfungen</a></p>
<p>Über die beiden Schaltflächen oben rechts kann der Prüfplan gespeichert und geladen werden.</p>
<p>Nach der Prüfung werden fehlerhafte Elemente rot und fehlerfreie Elemente grün eingefärbt. Bei der Auswahl eines Elements das fehler beinhaltet werden die Fehler in dem unteren Tab <strong>Fehler</strong> angezeigt. Dort kann der Fehler ausgewählt werden um ihn in CityDoctor anzuzeigen und weitere Informationen zu erhalten.</p>
<p>In the Schematron file field, a path to a Schematron file can be entered. In this file flexible rules for the semantic requirements can be defined. See <ahref="../semantic/">Semantic Requirements</a></p>
<p>The test plan can be saved and loaded via the two buttons at the top right.</p>
<p>After the check, elements with errors are colored red and elements without errors are colored green. When selecting an element that contains errors, the errors are displayed in the lower tab <strong>Errors</strong>. There you can select the error to display it in CityDoctor and get more information.</p>
<li>Der Parameter <code>useStreaming</code> ist ein Schalter um eine Datei Stück für Stück einzulesen anstelle erst die komplette Datei zu lesen bevor die Prüfung stattfindet. Mit dieser Einstellung können auch Dateien > 2GB ohne große RAM Anforderungen geprüft werden.</li>
<li>The parameter <code>useStreaming</code> is a switch to read a file piece by piece instead of reading the complete file before the check takes place. With this setting also files > 2GB can be checked without large RAM requirements.</li>
</ol>
<p>In dem Validierungsplan finden sich die selben Einstellungen wieder, die in der grafischen Oberfläche auch aufgelistet sind.</p>
<p>Unter requirements sind alle Anforderungen gelistet die geprüft werden sollen. Dabei sind die semantischen Prüfungen standardmäßig deaktiviert. </p>
<p>In the validation plan you will find the same settings that are listed in the graphical user interface.</p>
<p>All requirements that are to be checked are listed under requirements. The semantic checks are deactivated by default. </p>
