Règle attributaire Calculer les champs de géométrie (Gestion des données)

Synthèse

Génère une règle attributaire qui calcule les informations de géométrie d’une entité et les écrit dans un champ donné. Les attributs de géométrie représentent les caractéristiques spatiales ou géométriques ainsi que la localisation de chaque entité, telles que la longueur ou la surface, ainsi que les coordonnées x, y, z et les valeurs m.

Utilisation

• Les calculs de longueur et de surface sont exprimés dans les unités du système de coordonnées des entités en entrée, sauf si des unités différentes sont spécifiées dans les paramètres Unité de longueur et Unité de surface.

  En savoir plus sur les unités de longueur et de surface dans les outils de géotraitement

• Le paramètre facultatif de format des coordonnées requiert que la référence spatiale des tables en entrée soit un système de coordonnées géographiques.

• L’exécution de l’outil échouera si la classe en entrée est en cours de modification.

• Les règles créées avec cet outil sont configurées de façon à se déclencher uniquement pour les modifications apportées au champ SHAPE et aux champs définis comme cible pour les calculs de géométrie.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Table en entrée	La table ou classe d’entités à laquelle sera appliquée la nouvelle règle.	Feature Layer; Annotation Layer; Dimension Layer; Oriented Imagery Layer; Catalog Layer
Dossier en sortie	Dossier dans lequel la sortie est enregistrée.	Folder
Attributs géométriques	Champs dans lesquels les propriétés géométriques spécifiées sont calculées. 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 de nombre sont écrits dans des champs de type entier long, les attributs de surface, de longueur et de coordonnées x, y, z et de valeur m sont écrits dans des champs de type double et les notations de coordonnées telles que DMS (Degrés Minutes Secondes) ou MGRS (Système de référencement de carroyage militaire) sont écrites dans des champs de type texte. Sauf indication contraire, les propriétés de surface et de longueur sont des mesures planes utilisant les mathématiques cartésiennes en 2D. Surface : un attribut est ajouté pour stocker la surface de chaque entité surfacique. Surface (géodésique) : un attribut est ajouté pour stocker la surface géodésique de préservation de la forme de chaque entité surfacique. Coordonnée x du centroïde : un attribut est ajouté pour stocker la coordonnée x du centroïde de chaque entité. Coordonnée y du centroïde : un attribut est ajouté pour stocker la coordonnée y du centroïde de chaque entité. Coordonnée z du centroïde : un attribut est ajouté pour stocker la coordonnée z du centroïde de chaque entité. Valeur m du centroïde : un attribut est ajouté pour stocker la valeur m de chaque entité. Coordonnée x du point central : un attribut est ajouté pour stocker la 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. Coordonnée y du point central : un attribut est ajouté pour stocker la 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. Coordonnée z du point central : un attribut est ajouté pour stocker la 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. Valeur m du point central : un attribut est ajouté pour stocker la valeur 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. Nombre de courbes : un attribut est ajouté pour stocker le nombre de courbes dans chaque entité. Les courbes sont notamment les arcs elliptiques, les arcs circulaires et les courbes de Bézier. Nombre de trous : un attribut est ajouté pour stocker le nombre de trous intérieurs dans chaque entité surfacique. Coordonnée x minimale : un attribut est ajouté pour stocker la coordonnée x minimale de l’étendue de chaque entité. Coordonnée y minimale : un attribut est ajouté pour stocker la coordonnée y minimale de l’étendue de chaque entité. Coordonnée z minimale : un attribut est ajouté pour stocker la coordonnée z minimale de l’étendue de chaque entité. Coordonnée x maximale : un attribut est ajouté pour stocker la coordonnée x maximale de l’étendue de chaque entité. Coordonnée y maximale : un attribut est ajouté pour stocker la coordonnée y maximale de l’étendue de chaque entité. Coordonnée z maximale : un attribut est ajouté pour stocker la coordonnée z maximale de l’étendue de chaque entité. Longueur : un attribut est ajouté pour stocker la longueur de chaque entité linéaire. Longueur (géodésique) : un attribut est ajouté pour stocker la longueur géodésique de préservation de la forme de chaque entité linéaire. Longueur (3D) : un attribut est ajouté pour stocker la longueur 3D de chaque entité linéaire. Relèvement de ligne : un attribut est ajouté pour stocker le 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. Angle de ligne : un attribut est ajouté pour stocker l’angle arithmétique du début à la fin de chaque entité linéaire. Les valeurs sont comprises entre 0 et 360, où 0 correspond à l’est, 90 au nord, 180 à l’ouest, 270 au sud, etc. Coordonnée x du début de la ligne : un attribut est ajouté pour stocker la coordonnée x du point de début de chaque entité linéaire. Coordonnée y du début de la ligne : un attribut est ajouté pour stocker la coordonnée y du point de début de chaque entité linéaire. Coordonnée z du début de la ligne : un attribut est ajouté pour stocker la coordonnée z du point de début de chaque entité linéaire. Valeur m du début de la ligne : un attribut est ajouté pour stocker la valeur m du point de début de chaque entité linéaire. Coordonnée x de la fin de la ligne : un attribut est ajouté pour stocker la coordonnée x du point de fin de chaque entité linéaire. Coordonnée y de la fin de la ligne : un attribut est ajouté pour stocker la coordonnée y du point de fin de chaque entité linéaire. Coordonnée z de la fin de la ligne : un attribut est ajouté pour stocker la coordonnée z du point de fin de chaque entité linéaire. Valeur m de la fin de la ligne : un attribut est ajouté pour stocker la valeur m du point de fin de chaque entité linéaire. Nombre de parties : un attribut est ajouté pour stocker le nombre de parties composant chaque entité. Nombre de sommets : un attribut est ajouté pour stocker le nombre de points ou de sommets composant chaque entité. Longueur du périmètre : un attribut est ajouté pour stocker la longueur du périmètre ou de la bordure de chaque entité surfacique. Longueur du périmètre (géodésique): un attribut est ajouté pour stocker la longueur géodésique de préservation de la forme du périmètre ou de la bordure de chaque entité surfacique. Coordonnée x du point : un attribut est ajouté pour stocker la coordonnée x de chaque entité ponctuelle. Coordonnée y du point : un attribut est ajouté pour stocker la coordonnée y de chaque entité ponctuelle. Coordonnée z du point : un attribut est ajouté pour stocker la coordonnée z de chaque entité ponctuelle. Valeur m du point : un attribut est ajouté pour stocker la valeur m de chaque entité ponctuelle. Notation des coordonnées x et y du point : un attribut est ajouté pour stocker les coordonnées x et y de chaque entité ponctuelle se présentant sous la forme d’une notation de coordonnées spécifiée.	Value Table
Expression (Facultatif)	Expression SQL qui permet de limiter les entités de l’entrée qui participent à la règle attributaire.	SQL Expression
Unité de longueur (Facultatif)	Spécifie l’unité utilisée pour calculer la longueur. Kilomètres—L’unité de longueur est le kilomètre. Mètres—L’unité de longueur est le mètre. Milles terrestres—L’unité de longueur est le mille terrestre. Milles nautiques internationaux—L’unité de longueur est le mille nautique international. Yards internationaux—L’unité de longueur est le yard international. Pieds internationaux—L’unité de longueur est le pied international. Miles d’arpentage américains—L’unité de longueur est le mille d’arpentage américain. Milles nautiques d’arpentage américains—L’unité de longueur est le mille nautique d’arpentage américain. Yards d’arpentage américains—L’unité de longueur est le yard d’arpentage américain. Pieds d’arpentage américains—L’unité de longueur est le pied d’arpentage américain.	String
Unité de surface (Facultatif)	Spécifie l’unité utilisée pour calculer la surface. Kilomètres carrés—L’unité de surface est le kilomètre carré. Hectares—L’unité de surface est l’hectare. Mètres carrés—L’unité de surface est le mètre carré. Milles terrestres carrés—L’unité de surface est le mille terrestre carré. Milles nautiques internationaux carrés—L’unité de surface est le mille nautique international carré. Acres internationales—L’unité de surface est l’acre internationale. Yards internationaux carrés—L’unité de surface est le yard international carré. Pieds internationaux carrés—L’unité de surface est le pied international carré. Milles d’arpentage américains carrés—L’unité de surface est le mille d’arpentage américain carré. Milles nautiques d’arpentage américains carrés—L’unité de surface est le mille nautique d’arpentage américain carré. Acres d’arpentage américaines—L’unité de surface est l’acre d’arpentage américaine. Yards d’arpentage américains carrés—L’unité de surface est le yard d’arpentage américain carré. Pieds d’arpentage américains carrés—L’unité de surface est le pied d’arpentage américain carré.	String
Format 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.	String

Sortie obtenue

Étiquette	Explication	Type de données
CSV de règle en sortie	Le fichier .csv qui comportera la règle attributaire.	File

Python

arcpy.management.CalculateGeometryFieldsAttributeRule(in_table, out_folder, geometry_attributes, {where_clause}, {length_unit}, {area_unit}, {coordinate_format})

Nom	Explication	Type de données
in_table	La table ou classe d’entités à laquelle sera appliquée la nouvelle règle.	Feature Layer; Annotation Layer; Dimension Layer; Oriented Imagery Layer; Catalog Layer
out_folder	Dossier dans lequel la sortie est enregistrée.	Folder
geometry_attributes [geometry_attributes,...]	Champs dans lesquels les propriétés géométriques spécifiées sont calculées. 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 de nombre sont écrits dans des champs de type entier long, les attributs de surface, de longueur et de coordonnées x, y, z et de valeur m sont écrits dans des champs de type double et les notations de coordonnées telles que DMS (Degrés Minutes Secondes) ou MGRS (Système de référencement de carroyage militaire) sont écrites dans des champs de type texte. Sauf indication contraire, les propriétés de surface et de longueur sont des mesures planes utilisant les mathématiques cartésiennes en 2D. AREA : un attribut est ajouté pour stocker la surface de chaque entité surfacique. AREA_GEODESIC : un attribut est ajouté pour stocker la surface géodésique de préservation de la forme de chaque entité surfacique. CENTROID_X : un attribut est ajouté pour stocker la coordonnée x du centroïde de chaque entité. CENTROID_Y : un attribut est ajouté pour stocker la coordonnée y du centroïde de chaque entité. CENTROID_Z : un attribut est ajouté pour stocker la coordonnée z du centroïde de chaque entité. CENTROID_M : un attribut est ajouté pour stocker la valeur m de chaque entité. INSIDE_X : un attribut est ajouté pour stocker la 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 : un attribut est ajouté pour stocker la 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 : un attribut est ajouté pour stocker la 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 : un attribut est ajouté pour stocker la valeur 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 : un attribut est ajouté pour stocker le nombre de courbes dans chaque entité. Les courbes sont notamment les arcs elliptiques, les arcs circulaires et les courbes de Bézier. HOLE_COUNT : un attribut est ajouté pour stocker le nombre de trous intérieurs dans chaque entité surfacique. EXTENT_MIN_X : un attribut est ajouté pour stocker la coordonnée x minimale de l’étendue de chaque entité. EXTENT_MIN_Y : un attribut est ajouté pour stocker la coordonnée y minimale de l’étendue de chaque entité. EXTENT_MIN_Z : un attribut est ajouté pour stocker la coordonnée z minimale de l’étendue de chaque entité. EXTENT_MAX_X : un attribut est ajouté pour stocker la coordonnée x minimale de l’étendue de chaque entité. EXTENT_MAX_Y : un attribut est ajouté pour stocker la coordonnée y minimale de l’étendue de chaque entité. EXTENT_MAX_Z : un attribut est ajouté pour stocker la coordonnée z minimale de l’étendue de chaque entité. LENGTH : un attribut est ajouté pour stocker la longueur de chaque entité linéaire. LENGTH_GEODESIC : un attribut est ajouté pour stocker la longueur géodésique de préservation de la forme de chaque entité linéaire. LENGTH_3D : un attribut est ajouté pour stocker la longueur 3D de chaque entité linéaire. LINE_BEARING : un attribut est ajouté pour stocker le 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_ANGLE : un attribut est ajouté pour stocker l’angle arithmétique 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 : un attribut est ajouté pour stocker la coordonnée x du point de début de chaque entité linéaire. LINE_START_Y : un attribut est ajouté pour stocker la coordonnée y du point de début de chaque entité linéaire. LINE_START_Z : un attribut est ajouté pour stocker la coordonnée z du point de début de chaque entité linéaire. LINE_START_M : un attribut est ajouté pour stocker la valeur m du point de début de chaque entité linéaire. LINE_END_X : un attribut est ajouté pour stocker la coordonnée x du point de fin de chaque entité linéaire. LINE_END_Y : un attribut est ajouté pour stocker la coordonnée y du point de fin de chaque entité linéaire. LINE_END_Z : un attribut est ajouté pour stocker la coordonnée z du point de fin de chaque entité linéaire. LINE_END_M : un attribut est ajouté pour stocker la valeur m du point de fin de chaque entité linéaire. PART_COUNT : un attribut est ajouté pour stocker le nombre de parties composant chaque entité. POINT_COUNT : un attribut est ajouté pour stocker le nombre de points ou de sommets composant chaque entité. PERIMETER_LENGTH : un attribut est ajouté pour stocker la longueur du périmètre ou de la bordure de chaque entité surfacique. PERIMETER_LENGTH_GEODESIC : un attribut est ajouté pour stocker la longueur géodésique de préservation de la forme du périmètre ou de la bordure de chaque entité surfacique. POINT_X : attribut est ajouté pour stocker la coordonnée x de chaque entité ponctuelle. POINT_Y : un attribut est ajouté pour stocker la coordonnée y de chaque entité ponctuelle. POINT_Z : un attribut est ajouté pour stocker la coordonnée z de chaque entité ponctuelle. POINT_M : un attribut est ajouté pour stocker la valeur m de chaque entité ponctuelle. POINT_COORD_NOTATION : un attribut est ajouté pour stocker les coordonnées x et y de chaque entité ponctuelle se présentant sous la forme d’une notation de coordonnées spécifiée.	Value Table
where_clause (Facultatif)	Expression SQL qui permet de limiter les entités de l’entrée qui participent à la règle attributaire.	SQL Expression
length_unit (Facultatif)	Spécifie l’unité utilisée pour calculer la longueur. KILOMETERS—L’unité de longueur est le kilomètre. METERS—L’unité de longueur est le mètre. MILES_INT—L’unité de longueur est le mille terrestre. NAUTICAL_MILES_INT—L’unité de longueur est le mille nautique international. YARDS_INT—L’unité de longueur est le yard international. FEET_INT—L’unité de longueur est le pied international. MILES_US—L’unité de longueur est le mille d’arpentage américain. NAUTICAL_MILES—L’unité de longueur est le mille nautique d’arpentage américain. YARDS—L’unité de longueur est le yard d’arpentage américain. FEET_US—L’unité de longueur est le pied d’arpentage américain.	String
area_unit (Facultatif)	Spécifie l’unité utilisée pour calculer la surface. SQUARE_KILOMETERS—L’unité de surface est le kilomètre carré. HECTARES—L’unité de surface est l’hectare. SQUARE_METERS—L’unité de surface est le mètre carré. SQUARE_MILES_INT—L’unité de surface est le mille terrestre carré. SQUARE_NAUTICAL_MILES—L’unité de surface est le mille nautique international carré. ACRES—L’unité de surface est l’acre internationale. SQUARE_YARDS—L’unité de surface est le yard international carré. SQUARE_FEET_INT—L’unité de surface est le pied international carré. SQUARE_MILES_US—L’unité de surface est le mille d’arpentage américain carré. SQUARE_NAUTICAL_MILES_US—L’unité de surface est le mille nautique d’arpentage américain carré. ACRES_US—L’unité de surface est l’acre d’arpentage américaine. SQUARE_YARDS_US—L’unité de surface est le yard d’arpentage américain carré. SQUARE_FEET_US—L’unité de surface est le pied d’arpentage américain carré.	String
coordinate_format (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.	String

Sortie obtenue

Nom	Explication	Type de données
out_rule_csv	Le fichier .csv qui comportera la règle attributaire.	File

Exemple de code

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

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction CalculateGeometryFieldsAttributeRule.

import arcpy
arcpy.env.workspace = r"C:\data\City.gdb"
arcpy.management.CalculateGeometryFieldsAttributeRule(
    in_table="test_class",
    out_folder=r"C:\temp", 
    geometry_attributes="area_field AREA_GEODESIC",
    where_clause="OBJECTID = 1",
    length_unit="",
    area_unit="SQUARE_MILES_US",
    coordinate_format=""
)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.