Trend (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der 3D Analyst-Lizenz verfügbar.

Zusammenfassung

Interpoliert eine Raster-Oberfläche anhand von Punkten mithilfe einer Trendmethode.

Weitere Informationen zur Funktionsweise des Werkzeugs "Trend"

Verwendung

  • Wird die Polynom-Ordnung erhöht, wird auch die angepasste Oberfläche zunehmend komplexer. Ein Polynom höherer Ordnung liefert nicht immer die präziseste Oberfläche. Dies hängt von den Daten ab.

  • Für die Option Logistisch des Regressionstyps muss das Z-Wertefeld der Eingabe-Punkt-Features die Codes Null (0) und Eins (1) aufweisen.

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

  • Die optionale RMS-Dateiausgabe enthält Informationen zum RMS-Fehler der Interpolation. Diese Informationen können verwendet werden, um den optimalen Wert für die Polynom-Ordnung zu ermitteln, indem der Ordnungswert so lange geändert wird, bis Sie den niedrigsten RMS-Fehler erhalten. Informationen zur RMS-Datei finden Sie unter Funktionsweise des Werkzeugs "Trend".

  • Einige Eingabe-Datasets weisen mehrere Punkte mit denselben XY-Koordinaten auf. Wenn die Werte der Punkte an der gemeinsamen Position identisch sind, werden sie als Duplikate betrachtet und haben keinerlei Auswirkung auf die Ausgabe. Falls die Werte nicht identisch sind, werden sie als lagegleiche Punkte betrachtet.

    Die verschiedenen Interpolationswerkzeuge verarbeiten diese Datenbedingung möglicherweise unterschiedlich. In einigen Fällen wird beispielsweise der erste lagegleiche Punkt für die Berechnung verwendet, während in anderen Fällen der letzte Punkt verwendet wird. Dies kann dazu führen, dass einige Positionen im Ausgabe-Raster andere Werte enthalten als Sie erwarten. Die Lösung besteht darin, Ihre Daten vorzubereiten, indem Sie diese lagegleichen Punkte entfernen. Das Werkzeug Ereignisse erfassen in der Toolbox "Spatial Statistics" unterstützt Sie bei der Ermittlung aller lagegleichen Punkte in Ihren Daten.

  • Bei Datenformaten mit Unterstützung für NULL-Werte wie beispielsweise File-Geodatabase-Feature-Classes werden als Eingabe verwendete NULL-Werte ignoriert.

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

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Punkt-Features

Die Eingabe-Punkt-Features mit den Z-Werten, die in ein Oberflächen-Raster interpoliert werden.

Feature Layer
Z-Wert-Feld

Ein Feld mit einem Höhen- oder Größenwert für jeden Punkt.

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

Wenn der Regressionstyp "LOGISTIC" ist, können die Werte im Feld nur 0 oder 1 sein.

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
Polynom-Ordnung
(optional)

Die Ordnung des Polynoms.

Dies muss eine ganze Zahl zwischen 1 und 12 sein. Mit dem Wert 1 wird eine flache Ebene an den Punkten angebracht. Ein höherer Wert ergibt eine komplexere Oberfläche. Der Standardwert ist 1.

Long
Regressionstyp
(optional)

Der Typ der durchzuführenden Regression.

  • LinearEine Polynomregression wird durchgeführt, um eine aus kleinsten Quadraten bestehende Oberfläche an die Menge der Eingabepunkte anzupassen. Diese Option eignet sich für kontinuierliche Datentypen.
  • LogistischEs wird eine logistische Trendoberflächenanalyse durchgeführt. Diese erstellt eine kontinuierliche Wahrscheinlichkeitsoberfläche für binäre bzw. dichotome Datentypen.
String
Ausgabe-RMS-Datei
(optional)

Der Dateiname für die Ausgabetextdatei, die Informationen zum RMS-Fehler und dem Chi-Quadrat der Interpolation enthält.

Die Erweiterung muss .txt sein.

File

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster für die interpolierte Oberfläche.

Es handelt sich stets um ein Gleitkomma-Raster.

Raster

Trend(in_point_features, z_field, {cell_size}, {order}, {regression_type}, {out_rms_file})
NameErläuterungDatentyp
in_point_features

Die Eingabe-Punkt-Features mit den Z-Werten, die in ein Oberflächen-Raster interpoliert werden.

Feature Layer
z_field

Ein Feld mit einem Höhen- oder Größenwert für jeden Punkt.

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

Wenn der Regressionstyp "LOGISTIC" ist, können die Werte im Feld nur 0 oder 1 sein.

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
order
(optional)

Die Ordnung des Polynoms.

Dies muss eine ganze Zahl zwischen 1 und 12 sein. Mit dem Wert 1 wird eine flache Ebene an den Punkten angebracht. Ein höherer Wert ergibt eine komplexere Oberfläche. Der Standardwert ist 1.

Long
regression_type
(optional)

Der Typ der durchzuführenden Regression.

  • LINEAREine Polynomregression wird durchgeführt, um eine aus kleinsten Quadraten bestehende Oberfläche an die Menge der Eingabepunkte anzupassen. Diese Option eignet sich für kontinuierliche Datentypen.
  • LOGISTICEs wird eine logistische Trendoberflächenanalyse durchgeführt. Diese erstellt eine kontinuierliche Wahrscheinlichkeitsoberfläche für binäre bzw. dichotome Datentypen.
String
out_rms_file
(optional)

Der Dateiname für die Ausgabetextdatei, die Informationen zum RMS-Fehler und dem Chi-Quadrat der Interpolation enthält.

Die Erweiterung muss .txt sein.

File

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster für die interpolierte Oberfläche.

Es handelt sich stets um ein Gleitkomma-Raster.

Raster

Codebeispiel

Trend – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird ein Punkt-Shapefile eingegeben und die Ausgabeoberfläche als TIFF-Raster interpoliert.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTrend = Trend("ozone_pts.shp", "ozone", 2000, 2, "LINEAR")
outTrend.save("C:/sapyexamples/output/trendout.tif")
Trend – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird ein Punkt-Shapefile eingegeben und die Ausgabeoberfläche als Grid-Raster interpoliert.

# Name: Trend_Ex_02.py
# Description: Interpolate a series of point features 
#    onto a rectangular raster using a trend technique.
# 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
inPointFeatures = "ca_ozone_pts.shp"
zField = "ozone"
cellSize = 2000.0
PolynomialOrder = 2
regressionType = "LINEAR"


# Execute Trend
outTrend = Trend(inPointFeatures, zField, cellSize, 
                 PolynomialOrder, regressionType)

# Save the output 
outTrend.save("C:/sapyexamples/output/trendout02")

Lizenzinformationen

  • Basic: Erfordert Spatial Analyst oder 3D Analyst
  • Standard: Erfordert Spatial Analyst oder 3D Analyst
  • Advanced: Erfordert Spatial Analyst oder 3D Analyst

Verwandte Themen