OpenStreetMap importer for X-Plane®

Überblick

Diese Skripte erstellen X-Plane® Szenerie-Pakete mit genauen Straßen, Eisenbahnlinien, Stromleitungen und Parks, aus den Quelldaten des OpenStreetMap-Projekts.

Vorraussetzungen

• Sie müssen Programme über die Befehlszeile ausführen können.
• X-Plane® Version 9.00 oder höher und Global Scenery Version 9 muss für das Interessengebiet installiert sein.
• Windows: Erfordert Python 2.x (Version 2.5 empfohlen).
• Linux: Erfordert Wine und Python 2.x

Hinweis: Eine geeignete Version von Python ist mit MacOS enthalten.

Die Szenerie-Pakete von diesen erzeugten Skripts erfordern X-Plane® Version 9.00 oder höher (9.30 oder höher wird empfohlen) und Global Scenery Version 9 für den Bereich der installierten Szenerie-Pakete.

Installation

• Entpacken Sie den Inhalt des XPOSM. Zip-Datei in einen günstig gelegenen Ordner, z.B. einen Ordner namens XPOSM auf Ihrem Desktop.
• Laden Sie die Scenery Tools (Linux-Benutzer sollten die Windows-Version herunterladen) und kopieren Sie das Programm DSFTool in Ihren XPOSM Ordner.
• Starten Sie eine Eingabeaufforderung (Windows) oder eine Terminal-Anwendung (MacOS und Linux).
• Gehen Sie in Ihren XPOSM Ordner.

Quelldaten besorgen

Die Quelldatei muss in Form einer im XML-Daten OpenStreetMap(.OSM)-Format und kann mit .bz2, .gz oder .zip komprimiert sein. Man kann die Daten unter anderem bei Geofabrik oder CloudMade herunterladen.

X-Plane® organisiert die Szenerien in "Kacheln" von 1°×1°. Wenn Sie die Quelldaten nur für ein einzelnes Land (z.B. Deutschland) herunterladen, wird in den "Kacheln" angrenzender Länder (z.B. Belgien, Frankreich) jenseits der Landesgrenze keine Straßen anzeigen. Um diesem vorzubeugen, laden Sie bevorzugt eine größere Region (z.B. Europa) herunter, besonders wenn Sie vorhaben, Ihr Szenerie-Paket zu veröffentlichen.

• Laden und speichern Sie die Quelldaten für Ihr Gebiet in Ihrem XPOSM-Ordner.

Aufbau und Füllen einer MySQL-Datenbank

Die Skripte lesen die gesamten Quelldaten pro 1°×1°-Kachel ein. Wenn Sie planen, ein Szenerie-Paket für eine große Fläche (z.B. ein mittelgroßes Land) zu erstellen, dann kann das Einlesen sehr lange dauern. Sie können die Quelldaten in einer Datenbank ablegen, um den Prozess stark zu beschleunigen.

• Laden und installieren Sie MySQL:
• Windows: Laden und starten Sie den MySQL "Essentials"-Installer. Starten Sie eine neue Eingabeaufforderung nach der Installation von MySQL.
• MacOS: Laden und installieren Sie MySQL und starten Sie den MySQL-Server.
• Linux: Installieren Sie den MySQL-Client und MySQL-Server mit dem Paketmanager Ihrer Distribution.
• Download und Installation des Python-MySQL-Modul:/li>
  • Windows: Download und starten Sie das Python-MySQL-Installationsprogramm.
  • MacOS: Laden Sie das Python-Modul für MySQL MacOS 10.3.9 und MacOS 10.4 oder 10.5 und speichern Sie es in Ihrem XPOSM-Ordner.
  • Linux: Installation von Python-mysqldb mit Ihrer Distribution den Paketmanager.
• Erstellen Sie ein neues Schema für die OSM-Daten: 
  • Windows: In der Eingabeaufforderung geben:
                createdb
  • MacOS und Linux: In der Terminal-Anwendung ein:
                . / Createdb
  • Sie werden zweimal nach dem "root"-Passwort gefragt, das Sie gewählt, als Sie MySQL installiert haben. Bei MacOS bleibt das Root-Kennwort leer, drücken Sie einfach Return.
• Füllen Sie die MySQL-Datenbank: 
  • Windows: In der Eingabeaufforderung eingeben:
                import.py sourcedatafile.osm.bz2 
  • MacOS und Linux: Geben Sie in der Terminal-Anwendung ein:
                python ./import.py sourcedatafile.osm.bz2
  • sourcedatafile.osm.bz2 ist der Name Ihrer Quelldaten-Datei.
  • Das Befüllen der Datenbank kann einige Stunden dauern.
    
  Sie können mehrere Quellen gleichzeitig hinter import.py eingeben oder import.py mehrfach ausführen:
  • Sie können Quelldaten herunterladen und importieren, die nicht benachbarte Regionen abdecken.
  • Sie können Quelldaten herunterladen und importieren, die benachbarte oder sich überschneidende Gebiete abdecken, vorausgesetzt dass die Quelldaten aus dem OpenStreetMap-Datenbank-Master am selben Tag extrahiert wurden.
  • Sie sollten nicht aktualisierte Quelldaten für die Regionen, die bereits in der Datenbank vorhanden sind, downloaden und importieren, da dann sowohl alte als auch aktualisierte Daten gleichzeitig vorhanden sein könnten, was zu schlechten Ergebnissen in X-Plane führen würde.
    Wenn Sie auf eine neuere Kopie der OpenStreetMap-Quelldaten verwenden, dann sollten Sie die Datenbank mit dem Skript deletedb löschen und eine leere Datenbank neu befüllen.

Konfigurieren der Skripte

Sie konfigurieren die Skripte durch Editieren der Datei xposm.py in Ihrem XPOSM Ordner. Sie müssen die Punkte <code>interest</code>, <code>dsfdir</code>, <code>osmfile</code> und <code>tasks</code> anpassen.

• <code>interest</code>
  Geben Sie die gewünschten Regionen in einer Liste in Form von 1°×1°-Kacheln ein, wobei jede Kachel im Format (Westen, Süden, Osten, Norden) aufgebaut ist.
  Beispiel: <code>interest=[(8,54,9,55),(9,54,10,55),(10,54,11,55),(11,54,12,55),(12,54,13,55),(13,54,14,55)]</code> für die nördlichste Region Deutschlands.
• <code>dsfdir</code>
  Geben Sie den Pfad zu den Global Scenery v9 Gelände DSFs an, die das Terrainnetz abdecken.
• <code>osmfile</code>
  Geben Sie den Namen Ihrer Quelldatendatei an. Wenn Sie eine Datenbank nutzen, geben Sie "None" an.
• <code>tasks</code>
  Unter Windows, MacOS 10.5 und Linux können in Verbindung mit einer Datenbank (d.h. osmfile = None) mehrere Fliesen parallel (bis zu einer Kachel-Bearbeitungsaufgabe pro CPU) verarbeitet werden. Die Verarbeitung einer einzelnen Kachel können bis zu 1 GB RAM (je nach Dichte der Straße) beanspruchen. Für die beste Leistung sollten sie die Anzahl der Aufgaben beschränken - z.B. 2 Aufgaben auf einem System mit 2 GB RAM, 4 Aufgaben auf einem System mit 4 GB RAM.

Das Ausführen des Skripts

• Windows: In der Eingabeaufforderung eingeben:
        xposm.py
• MacOS und Linux: In der Terminal-Anwendung eingeben:
        python. / xposm.py

Wenn Sie die Skripte korrekt konfiguriert haben, werden sie in etwa so aussehen:
   (-7.000,49.000, -6.000,50.000)
   Reading mesh +40-010/+49-007.dsf
   9,520 time reading +40-010/+49-007.dsf
   ...
Die Skripte laufen teilweise mehrere Stunden. Sie zeigen den Fortschritt und etwaige Fehler in der Eingabeaufforderung / im Terminal-Fenster an. Eine Zusammenfassung der Kacheln, die die Skripte verarbeitet haben, findet sich in der Datei log.txt in dem XPOSM Ordner.. Sie sollten nach Beendigung des Skripts in diese Datei sehen und überprüfen, dass keine Fehler passiert sind.

die generierten Landschaften nutzen

Die Skripte erstellen einen Ordner namens "Earth nav Data" in dem XPOSM-Ordner und .txt und .dsf-Dateien in entsprechenden Unterordnern.

So verwenden Sie die Ausgabe des Skripts in X-Plane:

• Erstellen Sie einen neuen Ordner im Verzeichnis "Custom Scenery".
• Verschieben Sie "Earth Nav Daten-Ordner" in diesen neuen Ordner.

Wenn Sie mit der erstellten Szenerie zufrieden sind, sollten Sie die .txt-Dateien in den Unterordnern des löschen, weil sie groß sind. Wenn Sie Ihr neues Szenerie-Paket veröffentlichen möchten, dann sollten Sie nicht die .txt-Dateien enthalten. vor dem Erstellen eines Archivs für die Verteilung löschen Sie die .txt-Dateien oder nutzen Sie das X-Publish-Tool - es wird die .txt-Dateien automatisch weglassen.