Werkzeuge, die die Umgebungseinstellung berücksichtigen, verarbeiten nur Features oder Raster, die sich innerhalb der in dieser Einstellung angegebenen Ausdehnung befinden.
Mit der Umgebungseinstellung "Ausdehnung" werden die Features oder Raster definiert, die von einem Werkzeug verarbeitet werden. Dies ist insbesondere dann hilfreich, wenn nur ein Teil eines größeren Datasets verarbeitet werden soll. Sie können sich diese Einstellung als Rechteck vorstellen, das verwendet wird, um Eingabe-Features und -Raster für die Verarbeitung auszuwählen. Beachten Sie, dass das Rechteck nur zum Auswählen und nicht zum Ausschneiden von Features verwendet wird. Die Ausdehnung des Ausgabe-Datasets ist in der Regel größer als die Umgebungseinstellung "Ausdehnung", um Features oder Zellen einzubeziehen, die durch das Ausdehnungsrechteck verlaufen.
Verwendungshinweise
Vorsicht:
Es wird davon ausgegangen, dass die eingegebene Ausdehnung sich in dem Koordinatensystem befindet, in dem die Eingabedaten gespeichert sind, selbst wenn die Umgebung für das Ausgabe-Koordinatensystem festgelegt wurde. Wenn das Werkzeug mehrere Eingabe-Datasets verwendet, wird das Koordinatensystem der Ausdehnung durch das erste Dataset definiert.
Dialogfeldsyntax
- Standard: Das verwendete Werkzeug bestimmt die Verarbeitungsausdehnung. Alle Werkzeuge verfügen über eine Standardausdehnung, die aus deren Eingaben berechnet wird. Dieser Standardwert ist nur selten auf der Werkzeugreferenzseite dokumentiert, jedoch ist er normalerweise selbsterklärend. Das Werkzeug "Überschneiden" verarbeitet beispielsweise nur Features, die sich überschneiden, das Werkzeug "Vereinigen" verarbeitet alle Features und das Werkzeug "Ausschneiden" verarbeitet nur Features innerhalb der Ausdehnung der ausgeschnittenen Features.
- Vereinigungsmenge der Eingaben: Die kombinierte Ausdehnung aller Eingabedaten. Alle Features oder Raster werden verarbeitet.
- Schnittmenge der Eingaben: Die Ausdehnung, in der alle Eingabe-Features oder -Raster sich überschneiden (sich gegenseitig schneiden). Wenn sich keine Features oder Zellen überschneiden, kann dies eine NULL-Ausdehnung (Breite und Höhe von 0) zur Folge haben. In solchen Fällen werden keine Features verarbeitet.
- Aktuelle Anzeigeausdehnung: Die Ausdehnung der aktuellen Anzeige wird verwendet. Wenn Sie beispielsweise auf ein bestimmtes Untersuchungsgebiet gezoomt haben, können Sie diese Option zum Verarbeiten von Features verwenden, die innerhalb der aktuellen Anzeigeausdehnung liegen.
- Wie unten angegeben: Sie geben die Koordinaten für die Seiten des Rechtecks (links, rechts, oben und unten) an.
- Durchsuchen: Zu einem Dataset navigieren. Die Ausdehnung des Datasets wird für die Umgebungseinstellung "Ausdehnung" verwendet.
- Wie Layer: In der Liste sind alle Layer der aktiven Karte aufgeführt, und Sie können einen Layer als Ausdehnung auswählen.
Wenn Sie die Option Aktuelle Anzeigeausdehnung, Wie unten angegeben oder Wie Layer verwenden, wird die Ausdehnung ausgelesen und gespeichert. Die Umgebungseinstellung "Ausdehnung" wird angezeigt als Wie unten angegeben.
Skriptsyntax
arcpy.env.extent = extent
Hinweis:
Bei dieser Einstellung gibt die Umgebungseigenschaft "Ausdehnung" ein Extent-Objekt in Python zurück.
| Ausdehnung | Erläuterung |
|---|---|
Extent-Objekt | Ein Extent-Objekt kann zum Definieren der Ausdehnung verwendet werden. |
MINOF | Die Ausdehnung, in der alle Eingabe-Features oder -Raster sich überschneiden (sich gegenseitig schneiden). Beachten Sie, dass sich möglicherweise keine Features überschneiden und dies eine NULL-Ausdehnung (Breite und Höhe von NULL) zur Folge haben kann. In solchen Fällen werden keine Features oder Zellen verarbeitet. |
MAXOF | Die kombinierte Ausdehnung aller Eingabedaten. Alle Features oder Zellen werden verarbeitet. |
"XMin, YMin, XMax, YMax" | Durch Leerzeichen getrennte Koordinaten, die die Ausdehnung des Koordinatensystems definieren, in dem die Eingabedaten gespeichert sind. |
Pfadname | Der Pfad zu einem Dataset. Die Ausdehnung des Datasets wird verwendet. |
Skriptbeispiel
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"