# gdal_translate

`gdal_translate`는 GDAL(Geospatial Data Abstraction Library)에서 제공하는 핵심 명령줄 도구 중 하나로, 지리공간 래스터 데이터를 한 형식에서 다른 형식으로 변환하는 데 사용됩니다. 이 도구는 단순한 형식 변환을 넘어, 픽셀 값 조정, 영역 추출, 해상도 변경, 색상 테이블 적용 등 다양한 래스터 데이터 처리 기능을 제공하여 GIS(지리정보시스템) 분야에서 널리 활용되고 있습니다.

## 개요

`gdal_translate`는 지리공간 데이터 처리의 기초 단계에서 필수적인 도구로, 사용자는 이 명령어를 통해 다양한 래스터 파일 형식(예: GeoTIFF, JPEG2000, PNG, ASCII Grid 등) 간의 변환을 간편하게 수행할 수 있습니다. 또한, 데이터의 크기 축소, 특정 영역만 추출, 데이터 타입 변경, 메타데이터 조작 등도 가능하여, 대용량 원시 데이터를 분석이나 시각화에 적합한 형태로 변환하는 데 매우 유용합니다.

이 도구는 명령줄 기반으로 작동하므로, 자동화 스크립트나 배치 처리와 쉽게 통합할 수 있으며, Python, Bash, PowerShell 등 다양한 환경에서 호출 가능합니다.

---

## 주요 기능

### 1. 형식 변환

가장 기본적인 용도는 한 파일 형식을 다른 형식으로 변환하는 것입니다. 예를 들어, 원시 `.img` 파일을 `.tif` 형식으로 변환할 수 있습니다.

```bash
gdal_translate -of GTiff input.img output.tif
```

여기서 `-of` 옵션은 출력 형식(Output Format)을 지정합니다. 지원 형식은 `gdal_translate --formats` 명령어로 확인 가능합니다.

### 2. 영역 추출 (Subsetting)

특정 지리적 범위나 픽셀 범위의 하위 영역만을 추출할 수 있습니다.

- **지리적 범위 기준 추출**:
  ```bash
  gdal_translate -projwin ulx uly lrx lry input.tif subset.tif
  ```
  - `ulx`, `uly`: 왼쪽 상단 좌표 (x, y)
  - `lrx`, `lry`: 오른쪽 하단 좌표 (x, y)

- **픽셀 단위 추출**:
  ```bash
  gdal_translate -srcwin xoff yoff width height input.tif subset.tif
  ```

### 3. 해상도 및 크기 조정

출력 이미지의 해상도를 조정하거나 크기를 축소할 수 있습니다.

```bash
gdal_translate -outsize 50% 50% input.tif resized.tif
```

또는 특정 픽셀 크기를 지정:

```bash
gdal_translate -tr 30 30 input.tif resampled.tif
```

- `-tr`: 출력 픽셀 크기 (x, y 방향)

### 4. 데이터 타입 변경

출력 파일의 데이터 타입을 변경할 수 있습니다 (예: Float32 → Byte).

```bash
gdal_translate -ot Byte input.tif byte_output.tif
```

### 5. 픽셀 값 스케일링

예를 들어, 정규화된 값(0.0~1.0)을 8비트(0~255)로 스케일링할 수 있습니다.

```bash
gdal_translate -ot Byte -scale 0 1 0 255 input.tif scaled.tif
```

- `-scale [in_min in_max out_min out_max]`: 입력 범위를 출력 범위로 선형 매핑

### 6. 압축 및 옵션 최적화

출력 파일에 압축을 적용하여 용량을 줄일 수 있습니다.

```bash
gdal_translate -of GTiff -co "COMPRESS=DEFLATE" -co "TILED=YES" input.tif compressed.tif
```

- `COMPRESS`: 압축 방식 (예: LZW, DEFLATE, JPEG 등)
- `TILED`: 타일 기반 저장 (성능 향상)

---

## 실용적인 사용 예시

### 예시 1: 위성 영상의 일부를 PNG로 추출

```bash
gdal_translate \
  -projwin 126.0 38.0 127.0 37.0 \
  -of PNG \
  -ot Byte \
  -scale \
  -co "ZLEVEL=9" \
  landsat8.tif area.png
```

- 서울 인근 지역을 추출하여 고압축 PNG로 저장
- 자동 스케일링을 통해 명암 조정

### 예시 2: 대용량 DEM 데이터를 경량화

```bash
gdal_translate \
  -outsize 25% 25% \
  -tr 90 90 \
  -co "COMPRESS=LZW" \
  dem_1arc.tif dem_small.tif
```

- 해상도를 1/4로 축소하여 처리 속도 향상
- LZW 압축으로 저장 공간 절약

---

## 주의사항 및 팁

- **좌표계 유지**: `gdal_translate`는 기본적으로 입력 파일의 좌표계(CRS)를 유지합니다. 변환 후에도 지리적 정확성을 보장합니다.
- **NoData 값 처리**: `-a_nodata value` 옵션을 사용해 NoData 값을 명시적으로 설정할 수 있습니다.
- **메모리 사용**: 대용량 파일 처리 시 `-co "TILED=YES"` 및 블록 처리 옵션을 활용하면 성능이 향상됩니다.
- **버전 차이**: GDAL 버전에 따라 지원 옵션이 다를 수 있으므로, `gdal_translate --help`를 통해 최신 옵션을 확인하는 것이 좋습니다.

---

## 관련 도구 및 참고 자료

- **관련 명령어**:
  - `gdalwarp`: 재투영 및 기하학적 보정
  - `gdalinfo`: 래스터 파일 메타데이터 확인
  - `gdaladdo`: 오버뷰(미리보기) 생성

- **참고 문서**:
  - [GDAL 공식 문서 - gdal_translate](https://gdal.org/programs/gdal_translate.html)
  - [OSGeo GDAL GitHub 저장소](https://github.com/OSGeo/gdal)

- **설치 방법**:
  - Windows: OSGeo4W 또는 Conda (`conda install gdal`)
  - Linux: `sudo apt-get install gdal-bin`
  - macOS: `brew install gdal`

---

`gdal_translate`는 지리공간 데이터 처리의 기본이자 핵심 도구로, 자동화, 전처리, 형식 통합 등 다양한 작업에서 강력한 유연성을 제공합니다. 명령어 옵션을 숙지하면 반복 작업을 효율적으로 처리할 수 있으며, GIS 분석 파이프라인의 시작점으로 자주 사용됩니다.