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

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

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

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

• Esta herramienta ofrece varios métodos de transformación vertical de uso común, incluidos GEOID, Desplazamiento vertical y Desplazamiento vertical con cuadrícula. Algunos métodos se basan en ecuaciones, pero la mayoría, como GEOID o Desplazamiento vertical con cuadrícula, requieren un archivo de datos. Este archivo puede estar en formato binario o ASCII. Por razones de rendimiento, es preferible un formato binario.

  Los formatos de archivo admitidos actualmente en ArcGIS Pro son los siguientes:

  • EGM84 y EGM96 emitidos por la National Geospatial-Intelligence Agency
  • GEOID, VDATUM, VERTCON y VERTCON3 emitidos por el Servicio Geodésico Nacional de NOAA

• El método GEOID, que convierte las alturas elipsoidales en alturas relacionadas con la gravedad, y el método Desplazamiento verticla con cuadrícula, que convierte entre dos sistemas de alturas relacionadas con la gravedad, admiten un sencillo formato de archivo ASCII. Este formato de archivo lo utiliza el Servicio Geodésico Nacional de NOAA. 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. El siguiente conjunto de 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

• Si se utiliza un método basado en archivos, debe indicarse el método de interpolación adecuado. La herramienta incorpora varios métodos de interpolación.

• Si la transformación vertical utiliza un método que requiere uno o varios archivos, colóquelos 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.

• Esta herramienta solo permite crear definiciones de transformación que conviertan entre alturas elipsoidales y alturas relacionadas con la gravedad o entre dos alturas relacionadas con la gravedad. No permite establecer los sistemas de coordenadas verticales de origen y destino en sistemas de altura elipsoidal al mismo tiempo. Para convertir entre sistemas de alturas elipsoidales, utilice la herramienta Crear transformación geográfica personalizada.

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 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 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)	Método de transformación vertical que se utilizará. 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)	Área en la 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. 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)	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)	Método de transformación vertical que se utilizará. 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)	Área en la 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í