根据查找表生成范围环 (国防)

摘要

通过基于在查找表中存储的值的中心创建一组同心圆。

旧版本：

此工具已弃用。 此功能已被根据要素生成范围环工具取代。

使用情况

• 范围环类型参数用于确定是根据间隔和环的数量还是最小和最大距离来创建环。 两种范围环类型描述如下：

  • 从间隔生成范围环是指您将指定要创建的环的数量。 第一个环与中心点的距离为您指定的间隔距离，后续各环将与上一环相距相同的距离。
  • 从最小和最大距离生成范围环是指您将指定两个值，最小值和最大值。 将在距中心点指定距离位置为每个值创建一个环。

• 范围环值（间隔或最小和最大距离）必须存储在表中，如下所示：

  • 用于从间隔创建范围环的表必须至少包含一行，其中需包含以下三个字段：
    • 包含查找名称的文本字段，该名称将用于选择包含间隔值和要创建的环数的行。 默认字段名称为 Name。
    • 一个短整型、长整型、双精度型或浮点型字段，其中包含要创建的环的间隔值。 默认字段名称为 Intervals。
    • 一个短整型或长整型字段，其中包含要创建的圆环数目值。 默认字段名称为 Rings。
  • 用于从最小和最大距离创建范围环的表必须至少包含一行，其中需包含以下三个字段：
    • 包含查找名称的文本字段，该名称将用于选择包含要创建的环的最小和最大距离值。 默认字段名称为 Name。
    • 一个短整型、长整型、双精度型或浮点型字段，其中包含要创建的环的最小距离值。 默认字段名称为 Min。
    • 一个短整型、长整型、双精度型或浮点型字段，其中包含要创建的环的最大距离值。 默认字段名称为 Max。

参数

对话框

标注	说明	数据类型
输入要素（中心点）	点要素集用于标识范围环的中心点。 输入必须至少具有一个点。	Feature Set
输入查找表	输入表包含用于创建环的值。	Table
输出要素类（环）	包含环要素的输出要素类。	Feature Class
所选名称	输入查找表中包含最小和最大值或环的数量和间隔的输入值的行。	String
范围环类型	指定用于创建范围环的方法。 间隔—将根据环的数量以及环之间的距离来生成范围环。 这是默认设置。 最小值和最大值—将基于最小距离和最大距离生成范围环。	String
输出要素类（径向） (可选)	包含输出射线要素的要素类。	Feature Class
射线数目 (可选)	要创建的射线数目。	Long
距离单位 (可选)	指定环间隔字段参数或输入表最小范围和输入表最大范围参数的线性测量单位。 米—单位将为米。 这是默认设置。 千米—单位将为千米。 英里—单位将为英里。 海里—单位将为海里。 英尺—单位将为英尺。 美国测量英尺—单位将为美国测量英尺。	String
输入表所选名称字段 (可选)	输入表中包含所选名称值的字段。 默认字段名称为 Name。	Field
输入表最小范围 (可选)	输入表中包含最小范围值的字段。 默认字段名称为 Min。	Field
输入表最大范围 (可选)	输入表中包含最大范围值的字段。 默认字段名称为 Max。	Field
环数字段 (可选)	输入表中包含环数值的字段。 默认字段名称为 Rings。	Field
环间隔字段 (可选)	输入表中包含环间隔值的字段。 默认字段名称为 Interval。	Field

Python

arcpy.defense.GenerateRangeRingsFromTable(in_features, in_table, out_feature_class_rings, lookup_name, range_rings_type, {out_feature_class_radials}, {number_of_radials}, {distance_units}, {lookup_name_field}, {min_range_field}, {max_range_field}, {number_of_rings_field}, {ring_interval_field})

名称	说明	数据类型
in_features	点要素集用于标识范围环的中心点。 输入必须至少具有一个点。	Feature Set
in_table	输入表包含用于创建环的值。	Table
out_feature_class_rings	包含环要素的输出要素类。	Feature Class
lookup_name	in_table 中包含最小和最大值或环的数量和间隔的输入值的行。	String
range_rings_type	指定用于创建范围环的方法。 INTERVAL—将根据环的数量以及环之间的距离来生成范围环。 这是默认设置。 MIN_MAX—将基于最小距离和最大距离生成范围环。	String
out_feature_class_radials (可选)	包含输出射线要素的要素类。	Feature Class
number_of_radials (可选)	要创建的射线数目。	Long
distance_units (可选)	指定 ring_interval_field 参数或 min_range_field 和 max_range_field 参数的线性测量单位。 METERS—单位将为米。 这是默认设置。 KILOMETERS—单位将为千米。 MILES—单位将为英里。 NAUTICAL_MILES—单位将为海里。 FEET—单位将为英尺。 US_SURVEY_FEET—单位将为美国测量英尺。	String
lookup_name_field (可选)	输入表中包含 lookup_name 值的字段。 默认字段名称为 Name。	Field
min_range_field (可选)	输入表中包含最小范围值的字段。 默认字段名称为 Min。	Field
max_range_field (可选)	输入表中包含最大范围值的字段。 默认字段名称为 Max。	Field
number_of_rings_field (可选)	输入表中包含环数值的字段。 默认字段名称为 Rings。	Field
ring_interval_field (可选)	输入表中包含环间隔值的字段。 默认字段名称为 Interval。	Field

代码示例

GenerateRangeRingsFromTable 示例 1（Python 窗口）

以下 Python 窗口脚本演示了如何使用 GenerateRangeRingsFromTable 函数。

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.GenerateRangeRingsFromTable_defense("RLOS_Observers",
                                          "rrInputTable",
                                          "OutputRR",
                                          "M4",
                                          "MIN_MAX")

GenerateRangeRingsFromTable 示例 2（独立脚本）

以下示例将在示例工作流脚本中使用 GenerateRangeRingsFromTable 函数。

# Description: Generate range rings around active airports

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:\Data.gdb"
arcpy.env.overwriteOutput = True

# Select points from airports from input
airports = "Airports"
active = "Active_Airports"
whereClause = "Active = 'Yes'"
arcpy.Select_analysis(airports, active, whereClause)

# Generate Range Rings around selected airports
outputRings = "Rings"
outputRadials = "Radials"
ringType = "MIN_MAX"
distType = "KILOMETERS"
arcpy.GenerateRangeRingsFromTable_defense(active,
                                          "rrInputTable",
                                          outputRings,
                                          "M4",
                                          ringType,
                                          outputRadials,
                                          3,
                                          distType,
                                          "Name",
                                          "Min",
                                          "Max")

环境

输出坐标系, 当前工作空间, 临时工作空间