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

Syntax

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

Die Eingabe-Polylinien-Features, für die die Linienstatistik berechnet werden soll.

Feature Layer
field

Das Feld, auf dessen Grundlage die angegebene Statistik berechnet wird. Dieses kann ein beliebiges Zahlenfeld der Eingabe-Linien-Features sein.

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

Field
cell_size
(optional)

Die Zellengröße für das Ausgabe-Raster-Dataset.

Dies ist der Wert in der Umgebung, wenn dieser ausdrücklich festgelegt wurde. Wenn dies in der Umgebung nicht festgelegt wurde, wird die Breite oder Höhe (der kleinere Wert von beiden) der Ausdehnung des Eingabe-Feature-Datasets im Ausgabe-Raumbezug dividiert durch 250 verwendet.

Analysis Cell Size
search_radius
(optional)

Suchradius in Karteneinheiten, innerhalb dessen die gewünschte Statistik berechnet werden soll.

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

Double
statistics_type
(optional)

Der zu berechnende Statistiktyp.

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

  • MEAN Berechnet den durchschnittlichen 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 Länge, der innerhalb der Nachbarschaft liegt, wird verwendet.
  • MAJORITY Ermittelt den Wert, der die größte Linienlänge in der Nachbarschaft aufweist.
  • MAXIMUMErmittelt den größten Wert in der Nachbarschaft.
  • MEDIAN Ermittelt den nach Länge gewichteten Medianwert.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.
  • MINIMUM Berechnet den kleinsten Wert in jeder Nachbarschaft.
  • MINORITY Der Wert, der die kleinste Linienlänge in der Nachbarschaft aufweist.
  • RANGE Der Wertebereich (Maximum–Minimum).
  • VARIETY Die Anzahl der Einzelwerte.
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

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

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

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

Umgebungen

Verwandte Themen

Lizenzinformationen

ArcView: Erfordert Spatial Analyst
ArcEditor: Erfordert Spatial Analyst
ArcInfo: Erfordert Spatial Analyst

7/10/2012