命令行用户指南

cli允许您使用shell命令构建工作流，可以在命令提示下交互，也可以使用脚本。cli子命令涵盖了许多常见的情况，与实现类似于python脚本的功能相比，使用现成的命令通常更方便。

RIO程序是使用 Click 框架。它的插件系统允许外部模块共享一个公共的名称空间和处理上下文变量。

通过键入geojsonio cli将geojson拍摄到传单地图中 rio bounds tests/data/RGB.byte.tif | geojsonio .

这个 calc 命令将文件作为数组读取，在其上下文中计算类似Lisp的表达式，并将结果作为新文件写入。numpy模块的成员以及算术和逻辑运算符是可用的内置函数和运算符。它旨在进行简单的计算；任何需要多个步骤的计算都可以在Python中使用Rasterio和Numpy API更好地完成。

输入文件的带区数目可能不同，但行和列的数目应该相同。输出文件将具有与输入相同的行数和列数，并且表达式结果的每个元素都有一个带区。一个涉及n-d数组算术运算的表达式将产生一个n-d数组并产生一个n波段输出文件。

下面将生成一个3波段的geotiff，所有值的比例为0.95，增量为2。在表达式中， (read 1) 作为三维数组计算第一个输入数据集（3个频带）。

下面生成一个3波段的geotiff，其中第一个波段从输入的第一个波段复制，接下来的两个波段按第一个波段的平均值与各自的平均值之比缩放（缩小）。这个 --name 选项用于将数据集绑定到表达式中的名称。 (take a 1) 获取名为 a 作为二维数组 (asarray ...) 将二维数组的序列收集到三维数组中进行输出。

上面的命令也是计算的一个例子，它远远超出了calc命令的设计范围，而且可以在python中更有效地进行计算。

这个 clip 命令使用边界输入直接或从模板栅格剪裁栅格。

如果使用 --bounds ，值必须在输入的坐标参考系中。如果使用 --like ，边界将自动转换以匹配输入的坐标参考系。

它还可以结合使用fiona读取功能数据集的边界：

这个 convert 命令将栅格数据集复制并转换为其他数据类型和格式（类似于 gdal_translate ）

通过使用 --scale-ratio 和 --scale-offset 选项。目标栅格值计算为

例如，要将实际范围为0-4095到0-255的uint16数据缩放为uint8：

你可以使用 --rgb 作为 --co photometric=rgb .

这个 edit-info 命令允许您编辑栅格数据集的元数据，即

坐标参考系

nodata值

通过编辑这些元数据项，空间上不知情的图像处理软件（如photoshop或imagemagick）创建的TIFF可以变成geotiff。

例如，可以将数据集的坐标参考系统设置或更改为Web Mercator（epsg:3857）。

设置其 affine transformation matrix ，

或将其nodata值设置为，例如， 0 ：

或将其颜色解释设置为红色、绿色、蓝色和阿尔法：

也可以表示为：

见 rasterio.enums.ColorInterp 有关支持的颜色解释的完整列表和颜色文档的详细信息。

这个 mask 命令使用功能从栅格的所有带区中以像素为单位进行遮罩（遮罩出功能未覆盖的所有区域），并选择性地将输出栅格裁剪到功能范围内。假设特征与输入栅格在同一坐标参考系中。

一个常见的用例是通过政治或其他边界屏蔽栅格数据。

geojson特性可以使用stdin提供，也可以直接指定为第一个参数，输出可以裁剪到特性的范围内。

可以反转特征遮罩，以遮罩特征覆盖的像素，并保持特征不覆盖的像素。

这个 info 命令打印有关数据集的结构化信息。

可以使用 --verbose 选择权。

这个 merge 命令可用于平展一组相同结构的数据集。

这个 overview 命令创建存储在数据集中的概述，这可以提高某些应用程序的性能。

构建概述的抽取级别可以指定为逗号分隔的列表。

或者指数的基数和范围。

请注意，当前无法删除概述，并且在修改数据集的主带区时不会自动更新概述。

可以使用--ls选项打印有关现有概述的信息。

用于概述（内部或外部）的块大小（平铺宽度和高度）可以通过设置 GDAL_TIFF_OVR_BLOCKSIZE 环境变量的二次幂介于64和4096之间。默认值为128。

这个 rasterize 命令将geojson功能栅格化为新栅格或现有栅格。

生成的文件将具有由geojson边界确定的左上角坐标（epsg:4326，默认值），像素大小约为30弧秒。中心位于多边形内或由Bresenham线算法选择的像素将被烧掉，默认值为1。

可以将栅格化为现有栅格并使用其他默认值：

也可以使用模板栅格进行栅格化，模板栅格将用于确定输出栅格的变换、尺寸和坐标参考系统：

geojson特性可以使用stdin提供，也可以直接指定为第一个参数，并且可以提供尺寸来代替像素分辨率：

其他选项可用，请参见：

在数据集上调用shell的“$rm ”可用于删除由文件路径引用的数据集，但不会处理删除侧车文件。此命令了解数据集及其侧车文件。

sample命令读取 x, y 从stdin定位并将该位置的数据集值写入stdout。

转换命令的输出（见下文）可以很好地输入示例。

这个 shapes 命令以geojson的形式提取和写入指定数据集带区的特性。

上载到MapBox的结果文件如下： sgillies.j1ho338j .

使用 --mask 选项可以写出数据集有效数据区域的形状。

这个 stack 命令将一个或多个输入文件中的若干条带堆叠到多条带数据集中。输入数据集必须是一种类型：相同的数据类型、维度等。输出是从第一个输入克隆的。默认情况下， stack 将从每个输入中获取所有波段，并按相同的顺序写入输出。或者，可以使用以下语法指定每个输入的带区：

--bidx N 从输入端取第n个波段（第一个波段为1）。

--bidx M,N,O 带m、n和o。

--bidx M..O 带M-O，包括。

--bidx ..N 带上所有波段，包括N。

--bidx N.. 把所有的乐队从N带到结尾。

使用生成其副本的栅格测试数据集的示例。

你可以使用 --rgb 作为 --co photometric=rgb .

这个 transform 命令读取坐标的JSON数组，交错，并将另一个转换后的坐标数组写入stdout。

要将经度、纬度点（默认为epsg:4326）转换为输出精度为2位小数的另一个坐标系，请执行以下操作。

要将经度、纬度边界框转换为栅格数据集的坐标系，请执行以下操作。

这个 warp 命令扭曲（重新投影）基于可从模板栅格获取或直接输入的参数的栅格。输出总是被覆盖。

要从模板栅格复制坐标参考系、转换和尺寸，请执行以下操作：

可以使用proj.4或epsg:nnnn字符串或JSON文本编码的proj.4对象指定输出坐标系：

您还可以指定维度，该维度将根据目标CRS中边界与这些维度之间的关系自动计算适当的分辨率：

或提供输出边界（在源CRS中）和分辨率：

上一个命令，如果是南上图像， -- 逃离下一个 - ：

其他选项可用，请参见：

例如， rio-mbtiles 提供命令 rio mbtiles 将栅格导出到mbtiles文件。

见 click-plugins 有关如何构建这些插件的更多信息。

要在rio中使用这些插件，请将命令添加到 rasterio.rio_plugins' entry point in your setup.py file, as described here 而在 rasterio/rio/main.py .

见 plugin registry 获取可用插件的列表。

其他命令？ 欢迎对其他命令提出建议！