Zusammenfassung
Ermöglicht es Ihnen, Werte an neuen Positionen basierend auf Messwerten aus einer Sammlung von Punkten vorherzusagen. Das Werkzeug verwendet Punktdaten mit Werten an jedem Punkt und gibt ein Raster von vorhergesagten Werten zurück.
Abbildung
Verwendung
Dieses Portal-Werkzeug für die Raster-Analyse ist verfügbar, wenn Sie bei einem ArcGIS Enterprise -Portal mit einem konfigurierten ArcGIS Image Server für die Raster Analysis angemeldet sind. Beim Aufruf des Werkzeugs dient ArcGIS Pro als Client. Die Verarbeitung erfolgt auf den Servern, die mit ArcGIS Enterprise verbunden sind. Das Portal-Werkzeug akzeptiert Layer aus dem Portal als Eingabe und erstellt die Ausgabe im Portal.
Bei dem Eingabe-Feature-Layer kann es sich um einen Layer aus dem Portal oder ein URI bzw. eine URL zu einem Feature-Service handeln. Obwohl Sie lokale Feature-Daten und Layer als Eingabe für dieses Portal verwenden können, empfiehlt es sich, Layer aus Ihrem Portal als Eingabe zu nutzen.
Bei der Interpolation werden mehrere lokale Interpolationsmodelle erstellt, die dann zu einem endgültigen Ausgabe-Raster zusammengeführt werden. Die Anzahl der Punkte in jedem lokalen Modell kann durch den Parameter Größe lokaler Modelle gesteuert werden.
Zur Durchführung der zugrunde liegenden Interpolation wird das Werkzeug Empirical Bayesian Kriging verwendet. Dieses Werkzeug ist Bestandteil der ArcGIS-Erweiterung Geostatistical Analyst. Viele Parameter des Werkzeugs werden über Punkte interpolieren bereitgestellt, zahlreiche werden jedoch auch automatisch über den Parameter Interpolationsoption gesteuert.
Syntax
arcpy.ra.InterpolatePoints(inputPointFeatures, interpolateField, outputName, {optimizeFor}, {transformData}, {sizeOfLocalModels}, {numberOfNeighbors}, {outputCellSize}, {outputPredictionError})
Parameter | Erklärung | Datentyp |
inputPointFeatures | Die Eingabe-Punkt-Features, die interpoliert werden sollen. | Feature Set |
interpolateField | Das Feld mit den Datenwerten, die interpoliert werden sollen. Das Feld muss numerisch sein. | Field |
outputName | Der Name des Ausgabe-Raster-Service. Der Standardname basiert auf dem Werkzeugnamen und dem Namen des Eingabe-Layers. Wenn der Layer-Name bereits vorhanden ist, werden Sie dazu aufgefordert, einen anderen Namen einzugeben. | String |
optimizeFor (optional) | Legen Sie Ihre Präferenz für Geschwindigkeit im Vergleich zu Genauigkeit fest. Die Berechnung genauerer Vorhersagen nimmt mehr Zeit in Anspruch.
| String |
transformData (optional) | Legen Sie vor der Analyse fest, ob die Daten in Normalverteilung transformiert werden sollen. Falls Ihre Datenwerte augenscheinlich nicht in Normalverteilung (glockenförmig) vorliegen, empfehlen wir, eine Transformation durchzuführen.
| Boolean |
sizeOfLocalModels (optional) | Bestimmen Sie die Anzahl der Punkte in jedem einzelnen lokalen Modell. Durch größere Werte wird die Interpolation globaler und stabiler, allerdings werden Effekte mit kleinem Maßstab möglicherweise übersehen. Je kleiner die Werte, umso lokaler die Interpolation. Die Wahrscheinlichkeit, dass Effekte mit kleinem Maßstab erfasst werden, es dadurch höher, die Interpolation kann jedoch instabil sein. | Long |
numberOfNeighbors (optional) | Die bei der Berechnung der Vorhersage für eine bestimmte Zelle zu verwendende Anzahl von Nachbarn. | Long |
outputCellSize (optional) | Legen Sie die Zellengröße und die Einheiten des Ausgabe-Rasters fest. Wenn ein Vorhersagefehler-Raster erstellt wird, wird diese Zellengröße ebenfalls verwendet. Die Einheiten können Kilometer, Meter, Meilen oder Fuß sein. Die Standardeinheiten lauten Meter. | Linear Unit |
outputPredictionError (optional) | Legen Sie fest, ob Sie ein Raster mit den Standardfehlern der interpolierten Vorhersagen ausgeben möchten. Standardfehler sind hilfreich, da sie Informationen zur Zuverlässigkeit der vorhergesagten Werte liefern. Eine einfache Faustregel besagt, dass der tatsächliche Wert in 95% der Fälle innerhalb von zwei Standardfehlern um den vorhergesagten Wert liegt. Nehmen Sie beispielsweise an, dass für eine neue Position ein Wert von 50 mit einem Standardfehler von 5 vorhergesagt wird. Dies bedeutet, dass die bestmögliche Vorhersage für den tatsächlichen Wert an dieser Position 50 ist, er aber durchaus Werte zwischen 40 und 60 aufweisen könnte. Um diesen Bereich sinnvoller Werte zu berechnen, multiplizieren Sie den Standardfehler mit 2, addieren Sie diesen Wert mit dem vorhergesagten Wert, um den oberen Grenzwert des Bereichs zu erhalten, und subtrahieren Sie ihn vom vorhergesagten Wert, um den unteren Grenzwert zu berechnen. Wenn ein Raster mit Standardfehlern für die interpolierten Vorhersagen angefordert wird, entspricht der Name dem Namen des Ergebnis-Layers. Der Anhang lautete jedoch Errors.
| Boolean |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
outputRaster | Das Ausgabe-Raster. | Raster-Layer |
outputErrorRaster | Das Ausgabe-Raster für Vorhersagefehler. | Raster-Layer |
Codebeispiel
In diesem Beispiel wird ein Punkt-Feature-Service in ein Image-Service-Raster interpoliert.
import arcpy
arcpy.InterpolatePoints_ra('https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0',
'myField', 'outImgServ', 'SPEED', 'False', 50, 8, '10000 Meters', 'NO_OUTPUT_ERROR')
In diesem Beispiel wird ein Punkt-Feature-Service in ein Image-Service-Raster interpoliert.
#-------------------------------------------------------------------------------
# Name: InterpolatePoints_example02.py
# Description: Interpolates a point feature service into an image service raster.
#
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inPoints = 'https://MyPortal.esri.com/server/rest/services/Hosted/myPoints/FeatureServer/0'
inField = 'myField'
outRaster = 'outImgServ'
optimizeFor = 'SPEED'
transform = 'False'
subsetSize = 50
numNeighbors = 8
outCellSize = '10000 Meters'
error = 'NO_OUTPUT_ERROR'
# Execute InterpolatePoints
arcpy.InterpolatePoints_ra(inPoints, inField, outRaster, optimizeFor, transform,
subsetSize, numNeighbors, outCellSize, error)
Umgebungen
Lizenzinformationen
- Basic: Erfordert ArcGIS Image Server
- Standard: Erfordert ArcGIS Image Server
- Advanced: Erfordert ArcGIS Image Server