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
- Aktuelle Anzeigeausdehnung
: Die Ausdehnung basiert auf der aktiven Karte oder Szene. Diese Option ist nur verfügbar, wenn eine aktive Karte vorhanden ist. - Ausdehnung eines Layers:
Die Ausdehnung basiert auf einem aktiven Karten-Layer. Verwenden Sie die Dropdown-Liste, um einen verfügbaren Layer auszuwählen, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern, um die kombinierte Ausdehnung aller aktiven Karten-Layer mit Ausnahme der Grundkarte zu erhalten. Diese Option ist nur verfügbar, wenn eine aktive Karte mit Layern vorhanden ist. - Durchsuchen:
Die Ausdehnung basiert auf einem vorhandenen Dataset. - Schnittmenge der Eingaben
: Die Ausdehnung basiert auf der kleinsten oder überschneidenden Ausdehnung aller Eingaben. Wenn sich keine Eingaben überschneiden, entsteht eine Nullausdehnung. - Vereinigungsmenge der Eingaben:
Die Ausdehnung basiert auf der maximalen oder kombinierten Ausdehnung aller Eingaben. - Ausdehnung zurücksetzen
: Die Ausdehnung wird auf den Standardwert zurückgesetzt. - Manuell eingegebene Koordinaten: Die Koordinaten müssen numerische Werte sein und im Koordinatensystem der aktiven Karte liegen.
Die Karte verwendet möglicherweise unterschiedliche Anzeigeeinheiten.
Wenn Sie die Option Aktuelle Anzeigeausdehnung, Ausdehnung eines Layers oder Durchsuchen verwenden, wird die Ausdehnung ausgelesen und gespeichert.
Skriptsyntax
arcpy.env.extent = extent
Hinweis:
Bei dieser Einstellung gibt die Ausdehnungsumgebungseigenschaft 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). Möglicherweise überschneiden sich keine Features, und dies kann 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"