gdal_rasterize

创建日期:2024-06-21
更新日期:2025-01-19

将矢量几何刻画成栅格。

~#~# 概要

```

Usage: gdal_rasterize [-b band]* [-i] [-at]

{[-burn value]* | [-a attribute_name] | [-3d]} [-add]

[-l layername]* [-where expression] [-sql select_statement]

[-dialect dialect] [-of format] [-a_srs srs_def] [-to NAME=VALUE]*

[-co "NAME=VALUE"]* [-a_nodata value] [-init value]*

[-te xmin ymin xmax ymax] [-tr xres yres] [-tap] [-ts width height]

[-ot {Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/

CInt16/CInt32/CFloat32/CFloat64}] [-q]

```

~#~# 描述

该程序将矢量几何(点,线和多边形)刻录到光栅图像的光栅带中。 从OGR支持的向量格式读取向量。

请注意,只有矢量数据在光栅数据的坐标系上重新投影才能从GDAL 2.1.0起支持。

由于GDAL 1.8.0,目标GDAL文件可以由gdal_rasterize创建。 在这种情况下,必须使用-tr或-ts选项。

~*~*-b band:~*~*

频带将值加入。 可以使用多个-b参数来刻录到频带列表中。 默认为烧录到频带1。

~*~*-i:~*~*

反转光栅化。 将固定的刻录值或与第一个要素相关联的刻录值刻录到不在所提供的多边形内的图像的所有部分。

~*~*-at:~*~*

启用ALL_TOUCHED光栅化选项,使得线或多边形触摸的所有像素都将被更新,而不仅仅是在线渲染路径上或其中心点在多边形内的像素。 默认为禁用正常呈现规则。

~*~*-burn value:~*~*

一个固定值,可以烧录成所有对象的乐队。 可以提供-burn选项列表,每个波段写入一个

~*~*-a attribute_name:~*~*

标识要用于老化值的功能的属性字段。 该值将被烧录到所有输出频段。

~*~*-3d:~*~*

表示应从特征的“Z”值中提取刻录值。 截至目前,只有点和线以3D绘制。

~*~*-add:~*~*

而不是刻录新的值,这会将新值添加到现有栅格。 适用于例如热图。

~*~*-l layername:~*~*

指示将用于输入要素的数据源中的图层。 可以多次指定,但必须至少指定一个图层名称或-sql选项。

~*~*-where expression:~*~*

一个可选的SQL WHERE样式查询表达式,用于从输入层中选择要刻录的要素。

~*~*-sql select_statement:~*~*

要针对数据源进行评估的SQL语句,以生成要刻录的功能的虚拟层。

~*~*-dialect dialect:~*~*

(GDAL> = 2.1.0)SQL方言。 在某些情况下,可以通过传递OGRSQL来使用(未优化的)OGR SQL而不是RDBMS的本地SQL。 从GDAL 1.10开始,“SQLITE”方言也可以与任何数据源一起使用。

~*~*-of format:~*~*

(GDAL> = 1.8.0)选择输出格式。 默认值为GeoTIFF(GTiff)。 使用短格式名称。

~*~*-a_nodata value:~*~*

(GDAL> = 1.8.0)将指定的节点值分配给输出频带。

~*~*-init value:~*~*

(GDAL> = 1.8.0)用这些值预先输出图像带。 但是,它不会在输出文件中标记为nodata值。 如果仅给出一个值,则在所有频带中使用相同的值。

~*~*-a_srs srs_def:~*~*

(GDAL> = 1.8.0)覆盖输出文件的投影。 如果未指定,将使用输入向量文件的投影。 如果输入和输出文件之间的投影不兼容,则不会尝试重新投影功能。 srs_def可以是通常的GDAL / OGR格式,完整的WKT,PROJ.4,EPSG:n或包含WKT的文件。

~*~*-to NAME=VALUE:~*~*

(GDAL> = 2.3.0)设置一个适合传递给GDALCreateGenImgProjTransformer2()的变压器选项。 将几何坐标转换为目标光栅像素空间时使用。 例如,这可以用于指定与RPC相关的转换选项。

~*~*-co "NAME=VALUE":~*~*

(GDAL> = 1.8.0)将创建选项传递给输出格式驱动程序。 可能会列出多个-co选项。 有关每种格式的合法创建选项,请参阅格式化的文档。

~*~*-te xmin ymin xmax ymax :~*~*

(GDAL> = 1.8.0)设置地理参考范围。 值必须以地理参考单位表示。 如果没有指定,输出文件的范围将是矢量图层的范围。

~*~*-tr xres yres :~*~*

(GDAL> = 1.8.0)设置目标分辨率。 值必须以地理参考单位表示。 两者都必须是正值。

~*~*-tap:~*~*

(GDAL> = 1.8.0)(目标对齐像素)将输出文件的范围的坐标与-tr的值对齐,以使对齐的范围包含最小范围。

~*~*-ts width height:~*~*

(GDAL> = 1.8.0)以像素和行设置输出文件大小。 请注意,-ts不能与-tr一起使用

~*~*-ot type:~*~*

(GDAL> = 1.8.0)输出频带为指示数据类型。 默认为Float64

~*~*-q:~*~*

(GDAL> = 1.8.0)抑制进度监视和其他无错误输出。

~*~*src_datasource:~*~*

任何OGR支持可读数据源。

~*~*dst_filename:~*~*

GDAL支持输出文件。 必须支持更新模式的访问。 在GDAL 1.8.0之前,gdal_rasterize无法创建新的输出文件。

~#~# 例子

以下将将mask.shp中的所有多边形刻录到RGB TIFF文件work.tif中,颜色为红色(RGB = 255,0,0)。

```

gdal_rasterize -b 1 -b 2 -b 3 -burn 255 -burn 0 -burn 0 -l mask mask.shp work.tif

```

以下将把所有“A类”建筑物烧录到输出高程文件中,从ROOF_H属性中拉出顶部高程。

```

gdal_rasterize -a ROOF_H -where 'class="A"' -l footprints footprints.shp city_dem.tif

```