Kostengünstigster Korridor (Spatial Analyst)

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 über das Verbinden von Positionen durch Korridore

Verwendung

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

• Verwenden Sie die Kostenversion der Entfernungsakkumulation-Raster. Mögliche Einheiten für die Raster sind unter anderem Dollar pro Meter, Voreinstellung pro Fuß oder Minuten pro Meter. Dies ist abhängig von der Anwendung. Diese Kosteneinheiten werden in der Kostenoberfläche erfasst. Weitere Informationen erhalten Sie unter Anpassen der zurückgelegten Entfernung unter Verwendung einer Kostenoberfläche.

• Korridore sind ungerichtet. Das bedeutet, dass eine Fahrt von der ersten zur zweiten Quelle genauso viel kostet wie eine Fahrt in umgekehrter Richtung. Geben Sie bei der Erstellung des Rasters mit akkumulativen Kosten und des Gegenrichtungs-Rasters keine Werte für richtungsabhängige Parameter (horizontaler Faktor, vertikaler Faktor und Reiserichtung) an.

• Verwenden Sie für die Erstellung des Rasters mit akkumulativen Kosten und des Gegenrichtungs-Rasters der ersten Quelle und des Rasters mit akkumulativen Kosten und des Gegenrichtungs-Rasters der zweiten Quelle für das Werkzeug Entfernungsakkumulation und Entfernungsallokation dieselben Parametereinstellungen.

• Alle Eingabe-Raster müssen Gleitkomma-Raster sein und dieselbe Zellengröße und Ausdehnung und denselben räumlichen Bezug aufweisen.

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

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

• Wenn das Ausgabe-Raster-Format .crf lautet, wird in diesem Werkzeug die Raster-Speicherumgebung Pyramide unterstützt. In der Ausgabe werden standardmäßig Pyramiden erstellt. Bei anderen Ausgabeformaten wird diese Umgebung nicht unterstützt, und es werden keine Pyramiden erstellt.

• Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster 1 für akkumulative Kostenentfernung	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 Einheit ist Grad und gibt die Richtung der nächsten Zelle entlang des kostengünstigsten Pfades zurück zur ersten Quelle an. 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 2 der akkumulativen Kostenentfernung	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 Einheit ist Grad und gibt die Richtung der nächsten Zelle entlang des kostengünstigsten Pfades zurück zur zweiten Quelle an. 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 geringsten Kosten—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 Schwellenwerts 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 Einheit ist Grad und gibt die Richtung der nächsten Zelle entlang des kostengünstigsten Pfades zurück zur ersten Quelle an. 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 Einheit ist Grad und gibt die Richtung der nächsten Zelle entlang des kostengünstigsten Pfades zurück zur zweiten Quelle an. 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 wird nur aktiviert, wenn der Parameter auf gesetzt iACCUMULATIVE_COSTthreshold_methodPERCENT_OF_LEAST_COSTst	Double

Rückgabewert

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

Codebeispiel

Least Cost Corridor: Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion LeastCostCorridor 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")

Least Cost Corridor: Beispiel 2 (eigenständiges Skript)

Berechnen des Korridors zwischen zwei Bereichen.

# 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, Pyramide, Scratch-Workspace, Kachelgröße