Benutzerdefinierte geographische Transformation erstellen (Data Management Tools)

Zusammenfassung

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

Verwendung

Alle Dateien für benutzerdefinierte geographische Transformationen werden mit der Erweiterung .gtf 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.
Alle Geoverarbeitungswerkzeuge, die geographische Transformationen verwenden, untersuchen sämtliche benutzerdefinierten Transformationen am Standardspeicherort und zeigen diese in der Dropdown-Liste des Transformationsparameters an. Die Transformationen sind auch in der Umgebungseinstellung "Geographische Transformationen" verfügbar.
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 geographische Transformation, und überschreiben Sie die vorhandene Datei.
Transformation methods are divided into two groups: equation based and file based. Equation-based methods do not need external information. File-based methods require a file or files that are stored on disk to calculate the coordinate offset values. The files are similar to rasters— enthalten Punkte in regelmäßigen Abständen. Der Versatz für eine Position wird mithilfe einer Interpolationsmethode auf Basis von Werten der umgebenden Punkte berechnet.
Die Dateien müssen an einem der folgenden Speicherorte abgelegt werden:
- 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\\Geographic.
- 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\\Geographic.
- 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.

Beschriftung	Erläuterung	Datentyp
Name von geographischer Transformation	Der Name der Definition der benutzerdefinierten Transformation.	String
Geographisches Eingabe-Koordinatensystem	Das geographische Ausgangskoordinatensystem. Es muss sich um ein geographisches Koordinatensystem handeln, ein projiziertes Koordinatensystem ist ungültig. Geben Sie eine "Well Known ID" (WKID) an, oder verwenden Sie die Schaltfläche Koordinatensystem auswählen , um ein Koordinatensystem auszuwählen.	Coordinate System
Geographisches Ausgabe-Koordinatensystem	Das endgültige geographische Koordinatensystem. Es muss sich um ein geographisches Koordinatensystem handeln, ein projiziertes Koordinatensystem ist ungültig. Geben Sie eine WKID an, oder verwenden Sie die Schaltfläche Koordinatensystem auswählen , um ein Koordinatensystem auszuwählen. Die als Eingabe bzw. als Ausgabe verwendeten Koordinatensysteme können nicht identisch sein.	Coordinate System
Benutzerdefinierte geographische Transformation	Die für die benutzerdefinierte Transformation verwendete Methode. Eine Liste der Methoden und Parameter ist im PDF "Geographic and Vertical Transformations pdf" verfügbar. Wählen Sie in der Dropdown-Liste die Transformationsmethode aus, die zum Transformieren der Daten aus dem geographischen Eingabekoordinatensystem in das geographische Ausgabekoordinatensystem verwendet wird. Nach der Auswahl werden unter der Transformationsmethode weitere Optionen angezeigt.	String
Ausdehnung (Optional)	Der geographische Bereich, auf den die Transformation angewendet wird. Transformierte Daten, die innerhalb der festgelegten Ausdehnung liegen, werden auf jeden Fall mit der angegebenen Genauigkeit 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 (Accuracy) (Optional)	Die erwartete Differenz zwischen den transformierten Koordinaten (Ausgabekoordinaten) und den tatsächlichen Werten. Da jede Transformation die Qualität eines Datasets verschlechtert, entspricht der Genauigkeitswert stets dem zu erwartenden maximalen absoluten Fehler in Metern.	Double

Abgeleitete Ausgabe

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

arcpy.management.CreateCustomGeoTransformation(geot_name, in_coor_system, out_coor_system, custom_geot, {extent}, {accuracy})

Name	Erläuterung	Datentyp
geot_name	Der Name der Definition der benutzerdefinierten Transformation.	String
in_coor_system	Das geographische Ausgangskoordinatensystem. Es muss sich um ein geographisches Koordinatensystem handeln, ein projiziertes Koordinatensystem ist ungültig.	Coordinate System
out_coor_system	Das endgültige geographische Koordinatensystem. Es muss sich um ein geographisches Koordinatensystem handeln, ein projiziertes Koordinatensystem ist ungültig. Die als Eingabe bzw. als Ausgabe verwendeten Koordinatensysteme können nicht identisch sein.	Coordinate System
custom_geot	Die für die benutzerdefinierte Transformation verwendete Methode. Eine Liste der Methoden und Parameter ist im PDF "Geographic and Vertical Transformations pdf" verfügbar. Legen Sie die Werte für `METHOD` und `PARAMETER` in einer Zeichenfolge für die benutzerdefinierte Transformation `GEOGTRAN` fest. Legen Sie als Namen der Methode eine der verfügbaren Methoden `Geocentric_Translation`, `Molodensky`, `Molodensky_Abridged`, `Position_Vector`, `Coordinate_Frame`, `Molodensky_Badekas`, `NADCON`, `HARN`, `NTV2`, `Longitude_Rotation`, `Unit_Change` und `Geographic_2D_Offset` fest. Jede Methode verfügt über verschiedene Parameter. Sie können die Optionswerte bearbeiten, indem Sie innerhalb der gesamten Zeichenfolge der benutzerdefinierten geographischen Transformation neben dem Namen des Parameters Text eingeben. Beispiele hierfür finden Sie im folgenden Python-Beispiel.	String
extent (Optional)	Der geographische Bereich, auf den die Transformation angewendet wird. Transformierte Daten, die innerhalb der festgelegten Ausdehnung liegen, werden auf jeden Fall mit der angegebenen Genauigkeit 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. Eine durch Leerzeichen getrennte Zeichenfolge von Koordinaten: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Koordinaten werden im Format X-Min, Y-Min, X-Max, Y-Max angegeben.	Extent
accuracy (Optional)	Die erwartete Differenz zwischen den transformierten Koordinaten (Ausgabekoordinaten) und den tatsächlichen Werten. Da jede Transformation die Qualität eines Datasets verschlechtert, entspricht der Genauigkeitswert stets dem zu erwartenden maximalen absoluten Fehler in Metern.	Double

Abgeleitete Ausgabe

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

Codebeispiel

CreateCustomGeoTransformation Beispiel (eigenständiges Skript)

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

# Name: CreateCustomGeographicTransformation.py
# Description: Create a custom geographic transformation in the default directory.

# import system modules
import arcpy

# set the variables
geoTransfmName = "cgt_geocentric2"

# create a spatial reference object for GCS_Tokyo
inGCS = arcpy.SpatialReference("Tokyo")

# create a spatial reference object for GCS_WGS_1984
outGCS = arcpy.SpatialReference("WGS 1984")

customGeoTransfm = "GEOGTRAN[METHOD['Geocentric_Translation'],PARAMETER['X_Axis_Translation',''],PARAMETER['Y_Axis_Translation',''],PARAMETER['Z_Axis_Translation','']]"

arcpy.management.CreateCustomGeoTransformation(geoTransfmName, inGCS, outGCS, customGeoTransfm)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Benutzerdefinierte geographische Transformation erstellen (Data Management Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen