AdV-CityGML Import
Das AdV Plugin erweitert den import Befehl von vcdb-tool um den Unterbefehl
citygml-adv. Damit lassen sich Datensätze im AdV-CityGML-1.0 Format in die VCDB v5 importieren. Im Vergleich
zum bestehenden CityGML-Import Befehl konvertiert import citygml-adv die
Eingangsdaten automatisch in das AdV-CityGML-3.0 Format. Dies betrifft insbesondere die Konvertierung von
Gebäudemodellen in Brücken oder sonstige Bauwerke anhand vorgegebener Werte des bldg:function Attributs.
Die Eingangsdaten für den import citygml-adv Befehl sollten dem AdV-PQS-Standard in der Version 2.6 entsprechen.
Diese Vorgabe ist jedoch nicht zwingend. Der import citygml-adv-Befehl unterstützt auch CityGML-Daten, die
beispielsweise Objektarten, LoD-Stufen oder Attribute enthalten, die über die AdV-Spezifikation hinausgehen, oder
in anderen CityGML-Versionen vorliegen.
|
Optionen
Der import citygml-adv Befehl bietet die identischen Optionen wie der import citygml
Befehl an. Die nachfolgende Übersicht dient daher vor allem der Vollständigkeit. Weitergehende Einstellungen können über
eine JSON-Konfigurationsdatei definiert werden.
Globale Optionen
| Option | Beschreibung | Standardwert |
|---|---|---|
|
Eine oder mehrere Argumentdateien mit Optionen. |
|
|
Hilfenachricht anzeigen und beenden. |
|
|
Versionsinformationen ausgeben und beenden. |
|
|
Konfiguration aus dieser Datei laden. |
|
|
Log-Level: |
|
|
Log-Nachrichten in diese Datei schreiben. |
|
|
Deaktiviert Log-Nachrichten auf der Konsole. |
|
|
Datei mit der Prozess-ID erstellen. |
|
|
Erweiterungen aus diesem Verzeichnis laden. |
|
|
Plugins mit passendem vollqualifiziertem Klassennamen aktivieren oder deaktivieren. |
|
Weitere Informationen zu den globalen Optionen und Nutzungshinweise siehe hier.
Allgemeine Importoptionen
| Option | Beschreibung | Standardwert |
|---|---|---|
|
Eine oder mehrere Dateien oder Verzeichnisse zur Verarbeitung (Glob-Patterns erlaubt). |
|
|
Kodierung der Eingabedatei(en). |
|
|
Bei Fehlern sofort beenden. |
|
|
Temporäre Dateien in diesem Verzeichnis speichern. |
|
|
Importmodus: |
|
|
Anzahl der Threads für die parallele Verarbeitung. |
|
|
Im Vorschau-Modus ausführen. Features werden nicht importiert. |
|
|
Indexmodus: |
|
|
Envelopes von Features berechnen und ersetzen. |
|
|
Koordinaten mit einer 3x4-Matrix im Row-Major-Format transformieren. |
Weitere Informationen zu den allgemeinen Importoptionen und Nutzungshinweise siehe hier.
CityGML-Importoptionen
| Option | Beschreibung | Standardwert |
|---|---|---|
|
XML-Repräsentation von xAL-Adresselementen importieren. |
|
|
Anwendung von XSLT-Stylesheets zur Transformation der Eingabedaten. |
|
|
Appearances nicht verarbeiten. |
|
|
Appearances mit passendem Theme verarbeiten. Verwenden Sie |
Weitere Informationen zu den CityGML-Importoptionen und Nutzungshinweise siehe hier.
Metadatenoptionen
| Option | Beschreibung | Standardwert |
|---|---|---|
|
Zeitstempel im Format |
Attributwert oder |
|
Datenabstammung oder Ursprung der Features. |
|
|
Name des Benutzers, der für den Import verantwortlich ist. |
Datenbankbenutzer |
|
Grund für den Import der Daten. |
Weitere Informationen zu den Metadatenoptionen und Nutzungshinweise siehe hier.
Upgrade-Optionen für CityGML 2.0 und 1.0
| Option | Beschreibung | Standardwert |
|---|---|---|
|
Verwende LoD4 als LoD3 und ersetze bestehende LoD3 Geometrien. |
|
|
Bilde LoD0 Roof-Edge Geometrien auf Dachflächen ab. |
|
|
Bilde LoD1 Multi-Surfaces auf generische thematische Begrenzungsflächen ab. |
Weitere Informationen zu den Upgrade-Optionen und Nutzungshinweise siehe hier.
Filteroptionen
| Option | Beschreibung | Standardwert |
|---|---|---|
|
Namen der zu verarbeitenden Features. |
|
|
Identifier der zu verarbeitenden Features. |
|
|
Bounding Box als räumlicher Filter. |
|
|
Bounding Box Modus: |
|
|
Maximale Anzahl der zu verarbeitenden Features. |
|
|
Index innerhalb der Eingabemenge, ab dem Features verarbeitet werden. |
Weitere Informationen zu den Filteroptionen und Nutzungshinweise siehe hier.
Datenbank-Verbindungsoptionen
| Option | Beschreibung | Standardwert |
|---|---|---|
|
Hostname des VCDB Datenbankservers. |
|
|
Port des VCDB Datenbankservers. |
5432 |
|
Name der VCDB-Instanz, zu eine Verbindung hergestellt werden soll. |
|
|
Schema, das beim Verbinden zur VCDB verwendet werden soll. |
|
|
Benutzername für die Verbidung zur VCDB. |
|
|
Passwort für die Verbidung zur VCDB. Leer lassen, um zur Eingabe aufgefordert zu werden. |
|
|
Datenbankspezifische Verbindungsparameter. |
Weitere Informationen zu den Datenbank-Verbindungsoptionen und Nutzungshinweise siehe hier.
Verwendung
Die Dokumentation der einzelnen Optionen und allgemeine Hinweise zu ihrer Nutzung finden Sie in der
Dokumentation zum import citygml Befehl hier.
|
Im Gegensatz zum normalen CityGML-Import Befehl werden Gebäudemodelle durch
import citygml-adv beim Import in die Datenbank gemäß den Vorgaben des AdV-PQS-Standards v3.0 bei Bedarf in eine
andere CityGML-Objektart umgewandelt. Dazu wird jedes Top-Level-Objekt vom Typ bldg:Building in den Eingangsdaten
untersucht und der zugehörige Funktionscode aus dem Attribut bldg:function ausgelesen.
Anhand des Funktionscodes wird bestimmt, ob eine Konvertierung in eine andere Objektart erforderlich ist. Die Prüfung erfolgt in folgender Reihenfolge:
-
Konvertierung in eine Brücke (
brid:Bridge) -
Konvertierung in ein sonstiges Bauwerk (
con:OtherConstruction) -
Übernahme des Objekts als
bldg:Building(Default-Verhalten)
Welche Funktionscodes die Konvertierung eines Gebäudes in brid:Bridge oder con:OtherConstruction auslösen, ist
gemäß dem AdV-PQS-Standard festgelegt. Mithilfe der JSON-Konfiguration kann
die Liste der Funktionscodes jedoch benutzerspezifisch und pro Objektart angepasst werden.
Abhängig von der Zielobjektart werden unterschiedliche Konvertierungsschritte durchgeführt, die in den folgenden Kapiteln beschrieben werden.
Übernahme von Gebäuden
Konvertierung von Objektarten
Bei der Übernahme eines Gebäudes werden die Objektarten für AdV-CityGML-3.0 wie folgt umklassifiziert:
| Ausgangsobjekt | Zielobjekt |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Konvertierung von Attributen
Für die Konvertierung von Attributen gelten die folgenden Regeln:
-
Generische Attribute werden grundsätzlich übernommen. Eine Validierung der Attributwerte findet nicht statt.
-
Die folgenden generischen Attribute werden in AdV-CityGML-1.0 am
bldg:BuildingPartgeführt und müssen für die Konvertierung nach AdV-CityGML-3.0 ambldg:Buildingzusammengeführt werden. Bei widersprüchlichen Attributwerten gelten folgende Regeln:-
DatenquelleBodenhoehe: Der erste Wert wird übernommen. -
DatenquelleLage: Der erste Wert wird übernommen. -
Grundrissaktualitaet: Das älteste Datum wird übernommen.
-
-
Das generische Attribut
LetzteAenderungist fürbldg:BuildingObjekte verpflichtend. Wenn es für das Eingangsobjekt nicht gesetzt ist, wird es hinzugefügt und mit dem Wert voncore:creationDatebelegt. Ist auch dieses nicht vorhanden, wird das aktuelle Datum verwendet. -
Bei
core:ExternalReferencewird das Attributcore:informationSystementfernt. -
bldg:measuredHeight-Attribute werden incon:Heightumgeschrieben. DasstatusAttribut wird abhängig vom generischen AttributDatenquelleDachhoehewie folgt gesetzt:-
estimated: Bei einem Wert von 3000. -
measured: Bei allen anderen Werten.
-
-
Adressen des Gebäudes werden übernommen.
Konvertierung in Brücken
Konvertierung von Objektarten
Bei der Konvertierung eines Gebäudes in eine Brücke werden das Gebäude und seine Kindobjekte wie folgt umklassifiziert:
| Ausgangsobjekt | Zielobjekt |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Konvertierung von Attributen
Für die Konvertierung von Attributen gelten die folgenden Regeln:
-
Gebäudespezifische Attribute aus dem
bldg-Namensraum werden übernommen, soweit ein entsprechendes Attribut für das Brückenobjekt existiert. -
Generische Attribute werden grundsätzlich übernommen. Eine Validierung der Attributwerte findet nicht statt.
-
Die folgenden generischen Attribute werden in AdV-CityGML-1.0 am
bldg:BuildingPartgeführt und müssen für die Konvertierung nach AdV-CityGML-3.0 an derbrid:Bridgezusammengeführt werden. Bei widersprüchlichen Attributwerten gelten folgende Regeln:-
DatenquelleBodenhoehe: Der erste Wert wird übernommen. -
DatenquelleLage: Der erste Wert wird übernommen. -
Grundrissaktualitaet: Das älteste Datum wird übernommen.
-
-
Die folgenden generischen Attribute sind für Brücken nicht vorgesehen und werden entfernt:
-
BezugspunktDach -
DatenquelleGeschossanzahl
-
-
Das generische Attribut
LetzteAenderungist fürbrid:BridgeObjekte verpflichtend. Wenn es für dasbldg:Buildingnicht gesetzt ist, wird es hinzugefügt und mit dem Wert voncore:creationDatebelegt. Ist auch dieses nicht vorhanden, wird das aktuelle Datum verwendet. -
In Abhängigkeit des Funktionscodes wird
brid:isMovableauftrueoderfalsegesetzt. -
Bei
core:ExternalReferencewird das Attributcore:informationSystementfernt. -
bldg:measuredHeight-Attribute werden incon:Heightumgeschrieben. DasstatusAttribut wird abhängig vom generischen AttributDatenquelleDachhoehewie folgt gesetzt:-
estimated: Bei einem Wert von 3000. -
measured: Bei allen anderen Werten.
-
-
Adressen des Gebäudes werden für die Brücke übernommen.
Übernahme von Geometrien
Alle Geometrien des Gebäudeobjekts und seiner Kindobjekte werden unverändert in die entsprechenden Brückenobjekte
übernommen. Dies gilt für alle Geometriearten wie gml:Solid und gml:MultiSurface sowie für gml:MultiCurve
Geometrien von Geländeschnittkurven. Eine Geometrievalidierung findet nicht statt.
Konvertierung in sonstige Bauwerke
Konvertierung von Objektarten
Bei der Konvertierung eines Gebäudes in ein sonstiges Bauwerk werden das Gebäude und seine Kindobjekte wie folgt umklassifiziert:
| Ausgangsobjekt | Zielobjekt |
|---|---|
|
|
|
werden in |
|
|
|
|
|
|
|
- |
Im Gegensatz zu bldg:Building erlaubt con:OtherConstruction keine weitere Untergliederung in Bauwerksteile.
Gebäudeteile können daher nicht als solche erhalten werden, sondern werden im con:OtherConstruction Objekt
zusammengeführt. Begrenzungsflächen der bldg:BuildingPart Objekte werden hierfür in das con:OtherConstruction
Objekt übernommen.
|
Konvertierung von Attributen
Für die Konvertierung von Attributen gelten die folgenden Regeln:
-
Gebäudespezifische Attribute aus dem
bldg-Namensraum werden übernommen, soweit ein entsprechendes Attribut fürcon:OtherConstructionexistiert. -
Generische Attribute werden grundsätzlich übernommen. Eine Validierung der Attributwerte findet nicht statt.
-
Die folgenden generischen Attribute werden in AdV-CityGML-1.0 am
bldg:BuildingPartgeführt und für die Konvertierung beicon:OtherConstructionzusammengeführt. Bei widersprüchlichen Attributwerten gelten folgende Regeln:-
DatenquelleDachhoehe: Der erste Wert wird übernommen. -
BezugspunktDach: Der erste Wert wird übernommen. -
DatenquelleBodenhoehe: Der erste Wert wird übernommen. -
DatenquelleLage: Der erste Wert wird übernommen. -
Grundrissaktualitaet: Das älteste Datum wird übernommen.
-
-
Die folgenden generischen Attribute sind für sonstige Bauwerke nicht vorgesehen und werden entfernt:
-
DatenquelleGeschossanzahl
-
-
Das generische Attribut
LetzteAenderungist fürcon:OtherConstructionObjekte verpflichtend. Wenn es für dasbldg:Buildingnicht gesetzt ist, wird es hinzugefügt und mit dem Wert voncore:creationDatebelegt. Ist auch dieses nicht vorhanden, wird das aktuelle Datum verwendet. -
Bei
core:ExternalReferencewird das Attributcore:informationSystementfernt. -
bldg:measuredHeight-Attribute werden incon:Heightumgeschrieben. Dasstatus-Attribut wird abhängig vom generischen AttributDatenquelleDachhoehewie folgt gesetzt:-
estimated: Bei einem Wert von 3000. -
measured: Bei allen anderen Werten.
-
-
Bei der Zusammenführung von Gebäudeteilen wird die größte vorhandene Teilhöhe als Höhe des Bauwerks verwendet.
-
Adressen des Gebäudes werden für
con:OtherConstructionnicht übernommen.
Übernahme von Geometrien
Die Geometrien des Gebäudeobjekts werden grundsätzlich unverändert in con:OtherConstruction übernommen. Dies gilt
grundsätzlich für alle Geometriearten wie gml:Solid und gml:MultiSurface sowie für gml:MultiCurve Geometrien
von Geländeschnittkurven. Eine Geometrievalidierung findet nicht statt.
Wenn Gebäudeteile modelliert sind, ist zusätzlich eine Konvertierung auf Geometrieebene erforderlich. Für die
Zusammenführung der Geometrien im con:OtherConstruction Objekt gelten folgende Regeln:
-
Begrenzungsflächen vom Typ
bldg:WallSurface,bldg:RoofSurfaceundbldg:GroundSurfacewerden einschließlich ihrer Geometrie incon:OtherConstructionübernommen. -
Die Polygone der übernommenen Begrenzungsflächen werden als Referenz in die LoD2
SolidGeometrie dercon:OtherConstructionaufgenommen. -
Begrenzungsflächen vom Typ
bldg:ClosureSurfacedienen ausschließlich als Trennfläche zwischen zweibldg:BuildingPartObjekten. Sie werden daher einschließlich ihrer Geometrie ersatzlos entfernt. -
Die LoD1
SolidGeometrien der Gebäudeteile werden in einer einzelnen LoD1SolidGeometrie für diecon:OtherConstructionzusammengeführt. -
Geometrien der Geländeschnittkurven der Gebäudeteile werden in einer einzelnen
gml:MultiCurveGeometrie als Geländeschnittkurve dercon:OtherConstructiongetrennt für LoD2 und LoD1 zusammengeführt.
Bei validen Eingangsdaten bleiben die zusammengeführten Geometrien im LoD2 und LoD1 valide. Nur in der LoD1 Solid
Geometrie können an den Berührungsflächen der ursprünglichen Gebäudeteile doppelte Polygone entstehen, durch die die
Volumengeometrie invalide wird.
|
Logging
Nach einem erfolgreichen Import schreibt das AdV Plugin die Anzahl der Gebäudeobjekte, die in Brücken oder sonstige Bauwerke konvertiert wurden, als Zusammenfassung in die Log-Ausgabe von vcdb-tool. Falls keine Konvertierungen erfolgt sind, wird dies ebenfalls protokolliert.
Wenn --log-level auf debug gesetzt ist, wird zusätzlich für jedes konvertierte Gebäude ein Log-Eintrag mit dem
Funktionscode geschrieben, der die Konvertierung ausgelöst hat.
Die Log-Ausgaben des AdV Plugins enthalten den Marker [AdV] und können damit einfach gesucht und gefiltert
werden.
|