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
-
Für die Statistiken "Mehrheit", "Mittelwert", "Medianwert" und "Minderheit" 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, weist die Varianzstatistik den Wert 0 zu. Bei den anderen Statistiken wird "NoData" zugewiesen.
-
Nur die Statistiktypen "Majority", "Mean", "Median" und "Minority" 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 "Variety" immer ganzzahlig. Sie sind immer ein Gleitkommawert für den Mittelwert. Für die anderen Statistiken ist der Ausgabedatentyp mit dem Eingabefeldwerttyp identisch.
-
Wenn das Feld ganzzahlig ist, stehen folgende Auswahlmöglichkeiten für Überlagerungsstatistiken zur Verfügung: "Mean", "Majority", "Maximum", "Median", "Minimum", "Minority", "Range" und "Variety". Wenn das Feld den Typ "Gleitkomma" aufweist, sind als Statistiken nur "Mean", "Maximum", "Minimum" und "Range" zulässig.
-
Für die Statistiktypen "Majority", "Maximum", "Median", "Minimum", "Minority" und "Range" ist der Ausgabedatentyp des Rasters gleich dem Eingabefeldtyp. Bei dem Statistiktyp "Mittelwert" werden im Ausgabe-Raster immer Gleitkommazahlen verwendet. Bei "Variety" ist das Ausgabe-Raster stets ganzzahlig.
Syntax
Parameter | Erläuterung | Datentyp |
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.
| String |
Rückgabewert
Name | Erläuterung | Datentyp |
out_raster |
Das Ausgabe-Raster für "Linien-Statistiken". | Raster |
Codebeispiel
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")
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")