6. Klasse DTM

6.1. Allgemeines

Mit den Methoden der Klasse DTM können zu Koordination und Geometrien Höhen ermittelt werden. Die Klasse DTM muss mit |LOAD geladen werden.

Zur Zeit wird als DTM das Produkt swissALTI3D der swisstopo unterstützt.

6.2. DTM

MethodeDTM.SET_SYSTEM [s system] []
BeschreibungSetzt das DTM-System für die Ermittlung der Höhen. Folgende Systeme sind unterstützt: swissalti3d . Das Default System ist swissalti3d .
Beispiel
'swissalti3d' DTM.SET_SYSTEM [] 
MethodeDTM.SET_SYSTEM_GRID [r grid] []
BeschreibungSetzt die Auflösung des aktiven Systems. Folgende GRID's werden pro System unterstützt. swissalti3d: 0.5 oder 2.0, Default ist 2.0.
Beispiel
2.0 DTM.SET_SYSTEM_GRID [] 
MethodeDTM.SET_TRACE [b boolean] []
BeschreibungTRUE|FALSE. Im Logfile werden zusätzliche Information angezeigt.
Beispiel
TRUE DTM.SET_TRACE [] 
MethodeDTM.SET_DATA_DIR [s directory] []
BeschreibungSetzt das Verzeichnis für die DTM-Daten. Das Verzeichnis kann absolut oder relativ zu OPT.data_dir gesetzt werden. Das Verzeichnis muss bestehen. Das Default-Verzeichnis ist ILTOOLS\data\dtm und wird bei Bedarf erstellt.
Beispiel
'C:\DTM' DTM.SET_DATA_DIR [] 
MethodeDTM.DOWNLOAD_DATA [r x1, r y1, r x1, ry2] []
BeschreibungJe nach System werden Daten für den definierten Bereich automatisch heruntergeladen. Wenn auf einem Ziel-System kein Zugang zum Internet besteht, können mit dieser Methode vorgängig auf einem System mit Zugang zum Internet die benötigten DTM-Daten heruntergeladen werden und auf das Ziel-System kopiert werden.
Beispiel
2600000.0 1200000.0 2601000.0 1201000.0 DTM.DOWNLOAD_DATA [] 
MethodeDTM.GET_HEIGHT [r x, r y] [r z]
BeschreibungFür die Koordinate wird die Höhe ermittelt. Ist die Koordinate ausserhalb des Bereiches des DTM wird NULL zurückgegeben.
Beispiel
2662001.0 1230999.0 DTM.GET_HEIGHT [484.70] 
MethodeDTM.SET_HEIGHT_GEOM [g geom] [g geom]
BeschreibungFür alle Punkte der Geometrie werden die Höhen ermittelt und in der Z-Koordinate abgelegt.
Beispiel
VAR.GEOM DTM.SET_HEIGHT_GEOM [g] 

6.3. Spezielles swissALTI3D

Die DTM-Daten für das System swissALTI3D werden bei Bedarf automatisch aus dem Internet heruntergeladen und im Verzeichnis für die DTM Daten abgelegt.

Der Zugang zum INTERNET muss zur Verfügung stehen.

Folgende URL's werden abgesetzt::

First URL

Erste URL mit Bereich BBOX für die Files mit den Daten.

https://data.geo.admin.ch/api/stac/v0.9/collections/ch.swisstopo.swissalti3d/items?bbox=8.431656,47.359670,8.431656,47.359670
Next URL

Nächste URL von "next" aus der Response der letzten URL für die nächsten Files mit den Daten.

Pro URL werden in der Response maximal 100 Files geliefert. Falls weitere Files vorliegen, müssen diese mit der URL aus dem Tag 'next" abgefragt werden.

https://data.geo.admin.ch/api/stac/v0.9/collections/ch.swisstopo.swissalti3d/items?bbox=8.431656,47.359670,8.431656,47.359670&cursor=cD0zMjczMg%3D%3D
Download ZIP URL

Die Response der URL's liefert die Files als URL's. Diese URL's werden abgesetzt und die Files in das DTM-Daten-Verzeichnis heruntergeladen.

https://data.geo.admin.ch/ch.swisstopo.swissalti3d/swissalti3d_2019_2669-1241/swissalti3d_2019_2669-1241_2_2056_5728.xyz.zip

Beispiel Default DTM-Daten-Verzeichnis

ILTOOLSDFA\data\DTM\swissalti3d_2020_2675-1245_2_2056_5728.xyz.zip

Die Daten werden aus dem ZIP-File entzippt.

ILTOOLSDFA\data\DTM\SWISSALTI3D_2_XYZ_CHLV95_LN02_2675_1245.xyz