gdal_proximity.py
래스터 근접성 맵을 생성합니다.
개요
gdal_proximity.py <srcfile> <dstfile> [-srcband n] [-dstband n]
[-of format] [-co name=value]*
[-ot Byte/UInt16/UInt32/Float32/etc]
[-values n,n,n] [-distunits PIXEL/GEO]
[-maxdist n] [-nodata n] [-use_input_nodata YES/NO]
[-fixed-buf-val n]
설명
gdal_proximity.py 스크립트는 각 픽셀의 중심(center)에서 대상 픽셀로 식별된 최근접 픽셀의 중심까지의 거리를 나타내는 래스터 근접성(proximity) 맵을 생성합니다. 대상 픽셀은 래스터 픽셀 값이 대상 픽셀 값 집합에 있는 소스 래스터의 픽셀입니다.
- <srcfile>
대상 픽셀을 식별하기 위해 사용하는 소스 래스터 파일입니다.
- <dstfile>
근접성 맵을 작성할 대상 래스터 파일입니다. srcfile과 동일한 크기의 기존 파일일 수도 있습니다. 기존에 존재하지 않는 경우 새로 생성할 것입니다.
- -srcband <n>
소스 파일에서 사용할 밴드를 식별합니다. (기본값은 1입니다.)
- -dstband <n>
대상 파일에서 사용할 밴드를 식별합니다. (기본값은 1입니다.)
- -of <format>
산출물 포맷을 선택합니다. GDAL 2.3버전부터, 이 옵션을 지정하지 않을 경우 확장자로부터 포맷을 추정합니다. (이전에는 GTiff가 기본값이었습니다.) 단축 포맷 이름을 사용하십시오.
- -co <NAME=VALUE>
많은 포맷들이 생성된 파일에 대한 특정 요소들을 제어하기 위해 사용할 수 있는 선택적인 생성 옵션을 하나 이상 가지고 있습니다. 예를 들면 GeoTIFF 드라이버는 압축과 파일을 타일화할지 여부를 제어할 수 있는 생성 옵션을 지원합니다. 포맷 드라이버에 따라 사용할 수 있는 생성 옵션이 다양하며, 몇몇 단순 포맷들의 경우 어떤 생성 옵션도 가지고 있지 않기도 합니다. 어떤 포맷이 어떤 옵션을 지원하는지에 대한 목록은 –formats 명령줄 옵션으로 볼 수 있지만, 해당 포맷에 대한 문서야말로 드라이버 생성 옵션 관련 최종 정보 소스입니다. 각 포맷의 정당한 생성 옵션에 대해 알고 싶다면 래스터 드라이버 포맷 특화 문서를 읽어보십시오.
- -ot <type>
드라이버가 지원하는 데이터 유형을 지정합니다. 다음 가운데 하나를 사용할 수 있습니다:
Byte
,UInt16
,Int16
,UInt32
,Int32
,Float32
(기본값), 또는Float64
.
- -values <n>,<n>,<n>
소스 이미지에서 대상 픽셀로 간주되기 위한 대상 픽셀값의 목록입니다. 지정하지 않는 경우, 0값이 아닌 모든 픽셀을 대상 픽셀로 간주할 것입니다.
- -distunits PIXEL|GEO
생성된 거리를 픽셀 단위로 나타낼지 또는 지리참조 좌표로 나타낼지 설정합니다. (기본값은 PIXEL입니다.)
- -maxdist <n>
생성할 거리의 최대값입니다. 이 거리를 초과하는 픽셀에 대해서는 NODATA 값을 사용할 것입니다. NODATA 값을 지정하지 않는 경우, 산출 밴드에 산출 밴드의 NODATA 값을 쿼리할 것입니다. 산출 밴드가 NODATA 값을 가지고 있지 않은 경우, 65535값을 사용할 것입니다. -distunits를 GEO로 지정하지 않았다면 거리를 픽셀 단위로 해석합니다.
- -nodata <n>
산출 근접성 래스터에 사용할 NODATA 값을 지정합니다.
- -use_input_nodata YES/NO
입력 래스터에 있는 NODATA 픽셀이 산출 래스터의 NODATA가 되어야 할지를 나타냅니다. (기본값은 NO입니다.)
- -fixed-buf-val <n>
거리 값이 아니라 대상 픽셀의 -maxdist 안에 들어오는 (대상 픽셀을 포함하는) 모든 픽셀에 적용할 값을 지정합니다.