| Beschriftung | Erläuterung | Datentyp |
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-Raster | Das Ausgabe-Raster für die interpolierte Oberfläche. Es handelt sich stets um ein Gleitkomma-Raster. | Raster Dataset |
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.
| 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 |
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.
Parameter
arcpy.ddd.Trend(in_point_features, z_field, out_raster, {cell_size}, {order}, {regression_type}, {out_rms_file})| Name | Erläuterung | Datentyp |
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 |
out_raster | Das Ausgabe-Raster für die interpolierte Oberfläche. Es handelt sich stets um ein Gleitkomma-Raster. | Raster Dataset |
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.
| 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 |
Codebeispiel
In diesem Beispiel wird ein Punkt-Shapefile eingegeben und die Ausgabeoberfläche als TIFF-Raster interpoliert.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Trend_3d("ca_ozone_pts.shp", "ozone",
"C:/output/trendout.tif", 2000, 2, "LINEAR")In diesem Beispiel wird ein Punkt-Shapefile eingegeben und die Ausgabeoberfläche als Grid-Raster interpoliert.
# Name: Trend_3d_Ex_02.py
# Description: Interpolate a series of point features onto a
# rectangular raster using a trend technique.
# Requirements: 3D Analyst Extension
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inPointFeatures = "ca_ozone_pts.shp"
zField = "ozone"
outRaster = "C:/sapyexamples/output/trendout02"
cellSize = 2000.0
PolynomialOrder = 2
regressionType = "LINEAR"
# Execute Trend
arcpy.ddd.Trend(inPointFeatures, zField, outRaster, cellSize,
PolynomialOrder, regressionType)Umgebungen
Lizenzinformationen
- Basic: Erfordert 3D Analyst oder Spatial Analyst
- Standard: Erfordert 3D Analyst oder Spatial Analyst
- Advanced: Erfordert 3D Analyst oder Spatial Analyst