Etendue (paramètres d'environnement)

Les outils qui respectent l'environnement Etendue traitent uniquement les entités ou rasters qui se trouvent au sein de l'étendue spécifiée dans ce paramètre.

L’environnement Étendue définit les entités ou rasters qui seront traités par un outil. Il est utile lorsque vous devez traiter uniquement une partie d'un plus vaste jeu de données. 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. Notez que 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 Étendue afin de prendre en compte les entités ou cellules qui sont à cheval sur le rectangle d’emprise.

Remarques sur l'utilisation

• Attention :

  L'étendue définie est supposée être dans le système de coordonnées de stockage des données en entrée, même si l'environnement Système de coordonnées en sortie est défini. Si l'outil accepte plusieurs jeux de données en entrée, le premier jeu de données définit le système de coordonnées de l'étendue.

Syntaxe de la boîte de dialogue

• Par défaut : l'outil utilisé détermine l'étendue de traitement. Tous les outils possèdent une étendue par défaut qui est calculée à partir de leurs entrées. Cette valeur par défaut est rarement documentée sur la page de référence des outils, mais est généralement évidente. Par exemple, l’outil Intersecter traite uniquement les entités qui s’intersectent, l’outil Union traite toutes les entités et l’outil Découper traite uniquement les entités qui se trouvent dans l’étendue des entités de découpage.
• Union des entrées : étendue combinée de toutes les données en entrée. Tous les rasters ou entités sont traités.
• Intersection of Input (Intersection des entrées) : étendue dans laquelle toutes les entités en entrée ou tous les rasters se superposent (s’intersectent). Si aucune des entités ou cellules n’est superposée, une étendue de valeur nulle (largeur et hauteur égales à zéro) est engendrée. Dans ce cas, aucune entité ne sera traitée.
• Etendue actuellement affichée : l'étendue de l'affichage en cours est utilisé. Si, par exemple, vous avez appliqué un zoom avant à une zone d’étude, vous pouvez utiliser cette option pour traiter les entités comprises dans l’étendue d’affichage actuelle.
• As Specified Below (Comme spécifié ci-dessous) : saisissez les coordonnées des côtés du rectangle (gauche, droit, supérieur et inférieur).
• Browse (Parcourir) : accédez à un jeu de données. L’étendue du jeu de données est utilisé pour l’environnement Étendue.
• Same As Layer (Identique à la couche) : toutes les couches de la carte active sont répertoriées et vous pouvez en choisir une en guise d’étendue.

Lorsque vous utilisez l’option Current Display Extent (Étendue actuellement affichée), As Specified Below (Comme spécifiée ci-dessous) ou Same As Layer (Identique à la couche), l’étendue de la couche est lue et stockée. L’environnement Étendue apparaît comme As Specified Below (Comme spécifié ci-dessous).

Syntaxe de script

arcpy.env.extent = extent

Remarque :

Une fois définie, la propriété d’environnement de l’étendue renvoie un objet Extent dans Python.

Syntaxe extent

étendue	Explication
Objet Extent	Un objet Extent peut servir à définir l’étendue.
MINOF	Etendue dans laquelle toutes les entités en entrée ou tous les rasters se superposent (s'intersectent). Notez qu'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 engendré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.
Nom de chemin	Le chemin d’un jeu de données. L’étendue du jeu de données est utilisée.

Exemple 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"