Recalculer l’étendue de la classe d’entités (Gestion des données)

Synthèse

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. L’outil Recalculer l’étendue de la classe d’entités 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

  • Cet outil 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.

  • Le paramètre Étendue de stockage est pris en charge pour les tables spatiales non inscrites dans une base de données ou une géodatabase d’entreprise. Si ce paramètre est sélectionné, la nouvelle étendue est stockée dans les métadonnées de la colonne de forme de la table sous-jacente. Si ce paramètre n’est pas sélectionné, l’étendue est recalculée, mais la valeur n’est pas stockée, ce qui peut s’avérer utile si les données sous-jacentes sont fréquemment mises à jour.

  • 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.

  • Attention :

    Cet outil modifie les données en entrée. Pour plus d’informations et connaître les stratégies permettant d’empêcher les modifications de données indésirables, reportez-vous à la rubrique Outils qui modifient ou mettent à jour les données en entrée.

Paramètres

ÉtiquetteExplicationType de données
Classe d’entités en entrée

Fichier de formes ou classe d'entités de géodatabase qui sera mis(e) à jour.

Feature Layer
Stocker l’étendue
(Facultatif)

Indique si l’étendue des classes d’entités qui ne sont pas inscrites est stockée. Ce paramètre est actif uniquement si la classe d’entités en entrée est une table spatiale non inscrite dans une base de données ou une géodatabase d’entreprise.

Si la classe d’entités en entrée fait l’objet de mises à jour fréquentes, vous pouvez choisir de ne pas stocker la valeur d’étendue recalculée. Si vous choisissez de stocker l’étendue, celle-ci n’est pas recalculée à chaque ajout de la classe d’entités à une carte.

  • Activé : l’étendue de la classe d’entités en entrée est stockée.
  • Désactivé : l’étendue de la classe d’entités en entrée n’est pas stockée. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Classe d’entités mise à jour

Classe d’entités mise à jour.

Feature Class

arcpy.management.RecalculateFeatureClassExtent(in_features, {store_extent})
NomExplicationType de données
in_features

Fichier de formes ou classe d'entités de géodatabase qui sera mis(e) à jour.

Feature Layer
store_extent
(Facultatif)

Indique si l’étendue des classes d’entités qui ne sont pas inscrites est stockée. Ce paramètre est pris en charge uniquement si la classe d’entités en entrée est une table spatiale non inscrite dans une base de données ou une géodatabase d’entreprise.

Si la classe d’entités en entrée fait l’objet de mises à jour fréquentes, vous pouvez choisir de ne pas stocker la valeur d’étendue recalculée. Si vous choisissez de stocker l’étendue, celle-ci n’est pas recalculée à chaque ajout de la classe d’entités à une carte.

  • STORE_EXTENTL’étendue de la classe d’entités en entrée est stockée.
  • DO_NOT_STORE_EXTENTL’étendue de la classe d’entités en entrée n’est pas stockée. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
out_features

Classe d’entités mise à jour.

Feature Class

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction RecalculateFeatureClassExtent en mode immédiat. Elle recalcule l’étendue xy, z ou m d’une classe d’entités.

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

Rubriques connexes