Etendue (paramètres d'environnement)

Les outils qui respectent l’environnement Extent (Étendue) 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 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 É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

• Current Display Extent (Étendue actuellement affichée)  : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active.
• Extent of a Layer (Étendue d’une couche)  : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active.
• 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 minimale ou l’étendue d’intersection de toutes les entrées. S’il n’existe aucune intersection entre les entrées, il en résulte une étendue nulle avec uniquement des zéros.
• Union of Inputs (Union des entrées)  : l’étendue est basée sur l’étendue maximale ou combinée de toutes les entrées.
• Reset Extent (Réinitialiser l’étendue)  : la valeur par défaut de l’étendue est rétablie.
• Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées 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

Lorsque vous utilisez l’option Current Display Extent (Étendue actuellement affichée), Extent of a Layer (Étendue d’une couche) ou Browse (Parcourir), l’étendue est lue et stockée.

Syntaxe de script

arcpy.env.extent = extent

Remarque :

Une fois qu’elle est 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). 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.
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"