选项¶
GDAL的格式驱动程序有很多 configuration options . 这些选项有两种类型:
配置选项 用于更改gdal和ogr的默认行为,gdal通常将其视为全局环境变量。这些是通过
rasterio.Env()
python中的上下文块。创建选项 在数据集创建时作为关键字参数传递到驱动程序
rasterio.open(mode='w')
.
配置选项¶
gdal选项通常设置为环境变量。而环境变量会影响 rasterio
我们强烈建议避免使用它们,以便于通过编程定义行为。
设置栅格选项的首选方法是通过 rasterio.Env()
. 在进入上下文时设置的选项将在退出时删除。
import rasterio
with rasterio.Env(GDAL_TIFF_INTERNAL_MASK=True):
# GeoTIFFs written here will have internal masks, not the
# .msk sidecars.
# ...
# Option is gone and the default (False) returns.
使用本机python表单 (True
和 False
)对于布尔值选项。栅格将转换它们的内部形式。
见 configuration options 页面以获取可用选项的完整列表。
创建选项¶
每种格式都有一组特定于驱动程序的创建选项,可用于微调输出栅格。有关特定驱动程序的详细信息,请参阅 formats list .
在本文件中,我们将重点讨论 GeoTIFF creation options . 一些常见的geotiff创建选项包括:
TILED
,BLOCKXSIZE
和BLOCKYSIZE
定义内部平铺
COMPRESS
定义压缩方法
PHOTOMETRIC
定义色带的颜色解释
要在python代码中指定这些创建选项,可以将它们作为关键字参数传递给 rasterio.open()
命令处于写入模式。
with rasterio.open("output.tif", 'w', **src.meta, compress="JPEG",
tiled=True, blockxsize=256, blockysize=256,
photometric="YCBCR") as dataset:
# Write data to the dataset.
注解
geotiff格式要求 块大小 和 块状 是16的倍数。
在命令行上, rio
命令将接受多个 --co
选项。
$ rio copy source.tif dest.tif --co tiled=true
根据您的喜好,这些关键字参数可以是小写或大写。
注意
有些选项看起来可能是布尔型的,但实际上不是。geotiff格式的bigtiff选项就是其中之一。值必须是yes、no、if_needed或if_safer。
注解
一些 配置 选项还对创建时的驱动程序行为有影响。