Zusammenfassung
Berechnet Statistiken der Werte eines Gitternetzs innerhalb der Zonen eines anderen Datasets.
Abbildung
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
-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.Folgende Eingabe-Raster-Layer können verwendet werden: ein Layer aus dem Portal, ein URI oder eine URL zu einem Image-Service oder die Ausgabe des Werkzeugs Image Server-Layer erstellen. Als Eingabe-Feature-Layer kann ein Layer aus dem Portal verwendet werden. Es kann auch ein URI oder eine URL zu einem Feature-Service verwendet werden. 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 so hochwertiges Ergebnis wie gedacht, da das zusätzliche Detail tatsächlich 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. Beim Gleitkomma-Datentyp sind jedoch die Optionen für die Berechnung von Mehrheit, Medianwert, 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.
Zu den unterstützten multidimensionalen Dataset-Typen zählt auch der multidimensionale Image-Service.
Syntax
SummarizeRasterWithin(inputZoneLayer, zoneField, inputRasterLayertoSummarize, outputName, {statisticType}, {ignoreMissingValues}, {processAsMultidimensional}, {percentileValue})| Parameter | Erklärung | Datentyp |
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 die Optionen Durchschnitt, Maximum, Minimum, Bereich, Standardabweichung und Summe verfügbar.
| 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.
| Boolean |
processAsMultidimensional (optional) | Gibt an, wie die Eingabe-Werte-Raster verarbeitet werden, wenn sie multidimensional sind.
| 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 |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| outputRaster | Das Ausgabe-Raster. | Raster-Layer |
Codebeispiel
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')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)Umgebungen
Lizenzinformationen
- Basic: Erfordert ArcGIS Image Server
- Standard: Erfordert ArcGIS Image Server
- Advanced: Erfordert ArcGIS Image Server