ArcMap

Calculer des attributs géométriques

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

  • 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_management (in_features, field, geometry_property, {length_unit}, {area_unit}, {coordinate_system})
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
field

Champ qui sera mis à jour à l’aide des calculs géométriques.

Field
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.
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.

Coordinate System

Sortie dérivée

NomExplicationType de données
updated_features

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