Kostengünstigster Korridor (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Berechnet die Summe von zwei Rastern der akkumulativen Kostenentfernung. Dabei besteht die Option, basierend auf einem Prozentsatz oder akkumulativen Kosten einen Schwellenwert anzuwenden.

Weitere Informationen zum Verbinden von Positionen mit Korridoren

Verwendung

• Die Eingabe-Raster sind Entfernungsakkumulations- und Gegenrichtungs-Raster-Ausgaben der Werkzeuge Entfernungsakkumulation oder Entfernungsallokation.

• Verwenden Sie die Kostenversion der Entfernungsakkumulations-Raster. Die Einheiten der Raster können je nach Anwendung Dollar pro Meter, Präferenz pro Fuß oder Minuten pro Meter sein. Es sind aber auch andere Einheiten möglich. Diese Kosteneinheiten werden in der Kostenoberfläche erfasst. Weitere Informationen finden Sie unter Anpassen der zurückgelegten Entfernung unter Verwendung einer Kostenoberfläche.

• Korridore weisen keine Richtung auf. Dies bedeutet, dass die Bewegung von der ersten Quelle zur zweiten so viel kostet wie die Bewegung von der zweiten Quelle zur ersten. Geben Sie beim Erstellen der akkumulativen Kostenentfernungs- und Gegenrichtungs-Raster keine Werte für Parameter an, die von Richtungen abhängig sind. Dies sind der horizontale Faktor, der vertikale Faktor und die Reiserichtung.

• Verwenden Sie die gleichen Parametereinstellungen für das Werkzeug Entfernungsakkumulation oder Entfernungsallokation, wenn Sie die akkumulativen Kostenentfernungs- und Gegenrichtungs-Raster der ersten Quelle und der zweiten Quelle erstellen.

• Die Werte im Ausgabe-Korridor stellen die Summe der akkumulativen Kosten beim Erreichen einer bestimmten Position mit den gleichen Einheiten wie die Eingabe-Raster der akkumulativen Kostenentfernung dar.

• Wenn ein angegebener Schwellenwert größer ist als die maximalen akkumulativen Kosten beim Summieren der zwei Entfernungsakkumulations-Raster, deckt das Ausgabe-Korridor-Raster die gleiche Fläche wie die Eingabe-Akkumulations-Raster ab.

• Wenn ein angegebener Schwellenwert unter dem Minimalwert im Korridor-Raster liegt, wird eine Warnmeldung zurückgegeben, und das Ausgabe-Raster ist leer.

• Das Ausgabe-Korridor-Raster kann Zellen mit etwas höheren akkumulativen Kosten als der Schwellenwert enthalten. Diese entstehen dadurch, dass in Gegenrichtungs-Rastern Zellen verwendet werden, denen etwas höhere Kosten zugewiesen sind, um unverbundene Zellen mit dem Korridor zu verbinden. Weitere Informationen finden Sie unter Verbinden von Positionen durch Korridore.

• Zum Generieren eines Korridors wird die Umgebungseinstellung Zellengröße ignoriert, und zum Berechnen des Ausgabe-Rasters wird die Zellengröße der Eingabe-Raster mit akkumulativen Kosten verwendet. Das Muster des Eingabe-Rasters würde geändert werden, wenn für die Ausgabe ein Resampling mit einer anderen Auflösung durchgeführt würde.

• Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster der akkumulativen Kostenentfernung 1	Das Eingabe-Raster, das die akkumulative Kostenentfernung von der ersten Quelle darstellt. Verwenden Sie die Entfernungsakkumulationsausgabe des Werkzeugs Entfernungsakkumulation oder Entfernungsallokation.	Raster Layer
Eingabe-Gegenrichtungs-Raster 1	Das Eingabe-Gegenrichtungs-Raster von der ersten Quelle. Die Einheiten sind Grad und kennzeichnen die nächste Zelle entlang des kostengünstigsten Pfades zurück zur ersten Quelle. Verwenden Sie die Gegenrichtungsausgabe des Werkzeugs Entfernungsakkumulation oder Entfernungsallokation. Der Wertebereich reicht von 0 Grad bis 360 Grad, wobei 0 Grad für die Quellenzellen reserviert ist. In östlicher Richtung (rechts) befindet sich der 90-Grad-Winkel, und die Werte nehmen im Uhrzeigersinn zu (180 Grad ist Süden, 270 Grad ist Westen und 360 Grad ist Norden).	Raster Layer
Eingabe-Raster der akkumulativen Kostenentfernung 2	Das Eingabe-Raster, das die akkumulative Kostenentfernung von der zweiten Quelle darstellt. Verwenden Sie die Entfernungsakkumulationsausgabe des Werkzeugs Entfernungsakkumulation oder Entfernungsallokation.	Raster Layer
Eingabe-Gegenrichtungs-Raster 2	Das Eingabe-Gegenrichtungs-Raster von der zweiten Quelle. Die Einheiten sind Grad und kennzeichnen die nächste Zelle entlang des kostengünstigsten Pfades zurück zur zweiten Quelle. Verwenden Sie die Gegenrichtungsausgabe des Werkzeugs Entfernungsakkumulation oder Entfernungsallokation. Der Wertebereich reicht von 0 Grad bis 360 Grad, wobei 0 Grad für die Quellenzellen reserviert ist. In östlicher Richtung (rechts) befindet sich der 90-Grad-Winkel, und die Werte nehmen im Uhrzeigersinn zu (180 Grad ist Süden, 270 Grad ist Westen und 360 Grad ist Norden).	Raster Layer
Schwellenwertmethode	Gibt an, wie der Schwellenwert definiert wird. Kein Schwellenwert—Es wird kein Schwellenwert angewendet, und der resultierende Korridor deckt die volle Ausdehnung des Eingabe-Rasters ab. Dies ist die Standardeinstellung. Prozentsatz der Minimalkosten—Der Schwellenwert wird als Prozentsatz des Minimalwertes des Rasters der summierten akkumulativen Kostenentfernung definiert. Akkumulative Kosten—Der Schwellenwert wird in Einheiten der akkumulativen Kostenentfernung definiert.	String
Schwellenwert	Ein prozentualer Schwellenwert oder ein Schwellenwert der akkumulativen Kosten, der festlegt, ob eine bestimmte Zelle in das Ausgabe-Korridor-Raster aufgenommen wird. Wenn der Parameter Schwellenwertmethode auf Prozentsatz der Minimalkosten festgelegt ist, kennzeichnet der angegebene Wert die anzuwendende prozentuale Zunahme vom Minimalwert des Rasters der summierten akkumulativen Kostenentfernung. Wenn der Parameter Schwellenwertmethode auf Akkumulative Kosten festgelegt ist, kennzeichnet der Wert, dass Zellen mit summierten akkumulativen Kosten gleich oder unterhalb des Wertes in den Korridor aufgenommen werden. Dieser Parameter ist nur aktiv, wenn der Parameter Schwellenwertmethode auf Prozentsatz der Minimalkosten oder Akkumulative Kosten festgelegt ist.	Double

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Korridor-Raster, das Zellen mit Werten unterhalb des Schwellenwertes in Einheiten der akkumulativen Kostenentfernung enthält. Das Ausgabe-Raster ist ein Gleitkomma-Raster.	Raster

Python

LeastCostCorridor(in_accumulative_cost_distance_raster1, in_back_direction_raster1, in_accumulative_cost_distance_raster2, in_back_direction_raster2, threshold_method, threshold)

Name	Erläuterung	Datentyp
in_accumulative_cost_distance_raster1	Das Eingabe-Raster, das die akkumulative Kostenentfernung von der ersten Quelle darstellt. Verwenden Sie die Entfernungsakkumulationsausgabe des Werkzeugs Entfernungsakkumulation oder Entfernungsallokation.	Raster Layer
in_back_direction_raster1	Das Eingabe-Gegenrichtungs-Raster von der ersten Quelle. Die Einheiten sind Grad und kennzeichnen die nächste Zelle entlang des kostengünstigsten Pfades zurück zur ersten Quelle. Verwenden Sie die Gegenrichtungsausgabe des Werkzeugs Entfernungsakkumulation oder Entfernungsallokation. Der Wertebereich reicht von 0 Grad bis 360 Grad, wobei 0 Grad für die Quellenzellen reserviert ist. In östlicher Richtung (rechts) befindet sich der 90-Grad-Winkel, und die Werte nehmen im Uhrzeigersinn zu (180 Grad ist Süden, 270 Grad ist Westen und 360 Grad ist Norden).	Raster Layer
in_accumulative_cost_distance_raster2	Das Eingabe-Raster, das die akkumulative Kostenentfernung von der zweiten Quelle darstellt. Verwenden Sie die Entfernungsakkumulationsausgabe des Werkzeugs Entfernungsakkumulation oder Entfernungsallokation.	Raster Layer
in_back_direction_raster2	Das Eingabe-Gegenrichtungs-Raster von der zweiten Quelle. Die Einheiten sind Grad und kennzeichnen die nächste Zelle entlang des kostengünstigsten Pfades zurück zur zweiten Quelle. Verwenden Sie die Gegenrichtungsausgabe des Werkzeugs Entfernungsakkumulation oder Entfernungsallokation. Der Wertebereich reicht von 0 Grad bis 360 Grad, wobei 0 Grad für die Quellenzellen reserviert ist. In östlicher Richtung (rechts) befindet sich der 90-Grad-Winkel, und die Werte nehmen im Uhrzeigersinn zu (180 Grad ist Süden, 270 Grad ist Westen und 360 Grad ist Norden).	Raster Layer
threshold_method	Gibt an, wie der Schwellenwert definiert wird. NO_THRESHOLD—Es wird kein Schwellenwert angewendet, und der resultierende Korridor deckt die volle Ausdehnung des Eingabe-Rasters ab. Dies ist die Standardeinstellung. PERCENT_OF_LEAST_COST—Der Schwellenwert wird als Prozentsatz des Minimalwertes des Rasters der summierten akkumulativen Kostenentfernung definiert. ACCUMULATIVE_COST—Der Schwellenwert wird in Einheiten der akkumulativen Kostenentfernung definiert.	String
threshold	Ein prozentualer Schwellenwert oder ein Schwellenwert der akkumulativen Kosten, der festlegt, ob eine bestimmte Zelle in das Ausgabe-Korridor-Raster aufgenommen wird. Wenn der Parameter threshold_method auf PERCENT_OF_LEAST_COST festgelegt ist, kennzeichnet der angegebene Wert die anzuwendende prozentuale Zunahme vom Minimalwert des Rasters der summierten akkumulativen Kostenentfernung. Wenn der Parameter threshold_method auf ACCUMULATIVE_COST festgelegt ist, kennzeichnet der Wert, dass Zellen mit summierten akkumulativen Kosten gleich oder unterhalb des Wertes in den Korridor aufgenommen werden. Dieser Parameter ist nur aktiviert, wenn der Parameter threshold_method auf PERCENT_OF_LEAST_COST oder ACCUMULATIVE_COST festgelegt wurde.	Double

Rückgabewert

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Korridor-Raster, das Zellen mit Werten unterhalb des Schwellenwertes in Einheiten der akkumulativen Kostenentfernung enthält. Das Ausgabe-Raster ist ein Gleitkomma-Raster.	Raster

Codebeispiel

LeastCostCorridor: Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie das Werkzeug Kostengünstigster Korridor verwenden.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data"
out_LCC_raster = LeastCostCorridor("DistAccumRaster1.tif", "BackDirRaster1.tif",
                                   "DistAccumRaster2.tif", "BackDirRaster2.tif") 
out_LCC_raster.save("c:/arcpyexamples/output/corridor.tif")

LeastCostCorridor: Beispiel 2 (eigenständiges Skript)

Berechnen Sie einen Korridor zwischen zwei Flächen.

# Name: LeastCostCorridor_Ex_02.py
# Description: Calculates a potential wildlife corridor between two known 
#               protected areas.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set environment settings
env.workspace = "C:/arcpyexamples/data"

# Set local variables
in_accumulative_cost_distance_raster1 = "distaccum_s1.tif"
in_back_direction_raster1 = "backdir_s1.tif"
in_accumulative_cost_distance_raster2 = "distaccum_s2.tif"
in_back_direction_raster2 = "backdir_s2.tif"
threshold_method = "ACCUMULATIVE_COST" 
threshold = 500

# Run Least Cost Corridor
out_LCC_raster = LeastCostCorridor(
    in_accumulative_cost_distance_raster1, in_back_direction_raster1, 
    in_accumulative_cost_distance_raster2, in_back_direction_raster2, 
    "ACCUMULATIVE_COST", "500")

# Save the output 
out_LCC_raster.save("c:/arcpyexamples/output/corridor.tif")

Umgebungen

Auto-Commit, Komprimierung, Aktueller Workspace, Ausgabe-CONFIG-Schlüsselwort, Faktor für parallele Verarbeitung, Scratch-Workspace, Kachelgröße

Lizenzinformationen

• Basic: Erfordert Spatial Analyst
• Standard: Erfordert Spatial Analyst
• Advanced: Erfordert Spatial Analyst