거리 누적 도구는 각 셀에서 입력 시작지점까지의 누적 거리를 계산합니다.
비고:
이 도구를 실행하려면 포털이 래스터 분석에 대해 구성되어야 합니다.
Map Viewer에 이 도구가 보이지 않으면 포털 관리자에게 문의하세요. 포털이 래스터 분석에 대해 구성되어 있지 않거나 이 도구를 실행하는 데 필요한 권한이 없을 수도 있습니다.
워크플로 다이어그램
예시
적용 예시에는 다음 질문에 대한 대답이 포함됩니다.
- 가장 가까운 마을까지의 거리는 얼마입니까?
- 가장 가까운 도로까지의 비용 거리는 얼마입니까?
- 가장 가까운 수원까지의 거리 주변 경계는 얼마입니까?
사용 참고 사항
입력 시작지점 데이터가 래스터인 경우 시작지점 셀의 집합은 유효한 값을 가진 시작지점 래스터의 모든 셀로 구성됩니다. NoData 값을 가진 셀은 이 시작지점 집합에 포함되지 않습니다. 0 값은 유효한 시작지점으로 간주됩니다.
입력 시작지점 데이터가 피처인 경우 분석을 수행하기 전에 시작지점 위치가 내부적으로 래스터로 변환됩니다. 래스터의 해상도는 셀 크기 환경으로 제어할 수 있습니다. 기본 설정에 따라 도구에 다른 래스터가 지정되지 않은 경우 해상도는 입력 공간 참조 내 입력 피처 범위의 너비나 높이 중 더 짧은 것을 250으로 나눈 값으로 결정됩니다.
이러한 상황을 피하려면 중간 단계로 피처를 래스터로 변환 도구를 사용하여 입력 피처를 직접 래스터화하고 필드 매개변수를 설정할 수 있습니다. 그다음 결과 출력을 사용하려는 특정 거리 도구에 입력으로 사용합니다.
비용 래스터, 표면 래스터, 수직 래스터, 수평 래스터 등의 입력에 NoData가 있는 경우 모든 입력의 해당 위치에 있는 셀은 계산에서 무시됩니다. 이러한 래스터에 대한 NoData는 계산 전반에 유지되므로 모든 결과에서 NoData입니다.
시작지점이 해당 입력 래스터에서 NoData에 해당하는 경우 분석에서 무시되므로 해당 시작지점으로부터의 거리가 계산되지 않습니다.
알고리즘이 곱셈 프로세스이므로 비용 래스터에는 0 값이 포함될 수 없습니다. 비용 래스터에 0 값이 포함되어 있고 해당 값이 최저 비용 영역을 나타내는 경우 이 도구를 실행하기 전에 해당 셀을 작은 양수 값(예시: 0.01)으로 변경합니다.
범위 환경 설정이 지정되지 않은 경우 처리 범위는 다음과 같은 방법으로 결정됩니다.
시작지점과 경계 데이터만 지정된 경우 양쪽의 두 셀 너비만큼 확장된 입력 합집합이 처리 범위로 사용됩니다. 결과 래스터가 두 개의 행과 열로 확장되는 이유는 결과가 래스터로 최적의 경로 및 라인으로 최적의 경로에 사용될 때 생성된 경로는 경계 주위를 이동할 수 있기 때문입니다. 이 범위를 암시적 경계로 사용하려면 환경 설정에서 범위를 설정해야 합니다.
표면 래스터, 비용 래스터, 수직 래스터, 수평 래스터 데이터셋 중 하나가 지정된 경우 처리 범위는 해당 래스터의 교차 부분입니다.
셀 크기 또는 스냅 래스터 환경 설정이 지정되지 않고 입력으로 지정된 여러 개의 래스터가 있는 경우 셀 크기 및 스냅 래스터는 비용 래스터, 표면 래스터, 수직 래스터, 수평 래스터, 원본 데이터, 경계 데이터 우선 순위에 따라 설정됩니다.
경사면 방향 도구의 결과는 입력 수평 래스터 설정에 입력으로 사용될 수 있습니다.
어떠한 시작지점 특성 매개변수도 필드를 사용하여 지정된 경우 시작지점 특성은 시작지점 데이터에 지정된 필드의 정보에 따라 시작지점별로 적용됩니다. 키워드나 상수 값이 지정되면 모든 시작지점에 적용됩니다.
시작지점의 특성이나 시작지점에서 또는 시작지점까지의 이동자는 특정 매개변수로 제어할 수 있습니다.
- 초기 누적은 이동을 시작하기 전의 초기 비용을 설정합니다.
- 최대 누적은 시작지점이 한도에 도달하기 전에 누적할 수 있는 비용을 지정합니다.
- 비용에 적용할 승수는 시작지점에서의 크기 또는 이동 모드를 지정합니다.
- 이동 경로는 이동자가 시작지점에서 출발하여 비시작지점 위치로 이동했는지 아니면 비시작지점에서 출발하여 시작지점으로 다시 돌아왔는지를 식별합니다.
초기 누적이 지정된 경우 결과 비용 거리 표면의 시작지점 위치는 초기 누적 값으로 설정됩니다. 그렇지 않으면, 결과 비용 거리 표면의 시작지점 위치는 0으로 설정됩니다.
이 도구에 대한 매개변수는 다음 테이블에 나와 있습니다.
| 매개변수 | 설명 |
|---|---|
| 원본 래스터 또는 피처 선택 | 거리를 계산할 원본을 식별하는 래스터 또는 피처 레이어입니다. 입력이 래스터인 경우 원본에 유효한 값(0은 유효한 값)을 갖는 셀로 구성되어야 하며 나머지 셀에는 NoData가 할당되어야 합니다. 입력이 피처 레이어인 경우 포인트, 라인 또는 폴리곤일 수 있습니다. |
| 장애물 래스터 또는 피처 선택(선택 사항) | 장애물을 정의하는 데이터셋입니다. 래스터의 경우 입력 유형은 정수 또는 실수일 수 있습니다. 값(0 포함)이 있는 셀은 장애물로 처리됩니다. NoData인 셀은 장애물로 처리되지 않습니다. 피처의 경우 입력은 포인트, 라인 또는 폴리곤일 수 있습니다. |
| 표면 래스터 선택(선택 사항) | 거리 계산에 평면 거리를 사용할지 아니면 측지 거리를 사용할지를 지정합니다. 이 값은 셀 사이를 통과할 때 커버된 실제 표면 거리를 계산하는 데 사용됩니다. |
| 비용 래스터 선택(선택 사항) | 각 셀을 통해 평면으로 이동할 임피던스 또는 비용을 정의하는 래스터입니다. 각 셀 위치의 값은 셀을 통해 이동하기 위한 단가 거리를 나타냅니다. 각 셀 위치 값과 셀 해상도를 곱해 대각선 이동을 보정하여 셀 통과 총비용을 구합니다. 비용 래스터의 값은 정수이거나 부동 소수점일 수 있지만 음수이거나 0일 수는 없습니다(비용이 음수이거나 0일 수 없음). |
| 수직 래스터 선택(선택 사항) | 각 셀 위치의 z 값을 정의하는 래스터입니다. 이 값은 한 셀에서 다른 셀로 이동할 때 발생하는 수직 계수를 식별하는 데 사용되는 경사 계산에 사용됩니다. |
| 수직 계수(선택 사항) | 수직 계수는 수직 비용 요소(VF)와 수직 상대 이동 각도(VRMA) 간의 관계를 지정합니다. 이 옵션은 수직 래스터 선택(선택 사항)이 지정된 경우에만 사용할 수 있습니다. 정의된 수직 계수 그래프를 식별하도록 선택할 수정자를 포함하는 여러 계수가 있습니다. 이 그래프를 사용하여 인접 셀로 이동하는 총비용을 계산하는 데 사용되는 수직 계수를 식별할 수 있습니다. 아래 설명에서 VF는 한 셀에서 다음 셀로 이동할 때 발생하는 수직적 장애를 정의하고 VRMA 수정자는 시작 원본 셀과 끝 원본 셀 간의 경사 각도를 식별합니다.
수직 매개변수에 대한 수정자는 다음과 같습니다.
|
| 수평 래스터 선택(선택 사항) | 각 셀의 수평 방향을 정의하는 래스터입니다. 래스터의 값은 0에서 360 사이의 정수이고 0도가 북쪽이거나 화면 위쪽을 향하며 시계 방향으로 증가해야 합니다. 평평한 부분은 값이 -1이어야 합니다. 각 위치의 값을 수평 계수와 함께 사용하면 셀에서 해당 셀의 네이버로 이동할 때 발생하는 수평 비용을 결정할 수 있습니다. |
| 수평 계수(선택 사항) | 수평 계수와 수평 상대 이동 각도 간의 관계를 정의합니다. 이 옵션은 수평 래스터 선택(선택 사항)이 지정된 경우에만 사용할 수 있습니다. 정의된 수평 계수 그래프를 식별하도록 선택할 수정자를 포함하는 여러 계수가 있습니다. 이 그래프를 사용하여 인접 셀로 이동하는 총비용을 계산하는 데 사용되는 수평 계수를 식별할 수 있습니다. 아래 설명에서 HF(수평 계수)는 한 셀에서 다음 셀로 이동할 때 발생하는 수평적 장애를 정의하고 HRMA(수평 상대 이동 각도)는 셀에서 수평 방향과 이동 방향 간의 각도를 식별합니다. 이러한 HF의 정의 및 매개변수는 다음과 같습니다.
수평 키워드에 대한 수정자는 다음과 같습니다.
|
| 초기 누적(선택 사항) | 비용 계산을 시작할 초기 누적 비용입니다. 해당 비용을 통해 원본과 연결된 고정 비용을 지정할 수 있습니다. 비용 알고리즘이 비용 0이 아닌 초기 누적으로 설정된 값으로 시작됩니다. 이 값은 0 이상이어야 합니다. 기본값은 0입니다. |
| 최대 누적(선택 사항) | 원본에 대한 여행자의 최대 누적입니다. 지정된 누적에 도달할 때까지 각 원본에 대해 비용 계산이 계속됩니다. 이 값은 0보다 커야 합니다. 기본 누적은 결과 래스터의 가장자리까지입니다. |
| 비용 승수(선택 사항) | 비용 값에 적용할 승수입니다. 해당 승수를 통해 시작지점에서 이동 또는 크기 모드를 제어할 수 있습니다. 승수가 클수록 각 셀을 이동하는 비용이 커집니다. 이 값은 0보다 커야 합니다. 기본값은 1입니다. |
| 이동 경로(선택 사항) | 수평 및 수직 계수를 적용할 때 여행자의 방향을 지정합니다. 시작 원본 - 수평 계수 및 수직 계수가 입력 원본에서 출발하여 비원본 셀에 도착할 때 적용됩니다. 이 옵션이 기본 설정입니다. 끝 원본 - 수평 계수 및 수직 계수가 각 비원본 셀에서 출발하여 입력 원본 셀로 돌아갈 때 적용됩니다. 시작 원본 또는 도착 원본 키워드를 지정하여 모든 원본에 적용되도록 하거나 각 원본의 이동 방향을 식별하는 키워드가 포함된 원본 데이터의 필드를 지정합니다. 필드에는 FROM_SOURCE 또는 TO_SOURCE 문자열을 포함해야 합니다. |
| 거리 방법(선택 사항) | 거리 계산에 평면 거리를 사용할지 아니면 측지 거리를 사용할지를 지정합니다.
|
| 결과 거리 누적 래스터 이름 | 거리 누적 래스터에는 각 셀에 대해 최소 비용 원본과 왕래한 누적 거리가 포함됩니다. 결과 래스터는 실수 유형입니다. 내 콘텐츠에 생성되고 맵에 추가되는 레이어의 이름입니다. 기본 이름은 도구 이름과 입력 레이어 이름을 기반으로 합니다. 레이어가 이미 있는 경우 다른 이름을 입력하라는 메시지가 나타납니다. 결과 저장: 드롭다운 상자를 사용하여 결과가 저장될 내 콘텐츠에서 폴더 이름을 지정할 수 있습니다. |
| 결과 역방향 래스터 이름(선택 사항) | 역방향 래스터에는 도 단위로 계산된 방향이 포함되어 있습니다. 방향은 장애물을 피하면서 가장 인접한 시작지점으로 돌아가는 최단 경로를 따라 다음 셀을 식별합니다. 값 범위는 0도에서 360도까지이며 시작지점 셀에 0이 예약되어 있습니다. 동쪽(오른쪽)이 90도이고 값은 시계방향으로 증가합니다(180도 남쪽, 270도 서쪽, 360도 북쪽). 결과 래스터는 실수 유형입니다. 내 콘텐츠에 생성되고 맵에 추가되는 레이어의 이름입니다. 기본 이름은 도구 이름과 입력 레이어 이름을 기반으로 합니다. 레이어가 이미 있는 경우 다른 이름을 입력하라는 메시지가 나타납니다. 결과 저장: 드롭다운 상자를 사용하여 결과가 저장될 내 콘텐츠에서 폴더 이름을 지정할 수 있습니다. |
| 결과 원본 방향 래스터 이름(선택 사항) | 원본 방향 래스터는 최소 누적 비용 원본 셀의 방향을 방위각(도)으로 식별합니다. 값 범위는 0도에서 360도까지이며 시작지점 셀에 0이 예약되어 있습니다. 동쪽(오른쪽)이 90도이고 값은 시계방향으로 증가합니다(180도 남쪽, 270도 서쪽, 360도 북쪽). 결과 래스터는 실수 유형입니다. 내 콘텐츠에 생성되고 맵에 추가되는 레이어의 이름입니다. 기본 이름은 도구 이름과 입력 레이어 이름을 기반으로 합니다. 레이어가 이미 있는 경우 다른 이름을 입력하라는 메시지가 나타납니다. 결과 저장: 드롭다운 상자를 사용하여 결과가 저장될 내 콘텐츠에서 폴더 이름을 지정할 수 있습니다. |
| 결과 원본 위치 래스터 이름(선택 사항) | 원본 위치 래스터는 다중밴드 결과입니다. 첫 번째 밴드에는 행 색인이 포함되고 두 번째 밴드에는 열 색인이 포함됩니다. 해당 색인은 최저 누적 비용 거리로 떨어져 있는 원본 셀의 위치를 식별합니다. 내 콘텐츠에 생성되고 맵에 추가되는 레이어의 이름입니다. 기본 이름은 도구 이름과 입력 레이어 이름을 기반으로 합니다. 레이어가 이미 있는 경우 다른 이름을 입력하라는 메시지가 나타납니다. 결과 저장: 드롭다운 상자를 사용하여 결과가 저장될 내 콘텐츠에서 폴더 이름을 지정할 수 있습니다. |
환경
분석 환경 설정은 도구의 결과에 영향을 주는 추가 매개변수입니다. 도구의 분석 환경 설정은 도구 창 상단에 있는 기어 아이콘 
을 클릭하여 접근할 수 있습니다.
이 도구는 다음과 같은 분석 환경을 적용합니다.
- 결과 좌표계 - 결과 레이어의 좌표계를 지정합니다.
- 범위 - 분석에 사용할 영역을 지정합니다.
- 스냅 래스터 - 지정된 스냅 래스터 레이어의 셀 정렬과 일치하도록 결과의 범위를 조정합니다.
- 셀 크기 - 결과 레이어에서 사용할 셀 크기입니다.
- 마스크 - 마스크 레이어를 지정하며, 마스크 레이어 내에 해당하는 셀만 분석에 사용됩니다.
유사한 도구 및 래스터 함수
거리 누적 도구는 각 셀에서 입력 시작지점까지의 누적 거리를 계산합니다. 비슷한 문제를 해결하는 데 유용한 기타 도구를 사용할 수 있습니다.
Map Viewer 분석 도구 및 래스터 함수
거리 할당 이미지 서비스 결과가 필요한 경우에는 거리 할당 도구 또는 거리 할당 래스터 함수를 사용합니다.
거리 누적은 래스터 함수로도 사용할 수 있습니다.
ArcGIS Pro 분석 도구 및 래스터 함수
거리 누적 및 거리 할당 지오프로세싱 도구는 Spatial Analyst 도구상자에서 제공됩니다.
ArcGIS Enterprise 개발자 리소스
ArcGIS REST API에서 작업하는 경우에는 Distance Accumulation 및 Distance Allocation 작업을 수행합니다.
ArcGIS API for Python에서 작업하는 경우 arcgis.raster.functions.gbl 모듈에서 Distance Accumulation 
Distance Allocation 를 사용합니다.