1. Kommandozeilenaufruf

Der PlanPro Werkzeugkoffer kann durch die Angabe der Kommandozeilenparameter -headless -nosplash in einen Headless Modus versetzt werden. Hierbei wird die Benutzeroberfläche nicht dargestellt und der Benutzer kann nicht mit dem Werkzeugkoffer interagieren. Stattdessen können durch verschiedene Kommandozeilenparameter maschinenlesbare Ausgaben erzeugt werden, welche die Informationen des Werkzeugkoffers enthalten.

Achtung:
Das Format der maschinenlesbaren Ausgabedateien ist derzeit noch nicht festgelegt, sodass sich Format und Inhalte in zukünftigen Versionen ggf. ändern werden.

1.1 Standardparameter

Parameter Erforderlich Beschreibung

-headless

Ja

Startet den Werkzeugkoffer im Headlesss Modus

-nosplash

Nein

Versteckt den Ladebildschirm der Anwendung

-i Dateipfad

Ja

Eingabedatei im PlanPro Format

-o Ordnerpfad

Ja

Pfad für die Ausgabe von Informationen durch den Werkzeugkoffer. Wenn am gewählten Pfad noch kein Ordner existiert, so wird dieser erstellt.
Achtung: Vorhandene Dateien in diesem Ordner werden ohne Rückfrage überschrieben.

1.2 Verfügbare Ausgaben

Parameter Beschreibung

-validationReport

Erstellt einen Validitätsbericht im Ausgabeordner. Dateiname: validationreport.xml

1.3 Beispielaufrufe

Der folgende Aufruf kann, wenn er im Verzeichnis des Werkzeugkoffers ausgeführt wird, dazu verwendet werden, das Beispielmodell PHausen auf Validität zu prüfen. Das Ergebnis der Prüfung findet sich nach der Ausführung im Unterordner output in der Datei validationreport.xml.

./werkzeugkoffer.exe -nosplash -headless -i examples/2015-12-10_P-Hausen_1.9.0.2_4.0_Status_Genehmigt_V02.ppxml -o output -validationReport

2. Sicherungstechnischer Lageplan

2.1 Bedienung

2.1.1 Shortcuts

Kartenausschnitt auswählen
Es kann ein Kartenauschnitt ausgewählt werden, in den herangezoomt wird. Bei betätigter SHIFT-Taste ist der Bereich durch eine gedrückte linke Maustaste und entsprechenden Mausbewegungen auszuwählen. Beim loslassen der Maustaste wird die Kartenansicht passend auf den gewählten Bereich zentriert und herangezoomt.

Drehung der Kartenansicht
Die Kartenansicht kann frei gedreht werden, indem ähnlich zum Verschieben der Karte bei gedrückter linker Maustaste die Maus bewegt wird, während die Tastenkombination ALT + SHIFT betätigt bleibt.

Ansicht zurücksetzen
Durch einen Klick auf das Gesamtbereich darstellen Symbol, kann die Ansicht des Lageplans zurückgesetzt werden, sodass alle Objekte der aktuellen Planung dargestellt werden.

Messwerkzeug
Durch einen Klick auf das Messwerkzeug Symbol wird das Messwerkzeug aktiviert. Damit kann man die Distanz in Metern zwischen 2 beliebigen Punkten messen.

  • Um die Messung zu starten, klicke auf einen beliebigen Punkt auf der Karte.

  • Klicke auf beliebige weitere Punkte in der Karte um Wegpunkte hinzuzufügen, z.B. um über Eck zu messen.

  • Um die Messung zu beenden. doppelklicke auf den gewünschten Endpunkt.

  • Zum Deaktivieren des Werkzeugs klicke erneut auf das Symbol.

2.1.2 Maßstab

Im unteren linken Bereich des Lageplans wird der Maßstab angezeigt.

BedienungMassstab

Mit einem Linksklick auf den Maßstab kann dieser auf einen Wert von 1:1000 fixiert werden.

BedienungMassstab1000

Die Einstellung von 1:1000 bleibt bestehen, bis die Zoomeinstellung durch Klick auf die Vergrößern-/Verkleinern-Schaltflächen bzw. durch das Mausrad verändert wird.

2.1.3 Interaktion mit Objekten

Mit den dargestellten Objekte (u.a. Signale, Weichen und Gleise) im Lageplan kann durch anklicken interagiert werden.

Ein Linksklick auf ein Objekt markiert in allen offenen Tabellen des PlanPro Werkzeugkoffers das entsprechende Objekt, sofern dieses in der Tabelle vorhanden ist.

Durch einen Rechtsklick auf das Objekt kann ein Informationsfenster zum Objekt geöffnet werden.

2.2 Konfiguration der Lageplandienste

toolbox.siteplan.mapsources
Mit der Option toolbox.siteplan.mapsources können die im Werkzeugkoffer aktiven Kartenansichten angepasst werden.

Hierbei sind die folgenden Kartenquellen verfügbar:

Option Art Beschreibung

BKG_TOPPLUS

Topologisch

Topologisches Kartenmaterial bereitgestellt durch das Bundesamt für Kartographie und Geodäsie

Siehe https://www.bkg.bund.de/SharedDocs/Produktinformationen/BKG/DE/P-2017/170922-TopPlus-Web-Open.html

OSM

Topologisch

Topologisches Kartenmaterial von OpenStreetMap

Siehe https://www.openstreetmap.de/

ORM

Topologisch

Topologisches Kartenmaterial von OpenRailwayMap

Siehe https://www.openrailwaymap.org/

MAPBOX_TOP

Topologisch

Topologische Karte von Mapbox

Erfordert die Konfiguration von toolbox.siteplan.mapsources.mapbox_apikey, da Mapbox die Verwendung eines API Schlüssels voraussetzt

HERE_TOP

Topologisch

Topologische Karte von Here Maps über die Here-Maps Server der DB

Erfordert die Konfiguration von toolbox.siteplan.mapsources.here_clientid und toolbox.siteplan.mapsources.here_apikey, da eine ClientID und ein API Schlüssel benötigt wird.

BKG_SENT

Satellitenansicht

Satellitenbilder bereitgestellt durch das Bundesamt für Kartographie und Geodäsie

Siehe https://gdz.bkg.bund.de/index.php/default/webdienste/digitale-orthophotos/wms-deutschlandmosaik-aus-sentinel-2-daten-wms-sentinel2-de.html

DOP20

Satellitenansicht

Digitale Orthophotos Bodenauflösung 20 cm bereitgestellt durch das Bundesamt für Kartographie und Geodäsie

Erfordert die Konfiguration von toolbox.siteplan.mapsources.dop20_apikey, da ein API Schlüssel benötigt wird.

Siehe https://gdzshopv-lpz.bkg.bund.de/index.php/default/wms-digitale-orthophotos-bodenauflosung-20-cm-wms-dop.html

DOP20_INTERN

Satellitenansicht

Digitale Orthophotos Bodenauflösung 20 cm bereitgestellt durch das Bundesamt für Kartographie und Geodäsie

Wie DOP20, jedoch ohne Angabe eines API Schlüssels. Funktioniert nur innerhalb des Netzwerks der DB InfraGO AG.

MAPBOX_SAT

Satellitenansicht

Satellitenbilder von Mapbox

Erfordert die Konfiguration von toolbox.siteplan.mapsources.mapbox_apikey, da Mapbox die Verwendung eines API Schlüssels voraussetzt

ARCGIS

Satellitenansicht

Durch Esri bereitgestellte Satellitenbilder

Siehe https://www.arcgis.com/home/item.html?id=10df2279f9684e4a9f6a7f08febac2a9

HERE_SAT

Satellitenansicht

Satellitenbilder von Here Maps über die Here-Maps Server der DB

Erfordert die Konfiguration von toolbox.siteplan.mapsources.here_clientid und toolbox.siteplan.mapsources.here_apikey, da eine ClientID und ein API Schlüssel benötigt wird.

Um mehrere Kartenquellen parallel zu aktivieren, wird ein vertikaler Trennstrich verwendet. Soll beispielsweise das Kartenmaterial des Bundesamt für Kartographie und Geodäsie sowohl für die topologische Karte als auch für die Satellitenansicht verwendet werden, so wird die Option wie folgt angegeben:

toolbox.siteplan.mapsources=BKG_TOPPLUS|BKG_SENT

Weiterhin ist es möglich alle oben gelisteten Kartenquellen zu aktivieren, indem toolbox.siteplan.mapsources=* gesetzt wird.

toolbox.siteplan.mapsources.mapbox_apikey
toolbox.siteplan.mapsources.dop20_apikey
toolbox.siteplan.mapsources.here_apikey
toolbox.siteplan.mapsources.here_clientidi
Da die Verwendung von einigen Datenquellen für die Kartendarstellung seitens der Diensteanbieter einen API Schlüssel oder eine Client ID erfordert, muss dieser ggf. mithilfe dieser Optionen angegeben werden. Ist beispielsweise der von Mapbox ausgestellte API Schlüssel abcd1234, dann wird die Option wie folgt angegeben:

toolbox.siteplan.mapsources.mapbox_apikey=abcd1234

Wenn die jeweiligen Datenquellen nicht verwendet werden sollen, muss diese Option nicht angegeben werden. Es erfolgt in der Anwendung keine Prüfung auf Korrektheit des angegebenen Schlüssels, wodurch ein falscher API Schlüssel zu unerwartetem Verhalten führt.

toolbox.siteplan.lod_scale

Gibt an, bei welcher Skalierung der Lageplan in den Level-of-Detail Modus wechselt, in welchem ausschließlich Gleise in einer vergrößerten Darstellung angezeigt werden. Soll der Lageplan beispielsweise bei einer Skalierung von 1:5000 in den Level-of-Detail Modus wechseln, so wird

toolbox.siteplan.lod_scale=5000

gesetzt. Der Standardwert für diesen Konfigurationsparameter ist 10000.

toolbox.siteplan.export_dpi

Diese Option steuert, mit welcher Auflösung der PDF Export im Lageplan erstellt wird. Höhere Werte erhöhen dabei die Auflösung und ergeben eine klarere Zeichnung, benötigen jedoch mehr Zeit zur Generierung des Exports.

Der Standardwert für diesen Konfigurationsparameter ist 600. Der PDF Export ist derzeit nur im Entwicklungsmodus verfügbar.

2.3 Symbolkatalog

Hinweis:
Diese Option ist nur mit aktiviertem Entwicklermodus verfügbar.

Es gibt drei Möglichkeiten, die Signale zu betrachten.

symbolkatalog selectModus

2.3.1 Katalog

Es werden alle Signalvarianten angezeigt, nachdem die Signalgruppe ausgewählt wurde. Es besteht die Möglichkeit, die Signale mit den unterschiedlichen Befestigungsvarianten darzustellen, indem der Haken bei "Mit Befestigung verbinden" gesetzt wird.

katalog modus

2.3.2 Einzelnes Signal

Diese Option bietet die Möglichkeit, ein einzelnes Signal zusammenzubauen. Zunächst muss das Signalsystem (KS, Hl-SV, HV) ausgewählt werden. Anschließen lässt sich das Signal durch auswählen des Signalschirms und der Befestigung bestimmen. Zusätzlich lassen sich Zusatzsignale dem Signal beifügen.

einzeln modus

2.3.3 Signalbrücke und Ausleger

Diese Option bietet die Möglichkeit, Signalausleger zu betrachten.

ausleger bruecke

3. Entwicklermodus aktivieren

Der PlanPro Werkzeugkoffer bietet einige Funktionalität nur im Entwicklermodus an. Um diesen zu aktivieren ist wie folgt vorzugehen:

Bearbeiten der Datei:
<Pfad zum Werkzeugkoffer-Verzeichnis>\configuration\config.ini

Ändern der Zeile
toolbox.development.mode=false
nach
toolbox.development.mode=true