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-Portal mit einem für Raster Analysis konfigurierten ArcGIS Image Server 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 Werkzeugverarbeitung 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ätzlichen Details nicht in der Eingabe Zusammenzufassender Eingabe-Raster-Layer vorhanden sind.

  • 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 für Eingabe-Zonen-Layer ein Punkt-Feature festgelegt wurde, kann mehr als ein Punkt in einer bestimmten Zelle des Eingabe-Werte-Rasters enthalten sein. 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).

  • Der unterstützte Statistikwert hängt von dem Datentyp des Wertes für Eingabe-Werte-Raster und dem Typ der Statistikberechnung ab, der durch den Parameter Zirkuläre Statistiken berechnen angegeben wird.

    Wenn der Datentyp "Integer" lautet, unterstützt die Berechnung von arithmetischen Statistiken die Optionen Mittelwert, Mehrheit, Maximum, Medianwert, Minimum, Minderheit, Perzentil, Bereich, Standardabweichung, Summe und Varianz. Die Berechnung von zirkulären Statistiken unterstützt die Optionen Mittelwert, Mehrheit, Minderheit, Standardabweichung und Varianz.

    Wenn der Datentyp "Float" lautet, unterstützt die Berechnung von arithmetischen Statistiken die Optionen Mittelwert, Maximum, Medianwert, Minimum, Perzentil, Bereich, Standardabweichung und Summe. Die Berechnung von zirkulären Statistiken unterstützt die Optionen Mittelwert und Standardabweichung.

  • Bei Mehrheits- und Minderheitsberechnungen wird bei einem Gleichstand der niedrigste der beiden Werte ausgegeben.

  • Aktivieren Sie zur Berechnung von zirkulären Statistiken den Parameter Zirkuläre Statistiken berechnen (circularCalculation = "CIRCULAR" in Python), und geben Sie einen Wert für Umbruchwert für Verteilung auf Einheitskreis (circularWrapValue in Python) an.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Zonen-Layer

Die Eingabe, die die Zonen definiert.

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

Raster Layer; Feature Layer
Zonenfeld

Das Feld, das jede Zone definiert.

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

String
Zusammenzufassender Eingabe-Raster-Layer

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

Raster Layer
Ausgabename

Der Name des Ausgabe-Raster-Service.

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

String
Statistiktyp
(optional)

Gibt den Statistiktyp an, der berechnet werden soll.

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.

  • DurchschnittDer Durchschnitt aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet. Dies ist die Standardeinstellung.
  • MehrheitDer 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.
  • MedianwertDer 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.
  • MinderheitDer am seltensten vorkommende Wert aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • PerzentilDas 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.
  • BereichDie 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.
  • StandardabweichungDie Standardabweichung aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • SummeDer Gesamtwert aus allen Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
  • VarianzDie Anzahl der eindeutigen Werte für alle Zellen im zusammenzufassenden Raster-Layer, die zur selben Zone gehören wie die Ausgabezelle, wird berechnet.
String
Fehlende Werte ignorieren
(optional)

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

  • Aktiviert: Innerhalb 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.
  • Deaktiviert: Wenn 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
Als multidimensional verarbeiten
(optional)

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

  • Deaktiviert: Statistiken werden anhand des aktuellen Segments eines multidimensionalen Eingabe-Datasets berechnet. Dies ist die Standardeinstellung.
  • Aktiviert: Statistiken werden für alle Dimensionen (z. B. Zeit oder Tiefe) von allen Abschnitten des multidimensionalen Eingabe-Rasters berechnet.
Boolean
Perzentilwert
(optional)

Das Perzentil wird berechnet. 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.

Dieser Parameter ist nur bei der Perzentil-Berechnung verfügbar.

Double
Perzentil-Interpolationstyp
(optional)

Gibt die Interpolationsmethode an, die verwendet wird, wenn der Perzentilwert zwischen zwei Zellenwerte aus dem Eingabe-Werte-Raster fällt.

  • Automatisch erkennenWeist das Eingabe-Werte-Raster einen ganzzahligen Pixeltyp auf, wird die Methode Nächster Nachbar verwendet. Weist das Eingabe-Werte-Raster einen Gleitkomma-Pixeltyp auf, wird die Methode Linear verwendet. Dies ist die Standardeinstellung.
  • Nächster NachbarEs 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
Zirkuläre Statistiken berechnen
(optional)

Gibt an, wie der Statistiktyp berechnet wird.

  • Deaktiviert: Es werden arithmetische Statistiken berechnet. Dies ist die Standardeinstellung.
  • Aktiviert: Es werden zirkuläre Statistiken berechnet, die für zyklische Größen, wie etwa die Himmelsrichtung in Grad, Tageszeiten oder Bruchteile von reellen Zahlen, geeignet sind.
Boolean
Umbruchwert für Verteilung auf Einheitskreis
(optional)

Der höchstmögliche Wert (Maximum) in den zyklischen Daten. Es ist eine positive Zahl mit dem Standardwert 360. Dieser Wert stellt auch dieselben Größe als kleinstmöglichen Wert (Minimum) dar.

Dieser Parameter kommt nur bei der Berechnung zirkulärer Statistiken zur Anwendung.

Double

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster.

Raster Layer

arcpy.ra.SummarizeRasterWithin(inputZoneLayer, zoneField, inputRasterLayertoSummarize, outputName, {statisticType}, {ignoreMissingValues}, {processAsMultidimensional}, {percentileValue}, {percentileInterpolationType}, {circularCalculation}, {circularWrapValue})
NameErläuterungDatentyp
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 Statistiktyp an, der berechnet werden soll.

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 multidimensionalen Eingabe-Datasets berechnet. Dies ist die Standardeinstellung.
  • ALL_SLICESStatistiken werden für alle Dimensionen des multidimensionalen Eingabe-Datasets berechnet.
Boolean
percentileValue
(optional)

Das Perzentil wird berechnet. 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.

Dieser Parameter ist nur bei der Perzentil-Berechnung verfügbar.

Double
percentileInterpolationType
(optional)

Gibt die Interpolationsmethode an, die verwendet wird, wenn der Perzentilwert zwischen zwei Zellenwerte aus dem Eingabe-Werte-Raster fällt.

  • 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
circularCalculation
(optional)

Gibt an, wie der Statistiktyp berechnet wird.

  • ARITHMETICEs werden arithmetische Statistiken berechnet. Dies ist die Standardeinstellung.
  • CIRCULAREs werden zirkuläre Statistiken berechnet, die für zyklische Größen, wie etwa die Himmelsrichtung in Grad, Tageszeiten oder Bruchteile von reellen Zahlen, geeignet sind.
Boolean
circularWrapValue
(optional)

Der höchstmögliche Wert (Maximum) in den zyklischen Daten. Es ist eine positive Zahl mit dem Standardwert 360. Dieser Wert stellt auch dieselben Größe als kleinstmöglichen Wert (Minimum) dar.

Dieser Parameter kommt nur bei der Berechnung zirkulärer Statistiken zur Anwendung.

Double

Abgeleitete Ausgabe

NameErläuterungDatentyp
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.ra.SummarizeRasterWithin('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.ra.SummarizeRasterWithin(inputZoneLayer, zoneField, inputRasterLayertoSummarize,
                               outputName, statisticType, ignoreMissingValues)

Lizenzinformationen

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

Verwandte Themen