Stichprobe (Map Viewer)

Available with Image Server

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 Werkezug "Stichprobe" enthält Konfigurationen für Eingabe-Layer, Stichprobeneinstellungen und Ergebnis-Layer.

Eingabe-Layer

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

• Bilddaten-Layer wird verwendet, um ein einzelnes Bild oder eine Liste von Bildern auszuwählen, deren Werte auf der Grundlage der Eingabepositionsdaten entnommen werden.

  Jede beliebige Kombination von Rastern, wie Einzelband-, Multiband-, multidimensionale oder multivariate Raster, 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 wird verwendet, um den Layer mit den Positionen für die Stichprobennahme auszuwählen. 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 der Einstellung für Statistiktyp aggregiert.

Stichprobeneinstellungen

Die Gruppe Stichprobeneinstellungen enthält die folgenden Parameter:

• Resampling-Methode gibt den Resampling-Algorithmus an, der während der Stichprobennahme verwendet wird. Dieser Parameter umfasst die folgenden Optionen:
  • 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.
• Eindeutiges ID-Feld 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: Gibt die Dimension des multidimensionalen Eingabe-Layers an.
  • Startfeld oder -wert: Gibt das Feld an, das für den Anfang des Zeitbereichs innerhalb des multidimensionalen Eingabe-Layers verwendet wird. Alternativ können Sie einen bestimmten Dimensionswert eingeben.
  • Endfeld oder -wert: Gibt das Feld an, das für das Ende des Zeitbereichs innerhalb des multidimensionalen Eingabe-Layers verwendet wird. Alternativ können Sie einen bestimmten Dimensionswert eingeben.
  • 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. Statistiktyp enthält die folgenden Optionen:
  • 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 die Einstellung 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 bestimmt den Namen des Layers, 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 bestimmt den zu erstellenden Layer-Typ. 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, 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
• Faktor für parallele Verarbeitung

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).

Lizenzanforderungen

Für dieses Werkzeug werden folgende Lizenzen und Konfigurationen benötigt:

• Benutzertyp Creator oder GIS Professional
• Publisher- oder Administratorrolle oder eine entsprechende benutzerdefinierte Rolle
• ArcGIS Image Server mit Konfiguration für Raster-Analysen

Ressourcen

Weitere Informationen finden Sie in den folgenden Quellen:

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