Entfernungsallokation (Raster Analysis)

Zusammenfassung

Berechnet die Entfernungsallokation für jede Zelle zu den angegebenen Quellen auf Grundlage von geradliniger Entfernung, Kostenentfernung, tatsächlicher Oberflächenentfernung sowie vertikaler und horizontaler Kostenfaktoren.

Abbildung

Workflow "Entfernungsallokation"

Verwendung

  • Dieses Portal-Werkzeug für die Raster-Analyse ist verfügbar, wenn Sie bei einem ArcGIS Enterprise-Portal angemeldet sind, das über einen für Raster Analysis konfigurierten ArcGIS Image Server verfügt. Beim Ausführen des Werkzeugs dient ArcGIS Pro als Client. Die Verarbeitung erfolgt auf den Servern, die mit ArcGIS Enterprise verbunden sind. Das Portal-Werkzeug akzeptiert Layer aus dem Portal als Eingabe und erstellt die Ausgabe im Portal.

    Als Eingabe-Raster-Layer kann ein Layer aus dem Portal, ein URI bzw. eine URL zu einem Image-Service oder die Ausgabe des Werkzeugs Image Server-Layer erstellen verwendet werden. Bei dem Eingabe-Feature-Layer kann es sich um einen Layer aus dem Portal oder ein URI bzw. eine URL zu einem Feature-Service handeln. Lokale Raster-Daten oder -Layer werden von diesem Werkzeug nicht unterstützt. Obwohl Sie lokale Feature-Daten und Layer als Eingabe für dieses Portal verwenden können, empfiehlt es sich, Layer aus Ihrem Portal als Eingabe zu nutzen.

  • Die Eingabequelldaten können ein Feature-Service oder ein Image-Service sein. Der Feature-Service kann ein Punkt, eine Linie oder ein Polygon sein.

  • Wenn eine Quelle in einer NoData-Zelle eines der entsprechenden Eingabe-Raster liegt, wird sie in der Analyse ignoriert, sodass keine Entfernung von dieser Quelle berechnet wird.

  • Wenn es sich bei den Eingabequelldaten um einen Image-Service handelt, besteht die Menge der Quellzellen aus allen Zellen im Quell-Raster, die über gültige Werte verfügen. Zellen mit NoData-Werten sind nicht in der Quellmenge enthalten. Der Wert 0 wird als legitime Quelle verwendet.

  • Liegen die Eingabequelldaten in Form eines Feature-Service vor, werden die Quellpositionen intern in ein Raster konvertiert, bevor die Analyse ausgeführt wird. Die Auflösung des Rasters kann mithilfe der Umgebungseinstellung Zellengröße gesteuert werden. Wenn im Werkzeug keine anderen Raster angegeben sind, entspricht die Auflösung der Breite oder Höhe (der jeweils kleinere Wert) standardmäßig der Ausdehnung des Eingabe-Features im Eingabe-Raumbezug, dividiert durch 250.

  • Um dies zu vermeiden, können Sie die Eingabe-Features in einem Zwischenschritt direkt mit dem Werkzeug Feature in Raster rastern und den Parameter Feld festlegen. Verwenden Sie anschließend die resultierende Ausgabe als Eingabe in das jeweilige Entfernungswerkzeug, das Sie verwenden möchten. Alternativ können Sie eine kleine Zellengröße auswählen, damit der jeweilige Detaillierungsgrad von den Eingabe-Features erfasst wird.

  • Barrieren sind Hindernisse, die umgangen werden müssen. Sie können auf zwei Arten definiert werden.

    Für den Parameter Eingabe-Barriere-Raster- oder -Features können Barrieren entweder durch Zellen dargestellt werden, die einen gültigen Wert aufweisen, oder durch Feature-Daten, die in ein Raster konvertiert werden. Wenn Barrieren nur durch diagonale Zellen verbunden sind, werden sie verstärkt, damit sie undurchlässig werden.

    Barrieren werden auch durch Positionen definiert, an denen NoData-Zellen in den folgenden Eingaben vorliegen: Eingabe-Kosten-Raster, Eingabe-Oberflächen-Raster, Eingabe-Vertikal-Raster und Eingabe-Horizontal-Raster.. Wenn NoData nur durch diagonale Zellen verbunden sind, werden sie mit zusätzlichen NoData-Zellen verstärkt, damit sie zu einer undurchlässigen Barriere werden.

  • Wenn das Eingabe-Oberflächen-Raster ein vertikales Koordinatensystem (VKS) aufweist, wird angenommen, dass die Werte des Oberflächen-Rasters in den Einheiten des VKS vorliegen. Wenn der Eingabewert Oberflächen-Raster kein VKS aufweist und die Daten projiziert werden, wird angenommen, dass die Oberflächenwerte in den lineare Einheiten des Raumbezugs vorliegen. Wenn der Wert für Eingabe-Oberflächen-Raster kein VKS aufweist und die Daten nicht projiziert werden, wird angenommen, dass die Oberflächenwerte in Meter vorliegen. Das endgültige Ergebnis für die Entfernungsakkumulation wird in Kosten pro linearer Einheit angezeigt – oder in lineare Einheiten, wenn keine Kosten angegeben wurden.

  • Die Standardwerte für die Modifikatoren des vertikalen Faktors lauten folgendermaßen:

    Keyword                   Zero    Low    High   Slope  Power  Cos    Sec
                              factor  cut    cut                  power  power
                                      angle  angle                             
    ------------------------  ------  -----  -----  -----  -----  -----  -----
    Binary                    1.0     -30    30     ~      ~      ~      ~
    Linear                    1.0     -90    90      1/90  ~      ~      ~
    Symmetric linear          1.0     -90    90      1/90  ~      ~      ~
    Inverse linear            1.0     -45    45     -1/45  ~      ~      ~
    Symmetric inverse linear  1.0     -45    45     -1/45  ~      ~      ~
    Cos                       ~       -90    90     ~      1.0    ~      ~
    Sec                       ~       -90    90     ~      1.0    ~      ~
    Cos_sec                   ~       -90    90     ~      ~      1.0    1.0
    Sec_cos                   ~       -90    90     ~      ~      1.0    1.0
  • Die Ausgabe des Spatial Analyst-Werkzeugs Ausrichtung kann als Eingabe für den Parameter horizontales Eingabe-Raster verwendet werden.

  • Die Standardwerte für die Modifikatoren des horizontalen Faktors lauten folgendermaßen:

    Keywords         Zero factor   Cut angle     Slope   Side value
    --------------   -----------   -----------   -----   ---------
    Binary           1.0            45           ~       ~
    Forward          0.5            45 (fixed)   ~       1.0
    Linear           0.5           181            1/90   ~
    Inverse linear   2.0           180           -1/90   ~
  • Die Eigenschaften der Quelle oder die Reisenden von oder zu einer Quelle können durch bestimmte Parameter gesteuert werden.

    • Initiale Akkumulation legt die anfänglichen Kosten vor Beginn der Bewegung fest.
    • Maximale Akkumulation legt fest, welche Höhe an Kosten eine Quelle maximal akkumulieren kann.
    • Multiplikator zum Anwenden von Kosten gibt den Reisemodus oder die Höhe an der Quelle an.
    • Mit Reiserichtung wird ermittelt, ob der Reisende an einer Quelle startet und zu Nicht-Quellpositionen reist oder an anderen Nicht-Quellpositionen startet und zurück zu einer Quelle reist.

  • Wenn einer der Parameter der Quelleneigenschaften anhand eines Feldes festgelegt wird, wird die Quelleneigenschaft je nach Quelle und entsprechend den Informationen, die in diesem Feld für die Quelldaten angegeben sind, angewendet. Wenn ein Schlüsselwort oder ein konstanter Wert angegeben ist, wird er auf alle Quellen angewendet.

  • Wenn der Wert Initiale Akkumulation festgelegt ist, werden die Quellenpositionen der Ausgabe-Kostenentfernungsoberfläche auf den Wert von Initiale Akkumulation festgelegt; andernfalls werden die Quellenpositionen der Ausgabe-Kostenentfernungsoberfläche auf Null festgelegt.

  • Wenn die Umgebungseinstellung Ausdehnung nicht angegeben ist, wird die Verarbeitungsausdehnung wie folgt bestimmt:

    Wenn nur die Werte für Eingabe-Raster oder Feature-Quellen-Daten und Eingabe-Barriere-Raster- oder -Feature-Daten angegeben sind, wird die Vereinigungsmenge der Eingaben, die auf jeder Seite durch zwei Zellenbreiten erweitert ist, als Verarbeitungsausdehnung verwendet. Das Ausgabe-Raster wird durch zwei Zeilen und Spalten erweitert. Der Grund hierfür ist, dass wenn die Ausgaben in Optimaler Pfad als Raster und Optimaler Pfad als Linie verwendet werden können, es möglich ist, die generierten Pfade um die Barrieren herum zu bewegen. Um die Ausdehnung als implizite Barriere zu verwenden, müssen Sie die Ausdehnung in den Umgebungseinstellungen explizit festlegen.

    Die Verarbeitungsausdehnung entspricht dem Schnittpunkt von Eingabe-Oberflächen-Raster, Eingabe-Kosten-Raster, Eingabe-Vertikal-Raster oder Eingabe-Horizontal-Raster, insofern angegeben.

  • Die Analyse-Umgebungseinstellung Maske kann auf einen Feature-Service oder einen Image-Service festgelegt werden. Wenn die Maske ein Feature ist, wird sie in ein Raster konvertiert. Die Zellen, die über einen Wert verfügen, definieren die Positionen, die im Maskenbereich liegen. NoData-Zellen definieren die Positionen, die sich außerhalb des Maskenbereichs befinden, und werden als Barriere behandelt.

  • Wenn die Umgebungseinstellung Zellengröße oder Fang-Raster nicht festgelegt ist und mehrere Raster als Eingaben angegeben sind, werden die Umgebungseinstellungen Zellengröße und Fang-Raster anhand der Prioritätsreihenfolge festgelegt: Eingabe-Kosten-Raster, Eingabe-Oberflächen-Raster, Eingabe-Vertikal-Raster, Eingabe-Horizontal-Raster, Eingabe-Raster oder Feature-Quellen-Daten und Eingabe-Barriere-Raster- oder -Feature-Daten.

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Quell-Raster oder -Features

Die Eingabequellpositionen.

Dies ist ein Image- oder Feature-Service zum Ermitteln der Zellen oder Positionen von oder zu denen die Allokation jeder Ausgabezellenposition berechnet wird.

Bei einem Image-Service kann der Eingabetyp "Ganze Zahl" oder "Gleitkomma" sein. Bei einem Feature-Service kann der Eingabetyp ein Punkt, eine Linie oder ein Polygon sein.

Raster Layer; Feature Layer
Name des Ausgabe-Entfernungs-Zuordnungs-Rasters

Der Name des Ausgabe-Entfernungs-Zuordnungs-Raster-Service.

String
Eingabe-Barriere-Raster oder -Features
(optional)

Das Dataset, das die Barrieren definiert.

Die Barrieren können durch einen Ganzzahl- oder Gleitkomma-Image-Service oder durch einen Feature-Service definiert sein. Bei einem Feature-Service kann der Eingabetyp ein Punkt, eine Linie oder ein Polygon sein.

Für eine Image-Service-Barriere muss die Barriere einen gültigen Wert, einschließlich Null, aufweisen, und die Flächen, die keine Barrieren sind, müssen NoData-Flächen sein.

Raster Layer; Feature Layer
Eingabe-Oberflächen-Raster
(optional)

Ein Image-Service, der die Höhenwerte an jeder Zellenposition definiert.

Beim Übergang zwischen Zellen werden die Werte verwendet, um die tatsächliche Oberflächenentfernung zu berechnen.

Raster Layer
Eingabe-Kosten-Raster
(optional)

Ein Image-Service, der die Impedanz oder die Kosten für eine planimetrische Bewegung durch jede Zelle definiert.

Der Wert an jeder Zellenposition stellt die Kosten pro Einheitenentfernung für die Bewegung durch die Zelle dar. Jeder Zellenpositionswert wird mit der Zellenauflösung multipliziert, und gleichzeitig werden diagonale Bewegungen ausgeglichen, um die Gesamtkosten für die Bewegung durch die Zelle zu erhalten.

Die Werte im Kosten-Raster können Ganzzahl- oder Gleitkommawerte sein, sie dürfen jedoch nicht negativ oder 0 sein (negative oder keine Kosten sind nicht zulässig).

Raster Layer
Eingabe-Vertikal-Raster
(optional)

Ein Image-Service, der die Z-Werte für jede Zellenposition definiert.

Die Werte werden zum Berechnen der Neigung verwendet, die zum Identifizieren des vertikalen Faktors beim Übergang von einer Zelle zur anderen dient.

Raster Layer
Vertikaler Faktor
(optional)

Gibt die Beziehung zwischen dem vertikalen Kostenfaktor und dem VRMA (Vertical Relative Moving Angle) an.

Es stehen mehrere Faktoren mit Modifikatoren zur Auswahl, durch die ein definiertes Diagramm für den vertikalen Faktor festgelegt wird. Die Diagramme identifizieren den vertikalen Faktor, der zum Berechnen der Gesamtkosten für die Bewegung in eine benachbarte Zelle verwendet wird.

In den folgenden Beschreibungen definiert der vertikale Faktor (VF) die vertikalen Hindernisse bei der Bewegung von einer Zelle zur nächsten, und der vertikale relative Bewegungswinkel (VRMA) identifiziert den Neigungswinkel zwischen der Ausgangs- oder Verarbeitungszelle (FROM) und der Zielzelle (TO).

Die Optionen für Vertikaler Faktor lauten wie folgt:

  • Binär: Wenn der VRMA größer als der untere Schnittwinkel und kleiner als der obere Schnittwinkel ist, wird für den VF der dem Null-Faktor zugewiesene Wert festgelegt. Andernfalls ist dieser unendlich.
  • Linear: Der VF ist eine lineare Funktion des VRMA.
  • Symmetrisch linear: Der VF ist eine lineare Funktion des VRMA auf der negativen oder positiven Seite des VRMA und die beiden linearen Funktionen hinsichtlich der VF-Achse bzw. Y-Achse sind symmetrisch.
  • Invers Linear: Der VF ist eine invers lineare Funktion des VRMA.
  • Symmetrisch invers linear: Der VF ist eine invers lineare Funktion des VRMA auf der negativen oder positiven Seite des VRMA und die beiden linearen Funktionen hinsichtlich der VF-Achse bzw. Y-Achse sind symmetrisch.
  • Cos: Der VF ist die kosinusbasierte Funktion des VRMA.
  • Sec: Der VF ist die sekantenbasierte Funktion des VRMA.
  • Cos-Sec: Der VF ist bei einem negativen VRMA die kosinusbasierte Funktion des VRMA und bei einem positiven VRMA die sekantenbasierte Funktion des VRMA.
  • Sec-Cos: Der VF ist bei einem negativen VRMA die sekantenbasierte Funktion des VRMA und bei einem positiven VRMA die kosinusbasierte Funktion des VRMA.

Die Modifikatoren für die Schlüsselwörter des vertikalen Faktors lauten wie folgt:

  • Null-Faktor: Der vertikale Faktor, der verwendet wird, wenn der VRMA 0 ist. Dieser Faktor positioniert den Y-Schnittpunkt der angegebenen Funktion. Laut Definition ist der Null-Faktor nicht auf trigonometrische vertikale Funktionen (COS, SEC, COS-SEC oder SEC-COS) anwendbar. Der Y-Schnittpunkt wird von diesen Funktionen definiert.
  • Niedriger Schnittwinkel: Der VRMA, unter dem der VF auf unendlich festgelegt wird.
  • Hoher Schnittwinkel: Der VRMA, über dem der VF auf unendlich festgelegt wird.
  • Neigung: Die Neigung der Geraden, die mit den Schlüsselwörtern Linear und Invers linear für den vertikalen Faktor verwendet wird. Die Neigung wird als Verhältnis von Höhendifferenz zu horizontaler Distanz angegeben (z. B. ist eine 45-Grad-Neigung 1/45 und wird als 0,02222 eingegeben).
Vertical Factor
Eingabe-Horizontal-Raster
(optional)

Ein Image-Service, der die horizontale Richtung an jeder Zelle definiert.

Die Werte in dem Raster müssen ganzzahlig zwischen 0 und 360 Grad sein. Dabei steht 0 Grad für Norden (am Bildschirm oben), und der Winkel nimmt im Uhrzeigersinn zu. Ebenen Flächen sollte der Wert -1 zugewiesen werden. Beim Übergang von einer Zelle zu einer benachbarten Zelle werden die Werte an jeder Position zusammen mit dem Parameter Horizontaler Faktor verwendet, um die anfallenden horizontalen Kosten zu bestimmen.

Raster Layer
Horizontaler Faktor
(optional)

Gibt die Beziehung zwischen dem horizontalen Kostenfaktor und dem HRMA (Horizontal Relative Moving Angle) an.

Es stehen mehrere Faktoren mit Modifikatoren zur Auswahl, durch die ein definiertes Diagramm für den horizontalen Faktor festgelegt wird. Die Diagramme identifizieren den horizontalen Faktor, der zum Berechnen der Gesamtkosten für die Bewegung in eine benachbarte Zelle verwendet wird.

In den folgenden Beschreibungen definiert der horizontale Faktor (HF) die horizontalen Hindernisse bei der Bewegung von einer Zelle zur nächsten, und der horizontale relative Bewegungswinkel (HRMA) identifiziert den Winkel zwischen der horizontalen Richtung von einer Zelle und der Bewegungsrichtung.

Die Optionen für Horizontaler Faktor lauten wie folgt:

  • Binär: Wenn der HRMA kleiner ist als der Schnittwinkel, wird für den HF der dem Null-Faktor zugewiesene Wert festgelegt. Andernfalls ist dieser unendlich.
  • Vorwärts: Nur Vorwärtsbewegungen sind zulässig. Der HRMA muss größer als oder gleich 0 Grad und kleiner als 90 Grad sein (0 <= HRMA < 90). Wenn der HRMA größer als 0 und kleiner als 45 Grad ist, wird als HF für die Zelle der dem Null-Faktor zugewiesene Wert festgelegt. Wenn der HRMA größer als oder gleich 45 Grad ist, wird der Wert des Seitenwert-Modifikators verwendet. Der HF für einen HRMA, der größer als oder gleich 90 Grad ist, wird auf unendlich festgelegt.
  • Linear: Der HF ist eine lineare Funktion des HRMA.
  • Invers linear: Der HF ist eine invers lineare Funktion des HRMA.

Die Modifikatoren für die Schlüsselwörter der horizontalen Faktoren lauten wie folgt:

  • Null-Faktor: Der horizontale Faktor, der verwendet wird, wenn der HRMA 0 ist. Dieser Faktor positioniert den Y-Schnittpunkt für alle Funktionen für den horizontalen Faktor.
  • Schnittwinkel: Der HRMA, ab dem der HF auf unendlich festgelegt wird.
  • Neigung: Die Neigung der Geraden, die mit den Schlüsselwörtern Linear und Invers linear für den horizontalen Faktor verwendet wird. Die Neigung wird als Verhältnis von Höhendifferenz zu horizontaler Distanz angegeben (z. B. ist eine 45-Grad-Neigung 1/45 und wird als 0,02222 eingegeben).
  • Seitenfaktor: Der HF, wenn der HRMA größer als oder gleich 45 Grad und kleiner als 90 Grad ist und wenn das Schlüsselwort Vorwärts für den horizontalen Faktor angegeben wird.
Horizontal Factor
Name des Ausgabe-Entfernungsakkumulations-Rasters
(optional)

Der Name des Ausgabe-Entfernungsakkumulations-Rasters.

Das Entfernungsakkumulations-Raster enthält die akkumulative Entfernung jeder Zelle zu oder von der kostengünstigsten Quelle.

String
Name des Ausgabe-Gegenrichtungs-Rasters
(optional)

Der Name des Ausgabe-Gegenrichtungs-Rasters.

Das Gegenrichtungs-Raster enthält berechnete Richtungen in Grad. Die Richtung identifiziert die nächste Zelle entlang dem optimalen Pfad zurück zur Quelle mit den geringsten akkumulativen Kosten, wobei Barrieren vermieden werden.

Der Wertebereich reicht von 0 Grad bis 360 Grad. Der Wert 0 ist für die Quellenzellen reserviert. 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).

Das Ausgabe-Raster ist ein Gleitkomma-Raster.

String
Name des Ausgabe-Quellenrichtungs-Rasters
(optional)

Der Name des Ausgabe-Quellenrichtungs-Rasters.

Das Quellenrichtungs-Raster gibt die Richtung der Quellenzelle mit den geringsten akkumulativen Kosten als Azimut in Grad an.

Der Wertebereich reicht von 0 Grad bis 360 Grad. Der Wert 0 ist für die Quellenzellen reserviert. 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).

Das Ausgabe-Raster ist ein Gleitkomma-Raster.

String
Name des Ausgabe-Quellenpositions-Rasters
(optional)

Der Name des Ausgabe-Quellpositions-Rasters.

Das Quellpositions-Raster ist eine Multiband-Ausgabe. Das erste Band enthält einen Zeilenindex, und das zweite Band enthält einen Spaltenindex. Diese Indizes geben die Position der Quellenzelle an, deren Entfernung die geringsten akkumulativen Kosten aufweist.

String
Quellfeld
(optional)

Das Feld für die Zuweisung von Werten zu den Quellpositionen. Es muss eine ganze Zahl sein.

Field
Initiale Akkumulation
(optional)

Die anfänglichen akkumulativen Kosten, mit denen die Kostenberechnungen beginnen.

Ermöglicht die Festlegung der Fixkosten, die mit einer Quelle verknüpft sind. Der Kostenalgorithmus beginnt mit dem durch die Initiale Akkumulation festgelegten Wert statt mit dem Kostenwert Null.

Die Wert müssen größer gleich 0 sein. Die Standardeinstellung ist 0.

Double; Field
Maximale Akkumulation
(optional)

Die maximale Akkumulation für den Reisenden für eine Quelle.

Die Kostenberechnungen werden für jede Quelle fortgesetzt, bis die angegebene Akkumulation erreicht ist.

Die Werte müssen größer als Null sein. Die Standardakkumulation reicht bis zur Kante des Ausgabe-Rasters.

Double; Field
Multiplikator zum Anwenden von Kosten
(optional)

Der Multiplikator, der auf die Kostenwerte angewendet wird.

Dieser ermöglicht die Steuerung des Reisemodus oder der Magnitude an einer Quelle. Je größer der Multiplikator, desto höher sind die Kosten, um sich von einer Zelle zur anderen zu bewegen.

Die Werte müssen größer als Null sein. Die Standardeinstellung ist 1.

Double; Field
Reiserichtung
(optional)

Gibt die Richtung des Reisenden an, wenn horizontale und vertikale Faktoren angewendet werden.

Wenn Sie die Option Zeichenfolge auswählen, können Sie zwischen Von- und Zu-Optionen auswählen, die auf alle Quellen angewendet werden.

Bei Auswahl der Option Feld kann das Feld aus den Quelldaten ausgewählt werden, anhand derer die für jede Quelle zu verwendende Richtung festgelegt wird. Das Feld muss die folgende Textzeichenfolge FROM_SOURCE oder TO_SOURCE enthalten.

  • Von Quelle reisenDer horizontale Faktor und vertikale Faktor werden beginnend an der Eingabequelle angewendet und in Richtung Nicht-Quellenzellen fortgesetzt. Dies ist die Standardeinstellung.
  • Zu Quelle reisenDer horizontale Faktor und vertikale Faktor werden beginnend an jeder Nicht-Quellenzelle angewendet und zurück in Richtung Eingabequelle fortgesetzt.
String; Field
Entfernungsmethode
(optional)

Gibt an, ob die Berechnung mit einer planaren Methode (flache Erde) oder einer geodätischen Methode (Ellipsoid) erfolgt.

  • PlanarDie Entfernungsberechnung erfolgt auf einer projizierten flachen Ebene mithilfe eines kartesischen 2D-Koordinatensystems. Dies ist die Standardeinstellung.
  • GeodätischDie Entfernungsberechnung erfolgt für das Ellipsoid. Unabhängig von der Eingabe- oder Ausgabeprojektion ändern sich die Ergebnisse nicht.
String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Entfernungszuordnungs-Raster

Das Ausgabe-Entfernungsallokations-Raster.

Raster
Ausgabe-Entfernungsakkumulations-Raster

Das Ausgabe-Entfernungsakkumulations-Raster.

Raster
Ausgabe-Gegenrichtungs-Raster

Das Ausgabe-Gegenrichtungs-Raster.

Raster
Ausgabe-Quellenrichtungs-Raster

Das Ausgabe-Quellenrichtungs-Raster.

Raster
Ausgabe-Quellpositions-Raster

Das Ausgabe-Quellpositions-Raster.

Raster

arcpy.ra.DistanceAllocation(inputSourceRasterOrFeatures, outputDistanceAllocationRasterName, {inputBarrierRasterOrFeatures}, {inputSurfaceRaster}, {inputCostRaster}, {inputVerticalRaster}, {verticalFactor}, {inputHorizontalRaster}, {horizontalFactor}, {outputDistanceAccumulationRasterName}, {outputBackDirectionRasterName}, {outputSourceDirectionRasterName}, {outputSourceLocationRasterName}, {sourceField}, {sourceInitialAccumulation}, {sourceMaximumAccumulation}, {sourceCostMultiplier}, {sourceDirection}, {distanceMethod})
NameErläuterungDatentyp
inputSourceRasterOrFeatures

Die Eingabequellpositionen.

Dies ist ein Image- oder Feature-Service zum Ermitteln der Zellen oder Positionen von oder zu denen die Allokation jeder Ausgabezellenposition berechnet wird.

Bei einem Image-Service kann der Eingabetyp "Ganze Zahl" oder "Gleitkomma" sein. Bei einem Feature-Service kann der Eingabetyp ein Punkt, eine Linie oder ein Polygon sein.

Raster Layer; Feature Layer
outputDistanceAllocationRasterName

Der Name des Ausgabe-Entfernungs-Zuordnungs-Raster-Service.

String
inputBarrierRasterOrFeatures
(optional)

Das Dataset, das die Barrieren definiert.

Die Barrieren können durch einen Ganzzahl- oder Gleitkomma-Image-Service oder durch einen Feature-Service definiert sein. Bei einem Feature-Service kann der Eingabetyp ein Punkt, eine Linie oder ein Polygon sein.

Für eine Image-Service-Barriere muss die Barriere einen gültigen Wert, einschließlich Null, aufweisen, und die Flächen, die keine Barrieren sind, müssen NoData-Flächen sein.

Raster Layer; Feature Layer
inputSurfaceRaster
(optional)

Ein Image-Service, der die Höhenwerte an jeder Zellenposition definiert.

Beim Übergang zwischen Zellen werden die Werte verwendet, um die tatsächliche Oberflächenentfernung zu berechnen.

Raster Layer
inputCostRaster
(optional)

Ein Image-Service, der die Impedanz oder die Kosten für eine planimetrische Bewegung durch jede Zelle definiert.

Der Wert an jeder Zellenposition stellt die Kosten pro Einheitenentfernung für die Bewegung durch die Zelle dar. Jeder Zellenpositionswert wird mit der Zellenauflösung multipliziert, und gleichzeitig werden diagonale Bewegungen ausgeglichen, um die Gesamtkosten für die Bewegung durch die Zelle zu erhalten.

Die Werte im Kosten-Raster können Ganzzahl- oder Gleitkommawerte sein, sie dürfen jedoch nicht negativ oder 0 sein (negative oder keine Kosten sind nicht zulässig).

Raster Layer
inputVerticalRaster
(optional)

Ein Image-Service, der die Z-Werte für jede Zellenposition definiert.

Die Werte werden zum Berechnen der Neigung verwendet, die zum Identifizieren des vertikalen Faktors beim Übergang von einer Zelle zur anderen dient.

Raster Layer
verticalFactor
(optional)

Das Objekt Vertical factor definiert die Beziehung zwischen dem vertikalen Kostenfaktor und dem VRMA (Vertical Relative Moving Angle).

Es stehen mehrere Faktoren mit Modifikatoren zur Auswahl, durch die ein definiertes Diagramm für den vertikalen Faktor festgelegt wird. Die Diagramme identifizieren den vertikalen Faktor, der zum Berechnen der Gesamtkosten für die Bewegung in eine benachbarte Zelle verwendet wird.

In den folgenden Beschreibungen definiert der vertikale Faktor (VF) die vertikalen Hindernisse bei der Bewegung von einer Zelle zur nächsten, und VRMA identifiziert den Neigungswinkel zwischen der Ausgangs- oder Verarbeitungszelle (FROM) und der Zielzelle (TO).

Das Objekt kommt in den folgenden Formen vor:VfBinary, VfLinear, VfInverseLinear, VfSymLinear, VfSymInverseLinear, VfCos, VfSec, VfSec, VfCosSec und VfSecCos

Die Definitionen und Parameter dieser Formen lauten wie folgt:

  • VfBinary({zeroFactor}, {lowCutAngle}, {highCutAngle})

    Wenn der VRMA größer als der untere Schnittwinkel und kleiner als der obere Schnittwinkel ist, wird für den VF der dem Null-Faktor zugewiesene Wert festgelegt. Andernfalls ist dieser unendlich.

  • VfLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    Der VF ist eine lineare Funktion des VRMA.

  • VfInverseLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    Der VF ist eine invers lineare Funktion des VRMA.

  • VfSymLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    Der VF ist eine lineare Funktion des VRMA auf der negativen oder positiven Seite des VRMA und die beiden linearen Funktionen hinsichtlich der VF-Achse bzw. Y-Achse sind symmetrisch.

  • VfSymInverseLinear({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})

    Der VF ist eine invers lineare Funktion des VRMA auf der negativen oder positiven Seite des VRMA und die beiden linearen Funktionen hinsichtlich der VF-Achse bzw. Y-Achse sind symmetrisch.

  • VfCos({lowCutAngle}, {highCutAngle}, {cosPower})

    Der VF ist die kosinusbasierte Funktion des VRMA.

  • VfSec({lowCutAngle}, {highCutAngle}, {secPower})

    Der VF ist die sekantenbasierte Funktion des VRMA.

  • VfCosSec({lowCutAngle}, {highCutAngle}, {cosPower}, {secPower})

    Der VF ist bei einem negativen VRMA die kosinusbasierte Funktion des VRMA und bei einem positiven VRMA die sekantenbasierte Funktion des VRMA.

  • VfSecCos({lowCutAngle}, {highCutAngle}, {secPower}, {cos_power})

    Der VF ist bei einem negativen VRMA die sekantenbasierte Funktion des VRMA und bei einem positiven VRMA die kosinusbasierte Funktion des VRMA.

Die Modifikatoren für die Parameter des vertikalen Faktors lauten wie folgt:

  • zeroFactor: Der vertikale Faktor, der verwendet wird, wenn der VRMA 0 ist. Dieser Faktor positioniert den Y-Schnittpunkt der angegebenen Funktion. Laut Definition ist der Null-Faktor nicht auf trigonometrische vertikale Funktionen (Cos, Sec, Cos-Sec oder Sec-Cos) anwendbar. Der Y-Schnittpunkt wird von diesen Funktionen definiert.
  • lowCutAngle: Der VRMA, unterhalb dessen der VF auf unendlich festgelegt wird.
  • highCutAngle: Der VRMA, oberhalb dessen der VF auf unendlich festgelegt wird.
  • slope: Die Neigung der Geraden, die mit den Parametern VfLinear und VfInverseLinear verwendet wird. Die Neigung wird als Verhältnis von Höhendifferenz zu horizontaler Distanz angegeben (z. B. ist eine 45-Grad-Neigung 1/45 und wird als 0,02222 eingegeben).
Vertical Factor
inputHorizontalRaster
(optional)

Ein Raster, das die horizontale Richtung an jeder Zelle definiert.

Die Werte in dem Raster müssen ganzzahlig zwischen 0 und 360 Grad sein. Dabei steht 0 Grad für Norden (am Bildschirm oben), und der Winkel nimmt im Uhrzeigersinn zu. Ebenen Flächen sollte der Wert -1 zugewiesen werden. Beim Übergang von einer Zelle zu einer benachbarten Zelle werden die Werte an jeder Position zusammen mit dem Parameter horizontal_factor verwendet, um die anfallenden horizontalen Kosten zu bestimmen.

Raster Layer
horizontalFactor
(optional)

Das Objekt Horizontal Factor definiert die Beziehung zwischen dem horizontalen Kostenfaktor und dem HRMA (Horizontal Relative Moving Angle).

Es stehen mehrere Faktoren mit Modifikatoren zur Auswahl, durch die ein definiertes Diagramm für den horizontalen Faktor festgelegt wird. Die Diagramme identifizieren den horizontalen Faktor, der zum Berechnen der Gesamtkosten für die Bewegung in eine benachbarte Zelle verwendet wird.

In den folgenden Beschreibungen definiert der horizontale Faktor (HF) die horizontalen Hindernisse bei der Bewegung von einer Zelle zur nächsten, und der horizontale relative Bewegungswinkel (HRMA) identifiziert den Winkel zwischen der horizontalen Richtung von einer Zelle und der Bewegungsrichtung.

Das Objekt kommt in den folgenden Formen vor: HfBinary, HfForward, HfLinear und HfInverseLinear

Die Definitionen und Parameter lauten wie folgt:

  • HfBinary({zeroFactor}, {cutAngle})

    Wenn der HRMA kleiner ist als der Schnittwinkel, wird für den HF der dem Null-Faktor zugewiesene Wert festgelegt. Andernfalls ist dieser unendlich.

  • HfForward({zeroFactor}, {sideValue})

    Nur Vorwärtsbewegungen sind zulässig. Der HRMA muss größer als oder gleich 0 Grad und kleiner als 90 Grad sein (0 <= HRMA < 90). Wenn der HRMA größer als 0 und kleiner als 45 Grad ist, wird als HF für die Zelle der dem Null-Faktor zugewiesene Wert festgelegt. Wenn der HRMA größer als oder gleich 45 Grad ist, wird der Wert des Seitenwert-Modifikators verwendet. Der HF für einen HRMA, der größer als oder gleich 90 Grad ist, wird auf unendlich festgelegt.

  • HfLinear({zeroFactor}, {cutAngle}, {slope})

    Der HF ist eine lineare Funktion des HRMA.

  • HfInverseLinear({zeroFactor}, {cutAngle}, {slope})

    Der HF ist eine invers lineare Funktion des HRMA.

Die Modifikatoren für die Schlüsselwörter des horizontalen Faktors lauten wie folgt:

  • zeroFactor: Der horizontale Faktor, der verwendet wird, wenn der HRMA 0 ist. Dieser Faktor positioniert den Y-Schnittpunkt für alle Funktionen für den horizontalen Faktor.
  • cutAngle: Der HRMA, ab dem der HF auf unendlich festgelegt wird.
  • slope: Die Neigung der Geraden, die mit den Schlüsselwörtern HfLinear und HfInverseLinear für den horizontalen Faktor verwendet wird. Die Neigung wird als Verhältnis von Höhendifferenz zu horizontaler Distanz angegeben (z. B. ist eine 45-Grad-Neigung 1/45 und wird als 0,02222 eingegeben).
  • sideValue: Der HF, wenn der HRMA größer als oder gleich 45 Grad und kleiner als 90 Grad ist und wenn das Schlüsselwort HfForward für den horizontalen Faktor angegeben wird.

Horizontal Factor
outputDistanceAccumulationRasterName
(optional)

Der Name des Ausgabe-Entfernungsakkumulations-Rasters.

Das Entfernungsakkumulations-Raster enthält die akkumulative Entfernung jeder Zelle zu oder von der kostengünstigsten Quelle.

String
outputBackDirectionRasterName
(optional)

Der Name des Ausgabe-Gegenrichtungs-Rasters.

Das Gegenrichtungs-Raster enthält berechnete Richtungen in Grad. Die Richtung identifiziert die nächste Zelle entlang dem optimalen Pfad zurück zur Quelle mit den geringsten akkumulativen Kosten, wobei Barrieren vermieden werden.

Der Wertebereich reicht von 0 Grad bis 360 Grad. Der Wert 0 ist für die Quellenzellen reserviert. 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).

Das Ausgabe-Raster ist ein Gleitkomma-Raster.

String
outputSourceDirectionRasterName
(optional)

Der Name des Ausgabe-Quellenrichtungs-Rasters.

Das Quellenrichtungs-Raster gibt die Richtung der Quellenzelle mit den geringsten akkumulativen Kosten als Azimut in Grad an.

Der Wertebereich reicht von 0 Grad bis 360 Grad. Der Wert 0 ist für die Quellenzellen reserviert. 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).

Das Ausgabe-Raster ist ein Gleitkomma-Raster.

String
outputSourceLocationRasterName
(optional)

Der Name des Ausgabe-Quellpositions-Rasters.

Das Quellpositions-Raster ist eine Multiband-Ausgabe. Das erste Band enthält einen Zeilenindex, und das zweite Band enthält einen Spaltenindex. Diese Indizes geben die Position der Quellenzelle an, deren Entfernung die geringsten akkumulativen Kosten aufweist.

String
sourceField
(optional)

Das Feld für die Zuweisung von Werten zu den Quellpositionen. Es muss eine ganze Zahl sein.

Field
sourceInitialAccumulation
(optional)

Die anfänglichen akkumulativen Kosten, mit denen die Kostenberechnungen beginnen.

Ermöglicht die Festlegung der Fixkosten, die mit einer Quelle verknüpft sind. Der Kostenalgorithmus beginnt mit dem durch die source_initial_accumulation festgelegten Wert statt mit einem Kostenwert von Null.

Die Wert müssen größer gleich 0 sein. Die Standardeinstellung ist 0.

Double; Field
sourceMaximumAccumulation
(optional)

Die maximale Akkumulation für den Reisenden für eine Quelle.

Die Kostenberechnungen werden für jede Quelle fortgesetzt, bis die angegebene Akkumulation erreicht ist.

Die Werte müssen größer als Null sein. Die Standardakkumulation reicht bis zur Kante des Ausgabe-Rasters.

Double; Field
sourceCostMultiplier
(optional)

Der Multiplikator, der auf die Kostenwerte angewendet wird.

Dieser ermöglicht die Steuerung des Reisemodus oder der Magnitude an einer Quelle. Je größer der Multiplikator, desto höher sind die Kosten, um sich von einer Zelle zur anderen zu bewegen.

Die Werte müssen größer als Null sein. Die Standardeinstellung ist 1.

Double; Field
sourceDirection
(optional)

Gibt die Richtung des Reisenden an, wenn horizontale und vertikale Faktoren angewendet werden.

  • FROM_SOURCEDer horizontale Faktor und vertikale Faktor werden beginnend an der Eingabequelle angewendet und in Richtung Nicht-Quellenzellen fortgesetzt. Dies ist die Standardeinstellung.
  • TO_SOURCEDer horizontale Faktor und vertikale Faktor werden beginnend an jeder Nicht-Quellenzelle angewendet und zurück in Richtung Eingabequelle fortgesetzt.

Geben Sie das Schlüsselwort FROM_SOURCE bzw. TO_SOURCE an, das auf alle Quellen angewendet wird. Alternativ können Sie in den Quelldaten ein Feld mit den Schlüsselwörtern festlegen, um die Reiserichtung für jede Quelle zu ermitteln. Dieses Feld muss die Zeichenfolge FROM_SOURCE oder TO_SOURCE enthalten.

String; Field
distanceMethod
(optional)

Gibt an, ob die Berechnung mit einer planaren Methode (flache Erde) oder einer geodätischen Methode (Ellipsoid) erfolgt.

  • PLANARDie Entfernungsberechnung erfolgt auf einer projizierten flachen Ebene mithilfe eines kartesischen 2D-Koordinatensystems. Dies ist die Standardeinstellung.
  • GEODESICDie Entfernungsberechnung erfolgt für das Ellipsoid. Unabhängig von der Eingabe- oder Ausgabeprojektion ändern sich die Ergebnisse nicht.
String

Abgeleitete Ausgabe

NameErläuterungDatentyp
outputDistanceAllocationRaster

Das Ausgabe-Entfernungsallokations-Raster.

Raster
outputDistanceAccumulationRaster

Das Ausgabe-Entfernungsakkumulations-Raster.

Raster
outputBackDirectionRaster

Das Ausgabe-Gegenrichtungs-Raster.

Raster
outputSourceDirectionRaster

Das Ausgabe-Quellenrichtungs-Raster.

Raster
outputSourceLocationRaster

Das Ausgabe-Quellpositions-Raster.

Raster

Codebeispiel

DistanceAllocation – Beispiel 1 (Python-Fenster)

Das folgende Skript veranschaulicht die Verwendung des Werkzeugs DistanceAllocation im Python-Fenster.

import arcpy

arcpy.ra.DistanceAllocation('https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer',
                            'outDistanceAllocation',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/barrier/ImageServer',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/surface/ImageServer',
                            'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer')
DistanceAllocation – Beispiel 2 (eigenständiges Skript)

Berechnet für jede Zelle die Entfernung mit den geringsten akkumulativen Kosten zur nächstgelegenen Quelle, wobei die Oberflächenentfernung sowie horizontale und vertikale Kostenfaktoren berücksichtigt werden.

# Name: DistanceAllocation_Ex_02.py
# Description: Calculates the distance allocation.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputSourceRasterOrFeatures = 'https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer'
outputDistanceAllocationRasterName = "outDistAllo"
inputBarrierRasterOrFeatures  = 'https://MyPortal.esri.com/server/rest/services/Hosted/barrier/ImageServer'
inputSurfaceRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/surface/ImageServer'
inputCostRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer'
inputVerticalRaster = 'https://MyPortal.esri.com/server/rest/services/vertical/sources/ImageServer'
verticalFactor = ""
inputHorizontalRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/horizontal/ImageServer'
horizontalFactor = ""
outputDistanceAccumulationRasterName = "outAccum"
outputBackDirectionRasterName = "outBackDir"
outputSourceDirectionRasterName = "outSourceDir"
outputSourceLocationRasterName = "outSourceLocation"
sourceField = "SourceID"
sourceInitialAccumulation = "IntitalAccum"
sourceMaximumAccumulation = "500000"
sourceCostMultiplier = "CostMultiplier"
sourceDirection = "FROM_SOURCE"
distanceMethod = "PLANAR"

# Execute 
arcpy.ra.DistanceAllocation(inputSourceRasterOrFeatures, outputDistanceAllocationRasterName,
                            inputBarrierRasterOrFeatures, inputSurfaceRaster,
                            inputCostRaster, inputVerticalRaster, verticalFactor,
                            inputHorizontalRaster, horizontalFactor,
                            outputDistanceAccumulationRasterName, outputBackDirectionRasterName,
                            outputSourceDirectionRasterName, outputSourceLocationRasterName,
                            sourceField, sourceInitialAccumulation, sourceMaximumAccumulation,
                            sourceCostMultiplier, sourceDirection, distanceMethod)

Lizenzinformationen

  • Basic: Erfordert ArcGIS Image Server
  • Standard: Erfordert ArcGIS Image Server
  • Advanced: Erfordert ArcGIS Image Server

Verwandte Themen