cogdumper 1.1.0

# COG Dumper

[](https://travis-ci.org/mapbox/COGDumper) [](https://codecov.io/gh/mapbox/COGDumper)

A python (3.6) utility to extract a tile from a Cloud Optimized GeoTIFF (COG) without decompressing the contained data. Tiff data can be hosted locally, on a web server or S3.

This can be useful for serving compressed tiles from a TIFF without invoking Rasterio and GDAL. This utility has been tested with Tiff that have JPEG compression.

Tiled Tiff是TIFF 6.0的一个扩展，更多详细信息请参阅[这里](http://www.alternatiff.com/resources/TIFFphotoshop.pdf)

请注意，图块在图像边缘进行了填充。如果图块大小与图像宽度/高度不匹配（如测试数据中展示的），则需要定义一个图像[掩码](https://trac.osgeo.org/gdal/wiki/rfc15_nodatabitmask)。


## 数据准备

阅读[COG](https://trac.osgeo.org/gdal/wiki/CloudOptimizedGeoTIFF)文档并创建一个瓦片金字塔GeoTIFF。

例如；

```
gdal_translate SENTINEL2_L1C:S2A_MSIL1C_20170102T111442_N0204_R137_T30TXT_20170102T111441.SAFE/MTD_MSIL1C.xml:TCI:EPSG_32630 \
S2A_MSIL1C_20170102T111442_N0204_R137_T30TXT_20170102T111441_TCI.tif \
-co TILED=YES -co COMPRESS=DEFLATE
gdaladdo -r average S2A_MSIL1C_20170102T111442_N0204_R137_T30TXT_20170102T111441_TCI.tif 2 4 8 16 32
gdal_translate S2A_MSIL1C_20170102T111442_N0204_R137_T30TXT_20170102T111441_TCI.tif \
S2A_MSIL1C_20170102T111442_N0204_R137_T30TXT_20170102T111441_TCI_cloudoptimized_2.tif \
-co TILED=YES -co COMPRESS=JPEG -co PHOTOMETRIC=YCBCR -co COPY_SRC_OVERVIEWS=YES
```

此库还支持托管在S3存储桶中的文件。

## 安装

需要Python 3.6。

```
pip安装cogdumper
```

或者从源码安装

```
git clone https://github.com/mapbox/COGDumper
cd COGDumper
pip install .
```

## 命令行界面

```
$ cogdumper --help
用法：cogdumper [选项] 命令 [参数]...

COGDumper的命令行界面。

选项
--version 显示版本信息并退出。
--help 显示此信息并退出。

命令
file COGDumper命令行界面用于本地数据集。
http COGDumper命令行界面用于Web托管数据集。
s3 COGDumper命令行界面用于AWS S3托管数据集
```

##### 本地文件
```
cogdumper file --help
用法：cogdumper file [选项]

COGDumper命令行界面用于本地数据集。

选项
--file PATH 输入文件 [必需]
--output PATH 本地输出目录
--xyz INTEGER... xyz瓦片坐标，其中z是概述级别
--version 显示版本信息并退出。
--help 显示此信息并退出。
```
例如：`cogdumper file --file data/cog.tif --xyz 0 0 0`

##### 网络文件

```
cogdumper http --help
用法：cogdumper http [选项]

COGDumper命令行界面用于Web托管数据集。

选项
--server TEXT 服务器 e.g. http://localhost:8080 [必需]
--path TEXT 服务器路径
--resource TEXT 服务器资源
--output DIRECTORY 本地输出目录
--xyz INTEGER... xyz瓦片坐标，其中z是概述级别
--version 显示版本信息并退出。
--help 显示此信息并退出。
```

例如：`cogdumper http --server http://localhost:8080 --path data --resource cog.tif`

##### S3文件
```
cogdumper s3 --help
用法：cogdumper s3 [选项]

COGDumper命令行界面用于AWS S3托管数据集

选项
--bucket TEXT AWS S3存储桶 [必需]
--key TEXT AWS S3键 [必需]
--output DIRECTORY 本地输出目录
--xyz INTEGER... xyz瓦片坐标，其中z是概述级别
--help 显示此信息并退出。
```

例如：`cogdumper s3 --bucket bucket_name --key key_name/image.tif --xyz 0 0 0`