27.1.16. 向量创建

27.1.16.1. 偏移(平行)线阵列 

通过创建每个要素的多个偏移版本，在图层中创建线要素的副本。每个新版本都会以指定的距离递增偏移。

正距离将线向左偏移，负距离将线向右偏移。

../../../../_images/offset_lines_array.png — 图 27.36 蓝色为源层，红色为偏移层

允许 features in-place modification 线要素的数量

参见

偏移线, 转换的特征数组

参数

基本参数

标签	名字	类型	描述
Input layer	`INPUT`	[vector: line]	用于偏移的输入线向量层。
Number of features to create	`COUNT`	[number ] 默认：10	要为每个要素生成的偏移副本数
Offset step distance	`OFFSET`	[number ] 默认：1.0	两个连续偏移副本之间的距离
Offset lines	`OUTPUT`	[vector: line] 默认： `[Create temporary layer]`	指定具有偏移要素的输出线图层。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 追加到层… 还可以在此处更改文件编码。

高级参数

标签

名字

类型

描述

Segments

SEGMENTS

[number]

默认：8

创建四舍五入偏移量时用于近似四分之一圆的线段数

Join style

JOIN_STYLE

[enumeration]

默认：0

指定在偏移线中的拐角时应使用圆形连接、斜接连接还是斜接连接。以下选项之一：

0-圆角
1-斜接
2-斜面

../../../../_images/buffer_join_style.png — 图 27.37 圆形、斜接和斜接样式

Miter limit

MITER_LIMIT

[number]

默认：2.0

将创建斜接时要使用的与偏移几何图形的最大距离设置为偏移距离的系数(仅适用于斜接样式)。最低：1.0

../../../../_images/buffer_miter_limit.png — 图 27.38 限制为2的10M缓冲区和限制为1的10M缓冲区

产出

标签	名字	类型	描述
Offset lines	`OUTPUT`	[vector: line]	输出线图层和偏移要素。原始特征也会被复制。

Python代码

Algorithm ID ： native:arrayoffsetlines

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.2. 转换的特征数组 

通过创建每个要素的多个翻译版本来创建图层中要素的副本。每个副本在X、Y和/或Z轴上以预置量增量移动。

几何图形中存在的M值也可以转换。

../../../../_images/translate_array.png — 图 27.39 以蓝色色调输入图层，以红色色调输出具有转换要素的图层

允许 features in-place modification 点、线和面要素的

参见

翻译, 偏移(平行)线阵列

参数

标签	名字	类型	描述
Input layer	`INPUT`	[vector: any]	要转换的输入向量层
Number of features to create	`COUNT`	[number ] 默认：10	要为每个要素生成的副本数
Step distance (x-axis)	`DELTA_X`	[number ] 默认值：0.0	要在X轴上应用的置换
Step distance (y-axis)	`DELTA_Y`	[number ] 默认值：0.0	要在Y轴上应用的位移
Step distance (z-axis)	`DELTA_Z`	[number ] 默认值：0.0	要在Z轴上应用的置换
Step distance (m values)	`DELTA_M`	[number ] 默认值：0.0	要在M上应用的置换
Translated	`OUTPUT`	[same as input] 默认： `[Create temporary layer]`	输出包含要素的平移(移动)副本的矢量层。原始特征也会被复制。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 追加到层… 还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Translated	`OUTPUT`	[same as input]	输出包含要素的平移(移动)副本的矢量层。原始特征也会被复制。

Python代码

Algorithm ID ： native:arraytranslatedfeatures

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.3. 创建栅格 

创建具有覆盖给定范围的栅格的矢量层。网格单元可以有不同的形状：

../../../../_images/create_grid.png — 图 27.40 不同的网格单元形状

网格中每个元素的大小是使用水平和垂直间距定义的。

必须定义输出层的CRS。

栅格范围和间隔值必须以此CRS的坐标和单位表示。

Default menu ： Vector ► Research Tools

参数

标签	名字	类型	描述
Grid type	`TYPE`	[enumeration] 默认：0	网格的形状。以下选项之一： 0-点 1-行 2-矩形(多边形) 3-钻石(多边形) 4-六边形(多边形)
Grid extent	`EXTENT`	[extent]	网格的范围可用的方法包括：从Layer…计算：使用当前项目中加载的层的范围从布局地图…计算：使用的范围 layout map item 在激活项目中从书签…计算：使用已保存的数据区 bookmark 使用地图画布范围在画布上绘制：单击并拖动一个矩形，以分隔要考虑的区域将坐标输入为 `xmin, xmax, ymin, ymax`
Horizontal spacing	`HSPACING`	[number] 默认：1.0	X轴上栅格单元的大小
Vertical spacing	`VSPACING`	[number] 默认：1.0	Y轴上栅格单元格的大小
Horizontal overlay	`HOVERLAY`	[number] 默认值：0.0	X轴上两个连续格网像元之间的叠加距离
Vertical overlay	`VOVERLAY`	[number] 默认值：0.0	Y轴上两个连续格网像元之间的叠加距离
Grid CRS	`CRS`	[crs] 默认： Project CRS	要应用于格网的坐标参考系
Grid	`OUTPUT`	[vector: any] 默认： `[Create temporary layer]`	生成的矢量栅格层。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Grid	`OUTPUT`	[vector: any]	生成的矢量栅格层。输出几何类型(点、线或面)取决于 Grid type 。

Python代码

Algorithm ID ： native:creategrid

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.4. 从表中创建点图层 

从具有包含坐标字段的列的表中创建点图层。

除了X和Y坐标之外，您还可以指定Z和M字段。

参数

标签	名字	类型	描述
Input layer	`INPUT`	[vector: any]	输入矢量层或表格。
X field	`XFIELD`	[tablefield: any]	包含X坐标的字段
Y field	`YFIELD`	[tablefield: any]	包含Y坐标的字段
Z field 任选	`ZFIELD`	[tablefield: any]	包含Z坐标的字段
M field 任选	`MFIELD`	[tablefield: any]	包含M值的字段
Target CRS	`TARGET_CRS`	[crs] 默认： `EPSG:4326`	要用于层的坐标系。假定所提供的坐标是符合的。
Points from table	`OUTPUT`	[vector: point] 默认： `[Create temporary layer]`	指定生成的点图层。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Points from table	`OUTPUT`	[vector: point]	生成的点图层

Python代码

Algorithm ID ： native:createpointslayerfromtable

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.5. 沿线生成点(像素质心)

从输入的栅格和线图层生成点矢量图层。

这些点对应于与线层相交的像素质心。

../../../../_images/points_centroids.png — 图 27.41 像素质心点

参数

标签

名字

类型

描述

Raster layer

INPUT_RASTER

[raster]

输入栅格图层

Vector layer

INPUT_VECTOR

[vector: line]

输入线向量图层

Points along line

OUTPUT

[vector: point]

默认： [Create temporary layer]

使用像素质心生成的点层。以下选项之一：

创建临时层 (TEMPORARY_OUTPUT )
保存到文件…
保存到Geopackage…
保存到数据库表…

还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Points along line	`OUTPUT`	[vector: point]	具有像素质心的结果点图层

Python代码

Algorithm ID ： qgis:generatepointspixelcentroidsalongline

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.6. 在多边形内生成点(像素质心)

从输入栅格和多边形层生成点矢量层。

这些点对应于与多边形层相交的像素质心。

../../../../_images/points_centroids_polygon.png — 图 27.42 像素质心点

参数

标签

名字

类型

描述

Raster layer

INPUT_RASTER

[raster]

输入栅格图层

Vector layer

INPUT_VECTOR

[vector: polygon]

输入多边形矢量层

Points inside polygons

OUTPUT

[vector: point]

默认： [Create temporary layer]

像素质心的结果点层。以下选项之一：

创建临时层 (TEMPORARY_OUTPUT )
保存到文件…
保存到Geopackage…
保存到数据库表…

还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Points inside polygons	`OUTPUT`	[vector: point]	像素质心的结果点层

Python代码

Algorithm ID ： native:generatepointspixelcentroidsinsidepolygons

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.7. 导入带地理标记的照片 

从源文件夹中的JPEG或HEIC/HEIF图像创建与地理标记位置对应的点图层。

点图层将为每个输入文件包含一个可从中读取地理标记的Pointz要素。来自地理标记的任何高度信息都将用于设置点的Z值。

除了经度和纬度之外，海拔、方向和时间戳信息，如果出现在照片中，将作为属性添加到点上。

参数

标签	名字	类型	描述
Input folder	`FOLDER`	[folder]	包含带地理标记的照片的源文件夹的路径
Scan recursively	`RECURSIVE`	[boolean] 默认：FALSE	如果选中，将扫描文件夹及其子文件夹
Photos 任选	`OUTPUT`	[vector: point] 默认： `[Create temporary layer]`	为带地理标记的照片指定点向量层。以下选项之一：跳过输出创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。
Invalid photos table 任选	`INVALID`	[table] 默认： `[Skip output]`	指定不可读或未加地理标记的照片的表格。以下选项之一：跳过输出创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

产出

标签

名字

类型

描述

Photos

OUTPUT

[vector: point]

带有地理标记照片的点向量层。该层的表单将自动填充路径和照片预览设置。

Invalid photos table

任选

INVALID

[table]

也可以创建不可读或未加地理标记的照片的表格。

Python代码

Algorithm ID ： native:importphotos

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.8. 指向路径 

通过按输入点图层中的表达式或字段定义的顺序连接点，将点图层转换为线图层。

可以按字段或表达式对点进行分组，以区分线要素。

除了线向量层之外，还会输出一个文本文件，该文件将生成的线描述为起点以及方位角/方向(相对于方位角)和距离的序列。

参数

标签	名字	类型	描述
Input point layer	`INPUT`	[vector: point]	输入点矢量层
Create closed paths	`CLOSE_PATH`	[boolean] 默认：FALSE	如果选中，将连接线的第一个点和最后一个点并关闭生成的路径
Order expression 任选	`ORDER_EXPRESSION`	[expression]	提供连接路径中各点的顺序的字段或表达式。如果未设置，则功能ID (`$id` )被使用。
Sort text containing numbers naturally 任选	`NATURAL_SORT`	[boolean] 默认：FALSE	如果选中，自然会根据提供的表达式(即‘A9’<‘A10’)对要素进行排序。
Path group expression 任选	`GROUP_EXPRESSION`	[expression]	字段或表达式中具有相同值的点要素将组合在同一行中。如果未设置，则使用所有输入点绘制一条路径。
Paths	`OUTPUT`	[vector: line] 默认： `[Create temporary layer]`	指定路径的线矢量图层。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。
Directory for text output 任选	`OUTPUT_TEXT_DIR`	[folder] 默认： `[Skip output]`	指定将包含点和路径的描述文件的目录。以下选项之一：跳过输出保存到临时目录保存到目录

产出

标签	名字	类型	描述
Paths	`OUTPUT`	[vector: line]	路径的线矢量层
Directory for text output	`OUTPUT_TEXT_DIR`	[folder]	包含点和路径的描述文件的目录

Python代码

Algorithm ID ： native:pointstopath

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.9. 直线上的随机点 

创建一个新的点图层，其中的点放置在另一个图层的线上。

对于输入层中的每一条线，都会将给定数量的点添加到生成的层中。添加点的步骤如下：

从输入图层中随机选择线要素
如果要素由多部分组成，则随机选择其中的一部分
随机选择那条线的一段
在该线段上随机选择一个位置。

该过程意味着曲线部分(具有相对较短的线段)将比直线部分(具有相对较长的线段)获得更多的分数，如下图所示，其中 Random points along lines 算法的输出可以与 Random points on lines 算法(它产生的点平均而言，沿线均匀分布)。

../../../../_images/randompointsalonglines_illustration.png — 图 27.43 算法输出示例。左： *Random points along line* ，右： *Random points on lines*

可以指定最小距离，以避免点彼此太近。

参见

线上的随机点

参数

标签	名字	类型	描述
Input point layer	`INPUT`	[vector: line]	输入线向量图层
Number of points	`POINTS_NUMBER`	[number] 默认：1	要创建的点数
Minimum distance between points	`MIN_DISTANCE`	[number] 默认值：0.0	点之间的最小距离
Random points	`OUTPUT`	[vector: point] 默认： `[Create temporary layer]`	输出的随机点。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Random points	`OUTPUT`	[vector: point]	输出随机点层。

Python代码

Algorithm ID ： qgis:qgisrandompointsalongline

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.10. 范围中的随机点 

使用给定数量的随机点创建一个新的点图层，所有这些随机点都在给定范围内。

可以指定距离系数，以避免点彼此太近。如果点之间的最小距离导致无法创建新点，则可以减小距离或增加最大尝试次数。

Default menu ： Vector ► Research Tools

参数

基本参数

标签	名字	类型	描述
Input extent	`EXTENT`	[extent]	随机点的地图范围可用的方法包括：从Layer…计算：使用当前项目中加载的层的范围从布局地图…计算：使用的范围 layout map item 在激活项目中从书签…计算：使用已保存的数据区 bookmark 使用地图画布范围在画布上绘制：单击并拖动一个矩形，以分隔要考虑的区域将坐标输入为 `xmin, xmax, ymin, ymax`
Number of points	`POINTS_NUMBER`	[number] 默认：1	要创建的点数
Minimum distance between points	`MIN_DISTANCE`	[number] 默认值：0.0	点之间的最小距离
Target CRS	`TARGET_CRS`	[crs] 默认： Project CRS	随机点图层的CRS
Random points	`OUTPUT`	[vector: point] 默认： `[Create temporary layer]`	输出的随机点。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

高级参数

标签

名字

类型

描述

Maximum number of search attempts given the minimum distance

MAX_ATTEMPTS

[number]

默认：200

尝试放置这些点的最大次数

产出

标签	名字	类型	描述
Random points	`OUTPUT`	[vector: point]	输出随机点层。

Python代码

Algorithm ID ： native:randompointsinextent

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.11. 层边界中的随机点 

创建具有给定数量的随机点的新点图层，所有这些点都在给定层的范围内。

可以指定最小距离，以避免点彼此太近。

Default menu ： Vector ► Research Tools

参数

标签	名字	类型	描述
Input layer	`INPUT`	[vector: polygon]	定义区域的输入面图层
Number of points	`POINTS_NUMBER`	[number] 默认：1	要创建的点数
Minimum distance between points	`MIN_DISTANCE`	[number] 默认值：0.0	点之间的最小距离
Random points	`OUTPUT`	[vector: point] 默认： `[Create temporary layer]`	输出的随机点。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Random points	`OUTPUT`	[vector: point]	输出随机点层。

Python代码

Algorithm ID ： qgis:randompointsinlayerbounds

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.12. 多边形中的随机点 

创建一个点图层，将点放置在另一个图层的多边形内。

对于输入图层中的每个要素(多边形/多边形)几何图形，会将给定数量的点添加到结果图层。

可以指定每个要素和全局最小距离，以避免输出点图层中的点太近。如果指定了最小距离，则可能无法为每个要素生成指定数量的点。生成的点和遗漏的点的总数可以作为算法的输出。

下图显示了每个要素和全局最小距离以及零/非零最小距离(使用相同的种子生成，因此至少生成的第一个点将是相同的)的效果。

../../../../_images/randompointsinpolygons_mindistance.png — 图 27.44 每个多边形要素10个点， *left* ：Min.距离=0， *middle* ：最小距离=1， *right* ：Min.距离=1，全局最小距离=0

可以指定每个点的最大尝试次数。这仅与非零最小距离相关。

可以提供随机数生成器的种子，使得有可能为算法的不同运行获得相同的随机数序列。

可以包括生成点的面要素的属性 (Include polygon attributes )。

如果希望所有要素的点密度大致相同，则可以使用多边形要素几何图形的面积数据定义点的数量。

参见

多边形内的随机点

参数

基本参数

标签	名字	类型	描述
Input polygon layer	`INPUT`	[vector: line]	输入多边形矢量层
Number of points for each feature	`POINTS_NUMBER`	[number ] 默认：1	要创建的点数
Minimum distance between points 任选	`MIN_DISTANCE`	[number ] 默认值：0.0	一个面要素内的点之间的最小距离
Random points in polygons	`OUTPUT`	[vector: point] 默认： `[Create temporary layer]`	输出的随机点。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

高级参数

标签	名字	类型	描述
Global minimum distance between points 任选	`MIN_DISTANCE_GLOBAL`	[number ] 默认值：0.0	点之间的全局最小距离。应小于 Minimum distance between points (per feature) 才能使该参数生效。
Maximum number of search attempts (for Min. dist. > 0) 任选	`MAX_TRIES_PER_POINT`	[number ] 默认：10	每点的最大尝试次数。仅当设置点之间的最小距离(且大于0)时才相关。
Random seed 任选	`SEED`	[number] 默认：未设置	用于随机数生成器的种子。
Include polygon attributes	`INCLUDE_POLYGON_ATTRIBUTES`	[boolean] 默认值：True	如果设置，则点将从其所在的线获取属性。

产出

标签	名字	类型	描述
Random points in polygons	`OUTPUT`	[vector: point]	输出随机点层。
Number of features with empty or no geometry	`FEATURES_WITH_EMPTY_OR_NO_GEOMETRY`	[number]
Total number of points generated	`OUTPUT_POINTS`	[number]
Number of missed points	`POINTS_MISSED`	[number]	由于最小距离约束而无法生成的点数。
Number of features with missed points	`POLYGONS_WITH_MISSED_POINTS`	[number]	不包括具有空几何或无几何的要素

Python代码

Algorithm ID ： native:randompointsinpolygons

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.13. 多边形内的随机点 

在输入多边形层的每个多边形内创建具有给定数量的随机点的新点层。

有两种采样策略可用：

点数：每个要素的点数
点密度：每个要素的点密度

可以指定最小距离，以避免点彼此太近。

Default menu ： Vector ► Research Tools

参见

多边形中的随机点

参数

标签	名字	类型	描述
Input layer	`INPUT`	[vector: polygon]	输入多边形矢量层
Sampling strategy	`STRATEGY`	[enumeration] 默认：0	要使用抽样策略。以下选项之一： 0-点数：每个要素的点数 1-点密度：每个要素的点密度
Point count or density	`VALUE`	[number ] 默认：1.0	点的数量或密度，取决于所选的 Sampling strategy 。
Minimum distance between points	`MIN_DISTANCE`	[number] 默认值：0.0	点之间的最小距离
Random points	`OUTPUT`	[vector: point] 默认： `[Create temporary layer]`	输出的随机点。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Random points	`OUTPUT`	[vector: point]	输出随机点层。

Python代码

Algorithm ID ： qgis:randompointsinsidepolygons

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.14. 线上的随机点 

创建一个点图层，其中的点放置在另一个图层的线上。

对于输入图层中的每个要素(直线/多线)几何图形，会将给定数量的点添加到结果图层。

可以指定每个要素和全局最小距离，以避免输出点图层中的点太近。如果指定了最小距离，则可能无法为每个要素生成指定数量的点。生成的点和遗漏的点的总数可以作为算法的输出。

下图显示了每个要素和全局最小距离以及零/非零最小距离(使用相同的种子生成，因此至少生成的第一个点将是相同的)的效果。

../../../../_images/randompointsonlines_mindistance.png — 图 27.45 每条线要素五个点， *left* ：Min.距离=0， *middle* ：最小距离！=0， *right* ：Min.距离！=0，全局最小。距离=0

可以指定每个点的最大尝试次数。这仅与非零最小距离相关。

可以提供随机数生成器的种子，使得有可能为算法的不同运行获得相同的随机数序列。

可以包括生成点的线要素的属性 (Include line attributes )。

如果希望所有线要素的点密度大致相同，则可以使用线要素几何图形的长度数据定义点的数量。

参见

直线上的随机点

参数

基本参数

标签	名字	类型	描述
Input line layer	`INPUT`	[vector: line]	输入线向量图层
Number of points for each feature	`POINTS_NUMBER`	[number ] 默认：1	要创建的点数
Minimum distance between points (per feature) 任选	`MIN_DISTANCE`	[number ] 默认值：0.0	一个线要素内的点之间的最小距离
Random points on lines	`OUTPUT`	[vector: point] 默认： `[Create temporary layer]`	输出的随机点。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

高级参数

标签	名字	类型	描述
Global minimum distance between points 任选	`MIN_DISTANCE_GLOBAL`	[number ] 默认值：0.0	点之间的全局最小距离。应小于 Minimum distance between points (per feature) 才能使该参数生效。
Maximum number of search attempts (for Min. dist. > 0) 任选	`MAX_TRIES_PER_POINT`	[number ] 默认：10	每点的最大尝试次数。仅当设置点之间的最小距离(且大于0)时才相关。
Random seed 任选	`SEED`	[number] 默认：未设置	用于随机数生成器的种子。
Include line attributes	`INCLUDE_LINE_ATTRIBUTES`	[boolean] 默认值：True	如果设置，则点将从其所在的线获取属性。

产出

标签	名字	类型	描述
Random points on lines	`OUTPUT`	[vector: point]	输出随机点层。
Number of features with empty or no geometry	`FEATURES_WITH_EMPTY_OR_NO_GEOMETRY`	[number]
Number of features with missed points	`LINES_WITH_MISSED_POINTS`	[number]	不包括具有空几何或无几何的要素
Total number of points generated	`POINTS_GENERATED`	[number]
Number of missed points	`POINTS_MISSED`	[number]	由于最小距离约束而无法生成的点数。

Python代码

Algorithm ID ： native:randompointsonlines

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.15. 栅格像素转点 

创建与栅格层中的每个像素相对应的点的矢量层。

通过为栅格层中每个单独像素的中心创建点要素，将栅格层转换为矢量层。输出中将跳过任何无数据像素。

参数

标签	名字	类型	描述
Raster layer	`INPUT_RASTER`	[raster]	输入栅格图层
Band number	`RASTER_BAND`	[raster band]	要从中提取数据的栅格波段
Field name	`FIELD_NAME`	[string] 默认值：‘Value’	用于存储栅格波段值的字段的名称
Vector points	`OUTPUT`	[vector: point] 默认： `[Create temporary layer]`	指定像素质心的结果点层。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Vector points	`OUTPUT`	[vector: point]	像素质心的结果点图层

Python代码

Algorithm ID ： native:pixelstopoints

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.16. 栅格像素转多边形 

创建与栅格层中的每个像素相对应的多边形矢量层。

通过为栅格层中每个单独像素的范围创建多边形要素，将栅格层转换为矢量层。输出中将跳过任何无数据像素。

参数

标签	名字	类型	描述
Raster layer	`INPUT_RASTER`	[raster]	输入栅格图层
Band number	`RASTER_BAND`	[raster band]	要从中提取数据的栅格波段
Field name	`FIELD_NAME`	[string] 默认值：‘Value’	用于存储栅格波段值的字段的名称
Vector polygons	`OUTPUT`	[vector: polygon] 默认： `[Create temporary layer]`	指定像素范围的结果多边形层。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Vector polygons	`OUTPUT`	[vector: polygon]	像素范围的结果多边形层

Python代码

Algorithm ID ： native:pixelstopolygons

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。

27.1.16.17. 正规点 

创建一个新的点图层，将其点放置在给定范围内的规则栅格中。

栅格由点之间的间距(所有尺寸的间距相同)或要生成的点数指定。在后一种情况下，间距将根据范围确定。为了生成完整的矩形网格，对于后一种情况，至少生成由用户指定的点数。

可以对点间距应用随机偏移量，从而产生非规则的点图案。

Default menu ： Vector ► Research Tools

参数

标签	名字	类型	描述
Input extent (xmin, xmax, ymin, ymax)	`EXTENT`	[extent]	随机点的地图范围可用的方法包括：从Layer…计算：使用当前项目中加载的层的范围从布局地图…计算：使用的范围 layout map item 在激活项目中从书签…计算：使用已保存的数据区 bookmark 使用地图画布范围在画布上绘制：单击并拖动一个矩形，以分隔要考虑的区域将坐标输入为 `xmin, xmax, ymin, ymax`
Point spacing/count	`SPACING`	[number] 默认：100	点之间的间距或点的数量，取决于 `Use point spacing` 是否选中。
Initial inset from corner (LH side)	`INSET`	[number] 默认值：0.0	相对于左上角偏移点。该值同时用于X轴和Y轴。
Apply random offset to point spacing	`RANDOMIZE`	[boolean] 默认：FALSE	如果选中，这些点将具有随机间距
Use point spacing	`IS_SPACING`	[boolean] 默认值：True	如果未选中，则不会考虑点间距
Output layer CRS	`CRS`	[crs] 默认： Project CRS	随机点图层的CRS
Regular points	`OUTPUT`	[vector: point] 默认： `[Create temporary layer]`	指定输出规则点图层。以下选项之一：创建临时层 (`TEMPORARY_OUTPUT` ) 保存到文件… 保存到Geopackage… 保存到数据库表… 还可以在此处更改文件编码。

产出

标签	名字	类型	描述
Regular points	`OUTPUT`	[vector: point]	输出规则点图层。

Python代码

Algorithm ID ： qgis:regularpoints

import processing
processing.run("algorithm_id", {parameter_dictionary})

这个 algorithm id 当您将鼠标悬停在处理工具箱中的算法上时，将显示。这个 parameter dictionary 提供参数名称和值。看见从控制台使用处理算法有关如何从Python控制台运行处理算法的详细信息。