Etendue en sortie (paramètre d'environnement)
Les outils qui respectent l'environnement Etendue en sortie ne traitent que les entités ou les rasters compris dans l'étendue spécifiée avec ce paramètre.
Le paramètre d'environnement Etendue en sortie définit les entités ou les rasters devant être traités par un outil. Il est utile lorsque vous avez besoin de traiter uniquement une partie d'un jeu de données volumineux. Ce paramètre est comparable à un rectangle de sélection des entités et des rasters en entrée à traiter, comme illustré ci-dessous. Tout entité ou paramètre inclut dans le rectangle ou le croisant sera traité et écrit dans la sortie. Notez que le rectangle n'est utilisé que 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 grande que l'étendue définie par le paramètre pour prendre en compte les entités qui croisent le rectangle.
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 traite plusieurs jeux de données en entrée, le système de coordonnées du premier jeu de données s'applique à toute l'étendue.
Syntaxe de la boîte de dialogue
- Par défaut - L'outil que vous utilisez déterminera l'étendue de traitement. Tous les outils sont associés à une étendue par défaut qu'ils calculent à partir des entités en entrée. Cette étendue par défaut est rarement documentée dans la page de référence de l'outil, mais est généralement explicite. Par exemple, l'outil Intersecter ne traite que les entités qui se croisent, l'outil Agréger traite toutes les entités et l'outil Découper ne traite que les entités à l'intérieur de l'étendue des entités de découpage.
- Union des entrées - Etendue combinée de toutes les données en entrée. Tous les rasters ou entités seront traités.
- Intersection des entrées - Etendue dans laquelle tous les rasters ou entités en entrée se chevauchent (se croisent). Notez qu'il est possible qu'aucune entité n'en chevauche une autre, ce qui peut générer une étendue nulle (largeur et hauteur de zéro). Dans ce cas, aucune entité n'est traitée.
- Comme spécifié ci-dessous - vous entrez les coordonnées du rectangle (XMin, YMin, XMax, YMax).
- Identique à l'affichage - Dans ArcMap, ArcScene ou ArcGlobe, l'étendue de l'affichage en cours sera utilisée. Par exemple, si vous avez zoomé sur une zone d'étude particulière, cette option vous permet de traiter les entités comprises dans cette zone de l'étendue. Attention :
Lorsque vous spécifiez pour la première fois qu'une étendue doit être identique à l'affichage, l'étendue de l'affichage est lue et conservée. La prochaine fois que vous consulterez le paramètre Etendue, il indiquera Comme spécifié ci-dessous. Si vous modifiez l'étendue par la suite, le paramètre Etendue n'est pas mis à jour. Vous devrez redéfinir l'environnement de l'étendue.
- Comme 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 = étendue
Lorsqu'elle est définie, la propriété d'environnement de l'étendue renvoie un objet Extent dans Python.
extent | Explication |
---|---|
Objet Extent | Vous pouvez définir l'étendue à l'aide d'une classe Extent. |
MINOF | Etendue dans laquelle tous les rasters ou entités en entrée se chevauchent (se croisent). Notez qu'il est possible qu'aucune entité n'en chevauche une autre, ce qui peut générer une étendue nulle (largeur et hauteur de zéro). 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 seront 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 vers un jeu de données. Etendue du jeu de données qui sera 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"