Linien-Statistiken (Spatial Analyst)

Zusammenfassung

Berechnet eine Statistik der Linienattribute in einer kreisförmigen Nachbarschaft um jede Ausgabezelle.

Weitere Informationen zur Funktionsweise des Werkzeugs "Linien-Statistiken"

Verwendung

  • Es stehen verschiedene Statistiktypen zur Auswahl. Die verfügbaren Statistiken sind abhängig vom Typ des ausgewählten Feldes.

  • Für ganzzahlige Felder stehen folgende Statistiktypen zur Verfügung: "Mehrheit", "Maximum", "Mittelwert", "Medianwert", "Minimum", "Minderheit", "Bereich", "Varianz" und "Länge". Für Gleitkommafelder stehen folgende Statistiktypen zur Verfügung: "Maximum", "Medianwert", "Minimum", "Bereich" und "Länge". "Mehrheit", "Minderheit" und "Varianz" sind nicht verfügbar.

  • Wenn das angegebene Feld ganzzahlig ist, ist das Ausgabe-Raster für folgende Statistiken ganzzahlig: "Mehrheit", "Maximum", "Medianwert", "Minimum", "Minderheit", "Bereich" und "Varianz". Für die Statistiken "Mittelwert" und "Länge" ist das Ausgabe-Raster ein Gleitkomma-Raster.

    Wenn es sich um ein Feld vom Typ "Gleitkomma" handelt, ist das Ausgabe-Raster für alle verfügbaren Statistiktypen vom Typ "Gleitkomma".

  • Für die Statistiken "Mehrheit", "Mittelwert", "Medianwert", "Minderheit" und "Länge" wird nur der Teil einer Linie berücksichtigt, der innerhalb der Nachbarschaft liegt. Für die Statistiken "Maximum", "Minimum", "Bereich" und "Varianz" wird entweder ein Teil oder die gesamte Linie verwendet.

  • Die Statistiken "Maximum", "Mittelwert", "Medianwert" und "Minderheit" werden nach der Länge der Linien gewichtet. Wenn beispielsweise eine Linie doppelt so lang ist wie eine andere, gilt ihr Wert als doppelt so oft aufgetreten.

  • Wenn es keine Linien in der Nachbarschaft einer Raster-Zelle gibt, weisen die Statistiken "Varianz" und "Länge" den Wert 0 zu. Bei den anderen Statistiken wird "NoData" zugewiesen.

  • Der Parameter Ausgabe-Zellengröße kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wird die Zellengröße nicht explizit über den Parameterwert angegeben, wird sie aus der Umgebung Zellengröße abgeleitet, falls diese angegeben wurde. Wenn die Zellengröße nicht im Parameter oder in der Umgebung angegeben ist, wohingegen die Umgebung für das Fang-Raster festgelegt ist, wird die Zellengröße des Fang-Rasters verwendet. Wenn nichts angegeben ist, wird die Zellengröße aus der Breite oder Höhe der Ausdehnung (je nachdem was kürzer ist) berechnet, indem der Wert durch 250 dividiert wird. Dabei wird für die Ausdehnung das in der Umgebung angegebene Ausgabekoordinatensystem verwendet.

  • Wenn die Zellengröße mit einem numerischen Wert angegeben ist, wird dieser direkt für das Ausgabe-Raster verwendet.

    Wenn die Zellengröße mit einem Raster-Dataset angegeben ist, wird für den Parameter anstelle des Wertes für die Zellengröße der Pfad des Raster-Datasets angezeigt. Die Zellengröße dieses Raster-Datasets wird direkt in der Analyse verwendet, sofern der Raumbezug des Datasets mit dem des Ausgabe-Raumbezugs übereinstimmt. Wenn der Raumbezug des Datasets nicht mit dem Ausgabe-Raumbezug übereinstimmt, wird er basierend auf dem für Projektionsmethode für Zellengröße angegebenen Wert projiziert.

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Polylinien-Features

Die für die Nachbarschaftsoperation zu verwendenden Eingabelinien.

Für jede Ausgabezelle wird eine Statistik für alle Bestandteile der Eingabe-Polylinien-Features berechnet, die innerhalb der kreisförmigen Nachbarschaft liegen, die diese Zelle umgibt.

Die Größe der kreisförmigen Nachbarschaft wird durch den Suchradius definiert.

Feature Layer
Feld

Das Feld, für das die angegebene Statistik berechnet wird. Hierbei kann es sich um ein beliebiges Zahlenfeld der Eingabe-Features handeln.

Wenn als Statistiktyp Länge definiert wurde, kann das Feld auf KEIN festgelegt werden.

Dies kann das Feld Shape sein, wenn die Eingabe-Features Z-Werte enthalten.

Field
Ausgabe-Zellengröße
(optional)

Die Zellengröße des zu erstellenden Ausgabe-Rasters.

Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit über den Parameterwert angegeben wurde, wird der Wert für die Zellengröße aus der Umgebung verwendet, sofern diese angegeben wurde. Andernfalls wird die Zellengröße mithilfe zusätzlicher Regeln aus den anderen Eingaben berechnet. Weitere Details finden Sie im Abschnitt mit den Verwendungshinweisen.

Analysis Cell Size
Suchradius
(optional)

Der Suchradius in Karteneinheiten, innerhalb dessen die Statistik berechnet werden soll.

Der Standardradius ist fünfmal so groß wie die Ausgabe-Zellengröße.

Double
Statistiktyp
(optional)

Gibt den zu berechnenden Statistiktyp an.

Statistiken werden anhand des Wertes des angegebenen Feldes für alle Linien in der Nachbarschaft berechnet.

Der Standardstatistiktyp ist Mittelwert.

Die verfügbaren Optionen für den Statistiktyp werden durch den numerischen Typ des angegebenen Feldes bestimmt. Wenn das angegebene Feld ganzzahlig ist, stehen folgende Auswahlmöglichkeiten für Statistiken zur Verfügung: "Mehrheit", "Maximum", "Mittelwert", "Medianwert", "Minimum", "Minderheit", "Bereich", "Varianz" und "Länge". Wenn das Feld ein Gleitkommafeld ist, sind nur die Statistiken "Mittelwert", "Maximum", "Minimum", "Bereich" und "Länge" verfügbar.

  • MittelwertEs wird der durchschnittliche Feldwert (gewichtet nach Länge) in jeder Nachbarschaft berechnet.Berechnungsformel: Mittelwert = (Summe von (Länge * Feldwert)) / (Summe_der_Länge)Nur der Teil der Linie, der innerhalb der Nachbarschaft liegt, wird verwendet.
  • MehrheitEs wird der Wert ermittelt, der die größte Linienlänge in der Nachbarschaft aufweist.
  • MaximumEs wird der größte Wert in der Nachbarschaft ermittelt.
  • MedianwertEs wird der Medianwert (gewichtet nach Länge) berechnet.Prinzipiell werden alle Liniensegmente in der Nachbarschaft nach Wert sortiert und von Anfang bis zum Ende auf einer geraden Linie platziert. Der Wert des Segments am Mittelpunkt der geraden Linie ist der Medianwert.
  • MinimumEs wird der kleinste Wert in der jeweiligen Nachbarschaft ermittelt.
  • MinderheitEs wird der Wert ermittelt, der die kleinste Linienlänge in der Nachbarschaft aufweist.
  • BereichEs wird der Wertebereich (Maximum–Minimum) berechnet.
  • VarianzEs wird die Anzahl der Einzelwerte berechnet.
  • LängeEs wird die gesamte Linienlänge in der Nachbarschaft berechnet. Wenn das Feld einen anderen Wert aufweist als 1, werden die Längen mit dem Feldwert multipliziert, bevor diese addiert werden. Diese Option kann verwendet werden, wenn der Parameter des Feldes auf "Kein" festgelegt ist.
String

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster für "Linien-Statistiken".

Raster

LineStatistics(in_polyline_features, field, {cell_size}, {search_radius}, {statistics_type})
NameErläuterungDatentyp
in_polyline_features

Die für die Nachbarschaftsoperation zu verwendenden Eingabelinien.

Für jede Ausgabezelle wird eine Statistik für alle Bestandteile der Eingabe-Polylinien-Features berechnet, die innerhalb der kreisförmigen Nachbarschaft liegen, die diese Zelle umgibt.

Die Größe der kreisförmigen Nachbarschaft wird durch den Suchradius definiert.

Feature Layer
field

Das Feld, für das die angegebene Statistik berechnet wird. Hierbei kann es sich um ein beliebiges Zahlenfeld der Eingabe-Features handeln.

Wenn statistics_type auf Length festgelegt ist, kann der Parameter field auf NONE eingestellt werden.

Dies kann das Feld Shape sein, wenn die Eingabe-Features Z-Werte enthalten.

Field
cell_size
(optional)

Die Zellengröße des zu erstellenden Ausgabe-Rasters.

Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit über den Parameterwert angegeben wurde, wird der Wert für die Zellengröße aus der Umgebung verwendet, sofern diese angegeben wurde. Andernfalls wird die Zellengröße mithilfe zusätzlicher Regeln aus den anderen Eingaben berechnet. Weitere Details finden Sie im Abschnitt mit den Verwendungshinweisen.

Analysis Cell Size
search_radius
(optional)

Der Suchradius in Karteneinheiten, innerhalb dessen die Statistik berechnet werden soll.

Der Standardradius ist fünfmal so groß wie die Ausgabe-Zellengröße.

Double
statistics_type
(optional)

Gibt den zu berechnenden Statistiktyp an.

Statistiken werden anhand des Wertes des angegebenen Feldes für alle Linien in der Nachbarschaft berechnet.

  • MEANEs wird der durchschnittliche Feldwert (gewichtet nach Länge) in jeder Nachbarschaft berechnet.Berechnungsformel: Mittelwert = (Summe von (Länge * Feldwert)) / (Summe_der_Länge)Nur der Teil der Linie, der innerhalb der Nachbarschaft liegt, wird verwendet.
  • MAJORITYEs wird der Wert ermittelt, der die größte Linienlänge in der Nachbarschaft aufweist.
  • MAXIMUMEs wird der größte Wert in der Nachbarschaft ermittelt.
  • MEDIANEs wird der Medianwert (gewichtet nach Länge) berechnet.Prinzipiell werden alle Liniensegmente in der Nachbarschaft nach Wert sortiert und von Anfang bis zum Ende auf einer geraden Linie platziert. Der Wert des Segments am Mittelpunkt der geraden Linie ist der Medianwert.
  • MINIMUMEs wird der kleinste Wert in der jeweiligen Nachbarschaft ermittelt.
  • MINORITYEs wird der Wert ermittelt, der die kleinste Linienlänge in der Nachbarschaft aufweist.
  • RANGEEs wird der Wertebereich (Maximum–Minimum) berechnet.
  • VARIETYEs wird die Anzahl der Einzelwerte berechnet.
  • LENGTHEs wird die gesamte Linienlänge in der Nachbarschaft berechnet. Wenn das Feld einen anderen Wert aufweist als 1, werden die Längen mit dem Feldwert multipliziert, bevor diese addiert werden. Diese Option kann verwendet werden, wenn der Parameter des Feldes auf "Kein" festgelegt ist.

Der Standardstatistiktyp ist MEAN.

Die verfügbaren Optionen für den Statistiktyp werden durch den numerischen Typ des angegebenen Feldes bestimmt. Wenn das angegebene Feld ganzzahlig ist, stehen folgende Auswahlmöglichkeiten für Statistiken zur Verfügung: "Mehrheit", "Maximum", "Mittelwert", "Medianwert", "Minimum", "Minderheit", "Bereich", "Varianz" und "Länge". Wenn das Feld ein Gleitkommafeld ist, sind nur die Statistiken "Mittelwert", "Maximum", "Minimum", "Bereich" und "Länge" verfügbar.

String

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster für "Linien-Statistiken".

Raster

Codebeispiel

LineStatistics – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird die durchschnittliche Länge von Liniensegmenten innerhalb eines bestimmten Radius der einzelnen Zellen im Eingabe-Raster berechnet.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
lineStatOut = LineStatistics("streams", "LENGTH", 50, 500, "MEAN")
lineStatOut.save("C:/sapyexamples/output/linestatout")
LineStatistics – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird die durchschnittliche Länge von Liniensegmenten innerhalb eines bestimmten Radius der einzelnen Zellen im Eingabe-Raster berechnet.

# Name: LineStatistics_Ex_02.py
# Description: 
# Requirements: Spatial Analyst Extension

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

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

# Set local variables
inLines = "streams.shp"
field = "LENGTH"
cellSize = 50
searchRadius = 500

# Execute LineStatistics
lineStatOut = LineStatistics(inLines, field, cellSize, searchRadius,
                              "MEAN")

# Save the output 
lineStatOut.save("C:/sapyexamples/output/linestatisout")