标注 | 说明 | 数据类型 |
输入包含概率栅格 | 定义感兴趣区域中每个位置的包含概率。 位置值的范围必须介于 0(低包含概率)到 1(高包含概率)。 | Raster Layer; Mosaic Layer |
输出点数 | 将创建的采样位置数量。 | Long |
输出点要素类 | 包含所选采样位置及其包含概率的输出要素类。 | Feature Class |
摘要
可基于包含概率创建一组样本点,从而实现空间平衡的样本设计。 该工具通常用于通过建议采样位置来设计监测网络,并且可以使用包含概率栅格来定义对特定位置的偏好。
使用情况
输入概率栅格必须仅包含介于 0 到 1 之间的值。 该值越高,则在样本设计中包含像元的可能性将越大。
研究区域内所有值的包含概率应大于等于 0,而研究区域外的所有区域应具有 Null 值。
包含概率栅格的像元大小将决定生成样本的最高分辨率。 换句话说,该工具创建的点将始终位于栅格像元的中心。 针对包含概率栅格使用较小的像元大小将导致创建点的更多可能位置。
将点、线或面要素转换为栅格(以获得输入概率栅格)时,应考虑以下内容:
- 像元大小(分辨率)应足够精细,能够区分群体中的所有重要要素。 为了实现这一点,可将像元大小设置为小于要素之间最小距离的一半。 可以使用生成邻近表工具来计算此距离。
- 对于线和面要素,应设置像元大小,以便在生成的栅格中充分表示要素(例如蜿蜒的河流)。 例如,您可能无法使用较大的栅格像元大小来表示复杂河流;如果像元大小过大,则可能会对河流的曲线进行平滑。
- 还应考虑在外业定位采样位置的精度。 例如,如果要使用定位精度为 10 米的 GPS 查找位置,则像元大小应为 10 米。
- 请注意包含概率栅格的大小,因为随着像元数量的增加,处理时间也会增加。
为了避免输出呈现空间不平衡,建议采样位置的数量少于包含概率栅格中像元数量的 1%。
-
在随机数生成器环境中,仅支持 Mersenne Twister 选项。 如果选择其他选项,则将使用 Mersenne Twister。
参数
arcpy.management.CreateSpatiallyBalancedPoints(in_probability_raster, number_output_points, out_feature_class)
名称 | 说明 | 数据类型 |
in_probability_raster | 定义感兴趣区域中每个位置的包含概率。 位置值的范围必须介于 0(低包含概率)到 1(高包含概率)。 | Raster Layer; Mosaic Layer |
number_output_points | 将创建的采样位置数量。 | Long |
out_feature_class | 包含所选采样位置及其包含概率的输出要素类。 | Feature Class |
代码示例
基于输入包含概率栅格创建一组空间平衡点。
import arcpy
arcpy.management.CreateSpatiallyBalancedPoints("ca_prob", "10", "outpoints")
基于输入包含概率栅格创建一组空间平衡点。
# Description: This tool generates a set of sample points based on inclusion
# probabilities. The resulting sample design is spatially balanced, meaning
# that the spatial independence between samples is maximized, making the
# design more efficient than sampling the study area at random.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/dmpyexamples/data.gdb/data"
# Set local variables
inProb = "ca_prob"
numberPoints = 10
outPoints = "C:/dmpyexamples/output.gdb/csbp"
# Run CreateSpatiallyBalancedPoints
arcpy.management.CreateSpatiallyBalancedPoints(inProb, numberPoints, outPoints)
许可信息
- Basic: 需要 Geostatistical Analyst
- Standard: 需要 Geostatistical Analyst
- Advanced: 是