Resumen
Sobrescribe la información del sistema de coordenadas (proyección de mapa y datum) almacenada con un dataset. Esta herramienta se usa para los datasets que tienen definido un sistema de coordenadas desconocido o incorrecto.
Todos los datasets geográficos tienen un sistema de coordenadas que se utiliza a través de ArcGIS para visualizar, medir y transformar datos geográficos. Si el sistema de coordenadas para un dataset es desconocido o incorrecto, puede utilizar esta herramienta para especificar el sistema de coordenadas correcto. Debe conocer el sistema de coordenadas correcto del dataset antes de utilizar esta herramienta.
Uso
Esta herramienta solo actualiza la información del sistema de coordenadas existente, sin modificar ninguna geometría. Si desea transformar la geometría en otro sistema de coordenadas, utilice la herramienta Proyectar.
El uso más común de esta herramienta es asignar un sistema de coordenadas conocido a un dataset con un sistema de coordenadas desconocido (es decir, el sistema de coordenadas es "Desconocido" en las propiedades del dataset). Otro uso es asignar el sistema de coordenadas correcto para un dataset que tiene definido un sistema de coordenadas definido (por ejemplo, las coordenadas están en metros UTM, pero el sistema de coordenadas está definido como geográfico).
Cuando un dataset con un sistema de coordenadas conocido es una entrada a esta herramienta, la herramienta envía una advertencia, pero se ejecuta correctamente.
Todas las clases de entidades en un dataset de entidades de geodatabase estarán en el mismo sistema de coordenadas. El sistema de coordenadas para un dataset de geodatabase se debe determinar cuándo se crea. Una vez que contiene clases de entidades, el sistema de coordenadas no se puede cambiar.
Sintaxis
arcpy.management.DefineProjection(in_dataset, coor_system)
Parámetro | Explicación | Tipo de datos |
in_dataset | El dataset o clase de entidad cuya proyección se va a definir. | Feature Layer;Geodataset |
coor_system | El sistema de coordenadas que se aplica a la entrada. El valor predeterminado se establece según la configuración del entorno del Sistema de coordenadas de salida. Los valores válidos son un objeto de SpatialReference, un archivo con una extensión .prj o una representación de cadena de caracteres de un sistema de coordenadas. | Coordinate System |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_dataset | El geodataset de entrada actualizado. | Geodataset |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función DefineProjection en el modo inmediato.
import arcpy
infc = r"C:\data\citylim_unk.shp"
sr = arcpy.SpatialReference("NAD 1983 UTM Zone 11N")
arcpy.DefineProjection_management(infc, sr)
El siguiente script independiente usa la función DefineProjection para registrar información del sistema de coordenadas para el dataset de entrada.
# 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])
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí