Crear transformación geográfica personalizada (Administración de datos)

Resumen

Crea una definición de transformación para convertir los datos entre dos sistemas de coordenadas geográficas o datums. La salida de esta herramienta puede utilizarse como transformación para cualquier herramienta con un parámetro que requiera una transformación geográfica.

Uso

• Todos los archivos de transformación geográfica personalizados se guardan con la extensión .gtf y se almacenan en la carpeta Esri\ArcGISPro\ArcToolbox\CustomTransformations dentro de la carpeta de datos de la aplicación.

  • En todos los sistemas operativos Windows, la carpeta AppData se encuentra en %appdata% y la carpeta temp se encuentra en %temp%. La ubicación de la carpeta AppData se obtiene introduciendo %appdata% en una ventana de comandos. Si se escribe %temp%, se muestra la ubicación de la carpeta temporal.
  • En sistemas UNIX, las carpetas tmp y application data se ecuentran en su directorio inicial, en $TMP y $HOME, respectivamente. Al introducir /tmp en un terminal se muestra la ubicación de la carpeta temporal.

• Cualquier herramienta de geoprocesamiento que utilice transformaciones geográficas inspeccionará todas las transformaciones personalizadas en la ubicación de almacenamiento predeterminada y las presentará como opciones en la lista desplegable del parámetro de transformación. Las transformaciones también estarán disponibles en el entorno Transformaciones geográficas.

• No es posible editar archivos de transformaciones personalizadas. Son archivos binarios que almacenan información sobre la versión y la longitud de las cadenas de caracteres, que pueden resultar dañados si se modifican. Para actualizar un archivo de transformación, cree una nueva transformación geográfica personalizada y sobrescriba el archivo existente.

• Los métodos de transformación se dividen en dos grupos: basados en ecuaciones y basados en archivos. Los métodos basados en ecuaciones no necesitan información externa. Los métodos basados en archivos requieren uno o varios archivos almacenados en disco para calcular los valores de desplazamiento de coordenadas. Los archivos son similares a los rásteres, con puntos espaciados uniformemente, y el desplazamiento de una ubicación se calcula utilizando un método de interpolación y los valores de los puntos circundantes.

• Los archivos deben colocarse en una de las siguientes ubicaciones:

  • Si ArcGIS Coordinate Systems Data está instalado por máquina (para todos), copie el archivo o archivos en la carpeta C:\Program Files (x86)\ArcGIS\CoordinateSystemsData\pedata\Geographic.
  • Si ArcGIS Coordinate Systems Data está instalado por usuario, copie el archivo o archivos en la carpeta C:\Users\username\AppData\Local\Programs\ArcGIS\CoordinateSystemsData\pedata\Geographic.
  • Si ArcGIS Coordinate Systems Data no está instalado, copie el archivo o archivos en la carpeta pedata de ArcGIS Pro en C:\Program Files\ArcGIS\Pro\Resources\pedata si ArcGIS Pro está instalado por máquina (para todos).
  • Si ArcGIS Pro está instalado por usuario, copie el archivo o archivos en la carpeta pedate de ArcGIS Pro en C:\Users\username\AppData\Local\Programs\ArcGIS\Pro\Resources\pedata.

  Si no ha utilizado las ubicaciones de instalación predeterminadas para ArcGIS Pro o para ArcGIS Coordinate Systems Data, copie los archivos en la carpeta pedata equivalente. Si estas ubicaciones no están disponibles debido a restricciones de permisos o están ocultas, pida ayuda al administrador del sistema.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Nombre de transformación geográfica	Nombre de la definición de transformación personalizada.	String
Sistema de coordenadas geográficas de entrada	Sistema de coordenadas geográficas de partida. Especifique un Id. conocido (WKID) o utilice el botón Seleccionar sistema de coordenadas para seleccionar un sistema de coordenadas.	Coordinate System
Sistema de coordenadas geográficas de salida	Sistema de coordenadas geográficas final. Especifique un WKID o utilice el botón Seleccionar sistema de coordenadas para seleccionar un sistema de coordenadas.	Coordinate System
Transformación geográfica personalizada	Método de transformación personalizado que se utilizará. Para obtener una lista de los métodos y parámetros, consulte el documentoPDF de transformaciones geográficas y verticales. En la lista desplegable, elija el método de transformación que se utilizará para transformar los datos del sistema de coordenadas geográficas de entrada al sistema de coordenadas geográficas de salida. Una vez elegido, aparecerán opciones adicionales debajo del método de transformación.	String
Extent (Opcional)	Área geográfica en la que es aplicable la transformación. Se garantiza que los datos transformados dentro de la extensión proporcionada se convierten con el nivel de precisión especificado. Extensión de visualización actual : la extensión se basará en el mapa o la escena activa. Extensión de dibujo : la extensión se basará en un rectángulo dibujado en el mapa o la escena. Extensión de mapa : la extensión se basará en una capa de mapa activa. Elija una capa disponible o utilice la opción Extensión de datos en todas las capas. Cada capa de mapas tiene las opciones siguientes: Todas las entidades : extensión de todas las entidades. Entidades seleccionadas : extensión de las entidades seleccionadas. Entidades visibles : extensión de las entidades visibles. Examinar : la extensión se basará en un dataset. Portapapeles : la extensión puede copiarse en y desde el portapapeles. Copiar extensión : copia la extensión y el sistema de coordenadas en el portapapeles. Pegar extensión : pega la extensión y el sistema de coordenadas desde el portapapeles. Si el portapapeles no incluye un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa. Restablecer extensión : la extensión se restablecerá al valor predeterminado. Cuando las coordenadas se proporcionan de forma manual, las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. El mapa podría utilizar unidades de visualización distintas de las coordenadas proporcionadas. Utilice un valor de signo negativo para las coordenadas sur y oeste.	Extent
Precisión (Opcional)	Diferencia esperada entre las coordenadas transformadas (de salida) y sus valores reales. Dado que, en general, cualquier transformación degrada la calidad del conjunto de datos, el valor de precisión es siempre el máximo error absoluto esperado en metros.	Double

Salida derivada

Etiqueta	Explicación	Tipo de datos
Transformación de salida	Indica la transformación de salida.	Value Table

Python

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

Nombre	Explicación	Tipo de datos
geot_name	Nombre de la definición de transformación personalizada.	String
in_coor_system	Sistema de coordenadas geográficas de partida.	Coordinate System
out_coor_system	Sistema de coordenadas geográficas final.	Coordinate System
custom_geot	Método de transformación personalizado que se utilizará. Para obtener una lista de los métodos y parámetros, consulte el documentoPDF de transformaciones geográficas y verticales. Establezca los valores de METHOD y PARAMETER en una cadena de caracteres para la transformación personalizada GEOGTRAN. Establezca el nombre del método entre los métodos disponibles: Geocentric_Translation, Molodensky, Molodensky_Abridged, Position_Vector, Coordinate_Frame, Molodensky_Badekas, NADCON, HARN, NTV2, Longitude_Rotation, Unit_Change y Geographic_2D_Offset. Cada método tiene un conjunto de parámetros. Puede editar los valores de las opciones introduciendo texto junto al nombre del parámetro dentro de la representación de cadena completa de la transformación geográfica personalizada. Consulte ejemplos en el ejemplo de Python a continuación.	String
extent (Opcional)	Área geográfica en la que es aplicable la transformación. Se garantiza que los datos transformados dentro de la extensión proporcionada se convierten con el nivel de precisión especificado.	Extent
accuracy (Opcional)	Diferencia esperada entre las coordenadas transformadas (de salida) y sus valores reales. Dado que, en general, cualquier transformación degrada la calidad del conjunto de datos, el valor de precisión es siempre el máximo error absoluto esperado en metros.	Double

Salida derivada

Nombre	Explicación	Tipo de datos
out_transformation	Indica la transformación de salida.	Value Table

Muestra de código

Ejemplo de CreateCustomGeoTransformation (secuencia de comandos independiente)

La secuencia de comandos independiente siguiente utiliza la función CreateCustomGeoTransformation para crear una transformación personalizada.

# 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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí