Linien-Statistiken

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

• Die 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 in 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 der ausgewählten Projektionsmethode für Zellengröße projiziert.

• 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 anderen ist es nicht wichtig, ob ein Teil oder die ganze Linie verwendet wird.

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

• Nur die Statistiktypen "Mehrheit", "Mittelwert", "Medianwer" und "Minderheit" werden nach der Länge der Linie gewichtet. Wenn beispielsweise eine Linie doppelt so lang ist wie eine andere, gilt ihr Wert als doppelt so oft aufgetreten.

• Die Werte im Ausgabe-Raster sind im Fall von "Varianz" immer ganzzahlig. Für "Mittelwert" und "Länge" sind es immer Gleitkommazahlen. Für die anderen Statistiken ist der Ausgabedatentyp mit dem Eingabefeldwerttyp identisch.

• Für die Statistiktypen "Majority", "Maximum", "Median", "Minimum", "Minority" und "Range" ist der Ausgabedatentyp des Rasters gleich dem Eingabefeldtyp. Bei den Statistiktypen "Mittelwert" und "Länge" werden im Ausgabe-Raster immer Gleitkommazahlen verwendet. Bei "Varianz" ist das Ausgabe-Raster stets ganzzahlig.

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

Syntax

LineStatistics(in_polyline_features, field, {cell_size}, {search_radius}, {statistics_type})

Parameter	Erklärung	Datentyp
in_polyline_features	Die Eingabe-Polylinien-Features für die die Statistik in einer Nachbarschaft um jede Ausgabezelle berechnet werden soll.	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 als Statistiktyp LENGTH definiert wurde, kann das Feld auf "Kein" 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 in den Verwendungsmöglichkeiten.	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)	Gibt den zu berechnenden Statistiktyp an. 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. MAXIMUM —Ermittelt 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. LENGTH —Die gesamte Linienlänge in der Nachbarschaft. 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 des Feld auf "Kein" festgelegt ist. Wenn das angegebene Feld ganzzahlig ist, stehen folgende Auswahlmöglichkeiten für Statistiken zur Verfügung: "Mittelwert", "Mehrheit", "Maximum", "Medianwert", "Minimum", "Minderheit", "Bereich" und "Varianz". Wenn das Feld den Typ "Gleitkomma" aufweist, sind als Statistiken nur "Mittelwert", "Maximum", "Minimum" und "Bereich" zulässig.	String

Rückgabewert

Name	Erklärung	Datentyp
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

• Auto-Commit
• Zellengröße
• Projektionsmethode für Zellengröße
• Komprimierung
• Aktueller Workspace
• Ausdehnung
• Geographische Transformationen
• Ausgabe-CONFIG-Schlüsselwort
• Ausgabe-Koordinatensystem
• Scratch-Workspace
• Fang-Raster
• Kachelgröße

Lizenzinformationen

• Basic: Erfordert Spatial Analyst
• Standard: Erfordert Spatial Analyst
• Advanced: Erfordert Spatial Analyst