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

Synthèse

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.

Il existe un outil similaire, Ajouter des attributs géométriques, qui 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.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	La couche d’entités avec un champ sera mise à jour à l’aide des calculs géométriques.	Feature Layer
Attributs géométriques	Spécifie les champs dans lesquels les propriétés géométriques sélectionnées seront calculés. Vous pouvez sélectionner un champ existant ou indiquer un nouveau nom de champ. Si vous indiquez un nouveau nom de champ, le type de celui-ci est déterminé par le type des valeurs écrites dans ce champ. Les attributs numériques sont écrits dans des champs de type entier long. Les attributs de surface, de longueur et de coordonnées x ,y ,z et m sont écrits dans des champs de type double. Les notations de coordonnées (Degrés Minutes Secondes ou MGRS) sont écrites dans des champs de type texte. 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
Unité de longueur (Facultatif)	Spécifie l’unité utilisée pour calculer la longueur. Pieds (Etats-Unis)—L’unité de longueur est le pied (États-Unis). Mètres—L’unité de longueur est le mètre. Kilomètres—L’unité de longueur est le kilomètre. Miles (Etats-Unis)—L’unité de longueur est le mile (États-Unis). Miles nautiques (Etats-Unis)—L’unité de longueur est le mile nautique (États-Unis). Yards (Etats-Unis)—L’unité de longueur est le yard (États-Unis).	String
Unité de surface (Facultatif)	Spécifie l’unité utilisée pour calculer la surface. Acres—L’unité de surface est l’acre. Hectares—L’unité de surface est l’hectare. Miles carrés (Etats-Unis)—L’unité de surface est le mile carré (États-Unis). Kilomètres carrés—L’unité de surface est le kilomètre carré. Mètres carrés—L’unité de surface est le mètre carré. Pieds carrés (Etats-Unis)—L’unité de surface est le pied carré (États-Unis). Yards carrés (Etats-Unis)—L’unité de surface est le yard carré (États-Unis). Miles nautiques carrés (Etats-Unis)—L’unité de surface est le mile nautique carré (États-Unis).	String
Système de coordonnées (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. Pour les propriétés géométriques basées sur des coordonnées, le système de coordonnées n’est appliqué que lorsque le format des coordonnées est le même que celui en entrée ; sinon, le système de coordonnées géographiques WGS84 est utilisé.	Coordinate System
Format de coordonnées (Facultatif)	Spécifie le format dans lequel les coordonnées x et y sont calculées. 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. identique à l'entrée—Les unités de la référence spatiale des entités en entrée est utilisé pour le format des coordonnées. Il s’agit de l’option par défaut. Degrés décimaux—Format Decimal Degrees (Degrés décimaux). Degrees Minutes Seconds (Degrés minutes secondes) (DDD° MM' SSS.ss" <N|S|E|W>)—Format Degrees Minutes Seconds (Degrés minutes secondes) avec le composant de direction cardinale à la fin (DDD° MM' SSS.ss" <N|S|E|W>). Degrees Minutes Seconds (Degrés minutes secondes) (<N|S|E|W> DDD° MM' SSS.ss")—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"). Degrees Minutes Seconds (Degrés minutes secondes) (<+|-> DDD° MM' SSS.ss")—Format Degrees Minutes Seconds (Degrés minutes secondes) avec le composant de direction positive ou négative au début (<+|-> DDD° MM' SSS.ss"). Degrees Minutes Seconds (Degrés minutes secondes) (<+|-> DDD.MMSSSss)—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). Degrees Decimal Minutes (Degrés minutes décimales) (DDD° MM.mmm' <N|S|E|W>)—Format Degrees Decimal Minutes (Degrés minutes décimales) avec le composant de direction cardinale à la fin (DDD° MM.mmm' <N|S|E|W>). Degrees Decimal Minutes (Degrés minutes décimales) (<N|S|E|W> DDD° MM.mmm')—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'). Degrees Decimal Minutes (Degrés minutes décimales) (<+|-> DDD° MM.mmm')—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 (Global Area Reference System)—Le format Global Area Reference System, qui repose sur la latitude et la longitude, divise et subdivise le monde en cellules. GEOREF (World Geographic Reference System)—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)—Military Grid Reference System. USNG (United States National Grid)—United States National Grid. UTM (Universal Transverse Mercator)—Universal Transverse Mercator. UTM sans espace—Universal Transverse Mercator sans espace.	String

Sortie obtenue

Étiquette	Explication	Type de données
Entités mises à jour	Entités en entrée mises à jour.	Feature Layer

Python

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

Nom	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 [[Field, Property],...]	Spécifie les champs dans lesquels les propriétés géométriques sélectionnées seront calculés. Vous pouvez sélectionner un champ existant ou indiquer un nouveau nom de champ. Si vous indiquez un nouveau nom de champ, le type de celui-ci est déterminé par le type des valeurs écrites dans ce champ. Les attributs numériques sont écrits dans des champs de type entier long. Les attributs de surface, de longueur et de coordonnées x ,y ,z et m sont écrits dans des champs de type double. Les notations de coordonnées (Degrés Minutes Secondes ou MGRS) sont écrites dans des champs de type texte. 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)	Spécifie l’unité utilisée pour calculer la longueur. FEET_US—L’unité de longueur est le pied (États-Unis). METERS—L’unité de longueur est le mètre. KILOMETERS—L’unité de longueur est le kilomètre. MILES_US—L’unité de longueur est le mile (États-Unis). NAUTICAL_MILES—L’unité de longueur est le mile nautique (États-Unis). YARDS—L’unité de longueur est le yard (États-Unis).	String
area_unit (Facultatif)	Spécifie l’unité utilisée pour calculer la surface. ACRES—L’unité de surface est l’acre. HECTARES—L’unité de surface est l’hectare. SQUARE_MILES_US—L’unité de surface est le mile carré (États-Unis). SQUARE_KILOMETERS—L’unité de surface est le kilomètre carré. SQUARE_METERS—L’unité de surface est le mètre carré. SQUARE_FEET_US—L’unité de surface est le pied carré (États-Unis). SQUARE_YARDS—L’unité de surface est le yard carré (États-Unis). SQUARE_NAUTICAL_MILES—L’unité de surface est le mile nautique carré (États-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. Pour les propriétés géométriques basées sur des coordonnées, le système de coordonnées n’est appliqué que lorsque le format des coordonnées est le même que celui en entrée ; sinon, le système de coordonnées géographiques WGS84 est utilisé.	Coordinate System
coordinate_format (Facultatif)	Spécifie le format dans lequel les coordonnées x et y sont calculées. 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 la référence spatiale des entités en entrée est utilisé pour le format 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 obtenue

Nom	Explication	Type de données
updated_features	Entités en entrée mises à jour.	Feature Layer

Exemple de code

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

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction 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

Cas particuliers

Informations de licence

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