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.

Features, die durch die Ausdehnung verlaufen, werden verarbeitet.

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 Kartenansicht, Ausdehnung darstellen Ausgleichen und Beenden und Ausdehnung eines Layers Layer verwenden das Koordinatensystem der aktiven Karte.
  • Die Optionen Durchsuchen Durchsuchen und Zwischenablage Einfügen nutzen das Koordinatensystem des Datasets oder das eingefügte Koordinatensystem.
  • Die Optionen Vereinigungsmenge der Eingaben Überschneiden und Schnittmenge der Eingaben Vereinigen 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 Kartenansicht: Die Ausdehnung basiert auf der aktiven Karte oder Szene. Diese Option ist nur verfügbar, wenn eine aktive Karte vorhanden ist.
  • Ausdehnung darstellen Ausgleichen und Beenden: 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:Layer 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 Alles auswählen: Die Ausdehnung aller Features im Layer.
    • Ausgewählte FeaturesArea from Selected Features: Die Ausdehnung der ausgewählten Features im Layer.
    • Sichtbare Features Extent Indicator: Die Ausdehnung sichtbarer Features im Layer.
      Hinweis:

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

  • Durchsuchen:Durchsuchen Die Ausdehnung basiert auf einem vorhandenen Dataset.
  • Schnittmenge der Eingaben Überschneiden: Die Ausdehnung basiert auf der kleinsten oder überschneidenden Ausdehnung aller Eingaben. Wenn sich keine Eingaben überschneiden, entsteht eine Nullausdehnung.
  • Vereinigungsmenge der Eingaben:Vereinigen Die Ausdehnung basiert auf der maximalen oder kombinierten Ausdehnung aller Eingaben.
  • Zwischenablage Einfügen: Die Ausdehnung kann in die und aus der Zwischenablage kopiert werden.
    • Ausdehnung kopieren Kopieren: Kopiert die Ausdehnungskoordinaten und das Ausdehnungskoordinatensystem in die Zwischenablage.
    • Ausdehnung einfügen 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: ZurücksetzenDie 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 Kartenansicht, Ausdehnung darstellen Ausgleichen und Beenden, Ausdehnung eines Layers Layer oder Durchsuchen 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 Überschneiden und Vereinigungsmenge der Eingaben Vereinigen 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.

AusdehnungErlä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.

extent-Syntax

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"