Linien-Statistiken (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

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 mehrere Statistiktypen zur Auswahl. Die verfügbare Auswahl an Statistiken hängt vom Typ des angegebenen Feldes ab.

  • Bei Feldern vom Typ "Integer" lauten die gültigen Auswahloptionen für Statistiktyp wie folgt: "Mehrheit", "Maximum", "Mittelwert", "Medianwert", "Minimum", "Minderheit", "Bereich", "Varianz" und "Länge". Bei Float-Feldern lauten die gültigen Statistiken: "Maximum", "Mittelwert", "Minimum", "Bereich" und "Länge". "Mehrheit", "Minderheit" und "Varianz" sind nicht verfügbar.

  • Wenn der Feldtyp "Integer" lautet, ist das Ausgabe-Raster der folgenden Statistiken ebenfalls vom Typ "Integer": "Mehrheit", "Maximum", "Medianwert", "Minimum", "Minderheit", "Bereich" und "Varianz". Bei den Statistiken "Mittelwert" und "Länge" ist die Ausgabe vom Typ "Float".

    Wenn es sich bei dem Feldtyp um "Float" handelt, weist auch die Ausgabe für alle verfügbaren Statistiktypen den Typ "Float" auf.

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

  • Die Statistiktypen "Mehrheit", "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 Ausgabezellengröß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 der Parameter und die Umgebung für die Zellengröße nicht angegeben wurden, aber die Umgebung Fang-Raster festgelegt wurde, wird die Zellengröße des Fang-Rasters verwendet. Wenn kein Wert angegeben wird, 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 die Ausdehnung in der Umgebung im Ausgabekoordinatensystem angegeben.

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

    Wenn die Zellengröße mit einem Raster-Dataset angegeben wird, zeigt der Parameter anstelle des Zellengrößenwerts den Pfad des Raster-Datasets an. Die Zellengröße dieses Raster-Datasets wird direkt in der Analyse verwendet, vorausgesetzt der Raumbezug stimmt mit dem Ausgabe-Raumbezug überein. Wenn der Raumbezug des Datasets nicht mit dem Ausgabe-Raumbezug übereinstimmt, wird er basierend auf dem Wert für die ausgewählte Projektionsmethode für Zellengröße projiziert.

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Polylinien-Features

Die Eingabelinien, die bei der Nachbarschaftsoperation verwendet werden sollen.

Für jede Ausgabezelle wird für alle Teile der Eingabe-Polylinien-Features, die in die kreisförmige Nachbarschaft um die entsprechende Zelle fallen, eine Statistik berechnet.

Die Größe der kreisförmigen Nachbarschaft definiert sich über den Suchradius.

Feature Layer
Feld

Das Feld, für das die angegebene Statistik berechnet wird. Dieses kann ein beliebiges Zahlenfeld der Eingabe-Linien-Features sein.

Wenn Statistiktyp auf Länge festgelegt wurde, kann der Parameter Feld auf NONE festgelegt werden.

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

Field
Ausgabe-Zellengröße
(optional)

Die Zellengröße des Ausgabe-Rasters, das erstellt wird.

Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit als Parameterwert angegeben wurde, wird der Zellengrößenwert der Umgebung verwendet, sofern dieser angegeben wurde. Andernfalls werden zusätzliche Regeln verwendet, um ihn aus anderen Eingaben zu berechnen. Weitere Informationen finden Sie im Abschnitt zur Verwendung.

Analysis Cell Size
Suchradius
(optional)

Der Suchradius, innerhalb dessen die Statistik in Karteneinheiten berechnet wird.

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 vom Typ "Integer" ist, stehen für Statistiken folgende Auswahlmöglichkeiten zur Verfügung: "Mehrheit", "Maximum", "Mittelwert", "Medianwert", "Minimum", "Minderheit", "Bereich", "Varianz" und "Länge". Wenn das Feld vom Typ "Float" ist, sind nur die Statistiken für Mittelwert, Maximum, Minimum, Bereich und Länge verfügbar.

  • MittelwertBerechnet wird der durchschnittliche Feldwert (gewichtet nach Länge) in jeder Nachbarschaft.Die Berechnung hat folgendes Format:
    • 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.
  • MaximumDer größte Wert in jeder Nachbarschaft wird bestimmt.
  • MedianwertBerechnet wird der Medianwert (gewichtet nach Länge) in jeder Nachbarschaft.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.
  • MinimumDer kleinste Wert in jeder Nachbarschaft wird bestimmt.
  • MinderheitEs wird der Wert ermittelt, der die geringste Linienlänge in der Nachbarschaft aufweist.
  • BereichDer Wertebereich (Maximum–Minimum) wird berechnet.
  • VarianzDie Anzahl der Einzelwerte berechnet.
  • LängeDie gesamte Linienlänge in der Nachbarschaft wird 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 "Feld" 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 Eingabelinien, die bei der Nachbarschaftsoperation verwendet werden sollen.

Für jede Ausgabezelle wird für alle Teile der Eingabe-Polylinien-Features, die in die kreisförmige Nachbarschaft um die entsprechende Zelle fallen, eine Statistik berechnet.

Die Größe der kreisförmigen Nachbarschaft definiert sich über den Suchradius.

Feature Layer
field

Das Feld, für das die angegebene Statistik berechnet wird. Dieses kann ein beliebiges Zahlenfeld der Eingabe-Linien-Features sein.

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

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

Field
cell_size
(optional)

Die Zellengröße des Ausgabe-Rasters, das erstellt wird.

Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit als Parameterwert angegeben wurde, wird der Zellengrößenwert der Umgebung verwendet, sofern dieser angegeben wurde. Andernfalls werden zusätzliche Regeln verwendet, um ihn aus anderen Eingaben zu berechnen. Weitere Informationen finden Sie im Abschnitt zur Verwendung.

Analysis Cell Size
search_radius
(optional)

Der Suchradius, innerhalb dessen die Statistik in Karteneinheiten berechnet wird.

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.

  • MEANBerechnet wird der durchschnittliche Feldwert (gewichtet nach Länge) in jeder Nachbarschaft.Die Berechnung hat folgendes Format:
    • 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.
  • MAXIMUMDer größte Wert in jeder Nachbarschaft wird bestimmt.
  • MEDIANBerechnet wird der Medianwert (gewichtet nach Länge) in jeder Nachbarschaft.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.
  • MINIMUMDer kleinste Wert in jeder Nachbarschaft wird bestimmt.
  • MINORITYEs wird der Wert ermittelt, der die geringste Linienlänge in der Nachbarschaft aufweist.
  • RANGEDer Wertebereich (Maximum–Minimum) wird berechnet.
  • VARIETYDie Anzahl der Einzelwerte berechnet.
  • LENGTHDie gesamte Linienlänge in der Nachbarschaft wird 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 "Feld" 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 vom Typ "Integer" ist, stehen für Statistiken folgende Auswahlmöglichkeiten zur Verfügung: "Mehrheit", "Maximum", "Mittelwert", "Medianwert", "Minimum", "Minderheit", "Bereich", "Varianz" und "Länge". Wenn das Feld vom Typ "Float" ist, sind nur die Statistiken für 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")