Calculer des attributs géométriques (Gestion des données)

Résumé

Ajoute des informations aux champs attributaires d’une entité représentant les caractéristiques spatiales ou géométriques ainsi que l’emplacement de chaque entité, tels que la longueur ou la surface et les coordonnées x, y, z et m.

L’outil similaire Ajouter des attributs géométriques ajoute plusieurs attributs géométriques aux nouveaux champs attributaires.

Utilisation

Attention :

Cet outil modifie les données en entrée. Pour plus d’informations et connaître les stratégies permettant d’empêcher les modifications de données indésirables, reportez-vous à la rubrique Outils qui modifient ou mettent à jour les données en entrée.

• Les calculs de longueur et de surface sont exprimés dans les unités du système de coordonnées spécifié, sauf si vous sélectionnez des unités différentes dans les paramètres Length Unit (Unité de longueur) et Area Unit (Unité de surface).

• Si les entités en entrée comportent une sélection, seules les valeurs des entités sélectionnées sont calculées dans les champs ajoutés ; toutes les autres entités conservent leur valeur existante.

• Cet outil fonctionne avec les classes d’entités points, multi-points, polylignes, surfaciques et annotations.

Syntaxe

arcpy.management.CalculateGeometryAttributes(in_features, geometry_property, {length_unit}, {area_unit}, {coordinate_system}, {coordinate_format})

Paramètre	Explication	Type de données
in_features	La couche d’entités avec un champ sera mise à jour à l’aide des calculs géométriques.	Feature Layer
geometry_property [[Target Field, Property],...]	Indique les champs dans lesquels calculer les propriétés de géométrie, ainsi que les propriétés de géométrie à calculer. Voici les propriétés de géométrie prises en charge : AREA —Surface de chaque entité surfacique. AREA_GEODESIC —Surface géodésique de préservation de la forme de chaque entité surfacique. CENTROID_X —Coordonnée x du centroïde de chaque entité. CENTROID_Y —Coordonnée y du centroïde de chaque entité. CENTROID_Z —Coordonnée z du centroïde de chaque entité. CENTROID_M —Coordonnée m du centroïde de chaque entité. INSIDE_X —Coordonnée x d’un point central dans ou sur chaque entité. Ce point est le même que le centroïde si ce dernier se trouve à l’intérieur de l’entité. Il s’agit sinon d’un point d’étiquette interne. INSIDE_Y —Coordonnée y d’un point central dans ou sur chaque entité. Ce point est le même que le centroïde si ce dernier se trouve à l’intérieur de l’entité. Il s’agit sinon d’un point d’étiquette interne. INSIDE_Z —Coordonnée z d’un point central dans ou sur chaque entité. Ce point est le même que le centroïde si ce dernier se trouve à l’intérieur de l’entité. Il s’agit sinon d’un point d’étiquette interne. INSIDE_M —Coordonnée m d’un point central dans ou sur chaque entité. Ce point est le même que le centroïde si ce dernier se trouve à l’intérieur de l’entité. Il s’agit sinon d’un point d’étiquette interne. CURVE_COUNT —Nombre de courbes dans chaque entité. Les courbes sont notamment les arcs elliptiques, les arcs circulaires et les courbes de Bézier. HOLE_COUNT —Nombre de trous intérieurs dans chaque entité surfacique. EXTENT_MIN_X —Coordonnée x minimale de l’étendue de chaque entité. EXTENT_MIN_Y —Coordonnée y minimale de l’étendue de chaque entité. EXTENT_MIN_Z —Coordonnée z minimale de l’étendue de chaque entité. EXTENT_MAX_X —Coordonnée x maximale de l’étendue de chaque entité. EXTENT_MAX_Y —Coordonnée y maximale de l’étendue de chaque entité. EXTENT_MAX_Z —Coordonnée z maximale de l’étendue de chaque entité. LENGTH —Longueur de chaque entité linéaire. LENGTH_GEODESIC —Longueur géodésique de préservation de la forme de chaque entité linéaire. LENGTH_3D —Longueur 3D de chaque entité linéaire. LINE_BEARING —Relèvement du début à la fin de chaque entité linéaire. Les valeurs sont comprises entre 0 et 360, où 0 correspond au nord, 90 à l'est, 180 au sud, 270 à l'ouest, et ainsi de suite. LINE_START_X —Coordonnée x du point de départ de chaque entité linéaire. LINE_START_Y —Coordonnée y du point de départ de chaque entité linéaire. LINE_START_Z —Coordonnée z du point de départ de chaque entité linéaire. LINE_START_M —Coordonnée m du point de départ de chaque entité linéaire. LINE_END_X —Coordonnée x du point de fin de chaque entité linéaire. LINE_END_Y —Coordonnée y du point de fin de chaque entité linéaire. LINE_END_Z —Coordonnée z du point de fin de chaque entité linéaire. LINE_END_M —Coordonnée m du point de fin de chaque entité linéaire. PART_COUNT —Nombre de parties qui composent chaque entité. PERIMETER_LENGTH —Longueur du périmètre ou de la bordure de chaque entité surfacique. PERIMETER_LENGTH_GEODESIC —Longueur géodésique de préservation de la forme du périmètre ou de la bordure de chaque entité surfacique. POINT_COUNT —Nombre de points ou de sommets qui composent chaque entité. POINT_X —Coordonnée x de chaque entité ponctuelle. POINT_Y —Coordonnée y de chaque entité ponctuelle. POINT_Z —Coordonnée z de chaque entité ponctuelle. POINT_M —Coordonnée m de chaque entité ponctuelle. POINT_COORD_NOTATION —Coordonnées x et y de chaque entité ponctuelle se présentant sous la forme d’une notation de coordonnées définie.	Value Table
length_unit (Facultatif)	Unité de calcul de la longueur. FEET_US —Longueur en pieds (Etats-Unis) METERS —Longueur en mètres KILOMETERS —Longueur en kilomètres MILES_US —Longueur en miles (Etats-Unis) NAUTICAL_MILES —Longueur en miles nautiques (Etats-Unis) YARDS —Longueur en yards (Etats-Unis)	String
area_unit (Facultatif)	Unité de calcul de la surface. ACRES —Surface en acres HECTARES —Surface en hectares SQUARE_MILES_US —Surface en miles carrés (Etats-Unis) SQUARE_KILOMETERS —Surface en kilomètres carrés SQUARE_METERS —Surface en mètres carrés SQUARE_FEET_US —Surface en pieds carrés (Etats-Unis) SQUARE_YARDS —Surface en yards carrés (Etats-Unis) SQUARE_NAUTICAL_MILES —Surface en miles nautiques carrés (Etats-Unis)	String
coordinate_system (Facultatif)	Système de coordonnées dans lequel sont calculées les coordonnées, la longueur et la surface. Le système de coordonnées des entités en entrée est utilisé par défaut. Dans le cas des propriétés de géométrie à coordonnées, le système de coordonnées est appliqué uniquement lorsque le format de coordonnées est identique à celui en entrée. À défaut, le système de coordonnées géographiques WGS_1984 est utilisé.	Coordinate System
coordinate_format (Facultatif)	Format de coordonnées dans lequel sont calculées les coordonnées x et y. Le format de coordonnées correspondant aux unités de référence spatiale des entités en entrée est utilisé par défaut. Avec certains formats de coordonnées comme Degrees Minutes Seconds (Degrés minutes secondes) et Degrees Decimal Minutes (Degrés minutes décimales), entre autres, il est impératif d’effectuer le calcul dans un champ de texte. SAME_AS_INPUT —Les unités de référence spatiale des entités en entrée sont utilisées pour la mise en forme des coordonnées. Il s’agit de l’option par défaut. DD —Format Decimal Degrees (Degrés décimaux). DMS_DIR_LAST —Format Degrees Minutes Seconds (Degrés minutes secondes) avec le composant de direction cardinale à la fin (DDD° MM' SSS.ss" <N|S|E|W>). DMS_DIR_FIRST —Format Degrees Minutes Seconds (Degrés minutes secondes) avec le composant de direction cardinale au début (<N|S|E|W> DDD° MM' SSS.ss"). DMS_POS_NEG —Format Degrees Minutes Seconds (Degrés minutes secondes) avec le composant de direction positive ou négative au début (<+|-> DDD° MM' SSS.ss"). DMS_PACKED —Format Degrees Minutes Seconds (Degrés minutes secondes) condensé en une seule valeur avec le composant de direction positive ou négative au début (<+|-> DDD.MMSSSss). DDM_DIR_LAST —Format Degrees Decimal Minutes (Degrés minutes décimales) avec le composant de direction cardinale à la fin (DDD° MM.mmm' <N|S|E|W>). DDM_DIR_FIRST —Format Degrees Decimal Minutes (Degrés minutes décimales) avec le composant de direction cardinale au début (<N|S|E|W> DDD° MM.mmm'). DDM_POS_NEG —Format Degrees Decimal Minutes (Degrés minutes décimales) avec le composant de direction positive ou négative au début (<+|-> DDD° MM.mmm'). GARS —Le format Global Area Reference System, qui repose sur la latitude et la longitude, divise et subdivise le monde en cellules. GEOREF —Le format World Geographic Reference System repose sur le système géographique de la latitude et de la longitude, si ce n’est qu’il utilise une notation plus simple et plus flexible. MGRS —Military Grid Reference System. USNG —United States National Grid. UTM —Universal Transverse Mercator. UTMNS —Universal Transverse Mercator sans espace.	String

Sortie dérivée

Nom	Explication	Type de données
updated_features	Entités en entrée mises à jour.	Couche d'entités

Exemple de code

Exemple d’utilisation de l’outil CalculateGeometryAttributes (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil CalculateGeometryAttributes.

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.CalculateGeometryAttributes_management("roads", [["Length_mi", "LENGTH"], ["Stops", "POINT_COUNT"]], "MILES_US")

Exemple d’utilisation de l’outil CalculateGeometryAttributes (script autonome)

Permet de générer le rectangle d’emprise de chaque entité.

# Name: ExtentCreation.py
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.env.outputCoordinateSystem = arcpy.Describe("roads").spatialReference
# Set local variables
in_features = "roads"
# Generate the extent coordinates using CalculateGeometry
arcpy.CalculateGeometryAttributes_management(in_features, [["Left", "EXTENT_MIN_X"],
                                                           ["Bottom", "EXTENT_MIN_Y"],
                                                           ["Right", "EXTENT_MAX_X"],
                                                           ["Top", "EXTENT_MAX_Y"]])

Environnements

Système de coordonnées en sortie, Espace de travail courant

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui