| Étiquette | Explication | Type de données |
Entités en entrée | Une ou plusieurs classes d'entités ou couches d'entités dans lesquelles rechercher d'éventuels problèmes de géométrie. Licence :Avec une licence Desktop Basic, vous pouvez uniquement utiliser des fichiers de formes et des classes d'entités stockés dans une géodatabase fichier, un GeoPackage ou une base de données SpatiaLite en tant que formats d'entités en entrée valides. Avec une licence Desktop Standard ou Desktop Advanced, vous pouvez également utiliser des fichiers de formes stockés dans une base de données ou une géodatabase d’entreprise en tant que formats d'entités en entrée valides. | Feature Layer |
Table en sortie | Le rapport (sous forme de table) des problèmes découverts. | Table |
Méthode de validation (Facultatif) | Indique la méthode de validation utilisée pour identifier les problèmes de géométrie.
| String |
Synthèse
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 fichiers de formes et les classes d'entités stockés dans une géodatabase fichier, une base de données ou une géodatabase d'entreprise, un GeoPackage ou une base de données SpatiaLite. Les types spatiaux suivants sont pris en charge pour les classes d’entités stockées dans une base de données ou une géodatabase d’entreprise :
- Microsoft SQL Server : Géométrie et géographie
- PostgreSQL – PostGIS : Géométrie et géographie
- Oracle : SDO_Geometry
Licence :
Avec une licence Desktop Basic, vous pouvez appliquer cet outil uniquement aux fichiers de formes et aux classes d'entités stockés dans une géodatabase fichier, un GeoPackage ou une base de données SpatiaLite. Avec une licence Desktop Standard ou Desktop Advanced, vous pouvez également appliquer cet outil aux fichiers de formes stockés dans une base de données ou une géodatabase d’entreprise.
La valeur du paramètre 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 de la valeur du paramètre Table en sortie, y compris les codes du champ PROBLEM, est écrit en anglais.
Pour les entités ponctuelles, seul le problème de géométrie nulle est possible.
Pour réviser des entités identifiées comme ayant des problèmes de géométrie, vous pouvez joindre la valeur du paramètre Entités en entrée à la valeur du paramètre 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. Si l'une des valeurs du paramètre Entités en entrée est stockée dans une base de données ou une géodatabase d'entreprise, un GeoPackage ou une base de données SpatiaLite, la table en sortie comprendra également un champ TEXT_ID utilisé pour les colonnes OBJECTID à base de nombres non entiers.
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.
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 des bases de données ou des géodatabases d'entreprise, des GeoPackage ou des bases de données SpatiaLite ne puissent pas être résolus avec les outils ArcGIS.
La valeur du paramètre 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.
- TEXT_ID– Ce champ n'existe que lorsque les valeurs Entités en entrée sont stockées dans une base de données d'entreprise ou une géodatabase, un GeoPackage ou une base de données SpatiaLite.
- 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. Ce problème est indiqué par une valeur FEATURE_ID de -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 doit être réorganisée ou des points doubles être supprimé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 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 : un séparateur de pièce est dans la mauvaise position.
- SE_INVALID_POLYGON_CLOSURE : un 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 : une enveloppe de polygone n'a pas de surface.
- SE_POLYGON_HAS_VERTICAL_LINE : une enveloppe de polygone contient une ligne verticale.
- SE_OUTER_SHELLS_OVERLAP : certaines pièces d’une zone multipièces sont superposées.
- SE_SELF_INTERSECTING : une chaîne de lignes ou une limite poly s’intersecte elle-même.
Paramètres
arcpy.management.CheckGeometry(in_features, out_table, {validation_method})| Nom | Explication | Type de données |
in_features [in_features,...] | Une ou plusieurs classes d'entités ou couches d'entités dans lesquelles rechercher d'éventuels problèmes de géométrie. Licence :Avec une licence Desktop Basic, vous pouvez uniquement utiliser des fichiers de formes et des classes d'entités stockés dans une géodatabase fichier, un GeoPackage ou une base de données SpatiaLite en tant que formats d'entités en entrée valides. Avec une licence Desktop Standard ou Desktop Advanced, vous pouvez également utiliser des fichiers de formes stockés dans une base de données ou une géodatabase d’entreprise en tant que formats d'entités en entrée valides. | 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
# in 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
Cas particuliers
Informations de licence
- Basic: Limité
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?