描述
通过在地图范围内扩展某一现象（表示为点或线的属性）的已知量，根据点要素或线要素创建密度图。结果是按密度从小到大分类的面图层。
插图
使用方法
对于点输入，每个点应表示某一事件或事件点的位置，结果图层应表示每个单位面积中的事件点计数。新位置中的密度值越高则表示此位置附近的点越多。在多数情况下，可以将结果图层视为未来事件的风险表面。例如，如果输入点表示受到雷击的位置，则可将结果图层视为未来可能受到雷击的风险表面。
对于线输入，线密度表面表示每个位置附近的线总数。所计算的密度值的单位是每单位面积的线长度。例如，如果线表示河流，则结果图层将表示搜索半径范围内的河流总长度。此结果可用于确定适合放牧动物的区域。
此工具的其他用例如下：
- 创建犯罪密度地图以帮助警方适当地将资源分配到高犯罪率区域。
- 计算某县的医院密度。结果图层将显示容易到达医院和不容易到达医院的区域，此信息可用于确定新建医院的位置。
- 根据发生森林火灾的历史位置确定森林火灾的高风险区域。
- 查找距离主干道较远的社区以计划修建新道路的位置。
语法
arcpy.sfa.CalculateDensity(inputLayer, outputName, {field}, {cellSize}, {cellSizeUnits}, {radius}, {radiusUnits}, {boundingPolygonLayer}, {areaUnits}, {classificationType}, {numClasses})| 参数 | 说明 | 数据类型 |
inputLayer | 从中计算密度的点或线要素。 | Feature Set |
outputName | 要在门户中创建的输出图层的名称。 | String |
field （可选） | 用于指定每个位置处的事件点数量的字段。例如，如果您具有表示城市的点，则可以将表示城市人口的字段作为计数字段，得到的人口密度图层将用于计算邻近较多人口城市的较大人口密度。 如果未指定，则假定每个位置代表一个计数。 | Field |
cellSize （可选） | 该值用于创建从中计算密度值的点网格。默认值约为上下文参数中定义的分析范围的宽度和高度中较小者的 1/1000。该值越小，面边界越平滑。相反，该值越大，面边界越粗糙和参差不齐。 | Double |
cellSizeUnits （可选） | 像元大小值的单位。如果已设置像元大小，则必须为其赋值。
| String |
radius （可选） | 用于指定计算密度值时查找点要素或线要素搜索距离的距离。例如，如果您提供的搜索距离是 1,800 米，则输出图层中任意位置的密度将根据距此位置 1,800 米范围内的要素进行计算。在 1,800 米范围内任何不具有事件点的位置得到的密度值将为零。 如果未提供距离，则将根据输入要素的位置和计数字段中的值（如果已提供计数字段）计算默认值。 | Double |
radiusUnits （可选） | 半径值单位。如果已设置半径，则必须为其赋值。
| String |
boundingPolygonLayer （可选） | 用于指定要计算其密度的面的图层。例如，如果您要对湖中鱼的密度进行插值，则可以使用此参数中湖的边界，使输出结果仅在湖的边界内绘制。 | Feature Set |
areaUnits （可选） | 所计算密度值的单位。
| String |
classificationType （可选） | 确定将密度值划分到面的方法。
| String |
numClasses （可选） | 该值用于将预测值范围划分为不同的类。每个类中值的范围由分类类型决定。每个类定义结果面的边界。 默认值为 10，最大值为 32。 | Long |
派生输出
| 名称 | 说明 | 数据类型 |
| outputLayer | 带有已分类密度值的输出面图层。 | 要素集 |
环境
许可信息
- Basic: 需要 Portal for ArcGIS 中的ArcGIS Enterprise 中的帐户有执行分析的权限
- Standard: 需要 Portal for ArcGIS 中的ArcGIS Enterprise 中的帐户有执行分析的权限
- Advanced: 需要 Portal for ArcGIS 中的ArcGIS Enterprise 中的帐户有执行分析的权限