Etendue (Paramètre d’environnement)

Les outils qui respectent l’environnement Extent (Étendue) ne vont traiter que les entités ou les rasters qui intersectent l’étendue spécifiée.

L’environnement Extent (Étendue) définit les entités ou rasters qui seront traités par un outil. Il est utile lorsque vous traitez uniquement une partie d’un jeu de données plus vaste. Vous pouvez considérer ce paramètre comme un rectangle permettant de sélectionner des rasters et entités en entrée en vue de les traiter. Le rectangle est utilisé uniquement pour sélectionner des entités, et non pour les découper. L’étendue du jeu de données en sortie est généralement plus vaste que l’environnement Extent (Étendue) afin de prendre en compte les entités ou cellules qui sont à cheval sur le rectangle d’emprise.

Remarques sur l’utilisation

• Le système de coordonnées indiqué sous la section réductible Extent Coordinate System (Système de coordonnées de l’étendue) est utilisé par les outils pour interpréter la localisation des coordonnées de l’étendue et n’est pas affecté par l’environnement Output Coordinate System (Système de coordonnées en sortie).

• Les options Current Display Extent (Étendue d’affichage actuelle) , Draw Extent (Dessiner l’étendue) et Extent of a Layer (Étendue d’une couche) utilisent le système de coordonnées de la carte active.

• Les options Browse (Parcourir) et Clipboard (Presse-papiers) utilisent le système de coordonnées du jeu de données ou celui qui est fourni.

• Les options Intersection of Inputs (Intersection des entrées) et Union of Inputs (Union des entrées) déterminent le système de coordonnées lors de l’exécution de l’outil et utilisent le système de coordonnées du premier jeu de données en entrée.

• Lorsqu’une étendue est spécifiée sans système de coordonnées, elle utilise le système de coordonnées du premier jeu de données en entrée utilisé par un outil.

Syntaxe de la boîte de dialogue

• Current Display Extent (Étendue actuellement affichée) —L’étendue repose sur la carte ou scène active.

• Draw Extent (Dessiner l’étendue) —L’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène.

• Extent of a Layer (Étendue d’une couche) —L’étendue repose sur une couche de carte active. Choisissez une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches). Chaque couche de carte comporte les options suivantes :

  • All Features (Toutes les entités) —Étendue de toutes les entités.

  • Selected Features (Entités sélectionnées) —Étendue des entités sélectionnées.

  • Visible Features (Entités visibles) —Étendue des entités visibles.

• Browse (Parcourir) —L’étendue repose sur un jeu de données existant.

• Intersection of Inputs (Intersection des entrées) —L’étendue repose sur l’étendue d’intersection de toutes les entrées.

• Union of Inputs (Union des entrées) —L’étendue est l’étendue combinée de toutes les entrées.

• Clipboard (Presse-papiers) ![Coller]../../icons/EditPaste16.png—L’étendue peut être copiée depuis et vers le Presse-papiers.

  • Copy Extent (Copier l’étendue) —Copie l’étendue et le système de coordonnées dans le Presse-papiers.

  • Paste Extent (Coller l’étendue) ![Coller]../../icons/EditPaste16.png—Colle l’étendue et le système de coordonnées depuis le Presse-papiers. Si le Presse-papiers n’inclut pas de système de coordonnées, l’étendue utilise celui de la carte.

• Reset Extent (Réinitialiser l’étendue) —La valeur par défaut de l’étendue est rétablie.

Remarque :

Lorsque l’option de mise à jour Enable and disable editing (Activer et désactiver la mise à jour) de l’onglet Edit (Mettre à jour) est activée, vous devez activer la mise à jour dans l’onglet du ruban Edit (Mettre à jour) pour dessiner l’étendue.

Lorsque les coordonnées sont saisies manuellement, elles doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. Utilisez le signe moins pour les coordonnées sud et ouest.

Lorsque vous utilisez l’option Current Display Extent (Étendue d’affichage actuelle) , Draw Extent (Dessiner l’étendue) , Extent of a Layer (Étendue d’une couche) ou Browse (Parcourir) , l’étendue est lue et stockée à ce moment-là. Elle n’est pas mise à jour ultérieurement si une modification est apportée à la carte, à la couche ou au jeu de données. Les options Intersection of Inputs (Intersection des entrées) et Union of Inputs (Union des entrées) déterminent les coordonnées et le système de coordonnées de l’étendue au moment de l’exécution de l’outil.

Syntaxe Python

arcpy.env.extent = extent

Nom

Explication

extent

Extent objet—Un objet Extent (Étendue) peut être utilisé pour définir l’étendue. MINOF—Étendue dans laquelle tous les rasters ou toutes les entités en entrée se superposent (s’intersectent). Il est possible qu’aucune des entités ne soit superposée et qu’une étendue de valeur nulle (largeur et hauteur égales à zéro) soit générée. Dans ce cas, aucune entité ou cellule n'est traitée. MAXOF—Etendue combinée de toutes les données en entrée. Toutes les entités ou cellules seront traitées. "XMin, YMin, XMax, YMax"—Coordonnées délimitées par des espaces qui définissent l'étendue dans le système de coordonnées dans lequel les données en entrée sont stockées. Path name—Le chemin d’un jeu de données. L’étendue du jeu de données est utilisée. Remarque : Une fois définie, la propriété d’environnement extent renvoie un objet Extent dans Python.

Syntaxe de script

import arcpy

# Set the extent environment using a keyword
arcpy.env.extent = "MAXOF"

# Set the extent environment using the Extent class
arcpy.env.extent = arcpy.Extent(-107.0, 38.0, -104.0, 40.0)

# Set the extent environment using a space-delimited string
arcpy.env.extent = "-107.0 38.0 -104.0 40.0"

# Set the extent environment using a feature class
arcpy.env.extent = "C:/data/StudyArea_perim.shp"

# Set the extent environment using a raster
arcpy.env.extent = "C:/data/StudyArea.tif"

Rubriques connexes

• Paramètres d’environnement de géotraitement