Esta función define una transformación de datum en el dibujo actual. Si la transformación de datum (sistemas de coordenadas de origen y destino) ya existe, se sobrescribe. La función devolverá la transformación de datum definida.
Sintaxis
(esri_coordsys_DatumTransformations_set FromCS ToCS transformationStep_properties)
Argumentos
- FromCS | cadena de caracteres | obligatorio | WKID (número de identificación de sistema de coordenadas conocido) válido o WKT del sistema de coordenadas de Esri como una cadena de caracteres.
- ToCS | cadena de caracteres | obligatorio | WKID (número de identificación de sistema de coordenadas conocido) válido o WKT del sistema de coordenadas de Esri como una cadena de caracteres.
transformationStep_properties | lista asociada | obligatorio | Una lista de pasos de transformación como listas asociadas de dos propiedades de paso de par con puntos como se define en la siguiente tabla:
Etiqueta asociada Tipo de valor Descripción del valor Obligatorio u opcional "Direction" cadena de caracteres
La dirección del paso, que es "Forward" o 'Reverse, en la que debe aplicarse el paso de transformación.
requerido
"Step"
cadena de caracteres
El WKID o WKT del paso de transformación.
requerido
Uso
Al crear una transformación de datum compuesta, el orden de cada paso debe ser el correcto. Para el ejemplo 2 siguiente, 108355 es el primer paso y 108282 es el segundo y último paso. La dirección debe proporcionarse en forma de una cadena de caracteres "Avanzar" o "Invertir" y no distingue entre mayúsculas y minúsculas.
ArcGIS for AutoCAD no valida los pasos de transformación proporcionados. Si alguna parte del método definido no fuera válida o se aplicara en el orden erróneo, ArcGIS for AutoCAD puede dibujar capas incorrectamente.
Nota:
Al crear texto conocido (WKT) como un argumento de cadena de caracteres AutoLISP, la cadena de caracteres debe contener los caracteres de escape apropiados para incluir las comillas necesarias dentro de la cadena de caracteres de texto. A continuación, se muestran algunos ejemplos:
Sistema de coordenadas:
"PROJCS[\"NAD_1983_HARN_StatePlane_Florida_West_FIPS_0902_Feet\",GEOGCS[\"GCS_North_American_1983_HARN\",DATUM[\"D_North_American_1983_HARN\",SPHEROID[\"GRS_1980\",6378137.0,298.257222101]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Transverse_Mercator\"],PARAMETER[\"False_Easting\",656166.6666666665],PARAMETER[\"False_Northing\",0.0],PARAMETER[\"Central_Meridian\",-82.0],PARAMETER[\"Scale_Factor\",0.9999411764705882],PARAMETER[\"Latitude_Of_Origin\",24.33333333333333],UNIT[\"Foot_US\",0.3048006096012192],AUTHORITY[\"EPSG\",2882]]"
Transformación de datum
"GEOGTRAN[\"WGS_1984_(ITRF00)_To_NAD_1983\",GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],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]],METHOD[\"Coordinate_Frame\"],PARAMETER[\"X_Axis_Translation\",0.9956],PARAMETER[\"Y_Axis_Translation\",-1.9013],PARAMETER[\"Z_Axis_Translation\",-0.5215],PARAMETER[\"X_Axis_Rotation\",0.025915],PARAMETER[\"Y_Axis_Rotation\",0.009426],PARAMETER[\"Z_Axis_Rotation\",0.011599],PARAMETER[\"Scale_Difference\",0.00062],OPERATIONACCURACY[0.1]]"
Ejemplo de uso 1
Intenta definir una transformación de datum de un solo paso en el dibujo actual entre los sistemas de coordenadas de origen y destino definidos por WKID. La lista de pasos incluye un único paso de transformación de datum que hace referencia a WKID y debe aplicarse en el orden de avance.(esri_coordsys_DatumTransformations_set
"2882" "3857"
(list
(list (cons "Direction" "Forward") (cons "Step" 1580))
)
)
Ejemplo de resultado de uso 1
Define la transformación de datum de un único paso en el dibujo actual y devuelve toda la definición de la transformación de datum como una lista asociada.
(("From" . "2882") ("To" . "3857") ("Transformation" ((("Direction" . "Forward") ("Step" . "1580")))))
Ejemplo de uso 2
Intenta definir una transformación de datum compuesta en el dibujo actual entre los sistemas de coordenadas de origen y destino definidos por WKID (números de identificación conocidos). Los pasos de transformación de datum referenciados por valores de cadena de caracteres de WKID se dirigen para su aplicación en orden inverso.(esri_coordsys_DatumTransformations_set
"6425" "3857"
(list
(list (cons "Direction" "Reverse") (cons "Step" 108355))
(list (cons "Direction" "Reverse") (cons "Step" 108282))
)
)
Ejemplo de resultado de uso 2
Define la transformación de datum compuesta de dos pasos en el dibujo actual y devuelve toda la definición de la transformación de datum como una lista asociada.
(("From" . "6425") ("To" . "3857") ("Transformation" ((("Direction" . "Reverse") ("Step" . "108355")) (("Direction" . "Reverse") ("Step" . "108282")))))
Valores de retorno
- La transformación de datum se define y toda la definición de la transformación de datum se devuelve como una lista asociada.
- Si falla la función, se devuelve una lista con el primer valor de nil seguido de una lista asociada que contiene el valor de clave "Error" y un mensaje de error asociado como una cadena de caracteres: (nil ("Error" . "<message>")).
Valores de retorno fallido
Se puede producir un valor de retorno fallido por cualquiera de los siguientes motivos:
- (nil ("Error" . "Failed"))
El WKID o WKT proporcionado no es válido.
- (nil ("Error" . "This document contains existing web feature layers. Datum transformations cannot be modified when web feature layers present."))
Las transformaciones de datum no pueden definirse ni modificarse cuando el dibujo contiene capas de entidades web existentes.
- (nil ("Error" . "Missing required argument."))
No se suministraron uno o más de los argumentos requeridos.