配置查找表 (位置参考)

适用于 Location Referencing 许可。

摘要

为多字段路径 ID 中使用的一个或多个字段配置查找表。

对于多字段路径 ID,此工具可以在根据现有数据集创建 LRS 网络修改 LRS 网络之后运行。

了解有关创建 LRS、网络和事件的详细信息

当构成多字段路径 ID 的字段具有数百或数千个潜在值(例如街道名称列表或地理名称信息系统 (GNIS) 代码)时,查找表是使用编码值域的替代方法。 查找表主要用于创建路径

使用情况

  • 查找表可以配置查找键查找显示参数字段,允许用户使用其显示值搜索键值:

    • Lookup Key 字段为将为多字段路径 ID 中的字段保存的值。
    • Lookup Display 字段为显示在多字段路径 ID 的文本框中的值。

  • 字段应用于参数下拉菜单将仅显示所选 LRS 网络要素类中多字段路径 ID 包含的字段。

    注:

    查找表字段参数值将作为字段和多字段路径 ID 的一部分保存在地理数据库中。

    Lookup KeyLookup Display 字段可以是查找表中的相同或不同字段。

    查找键参数下拉菜单将仅显示符合以下条件的字段:查找表中具有相同字段类型,且长度小于或等于应用的字段参数下拉菜单中选择的路径字段。

  • 查找显示参数值是可选的。 如果要允许查找表中未包含的值,则不能配置查找显示参数。

  • Location Referencing 仅读取查找表;它不会向表中添加记录。 如果所需的值不存在,则可以使用此工具将其添加到查找表中。

  • 如果为字段配置了填充,且 Lookup Key 字段值小于字段长度,则会添加填充。

  • 每个 LRS 网络只能配置一个查找表。

  • 如果查找表位于多用户地理数据库中,则该表应为非版本化的表。

参数

标注说明数据类型
LRS 网络要素类

将在其中配置查找表的输入 LRS 网络要素类。 网络必须具有多字段路径 ID。

Feature Layer
查找表

包含街道名称及其对应 GNIS 代码列表的表。 它可以是独立表或位于 SDE 中。

Table View
应用的字段

将在其中配置查找表的 LRS 网络中的路径 ID 字段。

String
查找键

查找表中的键字段。

String
查找显示
(可选)

查找表描述字段。 此字段将显示在多字段路径 ID 的文本框中。

String
允许任何查找值
(可选)

指定是否可以添加不在查找表中的值。 选中此选项时,无法配置查找显示参数。

  • 选中 - 允许在表中不存在值时配置值。
  • 未选中 - 不允许配置查找显示值。 这是默认设置。
Boolean

派生输出

标注说明数据类型
输出网络要素类

已配置查找表的更新路径网络要素类。

Feature Layer

arcpy.locref.ConfigureLookupTable(in_feature_class, lookup_table, field_applied_to, lookup_key, {lookup_display}, {allow_any_lookup_value})
名称说明数据类型
in_feature_class

将在其中配置查找表的输入 LRS 网络要素类。 网络必须具有多字段路径 ID。

Feature Layer
lookup_table

包含街道名称及其对应 GNIS 代码列表的表。 它可以是独立表或位于 SDE 中。

Table View
field_applied_to

将在其中配置 lookup_table 的 LRS 网络中的路径 ID 字段。

String
lookup_key

lookup_table 中的键字段。

String
lookup_display
(可选)

lookup_table 描述字段。 此字段将显示在多字段路径 ID 的文本框中。

String
allow_any_lookup_value
(可选)

指定是否可以添加不在查找表中的值。 选中此选项时,无法配置 lookup_display 参数。

  • DO_NOT_ALLOW_ANY_VALUE允许在表中不存在值时配置值。
  • ALLOW_ANY_VALUE不允许配置查找显示值。 这是默认设置。
Boolean

派生输出

名称说明数据类型
out_feature_class

已配置查找表的更新路径网络要素类。

Feature Layer

代码示例

ConfigureLookupTable 示例 1(Python 窗口)

演示了如何在 Python 窗口中使用 ConfigureLookupTable 工具。

# Name: Configure_Lookup_Table.py
# Description: Configures a Lookup Table outside of database.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
LRS_Network = r"C:\RH_Data.gdb\LRS\StateLog"
Table = r"C:\Data\cityCodeLookup.dbf"

# Execute the tool
arcpy.locref.ConfigureLookupTable(LRS_Network, Table, "CITY_CODE", "CODE", "DESC_LOOKU", "DO_NOT_ALLOW_ANY_VALUE")

# Check in license
arcpy.CheckInExtension('LocationReferencing')
ConfigureLookupTable 示例 2(独立脚本)

演示如何使用 ConfigureLookupTable 工具作为独立 Python 脚本。

# Name: Configure_Lookup_Table.py
# Description: Configures a Lookup Table present in the same database.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Set LRS network and table
LRS_Network = r"C:\RH_Data.gdb\LRS\StateLog"
Table = r"C:\RH_Data.gdb\cityCodeLookup"

# Execute the tool
arcpy.locref.ConfigureLookupTable(LRS_Network, Table, "CITY_CODE", "CODE", "DESC_LOOKU", "DO_NOT_ALLOW_ANY_VALUE")

print("Table configured successfully")

# Check in license
arcpy.CheckInExtension('LocationReferencing')

许可信息

  • Basic: 需要 ArcGIS Location Referencing
  • Standard: 需要 ArcGIS Location Referencing
  • Advanced: 需要 ArcGIS Location Referencing

相关主题