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.

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

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

  • In Datenformaten, die NULL-Werte unterstützen (z. B. Feature-Classes in File-Geodatabases), wird ein als Eingabe verwendeter NULL-Wert ignoriert.

  • Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem 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 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
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 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
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