Crear transformación vertical personalizada (Administración de datos)

Resumen

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

Uso

• Todos los archivos de transformación vertical personalizados se guardan con la extensión .vtf 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 verticales inspeccionará todas las transformaciones personalizadas en la ubicación de almacenamiento predeterminada y las presentará como opciones para un parámetro de transformación. El cuadro de diálogo Transformaciones muestra rutas de transformación geográficas y verticales combinadas si es compatible. 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 vertical personalizada y sobrescriba el archivo existente.

• 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\Vertical.
  • 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\Vertical.
  • 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.

• La mayoría de los archivos están en formato binario por razones de rendimiento. El método GEOID, que convierte alturas elipsoidales en alturas geoidales (u otras relacionadas con la gravedad), admite un sencillo formato de archivo ASCII. Este formato de archivo lo utiliza el Servicio Geodésico Nacional de Estados Unidos. La línea de encabezamiento contiene en la esquina inferior izquierda: la latitud mínima seguida de la longitud mínima en grados decimales. No es necesario utilizar el intervalo de longitud 0-360, como se muestra a continuación. Seguidamente se indican las separaciones entre los puntos de latitud y longitud, también en grados decimales. Los siguientes valores son el número de puntos de una fila y una columna. El último valor es un dígito de control y siempre es 1. Los valores de desplazamiento, o separación, son flotantes y en metros. La primera fila comienza con los valores mínimos de latitud y longitud. Las tres primeras líneas siguientes muestran que una fila de valores no tiene por qué ser una sola línea.

      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

• No ajuste ambos sistemas de coordenadas verticales a alturas elipsoidales. Este comportamiento se bloqueará en una futura versión. Convierta alturas elipsoidales como parte de una transformación geográfica (datum).

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Nombre de la transformación vertical	Nombre de la definición de transformación personalizada.	String
Sistema de coordenadas vertical de origen	Indica el sistema de coordenadas verticales de partida. Especifique un Id. conocido (WKID) o utilice el botón Seleccionar sistema de coordenadas para seleccionar un sistema de coordenadas.	String
Sistema de coordenadas vertical del objetivo	Indica el sistema final de coordenadas verticales. Especifique un Id. conocido (WKID) o utilice el botón Seleccionar sistema de coordenadas para seleccionar un sistema de coordenadas.	String
Sistema de coordenadas geográficas de interpolación (Opcional)	Indica el sistema de coordenadas geográficas de interpolación. Este parámetro solo está activo si un método de transformación vertical lo requiere. El sistema de coordenadas geográficas se utiliza cuando se interpolan los valores de desplazamiento de un fichero, o cuando el método requiere coordenadas de latitud y longitud. Los métodos que no requieren un sistema de coordenadas geográficas de interpolación son Nulo, Cambio de unidad, Inversión de profundidad de altura y Desplazamiento vertical. Especifique un Id. conocido (WKID) o utilice el botón Seleccionar sistema de coordenadas para seleccionar un sistema de coordenadas.	Coordinate System
Método de transformación vertical (Opcional)	Indica el método de transformación vertical En la lista desplegable, elija el método de transformación que se utilizará para transformar los datos del sistema de coordenadas verticales de entrada al sistema de coordenadas verticales de salida. Una vez elegido, sus parámetros aparecerán en la tabla para su edición. Para obtener una lista de los métodos y parámetros, consulte el documentoPDF de transformaciones geográficas y verticales. Si utiliza un método que requiere un archivo, consulte las Notas de uso para saber dónde colocar el archivo o archivos.	String
Extensión (Opcional)	Ámbito en el que es aplicable la transformación. Utilice WGS84 (WKID: 4326) u otro sistema de coordenadas geográficas basado en GNSS como NAD 1983 o GDA2020 para el sistema de coordenadas de extensión. Si se proporciona un sistema de coordenadas proyectadas o una capa que tenga un sistema de coordenadas proyectadas, los valores se convertirán a latitud y longitud. Extensión de visualización actual : la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo. Extensión de dibujo : la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa. Nota: Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta. Nota: Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión. Extensión de mapa : la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas. Cada capa de mapas tiene las opciones siguientes: Todas las entidades : extensión de todas las entidades en una capa. Entidades seleccionadas: extensión de las entidades seleccionadas en la capa. Entidades visibles : extensión de las entidades visibles en la capa. Nota: Las extensiones de las opciones Entidades seleccionadas y Entidades visibles solo están disponibles para capas de entidades. Examinar : la extensión se basará en un dataset existente. Portapapeles : la extensión puede copiarse y pegarse desde el portapapeles. Copiar extensión : copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles. Usar Pegar extensión : pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa. Nota: Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial. Restablecer extensión : la extensión se restablecerá al valor predeterminado. Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. Precaución: El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.	Extent
Precisión (Opcional)	Declaración general de precisión 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.CreateCustomVerticalTransformation(vt_name, source_vt_coor_system, target_vt_coor_system, {interpolation_gcs}, {custom_vt}, {extent}, {accuracy})

Nombre	Explicación	Tipo de datos
vt_name	Nombre de la definición de transformación personalizada.	String
source_vt_coor_system	Indica el sistema de coordenadas verticales de partida.	String
target_vt_coor_system	Indica el sistema final de coordenadas verticales.	String
interpolation_gcs (Opcional)	Indica el sistema de coordenadas geográficas de interpolación. Este parámetro solo está activo si un método de transformación vertical lo requiere. El sistema de coordenadas geográficas se utiliza cuando se interpolan los valores de desplazamiento de un fichero, o cuando el método requiere coordenadas de latitud y longitud. Los métodos que no requieren un sistema de coordenadas geográficas de interpolación son Nulo, Cambio de unidad, Inversión de profundidad de altura y Desplazamiento vertical.	Coordinate System
custom_vt (Opcional)	Indica el método de transformación vertical En la lista desplegable, elija el método de transformación que se utilizará para transformar los datos del sistema de coordenadas verticales de entrada al sistema de coordenadas verticales de salida. Una vez elegido, sus parámetros aparecerán en la tabla para su edición. Para obtener una lista de los métodos y parámetros, consulte el documentoPDF de transformaciones geográficas y verticales. Si utiliza un método que requiere un archivo, consulte las Notas de uso para saber dónde colocar el archivo o archivos.	String
extent (Opcional)	Ámbito en el que es aplicable la transformación. Utilice WGS84 (WKID: 4326) u otro sistema de coordenadas geográficas basado en GNSS como NAD 1983 o GDA2020 para el sistema de coordenadas de extensión. Si se proporciona un sistema de coordenadas proyectadas o una capa que tenga un sistema de coordenadas proyectadas, los valores se convertirán a latitud y longitud. MAXOF: se usará la extensión máxima de todas las entradas. MINOF: se usará el área mínima común a todas las entradas. DISPLAY: la extensión es igual a la visualización visible. Nombre de capa: se utilizará la extensión de la capa especificada. Objeto de Extent: se utilizará la extensión del objeto especificado. Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.	Extent
accuracy (Opcional)	Declaración general de precisión 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 CreateCustomVerticalTransformation (ventana de Python)

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

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
)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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