Benutzerdefinierte vertikale Transformation erstellen (Data Management)

Zusammenfassung

Erstellt eine Transformationsdefinition für die Konvertierung von Daten zwischen zwei vertikalen Koordinatensystemen oder Datumsangaben. Die Ausgabe dieses Werkzeugs kann als Transformationsobjekt für alle Werkzeuge mit einem Parameter verwendet werden, der eine vertikale Transformation erfordert.

Verwendung

• Alle Geoverarbeitungswerkzeuge, die vertikale Transformationen verwenden, untersuchen sämtliche benutzerdefinierten Transformationen am Standardspeicherort und zeigen diese als Optionen für einen Transformationsparameter an. Im Dialogfeld Transformationen werden kombinierte geographische und vertikale Transformationspfade angezeigt, wenn diese unterstützt werden. Die Transformationen sind auch in der Umgebungseinstellung Geographische Transformationen verfügbar.

• Alle Dateien für benutzerdefinierte vertikale Transformationen werden mit der Erweiterung .vtf gespeichert und im Ordner Esri\ArcGISPro\ArcToolbox\CustomTransformations Ihres Ordners für Anwendungsdaten abgelegt.

  • In allen Windows-Betriebssystemen befindet sich der Ordner "AppData" in %appdata% und der Temp-Ordner in %temp%. Durch Eingabe von %appdata% in einem Befehlsfenster wird der Speicherort von "AppData" zurückgegeben. Durch Eingabe von %temp% wird der Speicherort des Ordners "Temp" zurückgegeben.
  • In UNIX-Systemen befinden sich die Ordner "tmp" und "application data" in Ihrem Stammverzeichnis unter $TMP bzw. $HOME. Durch Eingabe von /tmp in ein Terminal wird der Speicherort zurückgegeben.

• Benutzerdefinierte geographische Transformationen können nicht bearbeitet werden. Es handelt sich um Binärdateien, in denen Informationen zur Version und zur Zeichenfolgenlänge gespeichert sind, die durch eine Änderung beschädigt werden können. Erstellen Sie zum Aktualisieren einer Transformationsdatei eine neue benutzerdefinierte vertikale Transformation, und überschreiben Sie die vorhandene Datei.

• Dieses Werkzeug bietet verschiedene häufig verwendete Methoden der vertikalen Transformation wie "GEOID", "Vertikaler Versatz" und "Vertikaler Versatz mit Grid". Einige Methoden sind gleichungsbasiert, für die meisten (wie etwa für "GEOID" und "Vertikaler Versatz mit Grid") ist jedoch eine Datendatei erforderlich. Diese Datei kann in einem binären Format oder im ASCII-Format vorliegen. Aus Gründen der Performance ist ein Binärformat am besten geeignet.

  Folgende Dateiformate werden derzeit in ArcGIS Pro unterstützt:

  • EGM84 und EGM96 von der National Geospatial-Intelligence Agency
  • GEOID, VDATUM, VERTCON und VERTCON3 von der NOAA's National Geodetic Survey

• Die GEOID-Methode, mit der Ellipsoidhöhen in schwerkraftabhängige Höhen konvertiert werden, und die Methode "Vertikaler Versatz mit Grid", mit der schwerkraftabhängige Höhen zweier verschiedener Systeme in das jeweils andere System konvertiert werden, unterstützen ein einfaches ASCII-Dateiformat. Das Dateisystem wird von der NOAA's National Geodetic Survey verwendet. Die Kopfzeile enthält die linke untere Ecke: minimaler Breitengrad gefolgt vom minimalen Längengrad in Dezimalgrad. Sie müssen nicht den unten gezeigten Längengradbereich 0-360 verwenden. Als Nächstes folgen die Längen- und Breitengradtrennungen, ebenfalls in Dezimalgrad. Die nächsten Werte beziehen sich auf die Anzahl der Punkte in einer Zeile und einer Spalte. Der letzte Wert ist eine Prüfziffer und lautet immer 1. Die Werte für den Versatz (oder die Trennung) sind Fließkommazahlen, die in Meter angegeben werden. Die erste Zeile beginnt mit den minimalen Breitengrad- und Längengradwerten. Die ersten drei Zeilen unten zeigen, dass eine Zeile mit Werten nicht eine einzelne Zeile sein muss.

      15.000000000000    291.00000000000    0.1666666666667E-01    0.1666666666665E-01    361   301  1
    -29.2936  -29.3314  -29.3710  -29.4121  -29.4540  -29.4965  -29.5382  -29.5807
    -29.6233  -29.6660  -29.7090  -29.7522  -29.7956  -29.8397  -29.8846  -29.9301

• Bei Verwendung einer dateibasierten Methode muss eine geeignete Interpolationsmethode angegeben werden. In dem Werkzeug sind verschiedene integrierte Interpolationsmethoden verfügbar.

• Wenn für die vertikale Transformation eine Methode verwendet wird, für die eine oder mehrere Dateien erforderlich sind, speichern Sie diese an einem der folgenden Speicherorte:

  • Wenn ArcGIS Coordinate Systems Data pro Computer (für alle Benutzer) installiert sind, kopieren Sie die Dateien in den Ordner C:\Program Files (x86)\ArcGIS\CoordinateSystemsData\pedata\Vertical.
  • Wenn ArcGIS Coordinate Systems Data pro Benutzer installiert sind, kopieren Sie die Dateien in den Ordner C:\Users\username\AppData\Local\Programs\ArcGIS\CoordinateSystemsData\pedata\Vertical.
  • Wenn keine ArcGIS Coordinate Systems Data installiert sind und ArcGIS Pro pro Computer (für alle Benutzer) installiert ist, kopieren Sie die Dateien in den ArcGIS Pro-Ordner "pedata" unter C:\Program Files\ArcGIS\Pro\Resources\pedata.
  • Wenn ArcGIS Pro pro Benutzer installiert ist, kopieren Sie die Dateien in den ArcGIS Pro-Ordner "pedata" unter C:\Users\username\AppData\Local\Programs\ArcGIS\Pro\Resources\pedata.

  Wenn Sie für ArcGIS Pro oder die ArcGIS Coordinate Systems Data nicht die Standardinstallationsspeicherorte verwendet haben, kopieren Sie die Dateien in den entsprechenden Ordner "pedata". Wenn diese Speicherorte aufgrund von Berechtigungseinschränkungen nicht verfügbar sind oder ausgeblendet sind, bitten Sie den Systemadministrator um Hilfe.

• Mit diesem Werkzeug können nur Transformationsdefinitionen für die Konvertierung zwischen Ellipsoidhöhen und schwerkraftabhängigen Höhen oder zwischen zwei schwerkraftabhängigen Höhen erstellt werden. Es ist nicht möglich, sowohl für das vertikale Quell- als auch für das vertikale Zielkoordinatensystem gleichzeitig Ellipsoidhöhensysteme festzulegen. Verwenden Sie für die Konvertierung zwischen Ellipsoidhöhensystemen das Werkzeug Benutzerdefinierte geographische Transformation erstellen.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Name der vertikalen Transformation	Der Name der Definition der benutzerdefinierten Transformation.	String
Vertikales Ausgangskoordinatensystem	Das vertikale Ausgangskoordinatensystem. Geben Sie eine "Well Known ID" (WKID) an, oder verwenden Sie die Schaltfläche Koordinatensystem auswählen , um ein Koordinatensystem auszuwählen.	String
Vertikales Zielkoordinatensystem	Das endgültige vertikale Koordinatensystem. Geben Sie eine WKID an, oder verwenden Sie die Schaltfläche Koordinatensystem auswählen , um ein Koordinatensystem auszuwählen.	String
Geographisches Koordinatensystem der Interpolation (optional)	Das geographische Koordinatensystem der Interpolation. Dieser Parameter ist nur aktiv, wenn er für eine Methode für die vertikale Transformation erforderlich ist. Das geographische Koordinatensystem wird verwendet, wenn die Versatzwerte aus einer Datei interpoliert werden oder wenn für die Methode Breitengrad- und Längengradkoordinaten erforderlich sind. Für die folgenden Methoden ist kein geographisches Koordinatensystem der Interpolation erforderlich: NULL, Einheitenänderung, Umkehr von Höhe/Tiefe und Vertikaler Versatz. Geben Sie eine WKID an, oder verwenden Sie die Schaltfläche Koordinatensystem auswählen , um ein Koordinatensystem auszuwählen.	Coordinate System
Methode der vertikalen Transformation (optional)	Die Methode der vertikalen Transformation, die verwendet werden soll. Wählen Sie in der Dropdown-Liste die Transformationsmethode aus, die zum Transformieren der Daten aus dem vertikalen Eingabekoordinatensystem in das vertikale Ausgabekoordinatensystem verwendet wird. Nach der Auswahl werden die zugehörigen Parameter in der Tabelle angezeigt und können dort bearbeitet werden. Eine Liste der Methoden und Parameter finden Sie imPDF "Geographic and Vertical Transformations". Wenn Sie eine Methode verwenden, für die eine Datei erforderlich ist, erfahren Sie in den Verwendungshinweisen, wo Sie die Dateien ablegen müssen.	String
Ausdehnung (optional)	Die Fläche, auf die die Transformation angewendet wird. Verwenden Sie WGS84 (WKID: 4326) oder ein anderes GNSS-basiertes geographisches Koordinatensystem wie NAD 1983 oder GDA2020 für das Ausdehnungskoordinatensystem. Wenn ein projiziertes Koordinatensystem oder ein Layer mit einem projizierten Koordinatensystem angegeben wird, werden die Werte in Breitengrad und Längengrad konvertiert. Aktuelle Anzeigeausdehnung : Die Ausdehnung basiert auf der aktiven Karte oder Szene. Ausdehnung darstellen : Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Ausdehnung eines Layers: Die Ausdehnung basiert auf einem aktiven Karten-Layer. Wählen Sie einen verfügbaren Layer aus, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern. Jeder Karten-Layer bietet die folgenden Optionen: Alle Features : Die Ausdehnung aller Features. Ausgewählte Features : Die Ausdehnung der ausgewählten Features. Sichtbare Features : Die Ausdehnung sichtbarer Features. Durchsuchen : Die Ausdehnung basiert auf einem Dataset. Zwischenablage : Die Ausdehnung kann in die und aus der Zwischenablage kopiert werden. Ausdehnung kopieren : Kopiert die Ausdehnung und das Koordinatensystem in die Zwischenablage. Ausdehnung einfügen : Fügt die Ausdehnung und das Koordinatensystem aus der Zwischenablage ein. Wenn die Zwischenablage kein Koordinatensystem enthält, wird für die Ausdehnung das Koordinatensystem der Karte verwendet. Ausdehnung zurücksetzen: Die Ausdehnung wird auf den Standardwert zurückgesetzt. Wenn die Koordinaten manuell eingegeben wurden, dann müssen die Koordinaten numerische Werte sein und im Koordinatensystem der aktiven Karte liegen. Die Karte kann statt der angegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.	Extent
Genauigkeit (optional)	Eine allgemeine Angabe der Genauigkeit in Metern.	Double

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Transformation	Die Ausgabe-Transformation.	Value Table

Python

arcpy.management.CreateCustomVerticalTransformation(vt_name, source_vt_coor_system, target_vt_coor_system, {interpolation_gcs}, {custom_vt}, {extent}, {accuracy})

Name	Erläuterung	Datentyp
vt_name	Der Name der Definition der benutzerdefinierten Transformation.	String
source_vt_coor_system	Das vertikale Ausgangskoordinatensystem.	String
target_vt_coor_system	Das endgültige vertikale Koordinatensystem.	String
interpolation_gcs (optional)	Das geographische Koordinatensystem der Interpolation. Dieser Parameter ist nur aktiv, wenn er für eine Methode für die vertikale Transformation erforderlich ist. Das geographische Koordinatensystem wird verwendet, wenn die Versatzwerte aus einer Datei interpoliert werden oder wenn für die Methode Breitengrad- und Längengradkoordinaten erforderlich sind. Für die folgenden Methoden ist kein geographisches Koordinatensystem der Interpolation erforderlich: NULL, Einheitenänderung, Umkehr von Höhe/Tiefe und Vertikaler Versatz.	Coordinate System
custom_vt (optional)	Die Methode der vertikalen Transformation, die verwendet werden soll. Wählen Sie in der Dropdown-Liste die Transformationsmethode aus, die zum Transformieren der Daten aus dem vertikalen Eingabekoordinatensystem in das vertikale Ausgabekoordinatensystem verwendet wird. Nach der Auswahl werden die zugehörigen Parameter in der Tabelle angezeigt und können dort bearbeitet werden. Eine Liste der Methoden und Parameter finden Sie imPDF "Geographic and Vertical Transformations". Wenn Sie eine Methode verwenden, für die eine Datei erforderlich ist, erfahren Sie in den Verwendungshinweisen, wo Sie die Dateien ablegen müssen.	String
extent (optional)	Die Fläche, auf die die Transformation angewendet wird. Verwenden Sie WGS84 (WKID: 4326) oder ein anderes GNSS-basiertes geographisches Koordinatensystem wie NAD 1983 oder GDA2020 für das Ausdehnungskoordinatensystem. Wenn ein projiziertes Koordinatensystem oder ein Layer mit einem projizierten Koordinatensystem angegeben wird, werden die Werte in Breitengrad und Längengrad konvertiert. MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet. MINOF: Die minimale gemeinsame Fläche aller Eingaben wird verwendet. DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige. Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet. Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet. Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt.	Extent
accuracy (optional)	Eine allgemeine Angabe der Genauigkeit in Metern.	Double

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_transformation	Die Ausgabe-Transformation.	Value Table

Codebeispiel

CreateCustomVerticalTransformation: Beispiel (Python-Fenster)

Im folgenden eigenständigen Skript wird die Funktion CreateCustomVerticalTransformation verwendet, um eine benutzerdefinierte vertikale Transformation zu erstellen.

import arcpy
arcpy.management.CreateCustomVerticalTransformation(
    vt_name="NAD_1983_2011_ellipsoid_to_GEOID18b",
    source_vt_coor_system='VERTCS["NAD_1983_2011",DATUM["D_NAD_1983_2011",SPHEROID["GRS_1980",6378137.0,298.257222101]],PARAMETER["Vertical_Shift",0.0],PARAMETER["Direction",1.0],UNIT["Meter",1.0]]',
    target_vt_coor_system='VERTCS["NAVD88_height_(ftIntl)",VDATUM["North_American_Vertical_Datum_1988"],PARAMETER["Vertical_Shift",0.0],PARAMETER["Direction",1.0],UNIT["Foot",0.3048]]',
    interpolation_gcs='GEOGCS["GCS_NAD_1983_2011",DATUM["D_NAD_1983_2011",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]',
    custom_vt="GEOID|g2018u0.bin|Bilinear",
    extent='-110 30 -80 40 GEOGCS["GCS_North_American_1983",DATUM["D_North_American_1983",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]',
    accuracy=0.5
)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

• Basic: Ja
• Standard: Ja
• Advanced: Ja