Commit 0a185c70 authored by Matthias Betz's avatar Matthias Betz
Browse files

completed english translation

parent be907d63
Pipeline #7628 passed with stages
in 11 seconds
# R_GE_S_NOT_CLOSED # R_GE_S_NOT_CLOSED
siehe [https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0002](https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0002) siehe [https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0002](https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0002)
\ No newline at end of file \ No newline at end of file
# R_GE_S_POLYGON_WRONG_ORIENTATION # R_GE_S_POLYGON_WRONG_ORIENTATION
siehe [https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0007](https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0007) siehe [https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0007](https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0007)
# R_GE_S_SELF_INTERSECTION # R_GE_S_SELF_INTERSECTION
siehe [https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0006](https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0006) siehe [https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0006](https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0006)
# R_GE_S_TOO_FEW_POLYGONS # R_GE_S_TOO_FEW_POLYGONS
siehe [https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0001](https://gitlab.com/volkercoors/agqual3d/-/wikis/Validierung/Anforderungen/GE_gml_SO_0001) siehe [https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0001](https://gitlab.com/volkercoors/CiD4Sim/-/wikis/validation/Requirements/GE_gml_SO_0001)
# Validierung von 3D Stadtmodellen in CityGML # Validation of 3D city models encoded in CityGML
## Begriffe und Definitionen ## Terms and definitions
nach [CityGML Quality Interoperability Experiment, chapter 3](http://mail.opengeospatial.org/lists/lt.php?id=fR4CDVYeAlJfHwhTCwA) as defined in [CityGML Quality Interoperability Experiment, chapter 3](http://mail.opengeospatial.org/lists/lt.php?id=fR4CDVYeAlJfHwhTCwA)
**Validierung** **Validation**
> Prozess des validierens einer CityGML Datei nach spezifizierten Anforderungen. Eine valide Datei entspricht allen Anforderungen. > Process of validating a CityGML data set against a specified set of requirements. A valid data set is conformant to these requirements.
**Anforderungen** **Requirements**
> 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. > 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).
**Prüfung** **Check**
> Algorithmic implementation to check if a requirement is met in a validation software.
> Algorithmische Implementation um eine Anforderung innerhalb eines Validerungsprogramms zu prüfen. **Error**
> Result of a check in case of non-conformance.
**Fehler** **Validation plan**
> Ergebnis einer Prüfung im Falle einer Nichtkonformität von Anforderungen. > Structured list of requirements, usually depending on use case.
**Validierungsplan** ### Additional defintions
> Strukturierte Liste von Anforderungen, überlicherweise angepasst an den konkreten Fall. **XSD valid**
> A CityGML is conform to the schema or XSD valid if it validates against the CityGML XML schema.
### Zusätzliche Defintionen:
**XSD valide**
> Eine CityGML Datei XSD valide wenn sie dem CityGML XML Schema entspricht.
......
# Erster Start # First run
## Start ## Start
Nach dem entpacken der Zip Datei sollte je nach Version (GUI oder Batch) eine Struktur ähnlich diesem Bild rauskommen (Beispiel CityDoctorGUI): After extracting the zip file the file structure should be similar to the example image, depending on the version (GUI or batch).
![extracted](img/extracted.png) ![extracted](img/extracted.png)
Um CityDoctor zu starten kann die start.bat verwendet werden. 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.
Die .bat Datei enthält dabei nur den Befehl: The .bat/.sh file only contains the following command (example for windows and the GUI version):
``` ```
java -classpath libs/*;plugins/*;CityDoctorGUI-3.12.0.jar de.hft.stuttgart.citydoctor2.gui.MainWindow java -classpath app/*;plugins/* de.hft.stuttgart.citydoctor2.gui.CityDoctorGUIStarter
``` ```
!!! note !!! note
Der Befehl hat sich über die Versionshistorie von CityDoctor verändert. The exact command has changed over the development history of CityDoctor.
Für die Batch Version ist der Befehl analog und kann entsprechend für andere Betriebsysteme angepasst werden. For the batch version the command is similar and can be adapted for other operating systems.
!!! note !!! note
Für Linux oder Mac kann dieser Befehl auch verwendet werden, es muss nur das ";" durch ":" ersetzt werden. Der Rest bleibt gleich. The command can also be used for Linux and Mac but the ";" has to be replaced by ":".
\ No newline at end of file
# Geometrieanforderungen # Geometry Requirements
## Fehlercodes for geometrische Fehler ## Error codes for geometric errors
Die Fehlercodes wurden übernommen aus dem [CityGML Quality Interoperability Experiment, chapter 7.5](http://mail.opengeospatial.org/lists/lt.php?id=fR4CDVYeAlJfHwhTCwA). as defined in the [CityGML Quality Interoperability Experiment, chapter 7.5](http://mail.opengeospatial.org/lists/lt.php?id=fR4CDVYeAlJfHwhTCwA).
!!! note !!! note
Die Anforderungen wurden in CityDoctor umbenannt um einen auch von Menschen zu verstehenden Begriff, analog zu den Fehlercodes, darzustellen. The requirements were renamed in CityDoctor to be more human readable. The were renamed according to the error codes.
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: 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:
* Ring: R * Ring: R
* Polygon: P * Polygon: P
* Hülle (Shell): S * Shell: S
Fehlercodes folgen dem selben Namensschema wie die Anforderungen, siehe auch [Grundbegriffe](basic.md). Jede Verletzung einer Anforderung muss in einem Fehler enden, der einen entsprechenden Fehlercode beinhaltet. Error codes follow the same system as the requirements mentioned [fundamentals](basic.md). A violation of each respective data quality requirement should result in an error which must
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). 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.
## Vertex (Punkt) Anforderungen ## Vertex Requirement
Zwei Punkte A und B sind gleich wenn die Euclidische-Distanz zwischen den beiden Punkten kleiner als eine definierte Größe ist (*minVertexDistance*). 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 *minVertexDistance*. In den folgenden Anforderungen wird die Größe verwendet: 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:
* R_GE_R_CONSECUTIVE_POINTS_SAME * R_GE_R_CONSECUTIVE_POINTS_SAME
* R_GE_R_NOT_CLOSED * R_GE_R_NOT_CLOSED
* R_GE_R_SELF_INTERSECTION * R_GE_R_SELF_INTERSECTION
* R_GE_P_INTERIOR_DISCONNECTED * R_GE_P_INTERIOR_DISCONNECTED
Die folgenden Anforderungen wurden auf den drei geometrischen Ebenen definiert [(nach Ledoux (2013))]( https://doi.org/10.1111/mice.12043): The following requirements are defined for the three respective geometric levels [(adopted from Ledoux (2013))]( https://doi.org/10.1111/mice.12043):
## Linear Ring ## Linear Ring
| Anforderungs ID | Beschreibung | Fehlercode | Bekannte Prüfungen | | Requirement ID | Description | Error code | Known checks |
| --------------- | ------------ | ---------- |-------------------- | | --------------- | ------------ | ---------- |-------------------- |
| [R_GE_R_TOO_FEW_POINTS](R_GE_R_TOO_FEW_POINTS.md)| Zu wenig Punkte in einem Ring | GE_R_TOO_FEW_POINTS | C_GE_R_TOO_FEW_POINTS | | [R_GE_R_TOO_FEW_POINTS](R_GE_R_TOO_FEW_POINTS.md)| too few points | GE_R_TOO_FEW_POINTS | C_GE_R_TOO_FEW_POINTS |
| [R_GE_R_CONSECUTIVE_POINTS_SAME](R_GE_R_CONSECUTIVE_POINTS_SAME.md)| 2 aufeinanderfolgende Punkte sind gleich | GE_R_CONCECUTIVE_POINTS_SAME | C_GE_R_CONCECUTIVE_POINTS_SAME, C_GE_R_DUPLICATE_POINT | | [R_GE_R_CONSECUTIVE_POINTS_SAME](R_GE_R_CONSECUTIVE_POINTS_SAME.md)| 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](R_GE_R_NOT_CLOSED.md)| Der erste und letzte Punkt sind nicht gleich | GE_R_NOT_CLOSED | C_GE_R_NOT_CLOSED | | [R_GE_R_NOT_CLOSED](R_GE_R_NOT_CLOSED.md)| first-last points are not the same | GE_R_NOT_CLOSED | C_GE_R_NOT_CLOSED |
| [R_GE_R_SELF_INTERSECTION](R_GE_R_SELF_INTERSECTION.md)| Selbstverschneidung z.B. eine Schleife | GE_R_SELF_INTERSECTION | C_GE_R_SELF_INTERSECTION, C_GE_R_DUPLICATE_POINT | | [R_GE_R_SELF_INTERSECTION](R_GE_R_SELF_INTERSECTION.md)| 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](R_GE_R_COLLAPSED_TO_LINE.md)| **Momentan nicht in Benutzung, da redundant mit R_GE_R_SELF_INTERSECTION**<br/> Ring ist ein Punkt oder eine Linie | GE_R_COLLAPSED_TO_LINE | C_GE_R_COLLAPSED_TO_LINE | | [R_GE_R_COLLAPSED_TO_LINE](R_GE_R_COLLAPSED_TO_LINE.md)| **Currently not in use as it is redundant with R_GE_R_SELF_INTERSECTION**<br/> is point or line | GE_R_COLLAPSED_TO_LINE | C_GE_R_COLLAPSED_TO_LINE |
| R_GE_R_ALL | Container für: R_GE_R_TOO_FEW_POINTS, R_GE_R_CONSECUTIVE_POINTS_SAME, R_GE_R_NOT_CLOSED, R_GE_R_SELF_INTERSECTION | -- | -- | | 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 | -- | -- |
## Polygon ## Polygon
| Anforderungs ID | Beschreibung | Fehlercode | Bekannte Prüfungen | | Requirement ID | Description | Error code | Known checks |
| --------------- | ------------ | ---------- |-------------------- | | --------------- | ------------ | ---------- |-------------------- |
| [R_GE_P_INTERSECTING_RINGS](R_GE_P_INTERSECTING_RINGS.md) | 2+ Ringe schneiden sich | GE_P_INTERSECTING_RINGS | C_GE_P_INTERSECTING_RINGS | | [R_GE_P_INTERSECTING_RINGS](R_GE_P_INTERSECTING_RINGS.md) | 2+ rings intersect | GE_P_INTERSECTING_RINGS | C_GE_P_INTERSECTING_RINGS |
| [R_GE_P_NON_PLANAR](R_GE_P_NON_PLANAR.md) | Nicht planares Polygon, sowohl Distanz als auch Flächennormale Abweichungen | GE_P_NON_PLANAR_POLYGON_DISTANCE_PLANE, GE_P_NON_PLANAR_POLYGON_NORMALS_DEVIATION | C_GE_P_NON_PLANAR | | [R_GE_P_NON_PLANAR](R_GE_P_NON_PLANAR.md) | 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](R_GE_P_INTERIOR_DISCONNECTED.md) | Innenfläche ist nicht verbunden | GE_P_INTERIOR_DISCONNECTED | C_GE_P_INTERIOR_DISCONNECTED | | [R_GE_P_INTERIOR_DISCONNECTED](R_GE_P_INTERIOR_DISCONNECTED.md) | interior is not connected | GE_P_INTERIOR_DISCONNECTED | C_GE_P_INTERIOR_DISCONNECTED |
| [R_GE_P_HOLE_OUTSIDE](R_GE_P_HOLE_OUTSIDE.md) | 1+ inneren Ringe ist komplett außerhalb des Polygons | GE_P_HOLE_OUTSIDE | C_GE_P_HOLE_OUTSIDE | | [R_GE_P_HOLE_OUTSIDE](R_GE_P_HOLE_OUTSIDE.md) | 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](R_GE_P_INNER_RINGS_NESTED.md) | Innerer Ring ist komplett innerhalb eines anderen inneren Rings | GE_P_INNER_RINGS_NESTED | C_GE_P_INNER_RINGS_NESTED | | [R_GE_P_INNER_RINGS_NESTED](R_GE_P_INNER_RINGS_NESTED.md) | interior ring is located inside other | GE_P_INNER_RINGS_NESTED | C_GE_P_INNER_RINGS_NESTED |
| [R_GE_P_ORIENTATION_RINGS_SAME](R_GE_P_ORIENTATION_RINGS_SAME.md) | Äußerer Ring und innerer Ring haben die selbe Orientation | GE_P_ORIENTATION_RINGS_SAME | C_GE_P_ORIENTATION_RINGS_SAME | | [R_GE_P_ORIENTATION_RINGS_SAME](R_GE_P_ORIENTATION_RINGS_SAME.md) | exterior and interior rings have same orientation | GE_P_ORIENTATION_RINGS_SAME | C_GE_P_ORIENTATION_RINGS_SAME |
| R_GE_P_ALL | Container für: 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 | -- | -- | | 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 | -- | -- |
## Solid / Hülle (Shell) ## Solid / Shell
| Anforderungs ID | Beschreibung | Fehlercode | Bekannte Prüfungen | | Requirement ID | Description | Error code | Known checks |
| --------------- | ------------ | ---------- |-------------------- | | --------------- | ------------ | ---------- |-------------------- |
| [R_GE_S_TOO_FEW_POLYGONS](R_GE_S_TOO_FEW_POLYGONS.md) | <4 Polygone | GE_S_TOO_FEW_POLYGONS | C_GE_S_TOO_FEW_POLYGONS | | [R_GE_S_TOO_FEW_POLYGONS](R_GE_S_TOO_FEW_POLYGONS.md) | <4 polygons | GE_S_TOO_FEW_POLYGONS | C_GE_S_TOO_FEW_POLYGONS |
| [R_GE_S_NOT_CLOSED](R_GE_S_NOT_CLOSED.md) | Die Hülle ist nicht wasserdicht / hat 1+ Löcher | GE_S_NOT_CLOSED | C_GE_S_NOT_CLOSED | | [R_GE_S_NOT_CLOSED](R_GE_S_NOT_CLOSED.md) | there is 1+ hole(s) on the surface | GE_S_NOT_CLOSED | C_GE_S_NOT_CLOSED |
| [R_GE_S_NON_MANIFOLD_VERTEX](R_GE_S_NON_MANIFOLD_VERTEX.md) | Jedes Polygon, das an einem Punkt anliegt muss über Kanten mit den Anderen verbunden sein | GE_S_NON_MANIFOLD_VERTEX | C_GE_S_NON_MANIFOLD_VERTEX | | [R_GE_S_NON_MANIFOLD_VERTEX](R_GE_S_NON_MANIFOLD_VERTEX.md) | Each shell must be simple | GE_S_NON_MANIFOLD_VERTEX | C_GE_S_NON_MANIFOLD_VERTEX |
| [R_GE_S_NON_MANIFOLD_EDGE](R_GE_S_NON_MANIFOLD_EDGE.md) | An jeder Kante dürfen nur 2 Polygon anliegen | GE_S_NON_MANIFOLD_EDGE | C_GE_S_NON_MANIFOLD_EDGE | | [R_GE_S_NON_MANIFOLD_EDGE](R_GE_S_NON_MANIFOLD_EDGE.md) | 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](R_GE_S_MULTIPLE_CONNECTED_COMPONENTS.md) | Alle Polygone müssen über Punkte und Kanten verbunden sein | GE_S_MULTIPLE_CONNECTED_COMPONENTS | C_GE_S_MULTIPLE_CONNECTED_COMPONENTS | | [R_GE_S_MULTIPLE_CONNECTED_COMPONENTS](R_GE_S_MULTIPLE_CONNECTED_COMPONENTS.md) | 1+ polygons not connected to main shell | GE_S_MULTIPLE_CONNECTED_COMPONENTS | C_GE_S_MULTIPLE_CONNECTED_COMPONENTS |
| [R_GE_S_SELF_INTERSECTION](R_GE_S_SELF_INTERSECTION.md) | Die Hülle selbstverschneidet sich | GE_S_SELF_INTERSECTION | C_GE_S_SELF_INTERSECTION | | [R_GE_S_SELF_INTERSECTION](R_GE_S_SELF_INTERSECTION.md) | Solid self intersects | GE_S_SELF_INTERSECTION | C_GE_S_SELF_INTERSECTION |
| [R_GE_S_POLYGON_WRONG_ORIENTATION](R_GE_S_POLYGON_WRONG_ORIENTATION.md) | Die Orientierung eines Polygons ist falsch | GE_S_POLYGON_WRONG_ORIENTATION | C_GE_S_POLYGON_WRONG_ORIENTATION | | [R_GE_S_POLYGON_WRONG_ORIENTATION](R_GE_S_POLYGON_WRONG_ORIENTATION.md) | orientation of a polygon not correct | GE_S_POLYGON_WRONG_ORIENTATION | C_GE_S_POLYGON_WRONG_ORIENTATION |
| [R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION](R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION.md) | Alle Polygone zeigen in die falsche Richtung | GE_S_ALL_POLYGONS_WRONG_ORIENTATION | C_GE_S_ALL_POLYGONS_WRONG_ORIENTATION | | [R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION](R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION.md) | normals all pointing in wrong direction | GE_S_ALL_POLYGONS_WRONG_ORIENTATION | C_GE_S_ALL_POLYGONS_WRONG_ORIENTATION |
| R_GE_S_ALL | Container für: 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 | -- | -- | | 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 | -- | -- |
## Parameter Überblick ## Parameter Überblick
| Name | Beschreibung | Verwendet in | Einheit | | Name | Description | Used in | Unit |
| ---- | ------------ | ------------ | ------- | | ---- | ------------ | ------------ | ------- |
| 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 | | 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 | Planaritätsprüfungsart, kann *distance*, *angle*, *both* sein | R_GE_P_NON_PLANAR | - | | type | Planar check type, can be *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 | | distanceTolerance | Distance from the regression plane before a point is considered not in plane | 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 | | angleTolerance | Difference in normal vectors before a plane is not considered planar | R_GE_P_NON_PLANAR | Radiant |
## Abhängigkeitsbaum ## Abhängigkeitsbaum
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. 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.
```mermaid ```mermaid
graph TD; graph TD;
...@@ -125,9 +131,9 @@ graph TD; ...@@ -125,9 +131,9 @@ graph TD;
``` ```
## Multisurface und Solid Geometrie ## Multisurface und Solid Geometrie
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. 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.
| Anforderungs ID | Beschreibung | Abhängigkeiten | Fehlercode | Bekannte Prüfungen | | Requirement ID | Description | Dependencies | Error code | Known checks |
| --------------- | ------------ | -------------- | ---------- |-------------------- | | --------------- | ------------ | -------------- | ---------- |-------------------- |
| [R_GE_MS](R_GE_MS.md) | Valide Multisurface-Geometrie | R_SC-SCHEMA-VALIDATION, R_GE_P_ALL | -- | -- | | [R_GE_MS](R_GE_MS.md) | valid multisurface geometry | R_SC-SCHEMA-VALIDATION, R_GE_P_ALL | -- | -- |
| [R_GE_SO](R_GE_SO.md) | Valide Hüllengeometrie | R_SC-SCHEMA-VALIDATION, R_GE_S_ALL | -- | -- | | [R_GE_SO](R_GE_SO.md) | valid solid geometry | R_SC-SCHEMA-VALIDATION, R_GE_S_ALL | -- | -- |
\ No newline at end of file \ No newline at end of file
# CityDoctor2 # CityDoctor2
**Entwicklung eines Systems zur automatisierten Reparatur virtueller Stadtmodelle** ** Development of a automatic repair system for virtual city models**
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 [QualityADE](https://transfer.hft-stuttgart.de/gitlab/citydoctor/qualityade) um Prüfergebnisse direkt in CityGML zu speichern. 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](https://transfer.hft-stuttgart.de/gitlab/citydoctor/qualityade) to save test results directly into CityGML.
![examplePicture](img/checked.png) ![examplePicture](img/checked.png)
# Lizenzen / Versionen # Licence / Versions
### CityDoctorValidation ### CityDoctorValidation
The validation part of CityDoctor is freely available and [open source](https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctor2)
Der Validierungsteil von CityDoctor ist frei verfügbar und [OpenSource](https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctor2)
### CityDoctorGUI ### CityDoctorGUI
The graphical interface is free but not open source (see [Installation](requiredSoftware.md))
Die grafische Oberfläche ist frei aber nicht OpenSource (siehe [Installation](requiredSoftware.md))
### CityDoctorHealer ### CityDoctorHealer
Der Teil zuständig für die Reparatur ist nur in Absprache mit uns zu erhalten. The part responsible for the repair can be obtained only in consultation with us.
Mail an: Mail to:
![mail](img/mail.png) ![mail](img/mail.png)
# Projekt # Projekt
**Projektlaufzeit:** 01.11.2018 - 31.12.2021 **Project duration:** 01.11.2018 - 31.12.2021
## Partner ## Partner
**Projektverantwortliche:** **Project responsible:**
Prof. Dr. Margitta Pries Prof. Dr. Margitta Pries
**Verbundpartner:** **Collaboration partner:**
Prof. Dr.-Ing. Volker Coors Prof. Dr.-Ing. Volker Coors
**Kooperationspartner:** **Cooperation partner:**
[3DIS GmbH](https://www.3dis.de/) [3DIS GmbH](https://www.3dis.de/)
[3dpartzz GmbH](https://3dpartzz.com/) [3dpartzz GmbH](https://3dpartzz.com/)
[con terra GmbH](https://conterra.de/) [con terra GmbH](https://conterra.de/)
...@@ -42,13 +40,13 @@ Mark Wewetzer ...@@ -42,13 +40,13 @@ Mark Wewetzer
[Steinbeis - Transferzentrum](https://www.steinbeis.de/de.html) [Steinbeis - Transferzentrum](https://www.steinbeis.de/de.html)
[Virtual City Systems](https://www.virtualcitysystems.de/) [Virtual City Systems](https://www.virtualcitysystems.de/)
**Assoziative Partner:** **Associative partner:**
[Landesamt für Geoinformation und Landentwicklung Baden-Württemberg](https://www.lgl-bw.de/) [Landesamt für Geoinformation und Landentwicklung Baden-Württemberg](https://www.lgl-bw.de/)
**Mittelgeber:** **Funder:**
[Bundesministerium für Bildung und Forschung](https://www.bmbf.de/) [Bundesministerium für Bildung und Forschung](https://www.bmbf.de/)
**Projektträger:** **Project sponsor:**
[VDI Technologiezentrum](https://www.vditz.de/) [VDI Technologiezentrum](https://www.vditz.de/)
![partner](img/partner.png) ![partner](img/partner.png)
......
# Benötigte Software # Required Software
## Versionen ab 3.13.0 ## Versions from 3.13.0
Ab Version 3.13.0 wurde ein Repository auf dem Transferportal der Hochschule erstellt, das fortan als Ablageort für fertige Releases verwendet wird: 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](https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctorreleases) [https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctorreleases](https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctorreleases)
Die Versionen sind dort unterteilt zwischen CityDoctorValidation und CityDoctorGUI und unter diesen Ordnern gibt es die entsprechenden Versionsordner. The versions are divided there between CityDoctorValidation and CityDoctorGUI and under these folders there are the corresponding version folders.
### Releaseversionen ### Release Versions
Für jede CityDoctor Variante (CityDoctorValidation oder CityDoctorGUI) werden vier verschiedene Versionen zum Download bereitgestellt. For each CityDoctor variant (CityDoctorValidation or CityDoctorGUI) four different versions are provided for download.
Es werden in verschiedenen Versionen Java Runtimes der Liberica Distribution mitgeliefert. Java runtimes of the Liberica distribution are included in different versions.
| Version | Beschreibung | | Version | Description |
| ------- | ------------ | | ------- | ------------ |
| CityDoctor*-no-runtime.zip | Diese Version beinhaltet keine Runtime für Java. Falls auf Ihrem PC schon ein Java der Version 17 installiert ist (siehe [Java](requiredSoftware.md#java)), dann ist diese Version zu bevorzugen. | 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](requiredSoftware.md#java) |
| CityDoctor*-win.zip | Beinhaltet eine Windows Java Runtime zum ausführen von CityDoctor, kein Java muss installiert sein. | | CityDoctor*-win.zip | Includes a Windows Java Runtime to run CityDoctor, no Java needs to be installed. |
| CityDoctor*-lin.zip | Beinhaltet eine Linux Java Runtime zum ausführen von CityDoctor | | CityDoctor*-lin.zip | Includes a Linux Java Runtime to run CityDoctor |
| CityDoctor*-mac.zip | Beinhaltet eine Mac Java Runtime zum ausführen von CityDoctor | | CityDoctor*-mac.zip | Includes a Mac Java Runtime to run CityDoctor |
## Versionen bis 3.12.x ## Versions until 3.12.x
CityDoctor kann von verschiedenen Seiten heruntergeladen werden. Die aktuellste Stelle ist ein [gitlab Repository](https://gitlab.com/volkercoors/CiD4Sim/-/tree/master/CityDoctorExtension). Alternativ werden Releases auch auf der [CityDoctor Homepage der BHT](https://projekt.bht-berlin.de/citydoctor2/downloads/) gelistet. Es gibt dabei immer zwei Versionen: CityDoctor can be downloaded from various sites. The most recent place is a [gitlab repository](https://gitlab.com/volkercoors/CiD4Sim/-/tree/master/CityDoctorExtension). Alternatively, releases are also listed on the [CityDoctor homepage of the BHT](https://projekt.bht-berlin.de/citydoctor2/downloads/). There are always two versions:
* **CityDoctorGUI-3.x.x.zip:** Das ist die grafische Oberfläche inklusive der Prüfungen. Geeignet für den Endnutzer auf einem Desktop PC. * **CityDoctorGUI-3.x.x.zip:** This is the graphical interface including the checks. Suitable for the end user on a desktop PC.
* **CityDoctorValidation-3.x.x.zip:** 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. * **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.
!!! note !!! note
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. 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.
### Java ### Java
Vor der CityDoctor Version 3.12.x wird Java 8 entweder als JDK oder als JRE benötigt. Ab der Version 3.12.x wird Java 17 benötigt. 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.
!!! warning !!! warning
Es wichtig, dass die installierte Java Version die JavaFX Bibliotheken mit einschließt. Diese werden für die grafische Oberfläche benötigt. It is important that the installed Java version includes the JavaFX libraries. These are needed for the graphical user interface.
[Die Liberica JRE oder JDK](https://bell-sw.com/libericajdk/) hat sich für einen Einsatz mit CityDoctor bewährt. [The Liberica JRE oder JDK](https://bell-sw.com/libericajdk/) has proven itself for use with CityDoctor.
!!! note !!! note
Die Liberica Distribution ist zu 100% frei und OpenSource. The Liberica distribution is 100% free and open source.
!!! note !!! note
Für die Entwicklung mit CityDoctor wird eine JDK benötigt. For the development with CityDoctor a JDK is required.
\ No newline at end of file \ No newline at end of file
# Anforderungen und Prüfungen für die Validierung von CityGML-Modellen # Anforderungen und Prüfungen für die Validierung von CityGML-Modellen
Die Anforderungen sind die Grundbausteine für ein Validierungsplan um CityGML-Modelle zu validieren. Für Namenskonventionen und Definitionen, siehe [Grundbegriffe](basic.md). The requirements are the basic building blocks for a validation plan to validate CityGML models. For naming conventions and definitions, see [fundamentals](basic.md).
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. 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:
Unterschieden wird dabei zwischen: * [Schema Requirements](schemaRequirements.md)
* [Geometry Requirements](geometric.md)
* [Schemaanforderungen](schemaRequirements.md) * [Semantic Requirements](semantic.md)
* [Geometrieanforderungen](geometric.md)
* [Semantische Anforderungen](semantic.md)
# Schemaanforderungen # Schema Requirements
## R_SC_SCHEMA_VALIDATION ## R_SC_SCHEMA_VALIDATION
...@@ -6,14 +6,14 @@ ...@@ -6,14 +6,14 @@
| ID | R_SC_SCHEMA_VALIDATION | | ID | R_SC_SCHEMA_VALIDATION |
| ---- | ---- | | ---- | ---- |
| Beschreibung | Eine grundlengende Anforderung ist, dass jedes CityGML Dokument wohl definiert sein muss und XSD valide ist. | | Description | A basic requirement is that each CityGML document must be well defined and XSD valid. |
| Fehlercode | SC-SCHEMA-NOT-VALID | | Error code | SC-SCHEMA-NOT-VALID |
### Prüfung ### Prüfung
| ID | SC_SCHEMA_VALIDATION| | ID | SC_SCHEMA_VALIDATION|
| ---- | ---- | | ---- | ---- |
| Anforderungs ID | R_SC_SCHEMA_VALIDATION | | Anforderungs ID | R_SC_SCHEMA_VALIDATION |
| Vorbedingungen | keine | | Requirements | none |
| Beschreibung | Werkzeuge um eine XSD Validierung durchzuführen sind verfügbar und geben verlässliche Ergebnisse | | Description | Tools to perform XSD validation are available and give reliable results |
| Fehlercode | SC_SCHEMA_NOT_VALID | | Error code | SC_SCHEMA_NOT_VALID |
\ No newline at end of file \ No newline at end of file
# Semantische Anforderungen # Semantic Requirements
Die semantischen Anforderungen sind meistens auf Attributbasis. Daraus ergeben sich 3 Fehlerzustände für ein Attribut: The semantic requirements are mostly attribute based. This results in 3 error states for an attribute:
* **SE_ATTRIBUTE_WRONG_VALUE:** Wenn ein Attribut ein falschen Wert hat. * **SE_ATTRIBUTE_WRONG_VALUE:** If an attribute has a wrong value.
* **SE_ATTRIBUTE_MISSING:** Wenn ein Attribut fehlt, aber vorhanden sein sollte. * **SE_ATTRIBUTE_MISSING:** If an attribute is missing but should be present.
* **SE_ATTRIBUTE_INVALID:** Wenn ein Attribut vorhanden ist aber verboten ist. * **SE_ATTRIBUTE_INVALID:** If an attribute is present but forbidden.
!!! warning
**SE_ATTRIBUTE_INVALID:** ist noch nicht in CityDoctor und der QualityADE umgesetzt ist aber geplant in einer neuen Version zu unterstützen.
## Schematron ## Schematron
......
# Nutzeroberfläche # User interface
## CityDoctor ## CityDoctor
![interface](img/userInterface.png) ![interface](img/userInterface.png)
In der oberen Leiste sind folgende Schaltflächen in Reihenfolge: In the upper bar the following buttons are in order:
* **Laden:** Öffnet den Dialog zum laden einer CityGML Datei * **Load:** Opens the dialog for loading a CityGML file
* **Prüfen:** Öffnet den Dialog zum prüfen einer geladenen CityGML * **Validation:** Opens the dialog to check a loaded CityGML
* **Prüfberichte:** Öffnet den Dialog zum schreiben eines Prüfprotokolls in xml oder pdf Form * **Validation results:** Opens the dialog for writing a test protocol in xml or pdf form
* **Gitternetz:** Zeigt/Versteckt das Gitternetz anstatt gefüllter Polygone * **Grid:** Shows/hides the grid instead of filled polygons
* **ckseiten:** Zeigt/Versteckt Rückseiten von Polygonen * **Backsides:** Shows/hides backs of polygons
* **Globale Ansicht:** Lädt alle Elemente einer CityGML in die Ansicht * **Global View:** Loads all elements of a CityGML into the view
* **LODs:** Schaltet einzelne LODs von der Ansicht an oder aus * **LODs:** Turns individual LODs on or off from the view
* **Speichern:** Speichert eine CityGML Datei zurück, falls die Datei geprüft wurde wird die QualityADE mitgeschrieben. * **Save:** Saves a CityGML file back, if the file was checked the QualityADE is written too.
* **About:** Öffnet den Dialog mit Informationen zu dem Projekt CityDoctor2 * **About:** Opens the dialog with information about the project CityDoctor2
* **Ansichten:** Wechselt verschiedene Ansichten. Für die Prüfung gibt es nur eine. * **View:** Switches different views. There is only one for the validation part.
* **Sprache:** Hier kann die Sprache eingestellt werden (Deutsch/Englisch) * **Language:** Here you can set the language (German/English)
!!! warning !!! warning
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. Displaying the Global View can cause crashes with large CityGML files (> 100mb depending on the system). The display may take a short time.
## Laden ## Load
Über die Schaltfläche Laden wird der Dialog zum laden einer CityGML Datei geöffnet. The Load button opens the dialog for loading a CityGML file.
![open](img/open.png) ![open](img/open.png)
In der Datei Leiste kann ein Dateipfad eingetragen werden oder über die Schaltfläche **Auswählen** ausgewählt werden. In the file bar a file path can be entered or selected via the **Select** button.
Außerdem können weitere Einstellungen für das Lesen der Datei angegeben werden. In addition, other settings for reading the file can be specified.
* **NumberOfRoundingPlaces:** Auf wie viele Nachkommastellen werden die eingelesenen Werte gerundet. * **NumberOfRoundingPlaces:** To how many decimal places are the read-in values rounded?
* **XML-Validierung:** Führt eine XML Validierung durch. Fehler werden dabei direkt beim einlesen festgestellt und das Einlesen wird abgebrochen. * **XML-Validierung:** Performs an XML validation. Errors are detected directly during the import and the import is aborted.
* **Speicherverbrauch:** Spart RAM um größere Dateien in der GUI zu ermöglichen. Kostet geringfügig Performance bei der Prüfung. * **Low Memory Consumption Mode :** Saves RAM to allow larger files in the GUI. Slight performance costs during the validation process.
Beim Laden wird der Fortschritt ungefähr durch den Ladebalken repräsentiert. When loading, the progress is approximately represented by the loading bar.
!!! note !!! note
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) 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).
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. After loading a CityGML file, the elements are displayed in the individual tabs. Selecting an element will display it in the view.
![loadedFile](img/interfaceLoad.png) ![loadedFile](img/interfaceLoad.png)
!!! note !!! note
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. 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.
## Prüfen ## Validation
![checkDialog](img/checkDialog.png) ![checkDialog](img/checkDialog.png)
Im Prüfdialog kann der Validierungsplan angepasst werden. Hier werden neben den Verfügbaren Prüfungen auch die globalen Parameter angezeigt. The validation plan can be customized in the check dialog. In addition to the available checks, the global parameters are also displayed here.
Verändert können die Parameter mit einem Doppelklick in die Wert Spalte. Die Einheit ist dabei fest. The parameters can be changed with a double click in the value column. The unit is fixed.
!!! note !!! note
Der Parameter numberOfRoundingPlaces kann nicht verändert werden. Er wurde beim Laden der Datei festgelegt. The numberOfRoundingPlaces parameter cannot be changed. It was set when the file was loaded.
Falls Prüfungen nicht ausgeführt werden sollen können sie in der Spalte Aktiv deaktiviert werden. If checks should not be executed, they can be deactivated in the Active column.
!!! warning !!! warning
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 [Anforderungen](requirements.md). 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](requirements.md).
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 [Semantische Prüfungen](semantic.md) 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](semantic.md)
Über die beiden Schaltflächen oben rechts kann der Prüfplan gespeichert und geladen werden. The test plan can be saved and loaded via the two buttons at the top right.
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 **Fehler** angezeigt. Dort kann der Fehler ausgewählt werden um ihn in CityDoctor anzuzeigen und weitere Informationen zu erhalten. 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.
![checked](img/checked.png) ![checked](img/checked.png)
Die Elemente können mit dem Dropdown-Menü gefiltert werden um nur fehlerhafte Elemente anzuzeigen. The elements can be filtered with the dropdown menu to show only faulty elements.
## Prüfberichte ## Validation reports
In diesem Dialog gibt es nochmal eine Übersicht über die Fehler in Bildform und die Möglichkeit einen xml oder pdf Bericht zu schreiben. In this dialog there is again an overview of the errors in image form and the possibility to write an xml or pdf report.
![reportDialog](img/reportDialog.png) ![reportDialog](img/reportDialog.png)
\ No newline at end of file
# Validierungsplan # Validation Plan
der Validierungsplan für CityDoctor wird in [YAML](https://de.wikipedia.org/wiki/YAML) angegeben. the validation plan for CityDoctor is specified in [YAML](https://de.wikipedia.org/wiki/YAML).
Für die Version 3.12.x sieht ein Beispiel so aus: For version 3.12.x and later, an example looks like this:
``` {.yaml .annotate} ``` {.yaml .annotate}
globalParameters: globalParameters:
numberOfRoundingPlaces: 8 numberOfRoundingPlaces: 8
...@@ -69,8 +69,8 @@ requirements: ...@@ -69,8 +69,8 @@ requirements:
enabled: false enabled: false
``` ```
1. Der Parameter `useStreaming` 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. 1. The parameter `useStreaming` 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.
In dem Validierungsplan finden sich die selben Einstellungen wieder, die in der grafischen Oberfläche auch aufgelistet sind. In the validation plan you will find the same settings that are listed in the graphical user interface.
Unter requirements sind alle Anforderungen gelistet die geprüft werden sollen. Dabei sind die semantischen Prüfungen standardmäßig deaktiviert. All requirements that are to be checked are listed under requirements. The semantic checks are deactivated by default.
\ No newline at end of file \ No newline at end of file
...@@ -387,7 +387,7 @@ ...@@ -387,7 +387,7 @@
<img alt="extracted" src="../img/extracted.png"/></p> <img alt="extracted" src="../img/extracted.png"/></p>
<p>Um CityDoctor zu starten kann die start.bat verwendet werden.</p> <p>Um CityDoctor zu starten kann die start.bat verwendet werden.</p>
<p>Die .bat Datei enthält dabei nur den Befehl:</p> <p>Die .bat Datei enthält dabei nur den Befehl:</p>
<pre><code>java -classpath libs/*;plugins/*;CityDoctorGUI-3.12.0.jar de.hft.stuttgart.citydoctor2.gui.MainWindow <pre><code>java -classpath app/*;plugins/* de.hft.stuttgart.citydoctor2.gui.CityDoctorGUIStarter
</code></pre> </code></pre>
<div class="admonition note"> <div class="admonition note">
<p class="admonition-title">Note</p> <p class="admonition-title">Note</p>
......
This diff is collapsed.
...@@ -426,10 +426,6 @@ ...@@ -426,10 +426,6 @@
<li><strong>SE_ATTRIBUTE_MISSING:</strong> Wenn ein Attribut fehlt, aber vorhanden sein sollte.</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_INVALID:</strong> Wenn ein Attribut vorhanden ist aber verboten ist.</li>
</ul> </ul>
<div class="admonition warning">
<p class="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>
</div>
<h2 id="schematron">Schematron<a class="headerlink" href="#schematron" title="Permanent link">#</a></h2> <h2 id="schematron">Schematron<a class="headerlink" href="#schematron" title="Permanent link">#</a></h2>
<p>In CityDoctor wurde das <a href="https://de.wikipedia.org/wiki/Schematron">XML Validierungssystem Schematron</a> integriert um flexibel Attributprüfungen anzupassen und zu unterstützen. </p> <p>In CityDoctor wurde das <a href="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>Hier ist ein Beispiel für eine Schematron Datei die CityDoctor integrieren kann:</p>
......
...@@ -2,157 +2,157 @@ ...@@ -2,157 +2,157 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_MS/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_MS/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_HOLE_OUTSIDE/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_HOLE_OUTSIDE/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_INNER_RINGS_NESTED/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_INNER_RINGS_NESTED/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_INTERIOR_DISCONNECTED/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_INTERIOR_DISCONNECTED/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_INTERSECTING_RINGS/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_INTERSECTING_RINGS/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_NON_PLANAR/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_NON_PLANAR/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_ORIENTATION_RINGS_SAME/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_P_ORIENTATION_RINGS_SAME/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_R_COLLAPSED_TO_LINE/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_R_COLLAPSED_TO_LINE/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_R_CONSECUTIVE_POINTS_SAME/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_R_CONSECUTIVE_POINTS_SAME/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_R_NOT_CLOSED/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_R_NOT_CLOSED/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_R_SELF_INTERSECTION/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_R_SELF_INTERSECTION/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_R_TOO_FEW_POINTS/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_R_TOO_FEW_POINTS/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_SO/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_SO/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_ALL_POLYGONS_WRONG_ORIENTATION/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_MULTIPLE_CONNECTED_COMPONENTS/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_MULTIPLE_CONNECTED_COMPONENTS/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_NON_MANIFOLD_EDGE/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_NON_MANIFOLD_EDGE/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_NON_MANIFOLD_VERTEX/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_NON_MANIFOLD_VERTEX/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_NOT_CLOSED/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_NOT_CLOSED/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_POLYGON_WRONG_ORIENTATION/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_POLYGON_WRONG_ORIENTATION/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_SELF_INTERSECTION/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_SELF_INTERSECTION/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_TOO_FEW_POLYGONS/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/R_GE_S_TOO_FEW_POLYGONS/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/basic/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/basic/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/firstRun/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/firstRun/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/geometric/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/geometric/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/requiredSoftware/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/requiredSoftware/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/requirements/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/requirements/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/schemaRequirements/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/schemaRequirements/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/semantic/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/semantic/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/userInterface/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/userInterface/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
<url> <url>
<loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/validationPlan/</loc> <loc>https://transfer.hft-stuttgart.de/pages/citydoctor/citydoctorhomepage/validationPlan/</loc>
<lastmod>2023-06-02</lastmod> <lastmod>2023-06-05</lastmod>
<changefreq>daily</changefreq> <changefreq>daily</changefreq>
</url> </url>
</urlset> </urlset>
\ No newline at end of file
No preview for this file type
...@@ -355,7 +355,7 @@ ...@@ -355,7 +355,7 @@
<article class="md-content__inner md-typeset"> <article class="md-content__inner md-typeset">
<h1 id="validierungsplan">Validierungsplan<a class="headerlink" href="#validierungsplan" title="Permanent link">#</a></h1> <h1 id="validierungsplan">Validierungsplan<a class="headerlink" href="#validierungsplan" title="Permanent link">#</a></h1>
<p>der Validierungsplan für CityDoctor wird in <a href="https://de.wikipedia.org/wiki/YAML">YAML</a> angegeben.</p> <p>der Validierungsplan für CityDoctor wird in <a href="https://de.wikipedia.org/wiki/YAML">YAML</a> angegeben.</p>
<p>Für die Version 3.12.x sieht ein Beispiel so aus:</p> <p>Für die Version 3.12.x und neuere sieht ein Beispiel so aus:</p>
<pre class="annotate"><code class="language-yaml">globalParameters: <pre class="annotate"><code class="language-yaml">globalParameters:
numberOfRoundingPlaces: 8 numberOfRoundingPlaces: 8
# in m # in m
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment