Etendue en sortie (paramètre d'environnement)
Les outils qui respectent l'environnement Etendue en sortie traitent uniquement les entités ou rasters qui se trouvent au sein de l'étendue spécifiée dans ce paramètre.
Le paramètre d'environnement Etendue en sortie définit les entités ou rasters qui seront traités par un outil. Ce paramètre 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. Les entités ou rasters qui passent par le rectangle seront traités et écrits dans la sortie. 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 le paramètre Etendue en sortie afin de prendre en compte les entités qui passent par 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 qu'ils calculent à 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 Agréger traite toutes les entités et l'outil Découper traite uniquement les entités qui se trouvent au sein de 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 des entrées : étendue 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é n'est traitée.
- Comme spécifié ci-dessous : entrez les coordonnées des côtés du rectangle (gauche, droit, supérieur et inférieur).
- Identique à l'affichage : dans ArcMap, ArcScene ou ArcGlobe, l'étendue de l'affichage en cours est utilisée. Par exemple, si vous avez appliqué un zoom avant sur votre zone d'étude, vous pouvez utiliser cette option pour traiter les entités qui sont comprises au sein de l'étendue d'affichage actuelle. Attention :
Lorsque vous spécifiez la première fois qu'une étendue est identique à l'affichage, l'étendue de l'affichage est lue et stockée. La prochaine fois que vous consulterez le paramètre Etendue, il indiquera Comme spécifié ci-dessous. Si vous modifiez ultérieurement l'étendue de l'affichage, le paramètre Etendue n'est pas mis à jour ; vous devez redéfinir l'environnement Etendue.
- Identique à la couche <nom> : toutes les couches sont répertoriées et vous pouvez en choisir une comme étendue. A l'instar de l'option Identique à l'affichage, l'étendue de la couche est lue et stockée. La prochaine fois que vous consulterez le paramètre Etendue, il indiquera 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.
étendue | Explication |
|---|---|
Objet Extent | Une classe Etendue 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é n'est traitée. |
MAXOF | Etendue combinée de toutes les données en entrée. Tous les rasters ou entités sont traités. |
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 | 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"