Ausgabeausdehnung (Umgebungseinstellung)

Werkzeuge, die die Umgebungseinstellung "Ausgabeausdehnung" berücksichtigen, verarbeiten nur die Features oder Raster, die sich in der für diese Einstellung angegebenen Ausdehnung befinden.

Die Umgebungseinstellung "Ausgabeausdehnung" definiert die Features oder Raster, die von einem Werkzeug verarbeitet werden. Diese Einstellung ist hilfreich, wenn nur ein Teil eines größeren Datasets verarbeitet werden muss. Sie können sich diese Einstellung wie ein Rechteck vorstellen, das für die Auswahl von Eingabe-Features und -Rastern für die Verarbeitung verwendet wird, wie nachfolgend veranschaulicht. Jedes Feature oder Raster, das durch das Rechteck verläuft, wird verarbeitet und in die Ausgabe geschrieben. Beachten Sie, dass das Rechteck nur zum Auswählen der Features verwendet wird, nicht zum Ausschneiden. Die Ausdehnung des Ausgabe-Datasets ist in der Regel größer als die Einstellung für die Ausgabeausdehnung, um alle Features einzubeziehen, die durch das Ausdehnungsrechteck verlaufen.

Verwendungshinweise

• Vorsicht:

  Für die eingegebene Ausdehnung wird angenommen, dass sie sich in dem Koordinatensystem befindet, in dem die Eingabedaten gespeichert sind, selbst wenn die Umgebungseinstellung für das Ausgabe-Koordinatensystem festgelegt wurde. Wenn das Werkzeug mit mehreren Eingabe-Datasets arbeitet, definiert das erste Dataset das Koordinatensystem der Ausdehnung.

Dialogfeldsyntax

• Standard – Die Verarbeitungsausdehnung wird durch das verwendete Werkzeug bestimmt. Für alle Werkzeuge gibt es eine Standardausdehnung, die aus ihren Eingaben berechnet wird. Dieser Standard wird in der Werkzeugreferenzseite selten dokumentiert, ist aber gewöhnlich offensichtlich. Mit dem Werkzeug Überschneiden (Intersect) werden nur Features verarbeitet, die einander überschneiden. Mit dem Werkzeug Vereinigen (Union) können alle Features verarbeitet werden, und mit dem Werkzeug Ausschneiden werden nur Features in der Ausdehnung der auszuschneidenden Features verarbeitet.
• Vereinigungsmenge der Eingaben – Die kombinierte Ausdehnung aller Eingabedaten. Alle Features oder Raster werden verarbeitet.
• Schnittmenge der Eingaben – Die Ausdehnung, in der sich alle Eingabe-Features oder -Raster überlappen (einander überschneiden). Beachten Sie, dass es vorkommen kann, dass sich keine Features überlappen und sich eine Nullausdehnung (Breite und Höhe gleich Null) ergibt. In solchen Fällen werden keine Features verarbeitet.
• Wie unten angegeben – Sie geben die Koordinaten des Rechtecks (XMin, YMin, XMax, YMax) ein.
• Gleich wie Anzeige – In ArcMap, ArcScene oder ArcGlobe wird die Ausdehnung der aktuellen Anzeige verwendet. Wenn Sie z. B. ein bestimmtes Untersuchungsgebiet vergrößert haben, können Sie mit dieser Option Features verarbeiten, die sich in der aktuellen Anzeigeausdehnung befinden.
  Vorsicht:

  Wenn Sie beim ersten Mal für die Ausdehnung angeben, dass sie mit der Anzeige identisch sein soll, wird die Ausdehnung der Anzeige gelesen und gespeichert. Wenn Sie die Ausdehnungseinstellung das nächste Mal untersuchen, wird die Option Wie unten angegeben angezeigt. Wenn Sie die Ausdehnung der Anzeige nachträglich ändern, wird die Ausdehnungseinstellung nicht aktualisiert – Sie müssen die Ausdehnungsumgebung zurücksetzen.

• Wie Layer <Name> – In der Liste sind alle Layer aufgeführt, und Sie können einen Layer als Ausdehnung auswählen. Wie bei der Option Gleich wie Anzeige wird die Ausdehnung des Layers gelesen und gespeichert. Wenn Sie die Ausdehnungseinstellung das nächste Mal untersuchen, wird die Option Wie unten angegeben angezeigt.

Skriptsyntax

arcpy.env.extent = extent

Hinweis:

Wenn die Eigenschaft der Ausdehnungsumgebung festgelegt wurde, wird ein Ausdehnungsobjekt in Python zurückgegeben.

Ausdehnung	Erläuterung
Ausdehnungsobjekt	Die Ausdehnung kann mit einer Ausdehnungsklasse definiert werden.
MINOF	Die Ausdehnung, in der sich alle Eingabe-Features oder -Raster überlappen (einander überschneiden). Beachten Sie, dass es vorkommen kann, dass sich keine Features überlappen und sich eine Nullausdehnung (Breite und Höhe gleich Null) ergibt. In solchen Fällen werden keine Features verarbeitet.
MAXOF	Die kombinierte Ausdehnung aller Eingabedaten. Alle Features oder Raster werden verarbeitet.
XMin, YMin, XMax, YMax	Durch Leerzeichen getrennte Koordinaten, die die Ausdehnung im Koordinatensystem definieren, in dem die Eingabedaten gespeichert sind.
Pfadname	Pfad zum Dataset. Die Ausdehnung des Datasets wird verwendet.

Ausdehnungssyntax

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"