From b0238c23c6cb9e097d410d937afd40bbd65fcaf5 Mon Sep 17 00:00:00 2001
From: Riegel <alexander.riegel@hft-stuttgart.de>
Date: Thu, 8 Aug 2024 16:52:27 +0200
Subject: [PATCH] Created Documentation for CityDoctor Extensions
---
CityDoctorParent/Extensions/README.md | 122 ++++++++++++++++++
CityDoctorParent/pom.xml | 5 +
.../Badges/MaintenanceLevel_Abandoned.svg | 23 ++++
.../MaintenanceLevel_ActivelyDeveloped.svg | 23 ++++
.../MaintenanceLevel_ActivelyMaintained.svg | 23 ++++
.../Badges/MaintenanceLevel_Deprecated.svg | 23 ++++
.../MaintenanceLevel_InactivelyMaintained.svg | 23 ++++
.../Badges/MaintenanceLevel_NotMaintained.svg | 23 ++++
.../Badges/MaintenanceLevel_Obsolete.svg | 23 ++++
.../resources/Badges/Project_CD2.svg | 22 ++++
.../resources/Badges/Project_UDigiT.svg | 22 ++++
README.md | 5 +-
12 files changed, 336 insertions(+), 1 deletion(-)
create mode 100644 CityDoctorParent/Extensions/README.md
create mode 100644 CityDoctorParent/resources/Badges/MaintenanceLevel_Abandoned.svg
create mode 100644 CityDoctorParent/resources/Badges/MaintenanceLevel_ActivelyDeveloped.svg
create mode 100644 CityDoctorParent/resources/Badges/MaintenanceLevel_ActivelyMaintained.svg
create mode 100644 CityDoctorParent/resources/Badges/MaintenanceLevel_Deprecated.svg
create mode 100644 CityDoctorParent/resources/Badges/MaintenanceLevel_InactivelyMaintained.svg
create mode 100644 CityDoctorParent/resources/Badges/MaintenanceLevel_NotMaintained.svg
create mode 100644 CityDoctorParent/resources/Badges/MaintenanceLevel_Obsolete.svg
create mode 100644 CityDoctorParent/resources/Badges/Project_CD2.svg
create mode 100644 CityDoctorParent/resources/Badges/Project_UDigiT.svg
diff --git a/CityDoctorParent/Extensions/README.md b/CityDoctorParent/Extensions/README.md
new file mode 100644
index 0000000..e3ce451
--- /dev/null
+++ b/CityDoctorParent/Extensions/README.md
@@ -0,0 +1,122 @@
+# CityDoctor2 Extensions
+Extension modules to the core functionality of CityDoctor2.
+
+# Loading
+
+Except for CityDoctorGUI, all extension modules are not loaded into the Maven project by default.
+If you wish to load an extension, you can either import the respective Maven module directly, or adjust the CityDoctorParent
+pom.xml and move the respective modules out of the comment-block in the module list found at the end of the file.
+
+# Building
+
+All loaded modules will also be built upon building of the CityDoctorParent.
+
+# Module Information
+
+## CityDoctorAutoPro
+
+
+
+The AutoPro (short for automated processing) module is an interface for the conversion of the internal data model to a C++
+representation, to allow use of advanced functionalities of CGAL with CityDoctor2.
+
+### Usage
+
+The AutoPro module is deprecated and will be removed in a future release, once the C++ functionalities have been ported to Java.
+
+AutoPro requires a collection of .dll files to run, some of which are not available as open source projects. Access to the collection is only granted upon request. Contact a Maintainer for further information.
+
+## CityDoctorGUI
+
+
+The GUI module offers a graphical user interface for CityDoctor2, including a model viewer allowing for visual
+inspection of validation results and found errors.
+
+### View Plugins
+
+The GUI is expandable via plugins, enabling the creation of views for custom functionalities or extensions of the CityDoctor2 core.
+Custom views can be created by extending the Abstract class `View` of the CityDoctorGUI and need to be registered by calling
+`ViewRegistration.registerView(View view);` before starting the GUI.
+
+### Usage
+
+> âš CityDoctorGUI requires a JDK/JRE containing the JavaFX library to run.
+
+Prebuilt binaries for the GUI are available in [CityDoctorReleases](https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctorreleases).
+After extracting the archive the GUI can be started with **start.bat**.
+
+Binaries can be built with Maven using the create-binaries profile from the CityDoctorParent directory:
+```
+mvn install -P create-binaries
+```
+
+Lastly, the GUI can also be started by calling `MainWindow.main(args[])`.
+
+
+## CityDoctorHealer
+
+
+CityDoctorHealer implements functionalities for the automated repair of geometries containing errors.
+The healer uses naive approaches to fix geometrical errors, and thus, it cannot be guaranteed that semantical
+correctness is maintained after the healing process.
+
+
+### Usage
+
+Usage of CityDoctorHealer is similar to [CityDoctor](https://transfer.hft-stuttgart.de/gitlab/citydoctor/citydoctor2/-/tree/dev_GUI#usage).
+An example start command looks like this:
+```
+java -classpath libs/*;plugins/*;CityDoctorHealer-<version>.jar de.hft.stuttgart.citydoctor2.CityDoctorHealer -in <path-to-gml-file>.gml -config <path-to-validation-config>.yml -xmlReport <path-to-xml-output>.xml -pdfReport <path-to-pdf-output>.pdf -out <path-to-output-gml>.gml
+```
+Note: Unlike the CityDoctor core, the _-out_ argument is required
+
+To prevent infinite loops the `Healer` class has a limit for the number of healing iterations (default: 200). This limit
+can be changed by calling `Healer.setNumberOfIterations(int limit)`.
+
+## CityDoctorHealerGenetic
+
+
+CityDoctorHealerGenetic uses a genetical algorithm to establish an optimal CityDoctorHealer healing-plan for geometries containing errors.
+
+### Usage
+> âš This module has been abandoned. As of writing the module is still functional, but it may break at any time.
+>Issues, bug reports and suggestions for this module will not be processed. Use at your own discretion.
+
+Usage is nearly identical to CityDoctorHealer, only requiring changing the classpath to the HealerGenetic jar.
+
+A View for usage with CityDoctorGUI is included.
+
+## CityDoctorHealerGUI
+
+
+CityDoctorGUI-view for CityDoctorHealer.
+
+### Usage
+
+See [CityDoctorGUI](#view-plugins)
+
+
+## CityDoctorWebService
+
+
+Web service API for CityDoctor.
+
+### Usage
+> âš This module has been abandoned. As of writing the module is still functional, but it may break at any time.
+>Issues, bug reports and suggestions for this module will not be processed. Use at your own discretion.
+
+Run on a Tomcat Server.
+
+
+# Build
+
+Use [Maven](https://maven.apache.org/) to build CityDoctor2.
+
+```bash
+cd CityDoctorParent
+mvn install
+```
+
+
+## License
+[LGPL](http://www.gnu.org/licenses/lgpl-3.0.de.html)
diff --git a/CityDoctorParent/pom.xml b/CityDoctorParent/pom.xml
index afc82b4..1b8d4ca 100644
--- a/CityDoctorParent/pom.xml
+++ b/CityDoctorParent/pom.xml
@@ -258,15 +258,20 @@
</dependency>
</dependencies>
<modules>
+ <!--CityDoctor2 Core Modules-->
<module>CityDoctorModel</module>
<module>CityDoctorValidation</module>
<module>CityDoctorEdge</module>
<module>CityDoctorCheckResult</module>
+
+ <!--CityDoctor2 Extension Modules-->
<module>Extensions/CityDoctorGUI</module>
+ <!--
<module>Extensions/CityDoctorAutoPro</module>
<module>Extensions/CityDoctorHealer</module>
<module>Extensions/CityDoctorHealerGenetic</module>
<module>Extensions/CityDoctorHealerGUI</module>
<module>Extensions/CityDoctorWebService</module>
+ -->
</modules>
</project>
\ No newline at end of file
diff --git a/CityDoctorParent/resources/Badges/MaintenanceLevel_Abandoned.svg b/CityDoctorParent/resources/Badges/MaintenanceLevel_Abandoned.svg
new file mode 100644
index 0000000..c677a00
--- /dev/null
+++ b/CityDoctorParent/resources/Badges/MaintenanceLevel_Abandoned.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="194" height="20">
+ <linearGradient id="b" x2="0" y2="100%">
+ <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+ <stop offset="1" stop-opacity=".1"/>
+ </linearGradient>
+ <mask id="anybadge_1">
+ <rect width="194" height="20" rx="3" fill="#fff"/>
+ </mask>
+ <g mask="url(#anybadge_1)">
+ <path fill="#555" d="M0 0h121v20H0z"/>
+ <path fill="#FF0000" d="M121 0h73v20H121z"/>
+ <path fill="url(#b)" d="M0 0h194v20H0z"/>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="61.5" y="15" fill="#010101" fill-opacity=".3">Maintenance Level</text>
+ <text x="60.5" y="14">Maintenance Level</text>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="158.5" y="15" fill="#010101" fill-opacity=".3">Abandoned</text>
+ <text x="157.5" y="14">Abandoned</text>
+ </g>
+</svg>
diff --git a/CityDoctorParent/resources/Badges/MaintenanceLevel_ActivelyDeveloped.svg b/CityDoctorParent/resources/Badges/MaintenanceLevel_ActivelyDeveloped.svg
new file mode 100644
index 0000000..63a7480
--- /dev/null
+++ b/CityDoctorParent/resources/Badges/MaintenanceLevel_ActivelyDeveloped.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="243" height="20">
+ <linearGradient id="b" x2="0" y2="100%">
+ <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+ <stop offset="1" stop-opacity=".1"/>
+ </linearGradient>
+ <mask id="anybadge_1">
+ <rect width="243" height="20" rx="3" fill="#fff"/>
+ </mask>
+ <g mask="url(#anybadge_1)">
+ <path fill="#555" d="M0 0h121v20H0z"/>
+ <path fill="#228B22" d="M121 0h122v20H121z"/>
+ <path fill="url(#b)" d="M0 0h243v20H0z"/>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="61.5" y="15" fill="#010101" fill-opacity=".3">Maintenance Level</text>
+ <text x="60.5" y="14">Maintenance Level</text>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="183.0" y="15" fill="#010101" fill-opacity=".3">Actively Developed</text>
+ <text x="182.0" y="14">Actively Developed</text>
+ </g>
+</svg>
diff --git a/CityDoctorParent/resources/Badges/MaintenanceLevel_ActivelyMaintained.svg b/CityDoctorParent/resources/Badges/MaintenanceLevel_ActivelyMaintained.svg
new file mode 100644
index 0000000..7bc7454
--- /dev/null
+++ b/CityDoctorParent/resources/Badges/MaintenanceLevel_ActivelyMaintained.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="248" height="20">
+ <linearGradient id="b" x2="0" y2="100%">
+ <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+ <stop offset="1" stop-opacity=".1"/>
+ </linearGradient>
+ <mask id="anybadge_1">
+ <rect width="248" height="20" rx="3" fill="#fff"/>
+ </mask>
+ <g mask="url(#anybadge_1)">
+ <path fill="#555" d="M0 0h121v20H0z"/>
+ <path fill="#6B8E23" d="M121 0h127v20H121z"/>
+ <path fill="url(#b)" d="M0 0h248v20H0z"/>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="61.5" y="15" fill="#010101" fill-opacity=".3">Maintenance Level</text>
+ <text x="60.5" y="14">Maintenance Level</text>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="185.5" y="15" fill="#010101" fill-opacity=".3">Actively Maintained</text>
+ <text x="184.5" y="14">Actively Maintained</text>
+ </g>
+</svg>
diff --git a/CityDoctorParent/resources/Badges/MaintenanceLevel_Deprecated.svg b/CityDoctorParent/resources/Badges/MaintenanceLevel_Deprecated.svg
new file mode 100644
index 0000000..2041082
--- /dev/null
+++ b/CityDoctorParent/resources/Badges/MaintenanceLevel_Deprecated.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="198" height="20">
+ <linearGradient id="b" x2="0" y2="100%">
+ <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+ <stop offset="1" stop-opacity=".1"/>
+ </linearGradient>
+ <mask id="anybadge_1">
+ <rect width="198" height="20" rx="3" fill="#fff"/>
+ </mask>
+ <g mask="url(#anybadge_1)">
+ <path fill="#555" d="M0 0h121v20H0z"/>
+ <path fill="#800000" d="M121 0h77v20H121z"/>
+ <path fill="url(#b)" d="M0 0h198v20H0z"/>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="61.5" y="15" fill="#010101" fill-opacity=".3">Maintenance Level</text>
+ <text x="60.5" y="14">Maintenance Level</text>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="160.5" y="15" fill="#010101" fill-opacity=".3">Deprecated</text>
+ <text x="159.5" y="14">Deprecated</text>
+ </g>
+</svg>
diff --git a/CityDoctorParent/resources/Badges/MaintenanceLevel_InactivelyMaintained.svg b/CityDoctorParent/resources/Badges/MaintenanceLevel_InactivelyMaintained.svg
new file mode 100644
index 0000000..320d7e4
--- /dev/null
+++ b/CityDoctorParent/resources/Badges/MaintenanceLevel_InactivelyMaintained.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="260" height="20">
+ <linearGradient id="b" x2="0" y2="100%">
+ <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+ <stop offset="1" stop-opacity=".1"/>
+ </linearGradient>
+ <mask id="anybadge_1">
+ <rect width="260" height="20" rx="3" fill="#fff"/>
+ </mask>
+ <g mask="url(#anybadge_1)">
+ <path fill="#555" d="M0 0h121v20H0z"/>
+ <path fill="#A4A61D" d="M121 0h139v20H121z"/>
+ <path fill="url(#b)" d="M0 0h260v20H0z"/>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="61.5" y="15" fill="#010101" fill-opacity=".3">Maintenance Level</text>
+ <text x="60.5" y="14">Maintenance Level</text>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="191.5" y="15" fill="#010101" fill-opacity=".3">Inactively Maintained</text>
+ <text x="190.5" y="14">Inactively Maintained</text>
+ </g>
+</svg>
diff --git a/CityDoctorParent/resources/Badges/MaintenanceLevel_NotMaintained.svg b/CityDoctorParent/resources/Badges/MaintenanceLevel_NotMaintained.svg
new file mode 100644
index 0000000..b21cd9e
--- /dev/null
+++ b/CityDoctorParent/resources/Badges/MaintenanceLevel_NotMaintained.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="219" height="20">
+ <linearGradient id="b" x2="0" y2="100%">
+ <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+ <stop offset="1" stop-opacity=".1"/>
+ </linearGradient>
+ <mask id="anybadge_1">
+ <rect width="219" height="20" rx="3" fill="#fff"/>
+ </mask>
+ <g mask="url(#anybadge_1)">
+ <path fill="#555" d="M0 0h121v20H0z"/>
+ <path fill="#FF4500" d="M121 0h98v20H121z"/>
+ <path fill="url(#b)" d="M0 0h219v20H0z"/>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="61.5" y="15" fill="#010101" fill-opacity=".3">Maintenance Level</text>
+ <text x="60.5" y="14">Maintenance Level</text>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="171.0" y="15" fill="#010101" fill-opacity=".3">Not Maintained</text>
+ <text x="170.0" y="14">Not Maintained</text>
+ </g>
+</svg>
diff --git a/CityDoctorParent/resources/Badges/MaintenanceLevel_Obsolete.svg b/CityDoctorParent/resources/Badges/MaintenanceLevel_Obsolete.svg
new file mode 100644
index 0000000..f26fd5a
--- /dev/null
+++ b/CityDoctorParent/resources/Badges/MaintenanceLevel_Obsolete.svg
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="185" height="20">
+ <linearGradient id="b" x2="0" y2="100%">
+ <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+ <stop offset="1" stop-opacity=".1"/>
+ </linearGradient>
+ <mask id="anybadge_1">
+ <rect width="185" height="20" rx="3" fill="#fff"/>
+ </mask>
+ <g mask="url(#anybadge_1)">
+ <path fill="#555" d="M0 0h121v20H0z"/>
+ <path fill="#000000" d="M121 0h64v20H121z"/>
+ <path fill="url(#b)" d="M0 0h185v20H0z"/>
+ </g>
+ <g fill="white" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="61.5" y="15" fill="#010101" fill-opacity=".3">Maintenance Level</text>
+ <text x="60.5" y="14">Maintenance Level</text>
+ </g>
+ <g fill="white" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="154.0" y="15" fill="#010101" fill-opacity=".3">Obsolete</text>
+ <text x="153.0" y="14">Obsolete</text>
+ </g>
+</svg>
diff --git a/CityDoctorParent/resources/Badges/Project_CD2.svg b/CityDoctorParent/resources/Badges/Project_CD2.svg
new file mode 100644
index 0000000..1d815f5
--- /dev/null
+++ b/CityDoctorParent/resources/Badges/Project_CD2.svg
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="132" height="20">
+ <linearGradient id="b" x2="0" y2="100%">
+ <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+ <stop offset="1" stop-opacity=".1"/>
+ </linearGradient>
+ <mask id="anybadge_1">
+ <rect width="132" height="20" rx="10" fill="#fff"/>
+ </mask>
+ <g mask="url(#anybadge_1)">
+ <path fill="#FF0000" d="M0 0h132v20H0z"/>
+ <path fill="#262626" d="M53 2h70v16H53z"/>
+ <path fill="#262626" d="M122,18 a1,1 0 0,0 0,-16"/>
+ <path fill="url(#b)" d="M0 0h132v20H0z"/>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="26.5" y="14">Project</text>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="92.5" y="14">CityDoctor2</text>
+ </g>
+</svg>
diff --git a/CityDoctorParent/resources/Badges/Project_UDigiT.svg b/CityDoctorParent/resources/Badges/Project_UDigiT.svg
new file mode 100644
index 0000000..6113343
--- /dev/null
+++ b/CityDoctorParent/resources/Badges/Project_UDigiT.svg
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="144" height="20">
+ <linearGradient id="b" x2="0" y2="100%">
+ <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+ <stop offset="1" stop-opacity=".1"/>
+ </linearGradient>
+ <mask id="anybadge_1">
+ <rect width="144" height="20" rx="10" fill="#fff"/>
+ </mask>
+ <g mask="url(#anybadge_1)">
+ <path fill="#4169E1" d="M0 0h144v20H0z"/>
+ <path fill="#262626" d="M53 2h82v16H53z"/>
+ <path fill="#262626" d="M134,18 a1,1 0 0,0 0,-16"/>
+ <path fill="url(#b)" d="M0 0h144v20H0z"/>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="26.5" y="14">Project</text>
+ </g>
+ <g fill="#fff" text-anchor="middle" font-family="DejaVu Sans,Verdana,Geneva,sans-serif" font-size="11">
+ <text x="98.5" y="14">UDigiT-Doctor</text>
+ </g>
+</svg>
diff --git a/README.md b/README.md
index de17876..bd17d1b 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
# CityDoctor2
-[](https://transfer.hft-stuttgart.de/gitlab/betzms/citydoctor2/-/commits/master)
+[](https://transfer.hft-stuttgart.de/gitlab/betzms/citydoctor2/-/commits/master) 
CityDoctor2 is a Java program for validating CityGML files. It checks whether certain criteria for e.g. geometries are met and outputs a report on the results.
@@ -42,6 +42,9 @@ java -classpath libs/*;plugins/*;CityDoctorValidation-<version>.jar de.hft.stutt
Note:
-xmlReport, -pdfReport and -out are optional
+## Extension
+
+Example extensions for CityDoctor are included in this repository, and can be found in the [Extensions subdirectory](./CityDoctorParent/Extensions)
## License
[LGPL](http://www.gnu.org/licenses/lgpl-3.0.de.html)
--
GitLab