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.
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.
Syntaxe
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 :
| Value Table |
length_unit (Facultatif) | Unité de calcul de la longueur.
| String |
area_unit (Facultatif) | Unité de calcul de la surface.
| 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.
| 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
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")
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
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?