选项

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表单 (TrueFalse )对于布尔值选项。栅格将转换它们的内部形式。

configuration options 页面以获取可用选项的完整列表。

创建选项

每种格式都有一组特定于驱动程序的创建选项,可用于微调输出栅格。有关特定驱动程序的详细信息,请参阅 formats list .

在本文件中,我们将重点讨论 GeoTIFF creation options . 一些常见的geotiff创建选项包括:

  • TILEDBLOCKXSIZEBLOCKYSIZE 定义内部平铺

  • 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。

注解

一些 配置 选项还对创建时的驱动程序行为有影响。