La función esri_coordsys_DatumTransformation_set 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_DatumTransformation_set FromCS ToCS transformationStep_properties)
Argumentos
- FromCS | cadena de caracteres | obligatorio | Número de identificación conocido (WKID) válido del sistema de coordenadas de Esri como una cadena de caracteres.
- ToCS | cadena de caracteres | obligatorio | Número de identificación conocido (WKID) válido 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
Dirección del paso, que es "Forward" o "Reverse", en la que debe aplicarse el paso de transformación.
Requerido
"Step"
cadena
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. En el ejemplo de uso 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 "Forward" o "Reverse", que 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 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 en 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
Defina 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_DatumTransformation_set
"2882" "3857"
(list
(list (cons "Direction" "Forward") (cons "Step" 1580))
)
)
Ejemplo de resultado de uso 1
La transformación de datum de un único paso se define en el dibujo actual y toda la definición de la transformación de datum se devuelve como una lista asociada.
(("From" . "2882") ("To" . "3857") ("Transformation" ((("Direction" . "Forward") ("Step" . "1580")))))Ejemplo de uso 2
Defina una transformación de datum combinada en el dibujo actual entre los sistemas de coordenadas de origen y destino definidos por WKID. Los pasos de transformación de datum referenciados por valores de cadena de caracteres de WKID se deben aplicar en orden inverso.(esri_coordsys_DatumTransformation_set
"6425" "3857"
(list
(list (cons "Direction" "Reverse") (cons "Step" 108355))
(list (cons "Direction" "Reverse") (cons "Step" 108282))
)
)
Ejemplo de resultado de uso 2
La transformación de datum de dos pasos se define en el dibujo actual y toda la definición de la transformación de datum se devuelve como una lista asociada.
(("From" . "6425") ("To" . "3857") ("Transformation" ((("Direction" . "Reverse") ("Step" . "108355")) (("Direction" . "Reverse") ("Step" . "108282")))))Valores de retorno
Los siguientes son los valores de retorno posibles:
- Si todo va bien, 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 se produce un error, devuelve una lista con el primer valor de nil y, a continuación, se devuelve una lista asociada que contiene el valor de clave "Error" y un mensaje de error asociado como 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 proporcionaron uno o más de los argumentos requeridos.