Изменить заполнение ID маршрута (Location Referencing)

Доступно с лицензией Location Referencing.

Краткая информация

Изменяет свойства заполнения, пустых значений и длины для полей, являющихся частью ID маршрута с несколькими полями.

Идентификатор маршрута настраивается с помощью трех полей: RouteType, RouteNumber и RampNumber. Примеры настроек заполнения и пустых значений для трех полей показаны ниже.

  • RouteType текстовое поле длиной 3. Максимальное количество вводимых символов — три; однако для некоторых маршрутов в это поле может быть введен один или два символа. Дефис используется как символ заполнения справа.
  • RouteNumber короткий целочисленный тип поля. Поле будет иметь значения от 0 до 99999; 0 используется как символ заполнения слева.
  • RampNumber текстовое поле длиной 7; однако для некоторых маршрутов это поле не будет иметь значения, и его нужно оставить пустым. Символ подчеркивания используется как символ заполнения слева и справа.

Иллюстрация

Пример ввода и вывода для заполнения идентификатора маршрута

Использование

  • Каждое поле в идентификаторе маршрута может иметь укороченную максимальную длину; быть переменной или фиксированной длины; иметь добавленные символы заполнения слева, справа или как слева, так и справа, а также иметь добавленные заполнения в пустое поле. Кроме того, для одного или нескольких полей объединенного идентификатора маршрута можно использовать пустое значение.
  • Идентификатор маршрута для каждой записи будет хранится с включенным заполнением и нулевыми значениями. Каждое отдельное поле, используемое как часть объединенного идентификатора маршрута, будет храниться без каких-либо символов заполнения.

  • Настройки заполнения и пустоты можно изменить после создания сети. Любые маршруты, загруженные и созданные до изменения этих настроек, сохраняются в базе данных как есть. Любой маршрут, загруженный и созданный после изменения настроек, использует эти обновленные настройки при сохранении в базе данных.

  • Изменение длины изменяет только максимальное количество символов, которое ArcGIS Roads and Highways принимает для каждого поля как часть маршрута в сети. Ваши данные по-прежнему должны быть смоделированы в вашей базе геоданных с длиной поля идентификатора маршрута, представляющей собой сумму длин полей, составляющих объединенный идентификатор маршрута.

  • Опция Разрешить значения Null должна быть отмечена, если отмечено Заполнить, если Null.

  • Если для поля разрешены значения null, все поля справа от этого поля также должны допускать значения null. Однако, если отмечена опция Заполнять, если не указано значение, поля справа не обязательно должны допускать пустые значения.

  • Знак номера (#) не поддерживается в качестве заполняющего символа.

Параметры

ПодписьОписаниеТип данных
Класс объектов сети LRS

Входной слой сети идентификатора маршрута с несколькими полями, содержащий поля, которые необходимо изменить, используя заполнения, пустые значения и длину поля.

Feature Layer
Заполнение ID маршрута

Таблица значений, указывающая поле, которое нужно изменить, и соответствующие этому значения заполнения, пустых значений и длины.

  • FieldПоле, которое нужно изменить.
  • LengthЗначение длины поля, которое будет изменено. Длина поля должна быть между 1 и длиной поля базы данных.
  • Variable LengthУказывает, является ли значение Длины переменным или фиксированным значением.
  • Enable PaddingУказывает, поддерживает ли поле заполнение.
  • Padding CharacterСимвол заполнения для поля. По умолчанию это пробел.
  • Padding LocationУказывает, где заполнение должно применяться к значению поля.
    • Слева — добавляет символы заполнения слева от значения поля. Это значение по умолчанию
    • Справа — добавляет символы заполнения справа от значения поля.
    • Слева и справа — добавляет символы заполнения слева и справа от значения поля.
  • Pad if NullУказывает, добавляются ли символы заполнения, если поле имеет значение null.
  • Allow Null ValuesУказывает, поддерживает ли поле значения null.
Value Table

Производные выходные данные

ПодписьОписаниеТип данных
Выходной класс сетевых объектов

Обновленный слой объектов сети.

Feature Layer

arcpy.locref.ModifyRouteIdPadding(in_feature_class, route_id_padding)
ИмяОписаниеТип данных
in_feature_class

Входной слой сети идентификатора маршрута с несколькими полями, содержащий поля, которые необходимо изменить, используя заполнения, пустые значения и длину поля.

Feature Layer
route_id_padding
[route_id_padding,...]

Таблица значений, указывающая поле, которое нужно изменить, и соответствующие этому значения заполнения, пустых значений и длины.

  • FieldПоле, которое нужно изменить.
  • LengthЗначение длины поля, которое будет изменено. Длина поля должна быть между 1 и длиной поля базы данных.
  • Variable LengthУказывает, является ли значение Длины переменным или фиксированным значением.
  • Enable PaddingУказывает, поддерживает ли поле заполнение.
  • Padding CharacterСимвол заполнения для поля. По умолчанию это пробел.
  • Padding LocationУказывает, где заполнение должно применяться к значению поля.
    • Слева — добавляет символы заполнения слева от значения поля. Это значение по умолчанию
    • Справа — добавляет символы заполнения справа от значения поля.
    • Слева и справа — добавляет символы заполнения слева и справа от значения поля.
  • Pad if NullУказывает, добавляются ли символы заполнения, если поле имеет значение null.
  • Allow Null ValuesУказывает, поддерживает ли поле значения null.
Value Table

Производные выходные данные

ИмяОписаниеТип данных
out_feature_class

Обновленный слой объектов сети.

Feature Layer

Пример кода

ModifyRouteIdPadding, пример 1 (окно Python)

Демонстрирует, как использовать инструмент ModifyRouteIdPadding в окне Python.

# 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

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

# 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)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
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
  • Standard: Обязательно ArcGIS Location Referencing
  • Advanced: Обязательно ArcGIS Location Referencing

Связанные разделы