Résumé
Génère un rapport des problèmes de géométrie dans une classe d'entités.
Pour des informations supplémentaires sur les problèmes de géométrie, leur impact sur le logiciel et les sources potentielles, reportez-vous à la rubrique Vérification et réparation des géométries.
Utilisation
Les formats valides en entrée sont les shapefiles et les classes d'entités stockées dans un fichier ou une géodatabase d’entreprise. Les types spatiaux suivants sont pris en charge pour les classes d’entités stockées dans une géodatabase d’entreprise :
- Géométrie et géographie Microsoft SQL Server
- Géométrie et géographie PostgreSQL PostGIS
- Géométrie SDO Oracle
La table en sortie contient un enregistrement pour chaque problème de géométrie découvert. Si aucun problème n'est détecté, la table est vide.
Le contenu Output Table (Table en sortie), y compris les codes du champ PROBLEM, sont écrits en anglais.
Pour les entités ponctuelles, seul le problème de géométrie nulle est possible.
Pour faciliter la révision des entités identifiées comme ayant des problèmes de géométrie, vous pouvez joindre les valeurs Input Features (Entités en entrée) à la valeur Output Table (Table en sortie) à l’aide de l’outil Ajouter une jointure, ainsi que le champ OBJECTID ou FID de l’entrée et le champ FEATURE_ID de la table en sortie.
La méthode de validation de Esri permet de s’assurer que la géométrie est topologiquement correcte à l’aide de la méthode Simplifier de Esri. La méthode de validation de Esri est la seule disponible pour les données stockées dans une géodatabase d'entreprise.
La méthode de validation de l’Open Geospatial Consortium (OGC) permet de s’assurer que la géométrie est conforme à la spécification de l’OGC telle qu’elle est définie dans OpenGIS Implementation Standard for Geographic information – simple feature access – Part 1: common architecture.
Lorsque la géométrie d'une entité est réparée à l'aide de l'option OGC, les mises à jour ou modifications ultérieures peuvent entraîner la non-conformité de la géométrie avec la spécification de l'OGC. Lorsqu'une entité est modifiée, exécutez l'outil Vérifier les géométries pour rechercher d'éventuels nouveaux problèmes géométriques. Le cas échéant, réexécutez l'outil Réparer les géométries.
La méthode Simplifier de l'OGC ne prend pas en charge les segments non linéaires, tels que les courbes de Bézier, les arcs circulaires et les arcs elliptiques. Ces types de segments devront être densifiés à l'aide de l'outil Densifier dans le jeu de données en entrée avant d'exécuter Vérifier les géométries. Pour ne pas modifier de façon irréversible les segments non linéaires lors de l'exécution de l'outil Densifier, effectuez d'abord une copie des données. Pour savoir si vos données comportent des segments non linéaires, utilisez l'outil Ajouter des attributs géométriques.
Les problèmes identifiés par cet outil peuvent être résolus des façons suivantes :
- Mettez à jour et réparez manuellement l'entité comportant les problèmes de géométrie. Certains problèmes ne peuvent pas être résolus via une mise à jour.
- Utilisez l’outil Réparer les géométries. Il est possible que certains problèmes associés aux données stockées dans une base de données d'entreprise ne puissent pas être résolus avec les outils ArcGIS.
La table en sortie contient les champs suivants :
- CLASS : chemin complet et nom de la classe d’entités dans laquelle le problème a été détecté.
- FEATURE_ID : identifiant de l’entité (FID) ou Identifiant d’objet (OID) de l’entité avec le problème de géométrie.
- PROBLEM : courte description du problème.
Le champ PROBLEM contient l’un des codes suivants :
- Short segment : certains segments sont d'une longueur inférieure à celle autorisée par les unités système de la référence spatiale associée à la géométrie.
- Null geometry : l'entité n'a aucune géométrie ou aucun élément dans le champ SHAPE.
- Incorrect ring ordering : le polygone est simple d'un point de vue topologique, mais ses boucles peuvent ne pas être orientées correctement (boucles externes dans le sens horaire, boucles internes dans le sens anti-horaire).
- Incorrect segment orientation : des segments particuliers ne sont pas orientés de manière cohérente. Le point d'arrivée du segment i doit correspondre au point de départ du segment i+1.
- Self intersections : un polygone ne doit pas être auto-sécant.
- Unclosed rings : le point d'arrivée du dernier segment dans une boucle doit correspondre au point de départ du premier segment.
- Empty parts : la géométrie comporte plusieurs parties et l’une d’elles est vide (n’a aucune géométrie).
- Duplicate vertex : la géométrie comporte deux sommets séquentiels ou plus ayant des coordonnées identiques.
- Mismatched attributes : la coordonnée Z ou M de l’extrémité d’un segment de ligne ne correspond pas à la coordonnée Z ou M de l’extrémité coïncidente sur le segment suivant.
- Discontinuous parts : une des parties de la géométrie est composée de parties déconnectées ou discontinues.
- Empty Z values : la géométrie présente un ou plusieurs sommets incluant une valeur Z vide (NaN, par exemple).
- Bad envelope : l'enveloppe ne correspond pas à l'étendue des coordonnées de la géométrie.
- Bad dataset extent : la propriété d'étendue du jeu de données ne contient pas toutes les entités du jeu de données. Pour ce problème, le champ FEATURE_ID aura la valeur -1.
Pour les données stockées dans des géodatabases d’entreprise, le champ PROBLEM contiendra l’un des codes suivants :
- NEEDS_REORDERING : la forme est OK même si elle doit être réorganisée et/ou qu'il faille supprimer des points dupliqués.
- SE_INVALID_ENTITY_TYPE : type d'entité non valide.
- SE_SHAPE_INTEGRITY_ERROR : erreur d'intégrité de forme.
- SE_INVALID_SHAPE_OBJECT : la poignée de l'objet de forme indiquée n'est pas valide.
- SE_COORD_OUT_OF_BOUNDS : la coordonnée spécifiée dépasse la plage de coordonnées valide.
- SE_POLY_SHELLS_OVERLAP : deux anneaux ou deux enveloppes externes sont superposé(e)s.
- SE_TOO_FEW_POINTS : le nombre de points est inférieur à celui requis pour l'entité.
- SE_INVALID_PART_SEPARATOR : séparateur de pièce dans la mauvaise position.
- SE_INVALID_POLYGON_CLOSURE : le polygone ne se ferme pas correctement.
- SE_INVALID_OUTER_SHELL : une enveloppe externe de polygone n'enferme pas tous les anneaux pour la pièce.
- SE_ZERO_AREA_POLYGON : l'enveloppe du polygone n'a pas de surface.
- SE_POLYGON_HAS_VERTICAL_LINE : l'enveloppe du polygone contient une ligne verticale.
- SE_OUTER_SHELLS_OVERLAP : certaines pièces de la zone multipièces sont superposées.
- SE_SELF_INTERSECTING : la chaîne de lignes ou la limite poly s’intersecte elle-même.
Syntaxe
arcpy.management.CheckGeometry(in_features, out_table, {validation_method})| Paramètre | Explication | Type de données |
in_features [in_feature,...] | Une ou plusieurs classes d'entités ou couches d'entités à vérifier afin de rechercher d'éventuels problèmes de géométrie. | Feature Layer |
out_table | Le rapport (sous forme de table) des problèmes découverts. | Table |
validation_method (Facultatif) | Indique la méthode de validation utilisée pour identifier les problèmes de géométrie.
| String |
Exemple de code
Le script de fenêtre Python suivant montre comment utiliser la fonction CheckGeometry en mode immédiat dans une géodatabase fichier.
import arcpy
arcpy.env.workspace = "c:/data/data.gdb"
arcpy.CheckGeometry_management(["contours", "roads", "vegetation"], "CheckGeom_Result")Le script autonome suivant utilise la fonction CheckGeometry en faisant une boucle sur toutes les classes d'entités dans une géodatabase fichier.
# BatchCheckGeometry.py
# Description: Loops through all the feature classes in a geodatabase, and
# generates a report of the problems encountered with feature
# geometry.
# Import modules
import arcpy
import os
# The geodatabase in which the feature classes will be checked
arcpy.env.workspace = "C:\\data\\St_Lucia.gdb"
out_table = "checkGeometryResult"
# A variable that will hold the list of all the feature classes
# inside the geodatabase
fc_list = []
# Identify all feature classes in the geodatabase
for path, dirnames, fcs in arcpy.da.Walk(arcpy.env.workspace,
datatype='FeatureClass'):
for fc in fcs:
fc_list.append(os.path.join(path, fc))
print("Running the check geometry tool on {} feature classes".format(
len(fc_list)))
arcpy.CheckGeometry_management(fc_list, out_table)
print("{} geometry problems found, see {} for details.".format(
arcpy.GetCount_management(out_table)[0], out_table))Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?