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. Reportez-vous à la rubrique Outils qui ne génèrent pas de jeux de données en sortie pour obtenir plus d’informations, ainsi que des stratégies pour éviter les modifications de données indésirables.

  • 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

CalculateGeometryAttributes(in_features, geometry_property, {length_unit}, {area_unit}, {coordinate_system}, {coordinate_format})
ParamètreExplicationType 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 :

  • 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)

Unité de calcul de la longueur.

  • FEET_USLongueur en pieds (Etats-Unis)
  • METERSLongueur en mètres
  • KILOMETERSLongueur en kilomètres
  • MILES_USLongueur en miles (Etats-Unis)
  • NAUTICAL_MILESLongueur en miles nautiques (Etats-Unis)
  • YARDSLongueur en yards (Etats-Unis)
String
area_unit
(Facultatif)

Unité de calcul de la surface.

  • ACRESSurface en acres
  • HECTARESSurface en hectares
  • SQUARE_MILES_USSurface en miles carrés (Etats-Unis)
  • SQUARE_KILOMETERSSurface en kilomètres carrés
  • SQUARE_METERSSurface en mètres carrés
  • SQUARE_FEET_USSurface en pieds carrés (Etats-Unis)
  • SQUARE_YARDSSurface en yards carrés (Etats-Unis)
  • SQUARE_NAUTICAL_MILESSurface 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_INPUTLes 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.
  • 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.

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

Informations de licence

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

Rubriques connexes