Stichprobe (Map Viewer)

Das Werkzeug "Stichprobe" extrahiert Zellenwerte aus allen Eingabe-Rastern an jeder Eingabe-Feature-Position.

Die Ausgabe ist ein gehosteter Tabellen-Layer oder ein gehosteter Feature-Layer.

Beispiele

Dieses Werkzeug umfasst die folgenden Anwendungsgebiete:

• Extrahieren von Attributen für die Position von Mobilfunkmasten aus mehreren Rastern, z. B. Bodennutzung, Bodenart, Höhe und die Entfernung zur Straße.
• Extrahieren der Bodentemperatur in unterschiedlichen Tiefen für eine bestimmte Gruppe von Punkten.
• Zusammenfassen der Position von Tieren oder ihrer Heimatgebiete über einen bestimmten Zeitraum bei entsprechenden Beobachtungen von Tierarten aus 30 Jahre lang monatlich aufgezeichneten Daten zur Temperatur der Meeresoberfläche.

Verwendungshinweise

Das Werkzeug "Stichprobe" enthält Konfigurationen für die Eingabe-Layer, die Stichprobeneinstellungen und den Ergebnis-Layer.

Eingabe-Layer

Die Gruppe Eingabe-Layer enthält die folgenden Parameter:

• Bilddaten-Layer gibt das Bild oder die Bildliste an, aus deren Werten auf Grundlage der Eingabepositionsdaten Stichproben genommen werden.

  Jede beliebige Kombination von Rastern, wie Einzelband-, Multiband-, multidimensionale oder multivariaten Rastern, kann als Eingabe angegeben werden. Wenn die Eingabe-Raster multidimensional sind, ändert sich die Struktur der Ausgabe-Tabelle. Wenn ein Multiband-Raster als eines der Eingabe-Raster angegeben wird, werden alle Bänder in dieser Eingabe verwendet. Wenn eine Auswahl von Bändern aus einem Eingabemultiband-Raster verarbeitet werden soll, erstellen Sie zunächst ein Raster-Dataset, das aus den betreffenden Bändern besteht. Verwenden Sie das Ergebnis in der Liste der Eingabe-Raster.

  Damit von allen Abschnitten eines multidimensionalen Bilddaten-Layers Stichproben entnommen werden können, darf nur ein einziges Eingabe-Raster vorhanden sein.
• Positions-Layer gibt den Layer mit den Positionen für die Stichprobennahme an. Die folgenden Layer-Typen werden unterstützt:
  • Raster: Pixel, die gültige Werte (keine NoData-Werte) enthalten, werden verwendet, um die Pixelwerte aus allen Eingabe-Rastern zu extrahieren, und der Mittelpunkt des Pixels wird für Punktpositionen verwendet.
  • Punkt: Stichproben werden an jeder Punktposition genommen.
  • Polylinie oder Polygon: Stichproben werden am Polygon- oder Polylinien-Schwerpunkt genommen. Wenn es sich um ein multidimensionales Eingabe-Raster handelt, werden die Werte auf Basis des Parameters Statistiktyp aggregiert.

Stichprobeneinstellungen

Die Gruppe Stichprobeneinstellungen enthält die folgenden Parameter:

• Resampling-Methode gibt den verwendeten Resampling-Algorithmus an. Die folgenden Optionen sind verfügbar:
  • Nächster Nachbar: Verwendet den Wert der nächstgelegenen Zelle, um der Ausgabezelle beim Resampling einen Wert zuzuweisen. Dies ist die Standardeinstellung.
  • Bilinear: Bilineare Interpolation. Bestimmt den neuen Wert einer Zelle anhand eines gewichteten Entfernungsdurchschnitts der vier nächstgelegenen Mittelpunkte der Eingabezellen.
  • Kubisch: Kubische Faltung. Bestimmt den neuen Wert einer Zelle, indem eine geglättete Kurve durch die 16 nächstgelegenen Mittelpunkte der Eingabezellen geführt wird.
• Feld für die eindeutige ID gibt ein Feld im Layer an, das für jedes Positions- oder Eingabe-Feature einen anderen Wert enthält.
• Als multidimensional verarbeiten gibt an, ob die Eingabe-Bilddaten-Layer multidimensionale Daten enthalten.
• Erfassungsinformationen zu Positionsdaten gibt die Zeit, Tiefe oder andere Erfassungsdaten im Zusammenhang mit den Positionszellen oder -Features an. Dieser Parameter ist verfügbar, wenn die Option Als multidimensional verarbeiten aktiviert ist. Er enthält die folgenden Unterparameter:
  • Dimension: Die Dimension des multidimensionalen Eingabe-Layers.
  • Startfeld oder -wert: Das Feld bzw. der Dimensionswert für den Beginn des Zeitbereichs. Geben Sie ein Feld aus dem multidimensionalen Eingabe-Layer an, oder machen Sie eine Wertangabe.
  • Endfeld oder -wert: Das Feld bzw. der Dimensionswert für das Ende des Zeitbereichs. Geben Sie ein Feld aus dem multidimensionalen Eingabe-Layer an, oder machen Sie eine Wertangabe.
  • Relativer Wert oder Tage vorher: Gibt eine nicht negative Zahl an, die zum Feld oder Wert Dimension addiert wird, um den Anfang eines Dimensionswertebereichs festzulegen.
  • Relativer Wert oder Tage danach: Gibt eine nicht negative Zahl an, die zum Feld oder Wert Dimension addiert wird, um das Ende eines Dimensionswertebereichs festzulegen.
• Statistiktyp gibt den Typ der zu berechnenden Statistik an. Dieser Parameter ist verfügbar, wenn die Option Als multidimensional verarbeiten aktiviert ist. Die folgenden Optionen sind möglich:
  • Minimum: Sucht den Minimalwert innerhalb des angegebenen Bereichs.
  • Maximum: Sucht den Maximalwert innerhalb des angegebenen Bereichs.
  • Medianwert: Sucht den Medianwert innerhalb des angegebenen Bereichs.
  • Mittelwert: Berechnet den Mittelwert für den angegebenen Bereich.
  • Summe: Berechnet die Summe der Variablen innerhalb des angegebenen Bereichs.
  • Mehrheit: Sucht den Wert mit der größten Häufigkeit.
  • Minderheit: Sucht den Wert mit der geringsten Häufigkeit.
  • Standardabweichung: Berechnet die Standardabweichung.
  • Perzentil: Berechnet ein definiertes Perzentil innerhalb des angegebenen Bereichs.
• Perzentilwert gibt das für die Stichprobennahme zu verwendende Perzentil an. Dieser Parameter ist verfügbar, wenn die Option Als multidimensional verarbeiten aktiviert ist und der Wert Perzentil für die Option Statistiktyp ausgewählt wurde.

  Dieser Wert kann im Bereich von 0 bis 100 liegen. Der Standardwert ist 90.

• Feld oder Wert für Pufferabstand gibt den Abstand um die Positionsdaten-Features für die Stichprobennahme bei multidimensionalen Bilddaten-Layern an. Dieser Parameter ist verfügbar, wenn die Option Als multidimensional verarbeiten aktiviert ist.

Ergebnis-Layer

Die Gruppe Ergebnis-Layer enthält die folgenden Parameter:

• Ausgabe-Name gibt den Namen des Layers an, der erstellt und der Karte hinzugefügt wird. Der Name muss eindeutig sein. Wenn in der Organisation bereits ein Layer mit dem gleichen Namen vorhanden ist, tritt ein Fehler auf, und Sie werden aufgefordert, einen anderen Namen zu verwenden.
• Ausgabetyp gibt den Typ des erstellten Layers an. Die Ausgabe kann ein Tabellen- oder Feature-Layer sein.
• Ausgabe-Layout gibt an, ob die Stichprobenwerte in Zeilen oder Spalten in der Ausgabetabelle angezeigt werden. Dieser Parameter ist nur verfügbar, wenn für den Parameter Bilddaten-Layer ein multidimensionales Raster angegeben wurde, worin eine Variable und eine Dimension enthalten sind und jedes Segment ein Einzelband-Raster ist.
• In Ordner speichern gibt den Namen eines Ordners in Eigene Inhalte an, in dem das Ergebnis gespeichert wird.

Umgebungen

Umgebungseinstellungen für die Analyse sind zusätzliche Parameter, mit denen die Ergebnisse eines Werkzeugs beeinflusst werden können. Sie können über die Parametergruppe Umgebungseinstellungen auf die Umgebungseinstellungen des Werkzeugs für die Analyse zugreifen.

Dieses Werkzeug berücksichtigt die folgenden Analyseumgebungen:

• Ausgabe-Koordinatensystem
• Verarbeitungsausdehnung

  Hinweis:

  Die standardmäßige Verarbeitungsausdehnung in Map Viewer ist Volle Ausdehnung. Diese Standardeinstellung unterscheidet sich von Map Viewer Classic, wo Aktuelle Kartenausdehnung verwenden standardmäßig aktiviert ist.

• Maske

Credits

Dieses Werkzeug verbraucht Credits.

Verwenden Sie Credit-Anzahl schätzen, um die Anzahl der Credits zu berechnen, die zum Ausführen des Werkzeugs erforderlich sind. Weitere Informationen finden Sie unter Informationen zu Credits für räumliche Analysen.

Ausgaben

Das Werkzeug umfasst die folgenden Ausgaben:

• Ein Feature-Layer mit den Pixelwerten aus den Quell-Bilddaten-Layern für jede Eingabeposition in der Attributtabelle. Ein Feature-Layer wird erstellt, wenn der Parameter Ausgabetyp auf Features festgelegt ist. Der Feature-Layer enthält die folgenden Felder:
  • X: Gibt die horizontale Koordinate des Eingabepunkts an.
  • Y: Gibt die vertikale Koordinate des Eingabepunkts an.
  • Felder, die Werte für jedes Raster-Band oder Quell-Raster enthalten (der Name des Rasterbands wird in den Feldnamen aufgenommen).

    Hinweis:

    Bei einem multidimensionalen Eingabe-Layer enthält die Ausgabe ein Feld für jedes der angegebenen Zeitintervalle.

• Ein Tabellen-Layer mit den Pixelwerten aus den Quell-Bilddaten-Layern für jede Eingabeposition in der Attributtabelle. Ein Tabellen-Layer wird erstellt, wenn der Parameter Ausgabetyp auf Tabelle festgelegt ist. Der Tabellen-Layer enthält die folgenden Spalten:
  • X: Gibt die horizontale Koordinate des Eingabepunkts an.
  • Y: Gibt die vertikale Koordinate des Eingabepunkts an.
  • Spalten, die Werte für jedes Raster-Band oder Quell-Raster enthalten (der Name des Rasterbands wird in den Spaltennamen aufgenommen).

Anforderungen für die Verwendung

Für dieses Werkzeug werden der folgende Benutzertyp und die folgenden Konfigurationen benötigt:

• Benutzertyp Professional oder Professional Plus
• Publisher-, Vermittler- oder Administratorrolle oder eine entsprechende benutzerdefinierte Rolle mit der Berechtigung "Bilddatenanalyse"

Ressourcen

Weitere Informationen finden Sie in den folgenden Quellen:

• Stichprobe in ArcGIS REST API
• Stichprobe in ArcGIS API for Python
• Stichprobe in ArcGIS Pro