Добавить сетевой атрибут (Инженерная сеть)

Сводка

Добавляет сетевой атрибут в инженерную сеть.

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

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

  • Сетевой атрибут может быть связан только с одним атрибутом в классе объектов; однако, он может быть связан с несколькими классами объектов.

  • При работе с многопользовательской базой геоданных, подключенная учетная учетная запись портала ArcGIS Enterprise должна быть записью владельца инженерной сети на портале.

  • Топология сети должна быть отключена.

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

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

  • Этот инструмент может использоваться вместе с инструментом Установить атрибут сети, который используется для назначения сетевого атрибута полю класса объектов в инженерной сети.

  • Следующая таблица содержит список типов сетевых атрибутов и применяющиеся параметры:

    Тип атрибутаВстроенныйПропорциональныйМожет принимать значение NULLЗамена

    Short

    ОтметкаОтметка

    Long

    ОтметкаОтметкаОтметка

    (Только внешний)

    Double

    ОтметкаОтметка

    Date

    Отметка

Синтаксис

arcpy.un.AddNetworkAttribute(in_utility_network, attribute_name, attribute_type, {is_inline}, {is_apportionable}, {domain}, {is_overridable}, {is_nullable}, {is_substitution}, {network_attribute_to_substitute})
ParameterОбъяснениеТип данных
in_utility_network

Входная инженерная сеть, куда будет добавлен сетевой атрибут.

Utility Network; Utility Network Layer
attribute_name

Имя атрибута сети, добавляемого с инженерную сеть.

String
attribute_type

Определяет тип данных сетевого атрибута.

  • SHORTТип короткое целое
  • LONGТип Long integer
  • DOUBLEТип двойная точность
  • DATEТип Date
String
is_inline
(Дополнительный)

Указывает, будет ли сетевой атрибут сохранен в строку. Сетевые атрибуты в строку немного более эффективны, но количество битов для таких атрибутов ограничено 28 на каждую инженерную сеть. Наиболее часто используемые сетевые атрибуты (например, фаза для электрических сетей, давление для газовых и водных сетей) должны сохраняться как встроенные, если это возможно. Размер битов определен параметром домена. Встроенные атрибуты поддерживаются только для целочисленных атрибутов сети.

  • INLINEАтрибут будет добавлен непосредственно в топологию, и тогда его будет легче извлечь.
  • NOT_INLINEАтрибут будет храниться во внешней таблице, его вызов потребует обращения к внешней таблице весов. Используется по умолчанию.
Boolean
is_apportionable
(Дополнительный)

Указывает, будет ли сетевой атрибут пропорционально разделен между несколькими ребрами, принадлежащими одному объекту.

Например, в случае, если сетевой атрибут – shape_length, и один линейный объект состоит из пяти элементов ребер, и если общая длина этого линейного объекта равна 100 метрам, этот атрибут сети будет распределен между всеми ребрами, по 20 метров на каждое ребро. Распределение значения зависит от распределения процента каждого элемента ребра относительно начальной точки объекта.

  • APPORTIONABLEАтрибут сети будет делимым.
  • NOT_APPORTIONABLEАтрибут сети не будет делимым. Используется по умолчанию.
Boolean
domain
(Дополнительный)

Домен, с которым будет связан новый сетевой атрибут. Это обязательный параметр, когда is_inline соответствует True. Этот домен используется для определения количества бит, которые должны быть выделены для атрибута, записанного в строку. Этот домен по своему типу должен быть доменом кодированных значений. Например, домен LifeCycleStatusDomain (0, Unknown | 1, In-Service | 2, Proposed | 3, Abandoned) содержит четыре записи, то есть для хранения встроенного атрибута требуется 2 бита. Домен кодированных значений должен содержать последовательные значения кодов, начинающиеся с 0.

String
is_overridable
(Дополнительный)

Примечание:

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

Определяет, имеет ли данный сетевой атрибут внешнюю таблицу перезаписи, в которой сетевая топология считывает и перезаписывает текущее значение, сохраненное в топологии. Это можно использовать для ввода оперативных данных из внешних систем, например, текущего расположения для электрических сетей или значения давления для газовых сетей. Например, система SCADA производит обновление изменяемых положений Устройства A в перезаписываемой таблице атрибута сети DeviceStatus, которую затем механизм топологии использует для перезаписи текущего значения статуса для Устройства A.

  • OVERRIDEПерезаписывает текущее значение, хранящееся в топологии.
  • NOT_OVERRIDABLEТекущее значение, хранящееся в топологии, не будет перезаписано. Это значение используется по умолчанию.
Boolean
is_nullable
(Дополнительный)

Определяет, поддерживает ли данный сетевой атрибут значения null.

  • NULLABLEАтрибут сети поддерживает значения null.
  • NOT_NULLABLEАтрибут сети не поддерживает значения null. Используется по умолчанию.
Boolean
is_substitution
(Дополнительный)

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

  • SUBSTITUTIONАтрибут сети будет использоваться в качестве замены.
  • NOT_SUBSTITUTIONАтрибут сети не будет использоваться в качестве замены. Используется по умолчанию.
Boolean
network_attribute_to_substitute
(Дополнительный)

Сетевой атрибут, используемый для замены. Замены являются кодированными на основании числа битов в передаваемом сетевом атрибуте. Атрибут сети должен быть встроенным, с целочисленным типом поля менее и равным 8 битам.

String

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

NameОбъяснениеТип данных
out_utility_network

Обновленная инженерная сеть

Инженерная сеть

Пример кода

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

Добавление сетевого атрибута с именем Device Status и типом короткое целое.

import arcpy
arcpy.AddNetworkAttribute_un("Utility Network", "Device Status", "SHORT", 
                             "INLINE", "NOT_APPORTIONABLE", "", 
                             "ElectricDistributionDeviceStatus", 
                             "NOT_OVERRIDABLE")
AddNetworkAttribute, пример 2 (окно Python)

Добавление сетевого атрибута для использования в качестве замены.

import arcpy
arcpy.AddNetworkAttribute_un("Utility Network", 
                             "Phases", "LONG", "NOT_INLINE", 
                             "NOT_APPORTIONABLE", 
                             "ElectricDistributionDeviceStatus", "", 
                             "NOT_NULLABLE", "SUBSTITUTION", 
                             "Phases current")

Информация о лицензиях

  • Basic: Нет
  • Standard: Да
  • Advanced: Да

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