Cette fonction définit une transformation de datum dans le dessin actuel. Si la transformation de datum (des systèmes de coordonnées d’origine et de destination) existe déjà, elle est remplacée. La fonction renvoie la transformation de datum définie.
Syntaxe
(esri_coordsys_DatumTransformations_set FromCS ToCS transformationStep_properties)
Arguments
- FromCS | chaîne | obligatoire | WKID valide (numéro d’identification du système de coordonnées connu) ou WKT du système de coordonnées Esri sous forme d’une chaîne.
- ToCS | chaîne | obligatoire | WKID valide (numéro d’identification du système de coordonnées connu) ou WKT du système de coordonnées Esri sous forme d’une chaîne.
transformationStep_properties | liste associée | obligatoire | Liste des étapes de transformation sous forme de listes associées des propriétés de l’étape de paire pointée, comme l’indique la table suivante :
Etiquette associée Type de valeur Description de la valeur Requis ou facultatif "Direction" chaîne
Direction de l’étape, qui est « Forward » ou « Reverse », dans laquelle l’étape de transformation doit être appliquée.
required
"Step"
chaîne
WKID ou WKT de l’étape de transformation.
required
Utilisation
Lors de la création d’une transformation de datum composite, l’ordre de chaque étape doit être correct. Dans l’exemple 2 ci-dessous, 108355 est la première étape et 108282, la deuxième et ultime étape. La direction doit être indiquée sous la forme d’une chaîne « Avant » ou « Arrière » qui n’est pas sensible à la casse.
ArcGIS pour AutoCAD ne valide pas les étapes de transformation indiquées. Si une partie de la méthode définie n’est pas valide ou est appliquée dans la mauvaise direction, ArcGIS pour AutoCAD peut afficher les couches de manière incorrecte.
Remarque :
Lors de la création d’un texte connu (WKT) sous forme d’un argument de chaîne AutoLISP, la chaîne doit contenir les caractères d’échappement appropriés pour inclure les guillemets nécessaires au sein de la chaîne de texte. Voici quelques exemples :
Système de coordonnées :
"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]]"Transformation 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]]"Exemple d’utilisation 1
Tente de définir une transformation de datum en une seule étape dans le dessin actuel entre les systèmes de coordonnées d’origine et de destination signalés par le WKID. La liste des étapes inclut une seule étape de transformation de datum qui fait référence à un WKID et doit être appliquée vers l’avant.(esri_coordsys_DatumTransformations_set
"2882" "3857"
(list
(list (cons "Direction" "Forward") (cons "Step" 1580))
)
)
Exemple d’utilisation du résultat 1
Définit la seule étape de la transformation de datum dans le dessin actuel et renvoie la définition complète de la transformation de datum sous forme d’une liste associée.
(("From" . "2882") ("To" . "3857") ("Transformation" ((("Direction" . "Forward") ("Step" . "1580")))))Exemple d’utilisation 2
Tente de définir une transformation de datum composite dans le dessin actuel entre les systèmes de coordonnées d’origine et de destination signalés par le WKID (numéro d’identification connu). Les étapes de la transformation de datum référencées par les valeurs de la chaîne WKID doivent être appliquées vers l’arrière.(esri_coordsys_DatumTransformations_set
"6425" "3857"
(list
(list (cons "Direction" "Reverse") (cons "Step" 108355))
(list (cons "Direction" "Reverse") (cons "Step" 108282))
)
)
Exemple d’utilisation du résultat 2
Définit la transformation de datum composite en deux étapes dans le dessin actuel et renvoie la définition complète de la transformation de datum sous forme d’une liste associée.
(("From" . "6425") ("To" . "3857") ("Transformation" ((("Direction" . "Reverse") ("Step" . "108355")) (("Direction" . "Reverse") ("Step" . "108282")))))Valeurs renvoyées
- La transformation de datum est définie et la définition complète de la transformation de datum en renvoyée sous forme d’une liste associée.
- Si la fonction échoue, une liste avec la première valeur nil est renvoyée, suivie d’une liste associée contenant la valeur principale "Error" et un message d’erreur associé sous forme de chaîne : (nil ("Error" . "<message>")).
Valeurs d’échec renvoyées
Un échec peut être dû par exemple aux raisons suivantes :
- (nil ("Error" . "Failed"))
Le WKID ou WKT fourni n’est pas valide.
- (nil ("Error" . "This document contains existing web feature layers. Datum transformations cannot be modified when web feature layers present."))
Les transformations de datum ne peuvent pas être définies ni modifiées lorsque le dessin contient des couches d’entités Web.
- (nil ("Error" . "Missing required argument."))
Un ou plusieurs des arguments requis n’a pas été fourni.
Vous avez un commentaire à formuler concernant cette rubrique ?