Raster zusammenfassen (innerhalb) (Raster Analysis)

Zusammenfassung

Berechnet Statistiken der Werte eines Gitternetzs innerhalb der Zonen eines anderen Datasets.

Abbildung

Darstellung des Werkzeugs "Raster zusammenfassen (innerhalb)"

Verwendung

  • Eine Zone wird durch alle Flächen in der Eingabe mit demselben Wert definiert. Die Flächen müssen nicht zusammenhängend sein. Sowohl Raster als auch Features können als Zoneneingabe verwendet werden.

  • Dieses Portal-Werkzeug für die Raster-Analyse ist verfügbar, wenn Sie bei einem ArcGIS Enterprise Link zur Erläuterung der Analyse in ArcGIS Enterprise-Portal mit einem konfigurierten ArcGIS Image Server Link zu "Was ist ArcGIS Image Server?" für die Raster Analysis Link zu "Konfigurieren und Bereitstellen von Raster-Analysen" 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.

    Als Eingabe-Raster-Layer kann ein Layer aus dem Portal, ein URI bzw. eine URL zu einem Image-Service oder die Ausgabe des Werkzeugs Image Server-Layer erstellen verwendet werden. 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. Lokale Raster-Daten oder -Layer werden von diesem Werkzeug nicht unterstützt. 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.

  • Wenn der Eingabe-Zonen-Layer (inputZoneLayer in Python) ein Raster ist, muss er den Datentyp "Integer" aufweisen.

    Wenn die Zoneneingabe ein Feature ist, wird sie intern in ein Raster konvertiert, wobei die Zellengröße und die Zellenausrichtung aus dem Wert-Raster verwendet werden.

  • Bei Abweichungen der Zellengröße zwischen Eingabe-Zonen-Layer (inputZoneLayer in Python) und Zusammenzufassender Eingabe-Raster-Layer (inputRasterLayertoSummarize in Python) entspricht die Ausgabezellengröße dem Maximum der Eingabedaten. In diesem Fall wird das Werte-Raster intern als Fang-Raster verwendet. Wenn die Zellengröße übereinstimmt, die Zellen jedoch nicht ausgerichtet sind, wird das Wert-Raster intern als Fang-Raster verwendet. In beiden Fällen wird ein internes Resampling ausgelöst, bevor die zonale Operation ausgeführt wird.

    Wenn die Zonen- und Werteingaben jeweils Raster mit derselben Zellengröße sind und die Zellen ausgerichtet sind, werden sie direkt in dem Werkzeug verwendet. Während der Werkzeugausführung wird dann kein internes Resampling durchgeführt.

  • Wenn eine bestimmte Zone aus dem Eingabe-Zonen-Layer keine anderen Zellenmittelpunkte des Eingabe-Werte-Rasters überlagert, wird die Zone zu NoData. Bestimmen Sie in diesem Fall eine geeignete Raster-Auflösung, in der die Details der Zonen-Eingabe beibehalten werden. Verwenden Sie dann diese Auflösung als Zellengröße der Umgebung. Die Angabe einer kleineren Zellengröße hat ein größeres Ausgabe-Raster zur Folge. Die Ausgabe in einer höheren Auflösung ergibt nicht zwangsläufig ein qualitativ höherwertiges Ergebnis, da die zusätzliche Detailebene nicht in der Eingabe Zusammenzufassender Eingabe-Raster-Layer vorhanden ist.

  • Wenn der Eingabe-Zonen-Layer überlappende Polygone aufweist, wird die zonale Analyse nicht für jedes einzelne Polygon ausgeführt. Da die Feature-Eingabe in ein Raster konvertiert wird, kann jede Position über nur einen Wert verfügen.

    Eine alternative Methode besteht darin, die zonale Operation für jede Polygonzone iterativ zu verarbeiten und die Ergebnisse zu sortieren.

  • Wenn es sich bei dem Eingabe-Zonen-Layer um ein Punkt-Feature handelt, ist es möglich, dass eine bestimmte Zelle des Eingabe-Werte-Rasters mehr als einen Punkt enthält. Für derartige Zellen wird der Zonenwert durch den Punkt mit dem niedrigsten ObjectID-Feld (z. B. OID oder FID) bestimmt.

  • Beim Festlegen des Eingabe-Zonen-Layers entspricht das Standard-Zonenfeld dem ersten verfügbaren Ganzzahl- oder Textfeld. Sind keine anderen gültigen Felder vorhanden, wird das ObjectID-Feld als Standardfeld verwendet (z. B. OID oder FID).

  • Zusammenzufassender Eingabe-Raster-Layer kann entweder ein Ganzzahl- oder ein Gleitkomma-Raster sein. Bei Gleitkomma-Rastern sind jedoch die Optionen für die Berechnung von Mehrheit, Minderheit und Varianz nicht verfügbar. Wenn es bei den Statistiken "Mehrheit" und "Minderheit" zu einem Gleichstand kommt, basiert die Ausgabe für die Zone auf dem niedrigsten der verbundenen Werte.

Syntax

arcpy.ra.SummarizeRasterWithin(inputZoneLayer, zoneField, inputRasterLayertoSummarize, outputName, {statisticType}, {ignoreMissingValues}, {processAsMultidimensional}, {percentileValue}, {percentileInterpolationType})
ParameterErklärungDatentyp
inputZoneLayer

Die Eingabe, die die Zonen definiert.

Sowohl Raster- als auch Feature-Daten können als Zoneneingabe verwendet werden.

Raster Layer; Feature Layer
zoneField

Das Feld, das jede Zone definiert.

Es kann sich dabei um ein Ganzzahl- oder ein Zeichenfolgefeld des Zonen-Datasets handeln.

String
inputRasterLayertoSummarize

Das Raster, das die Werte für die Zusammenfassung der Statistik enthält.

Raster Layer
outputName

Der Name des Ausgabe-Raster-Service.

Wenn der Image-Service-Layer bereits vorhanden ist, werden Sie aufgefordert, einen anderen Namen einzugeben.

String
statisticType
(optional)

Gibt den zu berechnenden Statistiktyp an.

Wenn das zusammenzufassende Raster den Datentyp "Integer" aufweist, sind folgende Optionen verfügbar: Durchschnitt, Mehrheit, Maximum, Medianwert, Minimum, Minderheit, Perzentil, Bereich, Standardabweichung, Summe und Varianz.

Wenn das zusammenzufassende Raster den Datentyp "Float" aufweist, sind folgende Optionen verfügbar: Durchschnitt, Maximum, Medianwert, Minimum, Perzentil, Bereich, Standardabweichung und Summe.

  • MEANDer Durchschnitt aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet. Dies ist die Standardeinstellung.
  • MAJORITYDer am häufigsten vorkommende Wert aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • MAXIMUMDer Gesamtwert aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • MEDIANDer Medianwert aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • MINIMUMDer kleinste Wert aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • MINORITYDer am seltensten vorkommende Wert aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • PERCENTILEDas Perzentil aller Zellen im Wert-Raster, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet. Standardmäßig wird das 90. Perzentil berechnet. Sie können andere Werte (von 0 bis 100) mit dem Parameter Perzentilwert angeben.
  • RANGEDie Differenz zwischen dem größten und kleinsten Wert aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • STDDie Standardabweichung aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • SUMDer Gesamtwert aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • VARIETYDie Anzahl der eindeutigen Werte für alle Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
String
ignoreMissingValues
(optional)

Gibt an, ob sich fehlende Werte im zusammenzufassenden Raster-Layer in den Ergebnissen der Zonen, in denen sie sich befinden, ignoriert werden.

  • DATAInnerhalb einer bestimmten Zone werden nur Zellen, die über einen Wert im zusammenzufassenden Raster-Layer verfügen, zum Bestimmen des Ausgabewertes für diese Zone verwendet. Fehlende oder NoData-Zellen werden bei der Statistikberechnung ignoriert. Dies ist die Standardeinstellung.
  • NODATAWenn es in einer bestimmten Zone Zellen im zusammenzufassenden Raster-Layer gibt, die über keinen Wert verfügen, werden diese nicht ignoriert. Ihr Vorhandensein weist darauf hin, dass es nicht genügend Informationen zum Durchführen statistischer Berechnungen für alle Zellen in der Zone gibt. Entsprechend erhält die gesamte Zone den NoData-Wert für das Ausgabe-Raster.
Boolean
processAsMultidimensional
(optional)

Gibt an, wie die Eingabe-Werte-Raster verarbeitet werden, wenn sie multidimensional sind.

  • CURRENT_SLICEStatistiken werden anhand des aktuellen Segments eines mehrdimensionalen Eingabe-Datasets berechnet. Dies ist die Standardeinstellung.
  • ALL_SLICESStatistiken werden für alle Dimensionen des multidimensionalen Eingabe-Datasets berechnet.
Boolean
percentileValue
(optional)

Das zu berechnende Perzentil. Der Standardwert ist 90 und steht für das 90. Perzentil.

Zulässige Werte können zwischen 0 und 100 liegen. Grundsätzlich entspricht der Perzentilwert 0 statistisch gesehen dem Minimum und der Perzentilwert 100 dem Maximum. Der Wert 50 ergibt im Wesentlichen dasselbe Ergebnis wie der Medianwert der Statistik.

Diese Option ist nur verfügbar, wenn für den Parameter statisticType die Option PERCENTILE festgelegt wurde.

Double
percentileInterpolationType
(optional)

Gibt die Perzentil-Interpolationsmethode an, die verwendet werden soll, wenn die Anzahl der Werte aus dem zu berechnenden Eingabe-Raster gerade ist.

  • AUTO_DETECTWeist das Eingabe-Werte-Raster einen ganzzahligen Pixeltyp auf, wird die Methode NEAREST verwendet. Weist das Eingabe-Werte-Raster einen Gleitkomma-Pixeltyp auf, wird die Methode LINEAR verwendet. Dies ist die Standardeinstellung.
  • NEARESTEs wird der dem gewünschten Perzentil am nächsten liegende verfügbare Wert verwendet. In diesem Fall entspricht der Ausgabepixeltyp dem des Eingabe-Werte-Rasters.
  • LINEAREs wird der gewichtete Durchschnitt der beiden umgebenden Werte aus dem gewünschten Perzentil verwendet. In diesem Fall ist der Ausgabepixeltyp "Gleitkomma".
String

Abgeleitete Ausgabe

NameErklärungDatentyp
outputRaster

Das Ausgabe-Raster.

Raster-Layer

Codebeispiel

SummarizeRasterWithin – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird für jede Zone der Durchschnitt von Zellwerten im Raster-Layer bestimmt, der zusammengefasst werden soll.

import arcpy
arcpy.SummarizeRasterWithin_ra('https://MyPortal.esri.com/server/rest/services/Hosted/landuse/ImageServer',
                               'Landuse', 'https://MyPortal.esri.com/server/rest/services/Hosted/elevation/ImageServer',
                               'outRaster', 'MEAN', 'DATA')
SummarizeRasterWithin – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird für jede Zone der Durchschnitt im Raster-Layer bestimmt, der zusammengefasst werden soll.

#-------------------------------------------------------------------------------
# Name: SummarizeRasterWithin_Ex_02.py
# Description: Calculates the maximum sea-surface temperature at different ecological zones.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputZoneLayer = 'https://MyPortal.esri.com/server/rest/services/Hosted/zones/ImageServer'
zoneField = 'temperature'
inputRasterLayertoSummarize = 'https://MyPortal.esri.com/server/rest/services/Hosted/seaSurfaceTemperature/ImageServer'
outputName = 'outSSTRaster'
statisticType = 'MAXIMUM' 
ignoreMissingValues = ''
processAsMultidimensional = 'ALL_SLICES'

# Execute Multidimensional Summarize Raster Within operation
arcpy.SummarizeRasterWithin_ra(inputZoneLayer, zoneField, inputRasterLayertoSummarize,
                               outputName, statisticType, ignoreMissingValues)

Lizenzinformationen

  • Basic: Erfordert ArcGIS Image Server
  • Standard: Erfordert ArcGIS Image Server
  • Advanced: Erfordert ArcGIS Image Server

Verwandte Themen