거리 누적 도구는 각 셀에서 입력 시작지점까지의 누적 거리를 계산합니다.
비고:
이제 Map Viewer의 최신 맵 작성 도구인 ArcGIS Enterprise에서 이 도구가 제공됩니다. 자세한 내용은 거리 누적(Map Viewer)을 참고하세요.
이 도구를 실행하려면 기관이 래스터 분석에 대해 구성되어야 합니다.
Map Viewer Classic에 이 도구가 보이지 않으면 기관 관리자에게 문의하세요. 포털이 래스터 분석에 대해 구성되어 있지 않거나 이 도구를 실행하는 데 필요한 권한이 없을 수도 있습니다.
워크플로 다이어그램
예시
적용 예시에는 다음 질문에 대한 대답이 포함됩니다.
- 가장 가까운 마을까지의 거리는 얼마입니까?
- 가장 가까운 도로까지의 비용 거리는 얼마입니까?
- 가장 가까운 수원까지의 거리 주변 경계는 얼마입니까?
사용 참고사항
입력 시작지점 데이터는 피처 클래스 또는 래스터일 수 있습니다. 피처 클래스는 포인트, 라인, 폴리곤일 수 있습니다.
입력 시작지점 데이터가 래스터인 경우 시작지점 셀의 집합은 유효한 값을 가진 시작지점 래스터의 모든 셀로 구성됩니다. NoData 값을 가진 셀은 이 시작지점 집합에 포함되지 않습니다. 0 값은 유효한 시작지점으로 간주됩니다.
입력 시작지점 데이터가 피처인 경우 분석을 수행하기 전에 시작지점 위치가 내부적으로 래스터로 변환됩니다. 래스터의 해상도는 셀 크기 환경으로 제어할 수 있습니다. 기본 설정에 따라 도구에 다른 래스터가 지정되지 않은 경우 해상도는 입력 공간 참조 내 입력 피처 범위의 너비나 높이 중 더 짧은 것을 250으로 나눈 값으로 결정됩니다.
이러한 상황을 피하려면 중간 단계로 피처를 래스터로 변환 도구를 사용하여 입력 피처를 직접 래스터화하고 필드 매개변수를 설정할 수 있습니다. 그다음 결과 출력을 사용하려는 특정 거리 도구에 입력으로 사용합니다.
시작지점이 해당 입력 래스터에서 NoData에 해당하는 경우 분석에서 무시되므로 해당 시작지점으로부터의 거리가 계산되지 않습니다.
입력 표면 래스터에 수직 좌표계(VCS)가 있는 경우, 표면 래스터의 값은 VCS의 단위로 간주됩니다. 입력 표면 래스터에 VCS가 없으며 데이터가 투영된 경우, 표면 값은 공간 기준 체계의 선형 단위로 간주됩니다. 입력 표면 래스터에 VCS가 없으며 데이터가 투영되지 않은 경우, 표면 값은 미터 단위로 간주됩니다. 최종 거리 누적 결과는 선형 단위당 비용이거나 비용이 도입되지 않은 경우 선형 단위입니다.
경계는 주변으로 경로를 지정해야 하는 장애물입니다. 이는 두 가지 방식으로 정의할 수 있습니다.
경계 래스터 또는 피처 선택 매개변수의 경우 경계는 유효한 값이 있는 셀 또는 래스터로 변환된 피처 데이터로 나타낼 수 있습니다. 경계가 대각선 셀로만 연결된 경우에는 경계가 두꺼워져서 투과되지 않습니다.
또한 경계는 비용 래스터 선택, 표면 래스터 선택, 수직 래스터 선택, 수평 래스터 선택과 같은 입력에서 NoData 셀이 존재하는 위치로 정의됩니다. NoData가 대각선 셀로만 연결된 경우에는 추가 NoData 셀로 두꺼워져서 경계가 투과되지 않습니다.
알고리즘이 곱셈 프로세스이므로 비용 래스터에는 0 값이 포함될 수 없습니다. 비용 래스터에 0 값이 포함되어 있고 해당 값이 최저 비용 영역을 나타내는 경우 이 도구를 실행하기 전에 해당 셀을 작은 양수 값(예시: 0.01)으로 변경합니다.
수직 계수 수정자의 기본값은 다음과 같습니다.
Keyword Zero Low High Slope Power Cos Sec
factor cut cut power power
angle angle
------------------------ ------ ----- ----- ----- ----- ----- -----
Binary 1.0 -30 30 ~ ~ ~ ~
Linear 1.0 -90 90 1/90 ~ ~ ~
Symmetric linear 1.0 -90 90 1/90 ~ ~ ~
Inverse linear 1.0 -45 45 -1/45 ~ ~ ~
Symmetric inverse linear 1.0 -45 45 -1/45 ~ ~ ~
Cos ~ -90 90 ~ 1.0 ~ ~
Sec ~ -90 90 ~ 1.0 ~ ~
Cos_sec ~ -90 90 ~ ~ 1.0 1.0
Sec_cos ~ -90 90 ~ ~ 1.0 1.0경사면 방향 취득 도구의 결과는 수평 래스터 선택 매개변수에 입력으로 사용될 수 있습니다.
수평 계수 수정자의 기본값은 다음과 같습니다.
Keywords Zero factor Cut angle Slope Side value -------------- ----------- ----------- ----- --------- Binary 1.0 45 ~ ~ Forward 0.5 45 (fixed) ~ 1.0 Linear 0.5 181 1/90 ~ Inverse linear 2.0 180 -1/90 ~
시작지점의 특성이나 시작지점에서 또는 시작지점까지의 이동자는 특정 매개변수로 제어할 수 있습니다.
- 초기 누적은 이동을 시작하기 전의 초기 비용을 설정합니다.
- 최대 누적은 시작지점이 한도에 도달하기 전에 누적할 수 있는 비용을 지정합니다.
- 비용에 적용할 승수는 시작지점에서의 크기 또는 이동 모드를 지정합니다.
- 이동 경로는 이동자가 시작지점에서 출발하여 비시작지점 위치로 이동했는지 아니면 비시작지점에서 출발하여 시작지점으로 다시 돌아왔는지를 식별합니다.
어떠한 시작지점 특성 매개변수도 필드를 사용하여 지정된 경우 시작지점 특성은 시작지점 데이터에 지정된 필드의 정보에 따라 시작지점별로 적용됩니다. 키워드나 상수 값이 지정되면 모든 시작지점에 적용됩니다.
초기 누적이 지정된 경우 결과 비용 거리 표면의 시작지점 위치는 초기 누적 값으로 설정됩니다. 그렇지 않으면, 결과 비용 거리 표면의 시작지점 위치는 0으로 설정됩니다.
범위 환경 설정이 지정되지 않은 경우 처리 범위는 다음과 같은 방법으로 결정됩니다.
시작지점과 경계 데이터만 지정된 경우 양쪽의 두 셀 너비만큼 확장된 입력 유니온이 프로세싱 범위로 사용됩니다. 결과 래스터가 2개의 행과 열로 확장되는 이유는 결과가 래스터 형식 최적 경로 및 라인 형식 최적 경로에 사용될 때 생성된 경로는 경계 주위를 이동할 수 있기 때문입니다. 이 범위를 암시적 경계로 사용하려면 환경 설정에서 범위 값을 명시적으로 설정해야 합니다.
지정된 경우 프로세싱 범위는 표면 래스터, 비용 래스터, 수직 래스터, 수평 래스터의 교차점입니다.
분석 마스크 환경은 피처 클래스 또는 래스터 데이터셋으로 설정할 수 있습니다. 마스크가 피처인 경우 래스터로 전환됩니다. 값이 있는 셀은 마스크 영역 내에 있는 위치를 정의합니다. NoData 셀은 마스크 영역 외부에 있는 위치를 정의하며 경계로 처리됩니다.
셀 크기 또는 스냅 래스터 환경 설정이 지정되지 않고 입력으로 지정된 여러 개의 래스터가 있는 경우 셀 크기 및 스냅 래스터 환경은 비용 래스터, 표면 래스터, 수직 래스터, 수평 래스터, 원본 데이터, 경계 데이터 우선순위에 따라 설정됩니다.
이 도구에 대한 매개변수는 다음 테이블에 나와 있습니다.
| 매개변수 | 설명 |
|---|---|
| 원본 래스터 또는 피처 선택 | 거리를 계산할 원본을 식별하는 래스터 또는 피처 레이어입니다. 입력이 래스터인 경우 원본에 유효한 값(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도 북쪽). 결과 래스터는 실수 유형입니다. 내 콘텐츠에 생성되고 맵에 추가되는 레이어의 이름입니다. 기본 이름은 도구 이름과 입력 레이어 이름을 기반으로 합니다. 레이어가 이미 있는 경우 다른 이름을 입력하라는 메시지가 나타납니다. 결과 저장: 드롭다운 상자를 사용하여 결과가 저장될 내 콘텐츠에서 폴더 이름을 지정할 수 있습니다. |
| 결과 원본 위치 래스터 이름(선택 사항) | 원본 위치 래스터는 다중밴드 결과입니다. 첫 번째 밴드에는 행 색인이 포함되고 두 번째 밴드에는 열 색인이 포함됩니다. 해당 색인은 최저 누적 비용 거리로 떨어져 있는 원본 셀의 위치를 식별합니다. 내 콘텐츠에 생성되고 맵에 추가되는 레이어의 이름입니다. 기본 이름은 도구 이름과 입력 레이어 이름을 기반으로 합니다. 레이어가 이미 있는 경우 다른 이름을 입력하라는 메시지가 나타납니다. 결과 저장: 드롭다운 상자를 사용하여 결과가 저장될 내 콘텐츠에서 폴더 이름을 지정할 수 있습니다. |
환경
분석 환경 설정은 도구의 결과에 영향을 주는 추가 매개변수입니다. 도구의 분석 환경 설정은 도구 창 상단에 있는 기어 아이콘 
을 클릭하여 접근할 수 있습니다.
이 도구는 다음과 같은 분석 환경을 적용합니다.
- 결과 좌표계 - 결과 레이어의 좌표계를 지정합니다.
- 범위 - 분석에 사용할 영역을 지정합니다.
- 스냅 래스터 - 지정된 스냅 래스터 레이어의 셀 정렬과 일치하도록 결과의 범위를 조정합니다.
- 셀 크기 - 결과 레이어에서 사용할 셀 크기입니다.
- 마스크 - 마스크 레이어를 지정하며, 마스크 레이어 내에 해당하는 셀만 분석에 사용됩니다.
- 병렬 처리 계수 - 래스터 처리 CPU 또는 GPU 인스턴스를 제어합니다.
유사한 도구 및 래스터 함수
거리 누적 도구는 각 셀에서 입력 시작지점까지의 누적 거리를 계산합니다. 비슷한 문제를 해결하는 데 유용한 기타 도구를 사용할 수 있습니다.
Map Viewer Classic 분석 도구 및 래스터 함수
거리 할당 이미지 서비스 결과가 필요한 경우에는 거리 할당 도구 또는 거리 할당 래스터 함수를 사용합니다.
거리 누적은 래스터 함수로도 사용할 수 있습니다.
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 를 사용합니다.