gdal_retile.py
타일 집합을 다시 타일화하고, 그리고/또는 타일화된 피라미드 수준을 작성합니다.
개요
gdal_retile.py [-v] [-co NAME=VALUE]* [-of out_format] [-ps pixelWidth pixelHeight]
[-overlap val_in_pixel]
[-ot {Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/
CInt16/CInt32/CFloat32/CFloat64}]'
[ -tileIndex tileIndexName [-tileIndexField tileIndexFieldName]]
[ -csv fileName [-csvDelim delimiter]]
[-s_srs srs_def] [-pyramidOnly]
[-r {near/bilinear/cubic/cubicspline/lanczos}]
-levels numberoflevels
[-useDirForEachRow] [-resume]
-targetDir TileDirectory input_files
설명
이 유틸리티는 입력 타일(들)의 집합을 다시 타일화합니다. 모든 입력 타일(들)은 동일한 좌표계에서 지리참조되어야만 하며 밴드 개수가 일치해야만 합니다. 피라미드 수준을 생성하는 옵션이 있습니다. 타일화된 산출물에 대한 shapefile(들)을 생성할 수 있습니다.
입력 타일 개수가 명령줄 버퍼를 넘어서는 경우, 일반적인 –optfile 옵션을 사용하십시오.
- -targetDir <directory>
타일화 결과물을 생성하는 디렉터리입니다. 1부터 시작하는 하위 디렉터리에 피라미드를 저장합니다. 생성된 타일 이름은 번호 부여 스키마를 가지고 있으며, 소스 타일(들)의 이름을 담고 있습니다.
- -of <format>
산출물 포맷을 선택합니다. GDAL 2.3버전부터, 이 옵션을 지정하지 않을 경우 확장자로부터 포맷을 추정합니다. (이전에는 GTiff가 기본값이었습니다.) 단축 포맷 이름을 사용하십시오.
- -co <NAME=VALUE>
많은 포맷들이 생성된 파일에 대한 특정 요소들을 제어하기 위해 사용할 수 있는 선택적인 생성 옵션을 하나 이상 가지고 있습니다. 예를 들면 GeoTIFF 드라이버는 압축과 파일을 타일화할지 여부를 제어할 수 있는 생성 옵션을 지원합니다. 포맷 드라이버에 따라 사용할 수 있는 생성 옵션이 다양하며, 몇몇 단순 포맷들의 경우 어떤 생성 옵션도 가지고 있지 않기도 합니다. 어떤 포맷이 어떤 옵션을 지원하는지에 대한 목록은 –formats 명령줄 옵션으로 볼 수 있지만, 해당 포맷에 대한 문서야말로 드라이버 생성 옵션 관련 최종 정보 소스입니다. 각 포맷의 정당한 생성 옵션에 대해 알고 싶다면 래스터 드라이버 포맷 특화 문서를 읽어보십시오.
- -ot <type>
산출 이미지 밴드가 드라이버가 지원하는 특정 데이터 유형이도록 강제합니다. 이때 드라이버는 다음 가운데 하나일 수도 있습니다:
Byte
,UInt16
,Int16
,UInt32
,Int32
,Float32
,Float64
,CInt16
,CInt32
,CFloat32
orCFloat64
.
- -ps <pixelsize_x> <pixelsize_y>
산출 파일에 사용할 픽셀 크기입니다. 지정하지 않는 경우 기본값은 256x256입니다.
- -overlap< <val_in_pixel>
연속되는 타일들을 지정한 픽셀 개수만큼 중첩합니다. 지정하지 않는 경우 기본값은 0입니다.
New in version 2.2.
- -levels <numberOfLevels>
작성할 피라미드 수준의 개수입니다.
- -v
타일화 작업이 끝나면 작업에 대한 자세한 설명을 생성합니다.
- -pyramidOnly
다시 타일화하지 않고, 피라미드만 작성합니다.
- -r <algorithm>
리샘플링 알고리즘입니다. 기본값은
near
입니다.
- -s_srs <srs_def>
소스 공간 좌표계를 설정합니다. OGRSpatialReference.SetFromUserInput() 호출이 지원하는 모든 좌표계를 전송(pass)할 수 있습니다. 이 모든 좌표계는 EPSG PCS와 GCS들(예: EPSG:4296), (앞에서 보인대로의) PROJ.4 선언문, 또는 WKT를 담고 있는 .prj 파일의 이름을 포함합니다. srs_def를 지정하지 않는 경우, (소스 타일의 srs_def가 있다면) 소스 srs_def를 사용합니다. srs_def는 (가능하다면) 생성된 타일에 그리고 선택적인 shapefile(들)에 들어갈 것입니다.
- -tileIndex <tileIndexName>
산출되는 타일(들) 색인을 담고 있는 shapefile의 이름입니다.
- -tileIndexField <tileIndexFieldName>
타일 이름을 담고 있는 속성의 이름입니다.
- -csv <csvFileName>
타일(들)의 지리참조 정보를 담고 있는 CSV 파일의 이름입니다. 이 파일은 tilename, minx, maxx, miny, maxy 열 5개를 담고 있습니다.
- -csvDelim <column delimiter>
CSV 파일에서 쓰이는 열 구분자입니다. 기본값은 쌍반점 “;”입니다.
- -useDirForEachRow
일반적으로 기반 이미지의 타일은
-targetDir
에 설정한대로 저장됩니다. 대용량 이미지의 경우, 디렉터리 하나 안에 있는 파일 개수가 너무 큰 경우 일부 파일 시스템의 성능이 저하되어 gdal_retile이 적정한 시간 안에 종료되지 않을 수도 있습니다. 이 파라미터를 사용하면 다른 산출물 구조를 생성합니다. 0이라는 하위 디렉터리에 기반 이미지의 타일을 저장하고, 1, 2, … 번호를 붙인 하위 디렉터리에 피라미드를 저장합니다. 이 디렉터리 각각에 0에서 n까지 번호를 붙인 또다른 수준의 하위 디렉터리를 생성합니다. 이때 n은 각 수준에서 타일 행들이 얼마나 많이 필요하냐에 따라 달라집니다. 결국, 디렉터리 하나가 특정 수준 하나의 행 하나에 해당하는 타일들만 담게 됩니다. 대용량 이미지의 경우 N배의 성능 향상을 이룰 수 있습니다.
- -resume
다시 시작(resume) 모드입니다. 누락된 파일만 생성합니다.
Note
gdal_retile.py는 파이썬 스크립트로, GDAL이 파이썬 지원과 함께 빌드된 경우에만 작동할 것입니다.