Projektion definieren (Datenmanagement)

Zusammenfassung

Überschreibt die für ein Dataset gespeicherten Informationen des Koordinatensystems (Kartenprojektion und Datum). Dieses Werkzeug wird für Datasets verwendet, deren Koordinatensystem unbekannt oder falsch definiert ist.

Verwendung

  • Alle geographischen Datasets besitzen ein Koordinatensystem, mit dem in ArcGIS geographische Daten angezeigt, gemessen und transformiert werden. Wenn das Koordinatensystem für ein Dataset unbekannt oder falsch ist, können Sie mit diesem Werkzeug das richtige Koordinatensystem angeben.

  • Dieses Werkzeug aktualisiert nur die vorhandenen Informationen zum Koordinatensystem – es ändert keine Geometrie. Um die Geometrie in ein anderes Koordinatensystem zu transformieren, verwenden Sie das Werkzeug Projizieren.

  • Wenn ein Dataset mit einem bekannten Koordinatensystem als Eingabe für dieses Werkzeug verwendet wird, wird zwar eine Warnung ausgegeben, das Werkzeug wird jedoch erfolgreich ausgeführt.

  • Alle Feature-Classes in einem Geodatabase-Feature-Dataset werden in ein Koordinatensystem geschrieben. Das Koordinatensystem für ein Feature-Dataset muss bei der Erstellung festgelegt werden. Sobald ein Feature-Dataset Feature-Classes enthält, kann das Koordinatensystem nicht mehr geändert werden.

  • Das Werkzeug aktualisiert die zugehörige .wld-Datei einer CAD- oder BIM-Datei, um die geographisch angepasste Position der Daten zu erhalten.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Dataset oder -Feature-Class

Das Dataset oder die Feature-Class, dessen bzw. deren Projektion definiert werden soll.

Feature Layer;Geodataset
Koordinatensystem

Das Koordinatensystem, das auf die Eingabe angewendet wird.

Coordinate System

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Eingabe-Dataset oder -Feature-Class aktualisieren

Das aktualisierte Eingabe-Geodataset.

Geodataset

arcpy.management.DefineProjection(in_dataset, coor_system)
NameErläuterungDatentyp
in_dataset

Das Dataset oder die Feature-Class, dessen bzw. deren Projektion definiert werden soll.

Feature Layer;Geodataset
coor_system

Das Koordinatensystem, das auf die Eingabe angewendet wird.

Gültige Werte sind ein SpatialReference-Objekt, eine Datei mit der Erweiterung .prj oder die Zeichenfolgendarstellung eines Koordinatensystems.

Coordinate System

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_dataset

Das aktualisierte Eingabe-Geodataset.

Geodataset

Codebeispiel

DefineProjection – Beispiel (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion DefineProjection im unmittelbaren Modus verwendet wird:

import arcpy
infc = r"C:\data\citylim_unk.shp"
sr = arcpy.SpatialReference("NAD 1983 UTM Zone 11N")
arcpy.DefineProjection_management(infc, sr)
DefineProjection – Beispiel (eigenständiges Skript)

Im folgenden eigenständigen Skript werden mit der Funktion DefineProjection die Informationen des Koordinatensystems für das Eingabe-Dataset aufgezeichnet.

# Name: DefineProjection.py 
# Description: Records the coordinate system information for the specified input dataset or feature class

# import system modules
import arcpy

# set workspace environment
arcpy.env.workspace = "C:/data"

try:
    # set local variables
    in_dataset = "citylim_unk.shp" #"forest.shp"
    
    # get the coordinate system by describing a feature class
    dsc = arcpy.Describe("citylim_utm11.shp")
    coord_sys = dsc.spatialReference
    
    # run the tool
    arcpy.DefineProjection_management(in_dataset, coord_sys)
    
    # print messages when the tool runs successfully
    print(arcpy.GetMessages(0))
    
except arcpy.ExecuteError:
    print(arcpy.GetMessages(2))
    
except Exception as ex:
    print(ex.args[0])