Ausdehnung (Umgebungseinstellung)

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

• Das im ausblendbaren Abschnitt Ausdehnungskoordinatensystem aufgeführte Koordinatensystem wird von Werkzeugen zum Interpretieren der Position der Ausdehnungskoordinaten verwendet, und es wird nicht von der Umgebung Ausgabekoordinatensystem beeinflusst.
• Die Optionen Aktuelle Anzeigeausdehnung , Ausdehnung darstellen und Ausdehnung eines Layers verwenden das Koordinatensystem der aktiven Karte.
• Die Optionen Durchsuchen und Zwischenablage nutzen das Koordinatensystem des Datasets oder das eingefügte Koordinatensystem.
• Die Optionen Vereinigungsmenge der Eingaben und Schnittmenge der Eingaben bestimmen das Koordinatensystem zur Laufzeit des Werkzeugs und verwenden das Koordinatensystem des ersten Eingabe-Datasets.
• Wenn eine Ausdehnung ohne ein Koordinatensystem angegeben ist, verwendet die Ausdehnung das Koordinatensystem des ersten von einem Werkzeug verwendeten Eingabe-Datasets.

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 darstellen : Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Bei dieser Option wird eine Feature-Class in der Projekt-Geodatabase erstellt und ein Layer zur Karte hinzugefügt. Das Koordinatensystem der Feature-Class stimmt mit dem der Karte überein.

  Hinweis:

  Diese Option ist im Dialogfeld Umgebungen nicht verfügbar. Sie ist nur über einen Werkzeugparameter mit dem Datentyp "Ausdehnung" oder über die Registerkarte Umgebungen eines Werkzeugdialogfeldes verfügbar.

  Hinweis:

  Wenn die Bearbeitungsoption Bearbeitung über die Registerkarte "Bearbeiten" aktivieren und deaktivieren aktiviert ist, dann müssen Sie auf der Registerkarte Bearbeiten des Menübands die Bearbeitung aktivieren, um die Ausdehnung darzustellen.

• 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.

  Jeder Karten-Layer bietet die folgenden Optionen:

  • Alle Features : Die Ausdehnung aller Features im Layer.
  • Ausgewählte Features: Die Ausdehnung der ausgewählten Features im Layer.
  • Sichtbare Features : Die Ausdehnung sichtbarer Features im Layer.

    Hinweis:

    Die Ausdehnungen der Optionen Ausgewählte Features und Sichtbare Features sind nur für Feature-Layer verfügbar.

• 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.
• Zwischenablage : Die Ausdehnung kann in die und aus der Zwischenablage kopiert werden.
  • Ausdehnung kopieren : Kopiert die Ausdehnungskoordinaten und das Ausdehnungskoordinatensystem in die Zwischenablage.
  • Ausdehnung einfügen : Fügt die Ausdehnungskoordinaten und optional das Koordinatensystem aus der Zwischenablage ein. Wenn die Werte in der Zwischenablage kein Koordinatensystem beinhalten, wird für die Ausdehnung das Koordinatensystem der Karte verwendet.

  Hinweis:

  Beim Kopieren der Ausdehnungskoordinaten in die und Einfügen aus der Zwischenablage wird dieselbe Formatierung und Reihenfolge wie beim ArcPy-Objekt Extent verwendet: X-Min, Y-Min, X-Max, Y-Max und der Raumbezug.

• 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.

  Vorsicht:

  Die Karte kann statt der eingegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Die Verwendung einer Kardinalrichtung (N, S, O, W) wird nicht unterstützt. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.

Wenn Sie die Option Aktuelle Anzeigeausdehnung , Ausdehnung darstellen , Ausdehnung eines Layers oder Durchsuchen verwenden, wird die Ausdehnung in diesem Moment ausgelesen und gespeichert. Wenn dann später eine Änderung an der Karte, am Layer bzw. am Dataset vorgenommen wird, wird die Ausdehnung nicht aktualisiert. Die Optionen Schnittmenge der Eingaben und Vereinigungsmenge der Eingaben bestimmen die Koordinaten der Ausdehnung und das Koordinatensystem bei der Ausführung des Werkzeugs.

Skriptsyntax

arcpy.env.extent = extent

Hinweis:

Bei dieser Einstellung gibt die Umgebungseigenschaft extent ein Extent-Objekt in Python zurück.

extent-Syntax

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"