Skip To Content

샘플

샘플 이 도구는 정의된 위치에 대해 한 래스터 또는 래스터 집합의 셀 값을 보여주는 테이블 또는 포인트 피처 클래스를 생성합니다. 위치는 래스터 셀, 폴리곤 피처, 폴리라인 피처 또는 포인트 집합으로 정의됩니다.

비고:

이 도구를 실행하려면 포털이 래스터 분석에 대해 구성되어야 합니다.

Map Viewer에 이 도구가 보이지 않으면 포털 관리자에게 문의하세요. 포털이 래스터 분석에 대해 구성되어 있지 않거나 이 도구를 실행하는 데 필요한 권한이 없을 수도 있습니다.

워크플로 다이어그램

샘플 워크플로

예시

이 도구의 몇 가지 응용 예시는 다음과 같습니다.

  • 토지 사용, 토질 유형, 고도 및 도로까지의 거리 등 여러 래스터에서 기지국 위치에 대한 속성을 추출합니다.
  • 주어진 포인트 집합에 대해 여러 깊이에서 토양 온도를 추출합니다.
  • 30년 동안의 월간 해수면 온도 데이터로부터, 주어진 시간에 대해 동물종이 언제 관찰되었는지 동물의 위치나 행동권 내에서 요약합니다.

사용 참고 사항

각 위치의 모든 입력 래스터에서 셀 값이 추출됩니다. 테이블 또는 포인트 피처 클래스는 각 입력 래스터의 픽셀값이 포함된 필드로 생성됩니다. 입력 래스터 테이블의 추가 속성은 결과 테이블에 포함되지 않습니다.

단일밴드, 다중밴드, 다차원 또는 다변량과 같은 래스터의 조합을 입력 래스터로 지정할 수 있습니다. 입력 래스터가 다차원이면 결과 테이블의 구조가 변경됩니다. 다중밴드 래스터가 입력 래스터 중 하나로 지정되면 해당 입력의 모든 밴드가 사용됩니다. 따라서 입력 다중밴드 래스터의 일부 밴드를 선택해 처리하려면 먼저 해당 특정 밴드로 구성된 래스터 데이터셋을 생성해야 합니다. 그 결과를 입력 래스터 목록에 사용합니다.

입력 위치는 래스터 또는 피처일 수 있습니다.

  • 래스터 - 유효한 값(NoData가 아님)이 포함된 픽셀을 사용하여 모든 입력 래스터에서 픽셀값을 추출하며, 픽셀의 중심이 포인트 위치에 사용됩니다.
  • 포인트 - 각 포인트 위치에 값이 샘플링됩니다.
  • 폴리라인 또는 폴리곤 - 폴리라인 또는 폴리곤 중심에 값이 샘플링됩니다. 입력 래스터가 다차원인 경우, 값은 통계 유형에 따라 집계됩니다.

고유 ID 필드 지정 매개변수에 지정된 값을 저장하기 위해 결과 테이블에 필드가 추가됩니다. 기본 설정에 따라, 필드 이름은 입력 위치 데이터셋 이름과 같습니다. 추가 분석을 위해, 고유 값이 포함된 필드를 각 위치의 식별자로 사용하는 것을 권장합니다.

입력 래스터의 NoData 셀에서 값을 추출하는 위치의 경우 결과 테이블에 <null> 값이 제공됩니다.

입력 래스터는 네이티브 공간 기준 체계와 해상도로 샘플링됩니다. 공간 기준 체계 서로 다른 여러 입력 래스터가 있는 경우 입력 위치는 값이 추출되는 각 개별 래스터의 공간 기준 체계에 투영됩니다. 분석 환경은 입력 위치에만 적용되며 입력 래스터에는 적용되지 않습니다.

결과 샘플 테이블 또는 피처 클래스 내 x,y 좌표의 공간 기준 체계는 결과 좌표계 환경에 지정되어 있지 않는 한 입력 위치 래스터 또는 포인트 피처와 동일합니다. 입력 위치 데이터의 공간 기준 체계를 알 수 없다면 x,y 좌표의 공간 기준 체계도 알 수 없습니다. 입력 위치가 공간 색인이 없는 포인트 피처 클래스인 경우, 경고가 발행됩니다. 다수의 포인트가 있는 입력에 대해 도구 성능을 개선하려면 공간 색인을 생성하세요.

멀티포인트 피처 분석을 수행하려면 이러한 피처를 이 도구에 사용하기 전에 먼저 단일 포인트 피처로 변환해야 합니다.

위치 데이터 취득 정보 지정 매개변수는 샘플링에 사용할 입력 다차원 래스터의 부분집합을 지정하는 데 사용됩니다.

  • 디멘전, 시작 값 및 종료 값이 지정되면 시작 및 종료 값 내의 슬라이스가 처리됩니다. 기본 종료 값은 최대 디멘전 값입니다. 시간 디멘전의 경우, 표준 형식으로 값을 지정하세요. 다른 디멘전의 경우, 입력 래스터와 같은 단위로 값을 지정하세요.
  • 디멘전, 시작 필드 및 종료 필드가 지정되면(시작 필드와 종료 필드는 위치 데이터에서 가져옴) 이러한 필드의 값은 해당 위치에서 값을 샘플링하는 동안 입력 래스터의 부분집합을 지정하는 데 사용됩니다.
  • 상대 값 또는 이전 일, 그리고 상대 값 또는 이후 일 값은 시작 값에 상대적인 부분집합을 지정하는 데 사용될 수 있으며, 이전 값은 부분집합의 시작을 지정하고 이후 값은 부분집합의 끝을 지정합니다. 시간 값은 일 단위로 지정되며 다른 디멘전 값은 입력 래스터와 같은 단위로 지정됩니다.

통계 유형 선택 매개변수는 위치 데이터의 취득 정보 지정 매개변수의 부분집합에 지정된 대로 입력 래스터 매개변수의 값을 집계합니다.

샘플링된 값이 행에 나타남이 선택된 경우, 추출된 값은 변수와 같은 이름으로 필드에 저장됩니다. 디멘전과 같은 이름의 비공간 디멘전 값을 저장하기 위해 추가 필드가 생성됩니다. 샘플링된 값이 열에 나타남이 선택된 경우, 추출된 값은 <variable_name>_<dimension_name>_<dimension_value> 규칙을 따르는 이름으로 필드에 저장됩니다.

다차원 래스터에 여러 밴드가 있는 경우, 각 밴드에 추가 필드가 생성되어 해당 밴드에서 추출된 값을 저장합니다.

리샘플링 기법 지정 매개변수가 최근린으로 설정된 경우, 결과 테이블의 필드 유형이 래스터 유형의 필드 유형과 일치합니다. 리샘플링 옵션이 이중 선형 또는 3차인 경우, 필드 유형은 보간된 값의 정밀도를 유지하기 위해 항상 부동 소수점입니다.

기본 설정에 따라 결과는 테이블입니다. 결과 유형 지정피처로 선택된 경우, 결과는 샘플링된 값이 속성 테이블에 포함되어 있는 포인트 피처 클래스입니다. 가능한 위치 유형과 값이 샘플링되는 방법에 대한 설명은 다음과 같습니다.

  • 래스터 - 셀 중심의 위치를 사용하여 포인트가 생성됩니다.
  • 포인트 - 각 포인트 위치에 포인트가 생성됩니다.
  • 폴리라인 또는 폴리곤 - 각 폴리곤 또는 폴리라인 중심에 포인트가 생성됩니다.

결과 피처 클래스의 공간 기준 체계는 결과 좌표계 환경에 지정되어 있지 않는 한 입력 위치 래스터 또는 피처의 공간 기준 체계와 동일합니다.

병렬 처리 계수 환경은 입력이 다차원 래스터인 경우에만 지원됩니다.

마스크 환경에 피처가 지정된 경우, 입력 래스터 중 가장 작은 셀 크기를 사용하여 내부 래스터가 생성됩니다. 추출 중에 내부 마스크 래스터는 각 입력 래스터의 셀 크기로 다시 리샘플링됩니다.

현재 맵 범위 사용을 선택하면 현재 맵 범위 내에 보이는 레이어의 변수 또는 밴드가 분석됩니다. 선택하지 않으면 현재 맵 범위 외부에 있는 변수를 포함하여 전체 레이어의 변수 또는 밴드가 분석됩니다.

이 도구에 대한 매개변수는 다음 테이블에 나와 있습니다.

매개변수설명
샘플링할 영상 레이어 선택

입력 위치 데이터를 기반으로 값이 샘플링되는 단일 이미지 또는 이미지 목록입니다.

다차원 영상 레이어의 모든 슬라이스를 샘플링하려면 다차원 영상 레이어가 유일한 입력 래스터여야 합니다.

위치 레이어 선택

샘플링할 위치를 식별하는 데이터입니다.

래스터, 포인트, 폴리라인, 폴리곤 피처 클래스를 입력 위치 데이터로 사용할 수 있습니다.

고유 ID 필드 지정(선택 사항)

입력 위치 래스터 또는 피처 클래스의 모든 위치나 피처에 대해 서로 다른 값이 포함되는 필드입니다.

위치 데이터 취득 정보 지정(선택 사항)

위치 셀 또는 피처와 연관된 시간, 깊이 또는 기타 취득 데이터를 지정합니다.

각 디멘전에 대해, 다음과 같은 세 가지 옵션을 사용하여 위치 셀 또는 피처와 연관된 취득 정보를 지정할 수 있습니다.

  • 단일 필드 또는 값 - 이 옵션을 선택하면 다음 정보를 지정해야 합니다.
    • 디멘전 필드 또는 값 - 위치 데이터에서 디멘전 값의 필드를 선택하거나 특정 디멘전 값을 입력합니다.
  • 상대 값이 포함된 단일 필드 또는 값 - 이 옵션을 선택하면 변수의 통계 계산 범위를 정의할 때 다음의 정보를 함께 지정해야 합니다.
    • 디멘전 필드 또는 값 - 위치 데이터에서 디멘전 값의 필드를 선택합니다.
    • 이전 상대 값 - 디멘전 필드 또는 값에서 뺄 음수가 아닌 숫자를 지정하여 디멘전 값 범위의 시작을 정의합니다. 이 값은 디멘전이 시간인 경우 일수를 나타냅니다.
    • 이후 상대 값 - 디멘전 필드 또는 값에 더할 음수가 아닌 숫자를 지정하여 디멘전 값 범위의 끝을 정의합니다. 이 값은 디멘전이 시간인 경우 일수를 나타냅니다.
  • 시작 및 종료 필드 또는 값 - 이 옵션을 선택하면 변수의 통계 계산 범위를 정의할 때 아래의 정보를 함께 지정해야 합니다.
    • 시작 필드 또는 값 - 위치 데이터에서 디멘전 값의 필드를 선택하거나 특정 디멘전 값을 입력하여 디멘전 값 범위의 시작을 정의합니다.
    • 종료 필드 또는 값 - 위치 데이터에서 디멘전 값의 필드를 선택하거나 특정 디멘전 값을 입력하여 디멘전 값 범위의 종료를 정의합니다.

이 매개변수는 샘플링할 영상 레이어 선택 매개변수가 다차원 래스터인 경우에만 사용할 수 있습니다.

버퍼 거리 필드 또는 값 지정(선택 사항)

위치 데이터 피처 주변의 지정 거리입니다. 버퍼 거리는 위치 피처 공간 기준 체계의 선형 단위로 지정됩니다. 피처가 지리 기준 체계를 사용할 경우 단위는 도입니다.

통계는 이 버퍼 영역 내에서 계산됩니다.

이 매개변수는 샘플링할 영상 레이어 선택이 다차원 래스터인 경우에만 사용할 수 있습니다.

통계 유형 선택(선택 사항)

계산될 통계 유형입니다.

  • 최소값 - 지정된 범위 내에서 최소값을 찾습니다.
  • 최대값 - 지정된 범위 내에서 최대값을 찾습니다.
  • 중앙값 - 지정된 범위 내에서 중앙값을 찾습니다.
  • 평균 - 지정된 범위의 평균을 계산합니다.
  • 합계 - 지정된 범위 내에 있는 변수의 합계를 계산합니다.
  • 다수 - 가장 많이 발생한 값을 찾습니다.
  • 소수 - 가장 적게 발생한 값을 찾습니다.
  • 표준편차 - 표준편차를 계산합니다.
  • 백분위수 - 지정된 범위 내에서 정의된 백분위수를 계산합니다.

이 매개변수는 샘플링할 영상 레이어 선택 매개변수가 다차원 래스터이며 위치 레이어 선택 매개변수가 폴리라인 또는 폴리곤이거나 버퍼 거리 필드 또는 값 지정(선택 사항)이 지정된 경우에만 사용할 수 있습니다.

백분위수 값(선택 사항)

이 값의 범위는 0~100일 수 있습니다. 기본값은 90입니다.

이 매개변수는 통계 유형 선택 매개변수가 백분위수로 설정된 경우에만 사용할 수 있습니다.

리샘플링 기법 지정(선택 사항)

래스터를 샘플링할 때 사용되는 리샘플링 알고리즘입니다.

  • 최근린 - 최근린으로, 가장 가까운 셀의 값을 사용하여 리샘플링할 때 결과 셀에 값을 할당합니다. 이 옵션이 기본 설정입니다.
  • 이중 보간 - 이중 선형 보간(Interpolation)으로, 가장 가까운 4개의 입력 셀 중심에서 가중치 거리 평균을 기준으로 새로운 셀 값을 결정합니다.
  • 3차 - 3차 회선 보간법으로, 가장 가까운 16개의 입력 셀 중심에서 부드러운 곡선 맞춤을 기준으로 새로운 셀 값을 결정합니다.
결과 레이아웃 지정(선택 사항)

샘플링된 값이 결과 테이블의 행에 표시되는지 또는 열에 표시되는지를 지정합니다.

  • 샘플링된 값이 행에 표시됨 - 샘플링된 값이 결과 테이블의 개별 행에 나타납니다. 이 옵션이 기본 설정입니다.
  • 샘플링된 값이 열에 표시됨 - 샘플링된 값이 결과 테이블의 개별 열에 나타납니다.

이 매개변수는 샘플링할 영상 레이어 선택 매개변수가 다차원 래스터이며 하나의 변수와 하나의 디멘전이 포함되어 있고 각 슬라이스가 단일밴드 래스터인 경우에만 사용할 수 있습니다.

결과 유형 지정(선택 사항)

샘플링된 값이 테이블에 포함되어 있는 포인트 피처 클래스를 생성할지 또는 샘플링된 값이 포함되어 있는 테이블만 생성할지를 지정합니다.

  • 테이블 - 샘플링된 값이 포함되어 있는 테이블을 생성합니다. 이 옵션이 기본 설정입니다.
  • 피처 - 샘플링된 값이 테이블에 포함되어 있는 포인트 피처 클래스를 생성합니다. 위치 레이어 선택 매개변수가 폴리라인 또는 폴리곤인 경우 결과의 각 포인트는 입력 위치 피처의 각 지오메트리의 중심입니다.
결과 레이어 이름

내 콘텐츠에 생성되고 맵에 추가되는 레이어의 이름입니다. 기본 이름은 도구 이름과 입력 레이어 이름을 기반으로 합니다. 레이어가 이미 있는 경우 다른 이름을 입력하라는 메시지가 나타납니다.

결과 저장: 드롭다운 상자를 사용하여 결과가 저장될 내 콘텐츠에서 폴더 이름을 지정할 수 있습니다.

환경

분석 환경 설정은 도구의 결과에 영향을 주는 추가 매개변수입니다. 도구의 분석 환경 설정은 도구 창 상단에 있는 기어 아이콘 분석 환경을 클릭하여 접근할 수 있습니다.

이 도구는 다음과 같은 분석 환경을 적용합니다.

  • 범위 - 분석에 사용할 영역을 지정합니다.
  • 마스크 - 마스크 레이어를 지정하며, 마스크 레이어 내에 해당하는 셀만 분석에 사용됩니다.
  • 처리 작업자 간격 재구성 - 작업자 프로세스 재시작 전에 처리할 이미지 섹션 수를 정의합니다.
  • 병렬 처리 계수 - 래스터 처리 CPU 또는 GPU 인스턴스를 제어합니다.
  • 오류에 대한 재시도 횟수 - 작업 처리 시 랜덤 오류가 발생한 경우에 작업자 프로세스에서 재시도하게 되는 횟수를 정의합니다.

유사한 도구 및 래스터 함수

샘플 도구를 사용하여 한 래스터 또는 래스터 집합에서 추출한 데이터 값이 포함된 테이블 또는 포인트 피처 클래스를 정의된 위치에 생성합니다. 비슷한 문제를 해결하는 데 유용한 기타 도구를 사용할 수 있습니다.

Map Viewer 분석 도구 및 래스터 함수

다음 범위 내 래스터 요약 도구 또는 구역 통계 래스터 함수를 사용하여 경계 내 래스터를 요약하고 이미지 서비스 결과를 생성합니다.

ArcGIS Pro 분석 도구 및 래스터 함수

샘플구역 통계테이블 형식 구역 통계 지오프로세싱 도구는 Image AnalystSpatial Analyst 도구상자에서 제공됩니다.

다음 범위 내 래스터 요약테이블 형식 구역 통계 도구는 Raster Analysis 도구 상자에서 제공됩니다.

구역 통계는 래스터 함수로도 사용할 수 있습니다.

ArcGIS Enterprise 개발자 리소스

ArcGIS REST API에서 작업하는 경우에는 Sample, Summarize Raster Within 또는 Zonal Statistics As Table 작업을 수행합니다.

ArcGIS API for Python에서 작업하는 경우 arcgis.raster.analytics 모듈에서 sample ArcGIS for Python API 웹사이트, summarize_raster_within ArcGIS for Python API 웹사이트 또는 zonal_statistics_as_table ArcGIS for Python API 웹사이트를 사용하거나 arcgis.raster.functions.gbl 모듈에서 zonal_statistics ArcGIS for Python API 웹사이트를 사용합니다.