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

Résumé

Cet outil permet de recalculer la propriété 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 d'une 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 qu'elle contient. 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é extent qui contient la dernière étendue spatiale connue. Toutefois, cette propriété extent n'est pas toujours actualisée lorsque des entités d'une classe d'entités sont modifiées. Cela signifie que les valeurs de la propriété extent 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é extent.

Remarque :

Les étendues XY, Z et M présentées ici 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. L’étendue de la classe d’entités reflète 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'option Recalculer l'étendue de la classe d'entités met à jour les classes d'entités de géodatabase ou les fichiers de formes (ponctuelles, multi-points, linéaires ou surfaciques).

• Dans une géodatabase d'entreprise, extent 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'extent est calculée en fonction des entités figurant dans cette classe d'entités, dans toutes les versions. L'extent ne sera 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 pourra pas aboutir si vous n'êtes pas autorisé à modifier la classe d'entités.

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

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

• Vous pouvez exécuter cet outil ou ouvrir la boîte de dialogue Propriétés de la classe d’entités dans ArcCatalog ou la fenêtre Catalogue dans ArcMap, sélectionner l'onglet Etendue de l’entité et cliquer sur Recalculer dans la section Etendue 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

RecalculateFeatureClassExtent_management (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

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

• ArcGIS Desktop Basic: Non
• ArcGIS Desktop Standard: Oui
• ArcGIS Desktop Advanced: Oui