Add Point Layer Based Suitability Criteria (Business Analyst)

获得 Business Analyst 许可后可用。

摘要

Adds criteria based on spatial relationships between the input layer and a given point layer.

使用情况

  • The analysis layer can be created by the Make Suitability Analysis Layer tool.

  • The influence for the point can be based on count, a weight, or minimum distance.

  • For weight, a numeric field and Statistics Type must be specified.

  • For minimum distance, the centers of the sites must be specified. The center of the site is used for calculating the distance to the points.

  • Set the influence for each criteria using the Set Criteria Property tool.

参数

标注说明数据类型
Input Suitability Analysis Layer

The Suitability Analysis layer that will be used in the analysis.

Feature Layer
Site Layer ID Field

A field containing unique values for each record within the Suitability Analysis layer.

Field
Point Features

The layer containing point locations to be added as criteria based on spatial relationship to the Suitability Analysis layer.

Feature Layer
Criteria Type

Defines the type of spatial relationship to be used as criteria.

  • CountA count of points that fall within each Suitability Analysis layer polygon. This is the default.
  • WeightCalculates field-weighted criteria of points that fall within each Suitability Analysis polygon based on the user-selected statistical type.
  • Minimal DistanceAdds distance from the closest point to each of the Suitability Analysis layer centroids as criteria.
String
Distance Type
(可选)

Defines how minimal distance is calculated based on method of travel.

String
Measure Units
(可选)

Defines the type of distance measuring units to be used when calculating minimal distance.

String
Site Centers Features
(可选)

The point layer that will be used as site centers. This point layer will replace default polygon centroids of the Suitability Analysis layer.

Feature Layer
Site Centers Layer ID Field
(可选)

A field existing within the Site Centers Features parameter that uniquely identifies each record.

Field
Weight Field

Numeric fields that exist within a point layer that can be selected for weighting.

Field
Statistics Type
(可选)

The type of statistical operation to be applied to the weighted field.

  • SumCalculates the total of the field values in each point feature.
  • AverageDetermines the average field value in each point feature.
  • Standard DeviationCalculates the standard deviation of the field values in each point feature.
  • MinimumDetermines the smallest field value in each point feature.
  • MaximumDetermines the largest field value in each point feature.
String
Cutoff
(可选)

The distance beyond which points will not be considered in the calculation.

Double

派生输出

标注说明数据类型
Output Suitability Analysis Layer

A container for the output layer.

Feature Layer
Output Criteria Name

The name of the criteria that will be added to the Suitability Analysis layer.

String

arcpy.ba.AddPointLayerBasedSuitabilityCriteria(in_analysis_layer, site_layer_id_field, in_point_features, criteria_type, {distance_type}, {units}, {in_site_centers_features}, {site_centers_id_field}, weight_field, {statistics_type}, {cutoff_distance})
名称说明数据类型
in_analysis_layer

The Suitability Analysis layer that will be used in the analysis.

Feature Layer
site_layer_id_field

A field containing unique values for each record within the Suitability Analysis layer.

Field
in_point_features

The layer containing point locations to be added as criteria based on spatial relationship to the Suitability Analysis layer.

Feature Layer
criteria_type

Defines the type of spatial relationship to be used as criteria.

  • COUNTA count of points that fall within each Suitability Analysis layer polygon. This is the default.
  • WEIGHTCalculates field-weighted criteria of points that fall within each Suitability Analysis polygon based on the user-selected statistical type.
  • MINIMAL_DISTANCEAdds distance from the closest point to each of the Suitability Analysis layer centroids as criteria.
String
distance_type
(可选)

Defines how minimal distance is calculated based on method of travel.

String
units
(可选)

Defines the type of distance measuring units to be used when calculating minimal distance.

String
in_site_centers_features
(可选)

The point layer that will be used as site centers. This point layer will replace default polygon centroids of the Suitability Analysis layer.

Feature Layer
site_centers_id_field
(可选)

A field existing within the in_site_centers_features parameter that uniquely identifies each record.

Field
weight_field

Numeric fields that exist within a point layer that can be selected for weighting.

Field
statistics_type
(可选)

The type of statistical operation to be applied to the weighted field.

  • SUMCalculates the total of the field values in each point feature.
  • AVEDetermines the average field value in each point feature.
  • STD_DEVCalculates the standard deviation of the field values in each point feature.
  • MINDetermines the smallest field value in each point feature.
  • MAXDetermines the largest field value in each point feature.
String
cutoff_distance
(可选)

The distance beyond which points will not be considered in the calculation.

Double

派生输出

名称说明数据类型
out_analysis_layer

A container for the output layer.

Feature Layer
out_criteria_name

The name of the criteria that will be added to the Suitability Analysis layer.

String

代码示例

AddPointLayerBasedSuitabilityCriteria example (Python window)

The following Python window script demonstrates how to use the AddPointLayerBasedSuitabilityCriteria tool.

import arcpy
arcpy.ba.AddPointLayerBasedSuitabilityCriteria("Suitability Analysis layer", "OBJECTID", r"Data\Business Data\USA_SHC_2018.gdb\us_shc", "WEIGHT", None, None, None, None, "GLA", "SUM", None)

许可信息

  • Basic: 需要 Business Analyst, ArcGIS Network Analyst 扩展模块
  • Standard: 需要 Business Analyst, ArcGIS Network Analyst 扩展模块
  • Advanced: 需要 Business Analyst, ArcGIS Network Analyst 扩展模块

相关主题