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.

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

ÉtiquetteExplicationType 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.

  • AREASurface de chaque entité surfacique.
  • AREA_GEODESICSurface géodésique de préservation de la forme de chaque entité surfacique.
  • CENTROID_XCoordonnée x du centroïde de chaque entité.
  • CENTROID_YCoordonnée y du centroïde de chaque entité.
  • CENTROID_ZCoordonnée z du centroïde de chaque entité.
  • CENTROID_MCoordonnée m du centroïde de chaque entité.
  • INSIDE_XCoordonné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_YCoordonné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_ZCoordonné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_MCoordonné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_COUNTNombre de courbes dans chaque entité. Les courbes sont notamment les arcs elliptiques, les arcs circulaires et les courbes de Bézier.
  • HOLE_COUNTNombre de trous intérieurs dans chaque entité surfacique.
  • EXTENT_MIN_XCoordonnée x minimale de l’étendue de chaque entité.
  • EXTENT_MIN_YCoordonnée y minimale de l’étendue de chaque entité.
  • EXTENT_MIN_ZCoordonnée z minimale de l’étendue de chaque entité.
  • EXTENT_MAX_XCoordonnée x maximale de l’étendue de chaque entité.
  • EXTENT_MAX_YCoordonnée y maximale de l’étendue de chaque entité.
  • EXTENT_MAX_ZCoordonnée z maximale de l’étendue de chaque entité.
  • LENGTHLongueur de chaque entité linéaire.
  • LENGTH_GEODESICLongueur géodésique de préservation de la forme de chaque entité linéaire.
  • LENGTH_3DLongueur 3D de chaque entité linéaire.
  • LINE_BEARINGRelè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_XCoordonnée x du point de départ de chaque entité linéaire.
  • LINE_START_YCoordonnée y du point de départ de chaque entité linéaire.
  • LINE_START_ZCoordonnée z du point de départ de chaque entité linéaire.
  • LINE_START_MCoordonnée m du point de départ de chaque entité linéaire.
  • LINE_END_XCoordonnée x du point de fin de chaque entité linéaire.
  • LINE_END_YCoordonnée y du point de fin de chaque entité linéaire.
  • LINE_END_ZCoordonnée z du point de fin de chaque entité linéaire.
  • LINE_END_MCoordonnée m du point de fin de chaque entité linéaire.
  • PART_COUNTNombre de parties qui composent chaque entité.
  • PERIMETER_LENGTHLongueur du périmètre ou de la bordure de chaque entité surfacique.
  • PERIMETER_LENGTH_GEODESICLongueur géodésique de préservation de la forme du périmètre ou de la bordure de chaque entité surfacique.
  • POINT_COUNTNombre de points ou de sommets qui composent chaque entité.
  • POINT_XCoordonnée x de chaque entité ponctuelle.
  • POINT_YCoordonnée y de chaque entité ponctuelle.
  • POINT_ZCoordonnée z de chaque entité ponctuelle.
  • POINT_MCoordonnée m de chaque entité ponctuelle.
  • POINT_COORD_NOTATIONCoordonné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ètresL’unité de longueur est le mètre.
  • KilomètresL’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.

  • AcresL’unité de surface est l’acre.
  • HectaresL’unité de surface est l’hectare.
  • Miles carrés (Etats-Unis)L’unité de surface est le mile carré (États-Unis).
  • Kilomètres carrésL’unité de surface est le kilomètre carré.
  • Mètres carrésL’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éeLes 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écimauxFormat 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 espaceUniversal Transverse Mercator sans espace.
String

Sortie dérivée

ÉtiquetteExplicationType de données
Entités mises à jour

Entités en entrée mises à jour.

Feature Layer

arcpy.management.CalculateGeometryAttributes(in_features, geometry_property, {length_unit}, {area_unit}, {coordinate_system}, {coordinate_format})
NomExplicationType 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.

  • AREASurface de chaque entité surfacique.
  • AREA_GEODESICSurface géodésique de préservation de la forme de chaque entité surfacique.
  • CENTROID_XCoordonnée x du centroïde de chaque entité.
  • CENTROID_YCoordonnée y du centroïde de chaque entité.
  • CENTROID_ZCoordonnée z du centroïde de chaque entité.
  • CENTROID_MCoordonnée m du centroïde de chaque entité.
  • INSIDE_XCoordonné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_YCoordonné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_ZCoordonné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_MCoordonné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_COUNTNombre de courbes dans chaque entité. Les courbes sont notamment les arcs elliptiques, les arcs circulaires et les courbes de Bézier.
  • HOLE_COUNTNombre de trous intérieurs dans chaque entité surfacique.
  • EXTENT_MIN_XCoordonnée x minimale de l’étendue de chaque entité.
  • EXTENT_MIN_YCoordonnée y minimale de l’étendue de chaque entité.
  • EXTENT_MIN_ZCoordonnée z minimale de l’étendue de chaque entité.
  • EXTENT_MAX_XCoordonnée x maximale de l’étendue de chaque entité.
  • EXTENT_MAX_YCoordonnée y maximale de l’étendue de chaque entité.
  • EXTENT_MAX_ZCoordonnée z maximale de l’étendue de chaque entité.
  • LENGTHLongueur de chaque entité linéaire.
  • LENGTH_GEODESICLongueur géodésique de préservation de la forme de chaque entité linéaire.
  • LENGTH_3DLongueur 3D de chaque entité linéaire.
  • LINE_BEARINGRelè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_XCoordonnée x du point de départ de chaque entité linéaire.
  • LINE_START_YCoordonnée y du point de départ de chaque entité linéaire.
  • LINE_START_ZCoordonnée z du point de départ de chaque entité linéaire.
  • LINE_START_MCoordonnée m du point de départ de chaque entité linéaire.
  • LINE_END_XCoordonnée x du point de fin de chaque entité linéaire.
  • LINE_END_YCoordonnée y du point de fin de chaque entité linéaire.
  • LINE_END_ZCoordonnée z du point de fin de chaque entité linéaire.
  • LINE_END_MCoordonnée m du point de fin de chaque entité linéaire.
  • PART_COUNTNombre de parties qui composent chaque entité.
  • PERIMETER_LENGTHLongueur du périmètre ou de la bordure de chaque entité surfacique.
  • PERIMETER_LENGTH_GEODESICLongueur géodésique de préservation de la forme du périmètre ou de la bordure de chaque entité surfacique.
  • POINT_COUNTNombre de points ou de sommets qui composent chaque entité.
  • POINT_XCoordonnée x de chaque entité ponctuelle.
  • POINT_YCoordonnée y de chaque entité ponctuelle.
  • POINT_ZCoordonnée z de chaque entité ponctuelle.
  • POINT_MCoordonnée m de chaque entité ponctuelle.
  • POINT_COORD_NOTATIONCoordonné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_USL’unité de longueur est le pied (États-Unis).
  • METERSL’unité de longueur est le mètre.
  • KILOMETERSL’unité de longueur est le kilomètre.
  • MILES_USL’unité de longueur est le mile (États-Unis).
  • NAUTICAL_MILESL’unité de longueur est le mile nautique (États-Unis).
  • YARDSL’unité de longueur est le yard (États-Unis).
String
area_unit
(Facultatif)

Spécifie l’unité utilisée pour calculer la surface.

  • ACRESL’unité de surface est l’acre.
  • HECTARESL’unité de surface est l’hectare.
  • SQUARE_MILES_USL’unité de surface est le mile carré (États-Unis).
  • SQUARE_KILOMETERSL’unité de surface est le kilomètre carré.
  • SQUARE_METERSL’unité de surface est le mètre carré.
  • SQUARE_FEET_USL’unité de surface est le pied carré (États-Unis).
  • SQUARE_YARDSL’unité de surface est le yard carré (États-Unis).
  • SQUARE_NAUTICAL_MILESL’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_INPUTLes 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.
  • DDFormat Decimal Degrees (Degrés décimaux).
  • DMS_DIR_LASTFormat 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_FIRSTFormat 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_NEGFormat Degrees Minutes Seconds (Degrés minutes secondes) avec le composant de direction positive ou négative au début (<+|-> DDD° MM' SSS.ss").
  • DMS_PACKEDFormat 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_LASTFormat 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_FIRSTFormat 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_NEGFormat Degrees Decimal Minutes (Degrés minutes décimales) avec le composant de direction positive ou négative au début (<+|-> DDD° MM.mmm').
  • GARSLe format Global Area Reference System, qui repose sur la latitude et la longitude, divise et subdivise le monde en cellules.
  • GEOREFLe 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.
  • MGRSMilitary Grid Reference System.
  • USNGUnited States National Grid.
  • UTMUniversal Transverse Mercator.
  • UTMNSUniversal Transverse Mercator sans espace.
String

Sortie dérivée

NomExplicationType 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"]])

Informations de licence

  • Basic: Nécessite O
  • Standard: Nécessite O
  • Advanced: Nécessite O

Rubriques connexes