修改路径 ID 填充 (位置参考)

适用于 Location Referencing 许可。

摘要

修改属于多字段路径 ID 的字段的填充、空值和长度属性。

路径 ID 通过三个字段配置:RouteTypeRouteNumberRampNumber。 三个字段的示例填充和空值设置如下所示。

  • RouteType 为长度为 3 的文本字段。 最多可输入三个字符;但是,某些路径的此字段可能会输入一个或两个字符。 连字符将用作右侧的填充字符。
  • RouteNumber 为短整型字段类型。 该字段的值范围为 0 到 99999;0 将用作左侧的填充字符。
  • RampNumber 为长度为 7 的文本字段;但是,某些路径的此字段不具有值,需要将其留空。 下划线将用作左右侧的填充字符。

插图

路径 ID 填充的示例输入和输出

使用情况

  • 路径 ID 中的每个字段都可以缩短其最大长度;可以设置为可变长度或固定长度;或者在左侧、右侧或左右两侧添加填充字符,以及在空白字段中添加填充。 此外,空值可用于串连路径 ID 中的一个或多个字段。
  • 每条记录的路径 ID 将与填充和空值一同存储。 作为串连路径 ID 一部分的所有单个字段在存储时不包含填充字符。

  • 创建网络后,可以更改填充和空值设置。 在数据库中存储时,在更改这些设置之前加载和创建的任何路径都将保持原样。 在数据库中存储时,在更改设置后加载和创建的任何路径都将使用这些更新设置。

  • 更改长度只会更改作为网络中路径一部分的每个字段的 ArcGIS Roads and Highways 预期最大字符数。 您的数据仍应在地理数据库中进行建模,路径 ID 字段长度为构成串联路径 ID 的字段长度之和。

  • 如果选中如果为空,则填充复选框,则必须选中允许空值复选框。

  • 如果允许某字段使用空值,则也必须允许该字段右侧的所有字段使用空值。 但是,如果选中如果未提供值,则填充复选框,则右侧的字段不必允许空值。

  • 不支持将数字符号 (#) 作为填充字符。

参数

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

输入多字段路径 ID 网络图层,其中包含需要修改的填充、空值和长度值字段。

Feature Layer
路径 ID 填充

在此值表中指定了要修改的字段及其对应的填充、空值和长度值。

  • Field要修改的字段。
  • Length要修改的字段的长度值。 字段长度应介于 1 和数据库字段的长度之间。
  • Variable Length指定长度值是可变值还是固定值。
  • Enable Padding指定字段是否支持填充。
  • Padding Character字段的填充字符。 默认为空格。
  • Padding Location指定应将填充应用于字段值的位置。
    • 左侧 - 将填充字符添加到字段中值的左侧。 这是默认设置。
    • 右侧 - 将填充字符添加到字段中值的右侧。
    • 左侧和右侧 - 将填充字符添加到字段中值的左右两侧。
  • Pad if Null指定当字段具有空值时是否添加填充字符。
  • Allow Null Values指定字段是否支持空值。
Value Table

派生输出

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

更新的网络要素图层。

Feature Layer

arcpy.locref.ModifyRouteIdPadding(in_feature_class, route_id_padding)
名称说明数据类型
in_feature_class

输入多字段路径 ID 网络图层,其中包含需要修改的填充、空值和长度值字段。

Feature Layer
route_id_padding
[route_id_padding,...]

在此值表中指定了要修改的字段及其对应的填充、空值和长度值。

  • Field要修改的字段。
  • Length要修改的字段的长度值。 字段长度应介于 1 和数据库字段的长度之间。
  • Variable Length指定长度值是可变值还是固定值。
  • Enable Padding指定字段是否支持填充。
  • Padding Character字段的填充字符。 默认为空格。
  • Padding Location指定应将填充应用于字段值的位置。
    • 左侧 - 将填充字符添加到字段中值的左侧。 这是默认设置。
    • 右侧 - 将填充字符添加到字段中值的右侧。
    • 左侧和右侧 - 将填充字符添加到字段中值的左右两侧。
  • Pad if Null指定当字段具有空值时是否添加填充字符。
  • Allow Null Values指定字段是否支持空值。
Value Table

派生输出

名称说明数据类型
out_feature_class

更新的网络要素图层。

Feature Layer

代码示例

ModifyRouteIdPadding 示例 1(Python 窗口)

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

# Name: ModifyRouteIdPadding_inline.py
# Description: Modifies the padding, null, and length properties for fields that are part of a multifield route ID in the Python window.
# Requires: ArcGIS Location Referencing

# Tool variables 
in_feature_class = r"C:\Data\DOT.gdb\LRS\StateRoutes"

## Values format: "Field Length VariableLength EnablePadding PaddingCharacter PaddingLocation PadifNull AllowNullValues;Field2......" 
route_id_padding = "RouteSystem 3 false true @ LEFT false false;RouteNumber 10 true true 0 LEFT true true"

# Set current workspace
arcpy.env.workspace = "C:\Data\DOT.gdb"

# Execute the tool
arcpy.locref.ModifyRouteIdPadding(in_feature_class,route_id_padding)
ModifyRouteIdPadding 示例 2(独立脚本)

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

# Name: ModifyRouteIdPadding_standalone.py
# Description: Modifies the padding, null, and length properties for fields that are part of a multifield route ID in standalone mode.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Set local variables
in_feature_class = r"C:\Data\DOT.gdb\LRS\StateRoutes"

# Values format: "Field Length VariableLength EnablePadding PaddingCharacter PaddingLocation PadifNull AllowNullValues;Field2......" 
route_id_padding = "RouteSystem 3 false true @ LEFT false false;RouteNumber 10 true true 0 LEFT true true"

# Execute the tool
arcpy.locref.ModifyRouteIdPadding(in_feature_class,route_id_padding)

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

许可信息

  • Basic: 需要 ArcGIS Location Referencing(ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways)
  • Standard: 需要 ArcGIS Location Referencing(ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways)
  • Advanced: 需要 ArcGIS Location Referencing(ArcGIS Pipeline Referencing 或 ArcGIS Roads and Highways)

相关主题