Próbka

Próbka To narzędzie tworzy tabelę lub klasę obiektów punktowych, która pokazuje wartości komórek z rastra lub zestawu rastrów dla zdefiniowanych lokalizacji. Lokalizacje są zdefiniowane przez komórki rastra, obiekty poligonowe, obiekty poliliniowe lub zbiór punktów.

Notatka:

Ta funkcja jest aktualnie obsługiwana tylko w aplikacji Map Viewer Classic. Funkcja będzie dostępna w przyszłej wersji aplikacji Map Viewer.

Jeśli to narzędzie nie jest wyświetlane w przeglądarce map Map Viewer Classic, skontaktuj się z administratorem instytucji. Możesz nie mieć uprawnień do analizowania obrazów dostępnych z licencją ArcGIS Image for ArcGIS Online.

Diagram procedury wykonywania zadań

Procedura wykonywania zadań w narzędziu Próbka

Przykłady

Poniżej przedstawiono następujące przykładowe zastosowania tego narzędzia:

  • Wyodrębnienie atrybutów dla lokalizacji przekaźnika z wielu rastrów, takich jak użytkowanie gruntów, typ gleby, dane wysokościowe i odległość od drogi.
  • Wyodrębnienie dla danego zestawu punktów temperatury gleby na różnych głębokościach.
  • Sumowanie lokalizacji zwierząt lub zasięgu ich występowania dla danego czasu, kiedy zaobserwowano dany gatunek zwierząt, na podstawie zbieranych przez 30 lat miesięcznych danych o temperaturze powierzchni morza.

Uwagi dotyczące korzystania

Wartości komórek zostaną wyodrębnione ze wszystkich rastrów wejściowych w każdej lokalizacji. Zostanie utworzona tabela lub klasa obiektów punktowych z polami zawierającymi wartości pikseli dla każdego rastra wejściowego. Dodatkowe atrybuty z tabeli rastrów wejściowych nie zostaną uwzględnione w tabeli wynikowej.

Jako rastry wejściowe można zdefiniować dowolną kombinację rastrów, takich jak rastry jednopasmowe, wielopasmowe, wielowymiarowe czy wieloczynnikowe. Struktura tabeli wynikowej zmienia się, gdy rastry wejściowe są wielowymiarowe. Jeśli jako jeden z rastrów wejściowych zostanie podany raster wielopasmowy, zostaną użyte wszystkie pasma w tych danych wejściowych. Aby przetworzyć tylko niektóre pasma z wejściowego rastra wielopasmowego, najpierw utwórz zestaw danych rastrowych zawierający tylko odpowiednie pasma. Danych wynikowych użyj na liście rastrów wejściowych.

Lokalizacja wejściowa może być rastrem lub obiektem:

  • Raster — piksele zawierające poprawne wartości (nie NoData) są używane do wyodrębniania wartości pikseli ze wszystkich rastrów wejściowych, a centrum piksela jest używane na potrzeby lokalizacji punktów.
  • Punkt — wartości będą próbkowane w każdej lokalizacji punktu.
  • Polilinia lub poligon — wartości będą próbkowane w centroidzie poligonu lub polilinii. Jeśli raster wejściowy jest wielowymiarowy, wartości zostaną zagregowane na podstawie typu statystyk.

Do tabeli wynikowej zostanie dodane pole do zapisania wartości podanych w parametrze Podaj pole unikalnego identyfikatora. Domyślnie nazwa tego pola jest taka sama jak nazwa zestawu danych lokalizacji wejściowej. Na potrzeby dalszych analiz zaleca się używanie pola zawierającego wartości unikalne jako identyfikatora dla każdej lokalizacji.

Lokalizacje wyodrębniające wartości z komórek NoData w rastrze wejściowym otrzymają wartość <null> w tabeli wynikowej.

Rastry wejściowe są próbkowane w natywnym odniesieniu przestrzennym i natywnej rozdzielczości. Jeśli masz wiele rastrów wejściowych z różnymi odniesieniami przestrzennymi, lokalizacje wejściowe są odwzorowywane na odniesienia przestrzenne poszczególnych rastrów, z których są wyodrębniane wartości. Środowisko analizy jest stosowane do lokalizacji wejściowych, ale rastry wejściowe nie biorą go pod uwagę.

Odniesienie przestrzenne współrzędnych x,y w tabeli przykładowych danych wynikowych lub w klasie obiektów jest takie samo jak w przypadku wejściowego rastra lokalizacji albo obiektów punktowych, chyba że zdefiniowano je w środowisku Wynikowego układu współrzędnych. Jeśli odniesienie przestrzenne wejściowych danych dotyczących lokalizacji jest nieznane, odniesienie przestrzenne współrzędnych x,y też jest nieznane. Jeśli lokalizacją wejściową jest klasa obiektów punktowych bez indeksu przestrzennego, zostanie wyświetlone ostrzeżenie. Aby zwiększyć wydajność narzędzia w przypadku danych wejściowych złożonych z dużej liczby punktów, utwórz indeks przestrzenny.

Aby przeprowadzić analizę z obiektami wielopunktowymi, przekształć je w obiekty jednopunktowe, zanim użyjesz ich w tym narzędziu.

Parametr Podaj informacje o pozyskaniu danych dotyczących lokalizacji zostanie użyty w celu podania podzestawu wejściowego rastra wielowymiarowego do użycia przy próbkowaniu.

  • Gdy jest podana wartość początkowa i końcowa wymiaru, są przetwarzane przekroje mieszczące się w zakresie tych wartości. Domyślną wartością końcową jest maksymalna wartość wymiaru. W przypadku wymiaru czasu podaj wartość w formacie standardowym. W przypadku pozostałych wymiarów podaj wartość w tych samych jednostkach, jakie są używane w rastrze wejściowym.
  • Gdy jest podane pole początkowe i końcowe wymiaru (pole początkowe i pole końcowe pochodzą z danych dotyczących lokalizacji), wartości z tych pól służą do określenia podzestawu rastra wejściowego przy próbkowaniu wartości w tej lokalizacji.
  • Wartości takie jak wartość względna lub liczba dni przed i wartość względna lub liczba dni po mogą zostać użyte do podania podzestawu względem wartości początkowej, w którym wartość przed określa początek podzestawu, a wartość po określa koniec podzestawu. Wartości czasu są podawane w dniach, a pozostałe wartości wymiarów są podawane w tych samych jednostkach, jakie są używane w rastrze wejściowym.

Parametr Wybierz typ statystyki agreguje wartości parametru Raster wejściowy zgodnie z podzestawem w parametrze Podaj informacje o pozyskaniu danych lokalizacji.

Jeśli jest zaznaczona opcja Wartości próbkowane są wyświetlane w wierszu, wyodrębnione wartości są przechowywane w polu o takiej samej nazwie jak nazwa zmiennej. Do przechowywania nieprzestrzennych wartości wymiarów są tworzone dodatkowe pola o takiej samej nazwie jak nazwa wymiaru. Jeśli jest zaznaczona opcja Wartości próbkowane są wyświetlane w kolumnie, wyodrębnione wartości są przechowywane w polach o nazwach zgodnych z konwencją <nazwa_zmiennej>_<nazwa_wymiaru>_<wartość_wymiaru>.

Jeśli raster wielowymiarowy ma wiele pasm, dla każdego pasma jest tworzone dodatkowe pole, w którym jest przechowywana wartość wyodrębniona z tego pasma.

Jeśli parametr Podaj technikę ponownego próbkowania skonfigurowano na wartość Najbliższy, typ pola w tabeli wynikowej będzie odpowiadał typowi rastra. Gdy opcją ponownego próbkowania jest Dwuliniowe lub Sześcienne, pole będzie zawsze typu zmiennoprzecinkowego, aby zachować precyzję interpolowanych wartości.

Domyślnie dane wynikowe to Tabela. Jeśli w polu Podaj typ danych wynikowych zostanie wybrana wartość Obiekty, dane wynikowe będą klasą obiektów punktowych z próbkowanymi wartościami w jej tabeli atrybutów. Poniżej przedstawiono możliwe typy lokalizacji z opisami sposobu próbkowania wartości:

  • Raster — punkty zostaną utworzone z użyciem lokalizacji środka komórki.
  • Punkt — punkt zostanie utworzony w każdej z lokalizacji punktów.
  • Polilinia lub poligon — punkt zostanie utworzony w każdej centroidzie poligonu lub polilinii.

Odniesienie przestrzenne wynikowej klasy obiektów jest takie samo jak w przypadku wejściowego rastra lokalizacji lub obiektów, chyba że zdefiniowano je w środowisku Wynikowego układu współrzędnych.

Środowisko Czynnika przetwarzania równoległego jest obsługiwane tylko wtedy, gdy dane wejściowe to raster wielowymiarowy.

Jeśli obiekt jest podany w środowisku Maska, raster wewnętrzny jest tworzony z użyciem minimalnego rozmiaru komórki rastrów wejściowych. Podczas wydzielania wewnętrzny raster maski jest ponownie próbkowany do rozmiaru komórki poszczególnych rastrów wejściowych.

Jeśli zaznaczono opcję Użyj bieżącego zasięgu mapy, analizowane będą zmienne lub pasma warstwy widoczne w bieżącym zasięgu mapy. Jeśli ta opcja nie jest zaznaczona, analizowane będą zmienne lub pasma pełnej warstwy, nawet jeśli znajdują się poza bieżącym zasięgiem mapy.

Parametry tego narzędzia zostały wymienione w następującej tabeli:

ParametrObjaśnienie
Wybierz warstwy zobrazowań do próbkowania

Jeden obraz lub lista obrazów, których wartości będą próbkowane na podstawie wejściowych danych dotyczących lokalizacji.

Aby można było próbkować wszystkie przekroje wielowymiarowej warstwy zobrazowań, musi ona być jedynym rastrem wejściowym.

Wybierz warstwę lokalizacji

Pozycje identyfikujące dane, które chcesz próbkować.

Wejściowe dane dotyczące lokalizacji mogą być rastrem albo klasą obiektów punktowych, poliliniowych lub poligonowych.

Wypełnij pole unikalnego identyfikatora (opcjonalnie)

Pole zawierające inną wartość w przypadku każdej lokalizacji lub obiektu w wejściowym rastrze lokalizacji albo klasie obiektów.

Podaj informacje o pozyskaniu danych dotyczących lokalizacji (opcjonalnie)

Wpisz czas, głębokość lub inne dane o pozyskaniu powiązane z obiektami albo komórkami lokalizacji.

W przypadku każdego wymiaru istnieją trzy opcje definiowania informacji o pozyskaniu powiązanych z obiektami albo komórkami lokalizacji:

  • Jedno pole lub jedna wartość — gdy ta opcja jest wybrana, należy podać następujące informacje:
    • Pole lub wartość wymiaru — wybierz pole wartości wymiaru z danych dotyczących lokalizacji lub wpisz odpowiednią wartość wymiaru.
  • Jedno pole lub jedna wartość z wartościami względnymi — jeśli ta opcja jest wybrana, należy podać poniższe informacje razem, aby zdefiniować zakres, w którym statystyki będą obliczane dla zmiennych:
    • Pole lub wartość wymiaru — wybierz pole wartości wymiaru z danych dotyczących lokalizacji.
    • Wartość względna przed — podaj nieujemną liczbę, która zostanie odjęta od Pola lub wartości wymiaru w celu zdefiniowania wartości początkowej zakresu wartości wymiaru. Ta wartość oznacza liczbę dni, jeśli wymiarem jest czas.
    • Wartość względna po — podaj nieujemną liczbę, która zostanie dodana do Pola lub wartości wymiaru w celu zdefiniowania wartości końcowej zakresu wartości wymiaru. Ta wartość oznacza liczbę dni, jeśli wymiarem jest czas.
  • Początkowe i końcowe pola lub wartości — jeśli ta opcja jest wybrana, należy podać poniższe informacje razem, aby zdefiniować zakres, w którym statystyki będą obliczane dla zmiennych:
    • Pole lub wartości początkowe — wybierz pole wartości wymiaru z danych dotyczących lokalizacji lub wpisz odpowiednią wartość wymiaru, aby zdefiniować wartość początkową zakresu wartości wymiaru.
    • Pole lub wartości końcowe — wybierz pole wartości wymiaru z danych dotyczących lokalizacji lub wpisz odpowiednią wartość wymiaru, aby zdefiniować wartość końcową zakresu wartości wymiaru.

Ten parametr jest dostępny tylko wtedy, gdy parametrem Wybierz warstwy zobrazowań do próbkowania jest raster wielowymiarowy.

Podaj pole lub wartość odległości buforowania (opcjonalnie)

Zdefiniowana odległość wokół obiektów danych dotyczących lokalizacji. Odległość buforowania jest zdefiniowana w jednostkach liniowych odniesienia przestrzennego obiektu lokalizacji. Jeśli obiekt używa odniesienia geograficznego, jednostką będą stopnie.

Statystyki będą obliczane w tym obszarze buforowym.

Ten parametr jest dostępny tylko wtedy, gdy w polu Wybierz warstwy zobrazowań do próbkowania jest wybrany raster wielowymiarowy.

Wybierz typ statystyk (opcjonalnie)

Typ statystyki do obliczenia.

  • Minimum — znajduje wartość minimalną w podanym zakresie.
  • Maksimum — znajduje wartość maksymalną w podanym zakresie.
  • Mediana — znajduje wartość mediany w podanym zakresie.
  • Średnia — oblicza wartość średnią w podanym zakresie.
  • Suma — oblicza sumę zmiennych w podanym zakresie.
  • Większość — znajduje wartość, która występuje najczęściej.
  • Mniejszość — znajduje wartość, która występuje najrzadziej.
  • Odchylenie standardowe — oblicza odchylenie standardowe.
  • Percentyl — oblicza zdefiniowany percentyl w podanym zakresie.

Ten parametr jest dostępny tylko wtedy, gdy parametrem Wybierz warstwy zobrazowań do próbkowania jest raster wielowymiarowy, a parametrami Wybierz warstwę lokalizacji są polilinie lub poligony, albo podano wartość w parametrze Podaj pole lub wartość odległości buforowania (opcjonalnie).

Wartość percentylowa (opcjonalnie)

Ta wartość należy do zakresu od 0 do 100. Wartość domyślna to 90.

Ten parametr jest dostępny tylko wtedy, gdy parametr Wybierz typ statystyk skonfigurowano na wartość Percentyl.

Podaj technikę ponownego próbkowania (opcjonalnie)

Algorytm ponownego próbkowania używany podczas próbkowania rastra.

  • Najbliższe — najbliższy sąsiad. W celu przypisania wartości do komórki danych wynikowych podczas ponownego próbkowania używana jest wartość najbliższej komórki. Jest to opcja domyślna.
  • Dwuliniowe — interpolacja dwuliniowa. Nowa wartość komórki jest wyznaczana na podstawie ważonej średniej odległości środków czterech najbliższych komórek wejściowych.
  • Sześcienne — splatanie sześcienne. Nowa wartość komórki jest wyznaczana na podstawie dopasowania wygładzonej krzywej przechodzącej przez środki 16 najbliższych komórek wejściowych.
Podaj kompozycję wynikową (opcjonalnie)

Decyduje, czy próbkowane wartości pojawiają się w wierszach czy w kolumnach tabeli wynikowej.

  • Próbkowane wartości pojawiają się w wierszu — próbkowane wartości pojawiają się w oddzielnych wierszach tabeli wynikowej. Jest to opcja domyślna.
  • Próbkowane wartości pojawiają się w kolumnie — próbkowane wartości pojawiają się w oddzielnych kolumnach tabeli wynikowej.

Ten parametr jest dostępny tylko wtedy, gdy parametrem Wybierz warstwy zobrazowań do próbkowania jest raster wielowymiarowy zawierający jedną zmienną i jeden wymiar, a każdy jego przekrój to raster jednopasmowy.

Podaj typ wynikowy (opcjonalnie)

Decyduje, czy należy wygenerować klasę obiektów punktowych z próbkowanymi wartościami w tabeli czy tylko tabelę z próbkowanymi wartościami.

  • Tabela — wygeneruj tabelę z próbkowanymi wartościami. Jest to opcja domyślna.
  • Obiekty — wygeneruj klasę obiektów punktowych z próbkowanymi wartościami w tabeli. Jeśli parametrami Wybierz warstwę lokalizacji są polilinie lub poligony, każdy punkt w danych wynikowych to centroid każdej geometrii wejściowych obiektów lokalizacji.
Nazwa warstwy wynikowej

Nazwa warstwy, która zostanie utworzona w obszarze Moje zasoby i dodana do mapy. Nazwa domyślna jest tworzona w oparciu o nazwę narzędzia i nazwę warstwy wejściowej. Jeśli warstwa już istnieje, wyświetlony zostanie komunikat z monitem o podanie innej nazwy.

Za pomocą listy rozwijanej Zapisz wynik w można podać nazwę folderu w obszarze Moje zasoby, gdzie zostanie zapisany wynik.

Wskazówka:

Kliknij opcję Pokaż kredyty przed uruchomieniem analizy w celu sprawdzenia, ile kredytów zostanie wykorzystanych.

Środowiska

Ustawienia środowiska analiz to dodatkowe parametry wpływające na wyniki działania narzędzia. Dostęp do ustawień środowiska analiz tego narzędzia można uzyskać, klikając ikonę koła zębatego Środowiska analizy u góry panelu narzędzia.

To narzędzie honoruje następujące środowiska analiz:

  • Zasięg – decyduje o obszarze, który ma być używany podczas analizy.
  • Maska – określa warstwę maskowania, dzięki której podczas analizy będą używane tylko komórki należące do obszaru maski.
  • Interwał ponownego wykorzystywania wątków przetwarzania – definiuje liczbę sekcji obrazu, które należy przetworzyć przed ponownym uruchomienie wątków przetwarzania.
  • Współczynnik przetwarzania równoległego – steruje instancjami procesorów lub procesorów graficznych biorących udział w przetwarzaniu rastra.
  • Liczba ponownych prób w razie niepowodzeń – definiuje liczbę ponownych prób uruchomienia wątków przetwarzania w razie przypadkowych niepowodzeń przetwarzania zadania.

Podobne narzędzia i funkcje rastrowe

Użyj narzędzia Próbka, aby utworzyć tabelę lub klasę obiektu punktowego z wartościami danych w zdefiniowanych lokalizacjach wyodrębnionych z rastra lub zestawu rastrów. Do rozwiązywania podobnych problemów mogą być przydatne inne narzędzia.

Narzędzia analizy i funkcje rastrowe przeglądarki map Map Viewer Classic

Narzędzie Podsumuj raster w ramach i funkcja rastrowa Statystyka strefowa służą do podsumowywania rastrów w ramach granic i tworzenia danych wynikowych usługi obrazowej.

Narzędzia analizy i funkcje rastrowe aplikacji ArcGIS Pro

Narzędzia geoprzetwarzania Próbka, Statystyka strefowa i Statystyka strefowa jako tabela są dostępne w skrzynkach narzędziowych rozszerzeń Image Analyst i Spatial Analyst.

Narzędzia Podsumuj raster w ramach i Statystyka strefowa jako tabela są dostępne w skrzynce narzędziowej rozszerzenia Analiza rastrowa.

Narzędzie Statystyka strefowa jest także dostępne jako funkcja rastrowa.

Zasoby dla programistów ArcGIS Enterprise

Jeśli pracujesz z interfejsem ArcGIS REST API, użyj zadania Sample, Summarize Raster Within lub Zonal Statistics As Table.

Jeśli pracujesz z interfejsem ArcGIS API for Python, skorzystaj z sample witryny ArcGIS for Python API, summarize_raster_within witryny ArcGIS for Python API lub zonal_statistics_as_table witryny ArcGIS for Python API z modułu arcgis.raster.analytics albo skorzystaj z zonal_statistics witryny ArcGIS for Python API z modułu arcgis.raster.functions.gbl.