Recalculer l'étendue de la classe d'entités

Résumé

Recalcule les propriétés d’étendue XY, Z et M d’une classe d’entités en fonction des entités qu’elle contient.

L’étendue spatiale d’une classe d’entités repose sur toutes les coordonnées de la classe d’entités. Vous utilisez l’étendue spatiale lorsque vous ajoutez une classe d’entités à une carte pour recentrer et afficher toutes les entités. Plutôt que d’examiner chaque entité d’une classe d’entités chaque fois qu’elle est ajoutée à une carte (processus qui peut prendre du temps), une classe d’entités comporte une propriété d’étendue qui contient la dernière étendue spatiale connue. Toutefois, cette propriété d’étendue n’est pas toujours actualisée lorsque des entités d’une classe d’entités sont mises à jour. Cela signifie que les valeurs de la propriété d’étendue risquent de ne pas contenir l’étendue spatiale réelle des entités. Lors de son exécution, cet outil lit toutes les entités et met à jour la propriété d’étendue.

Remarque :

Les étendues XY, Z et M ne correspondent pas aux domaines de référence spatiale. Les domaines XY, Z et M d'une référence spatiale définissent la plage valide de valeurs de coordonnées pouvant être stockées dans une classe d'entités. Les étendues de la classe d’entités reflètent la plage réelle des valeurs de coordonnées présentes dans la classe d’entités. Ces étendues ne peuvent pas être plus importantes que les domaines.

Utilisation

• L’outil Recalculer l’étendue de la classe d’entités met à jour les classes d’entités de géodatabase ou les shapefiles (point, multi-points, ligne ou polygone).

• Dans une géodatabase d’entreprise, l’étendue est une propriété de la structure de classe d’entités qui nécessite l’exécution d’un verrou exclusif de structure.

• Lorsque vous utilisez cet outil avec une classe d’entités de géodatabase d’entreprise en entrée, l’étendue est calculée en fonction des entités figurant dans cette classe d’entités, dans toutes les versions. L’étendue n’est ni réduite, ni développée si vous n’exécutez pas cet outil après avoir compressé la base de données.

• L’exécution de cet outil ne peut pas aboutir si vous n’êtes pas autorisé à modifier la classe d’entités.

• Si vous recalculez l’étendue d’une classe d’entités, cette opération ne peut pas être annulée.

• Les valeurs de l’étendue sont renvoyées par la propriété extent de la fonction arcpy.Describe.

• Vous pouvez exécuter cet outil ou ouvrir la fenêtre Feature Class Properties (Propriétés de la classe d’entités) dans ArcCatalog ou Catalog (Catalogue) dans ArcMap, sélectionner l’onglet Feature Extent (Étendue de l’entité) et cliquer sur Recalculate (Recalculer) dans la section Extent (Étendue) appropriée.

Attention :

Cet outil modifie les données en entrée. Reportez-vous à la rubrique Outils sans sortie pour obtenir plus d'informations, ainsi que des stratégies pour éviter les modifications de données indésirables.

Syntaxe

arcpy.management.RecalculateFeatureClassExtent(in_features)

Paramètre	Explication	Type de données
in_features	Fichier de formes ou classe d'entités de géodatabase qui sera mis(e) à jour.	Feature Layer

Sortie dérivée

Nom	Explication	Type de données
out_features	Classe d’entités mise à jour.	Classe d’entités

Exemple de code

Exemple d'utilisation de l'outil RecalculateFeatureClassExtent (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser l'outil RecalculateFeatureClassExtent en mode immédiat. Il recalcule l'étendue XY, M ou Z d'une classe d'entités.

import arcpy
feature_class = r"C:\Data\europe.gdb\norway_cities"
arcpy.RecalculateFeatureClassExtent_management(feature_class)

Environnements

• Espace de travail courant
• Espace de travail temporaire

Informations de licence

• Basic: Non
• Standard: Oui
• Advanced: Oui