Сводка
Добавляет сетевой атрибут в инженерную сеть.
Сетевой атрибут представляет собой значение, полученное из атрибутов соответствующих объектов в сети и сохраненное в топологии сети. Сетевые атрибуты используются в анализе трассировки для управления возможностью прохождения сети. Хотя сетевой атрибут может быть связан только с одним атрибутом класса объектов, не существует ограничений на количество сетевых атрибутов, которые могут быть в отдельной инженерной сети. Сетевые атрибуты используются как веса для управления проходимостью и моделирования стоимости перемещения в сети.
Использование
Сетевой атрибут может быть связан только с одним атрибутом в классе объектов; однако, он может быть связан с несколькими классами объектов.
При работе с многопользовательской базой геоданных, подключенная учетная учетная запись портала 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 | Определяет тип данных сетевого атрибута.
| String |
is_inline (Дополнительный) | Указывает, будет ли сетевой атрибут сохранен в строку. Сетевые атрибуты в строку немного более эффективны, но количество битов для таких атрибутов ограничено 28 на каждую инженерную сеть. Наиболее часто используемые сетевые атрибуты (например, фаза для электрических сетей, давление для газовых и водных сетей) должны сохраняться как встроенные, если это возможно. Размер битов определен параметром домена. Встроенные атрибуты поддерживаются только для целочисленных атрибутов сети.
| Boolean |
is_apportionable (Дополнительный) | Указывает, будет ли сетевой атрибут пропорционально разделен между несколькими ребрами, принадлежащими одному объекту. Например, в случае, если сетевой атрибут – shape_length, и один линейный объект состоит из пяти элементов ребер, и если общая длина этого линейного объекта равна 100 метрам, этот атрибут сети будет распределен между всеми ребрами, по 20 метров на каждое ребро. Распределение значения зависит от распределения процента каждого элемента ребра относительно начальной точки объекта.
| Boolean |
domain (Дополнительный) | Домен, с которым будет связан новый сетевой атрибут. Это обязательный параметр, когда is_inline соответствует True. Этот домен используется для определения количества бит, которые должны быть выделены для атрибута, записанного в строку. Этот домен по своему типу должен быть доменом кодированных значений. Например, домен LifeCycleStatusDomain (0, Unknown | 1, In-Service | 2, Proposed | 3, Abandoned) содержит четыре записи, то есть для хранения встроенного атрибута требуется 2 бита. Домен кодированных значений должен содержать последовательные значения кодов, начинающиеся с 0. | String |
is_overridable (Дополнительный) | Примечание:Этот параметр не используется, и в текущей версии любое введенное значение будет проигнорировано. Функциональность этого параметра пока находится в разработке и будет реализована в будущих версиях.
| Boolean |
is_nullable (Дополнительный) | Определяет, поддерживает ли данный сетевой атрибут значения null.
| Boolean |
is_substitution (Дополнительный) | Определяет, может ли данный атрибут сети использоваться в качестве замены. Сетевые атрибуты замены позволяют использовать замененные значения вместо значений битового множества атрибутов сети во время прохождения в операции трассировки.
| Boolean |
network_attribute_to_substitute (Дополнительный) | Сетевой атрибут, используемый для замены. Замены являются кодированными на основании числа битов в передаваемом сетевом атрибуте. Атрибут сети должен быть встроенным, с целочисленным типом поля менее и равным 8 битам. | String |
Производные выходные данные
Name | Объяснение | Тип данных |
out_utility_network | Обновленная инженерная сеть | Инженерная сеть |
Пример кода
Добавление сетевого атрибута с именем Device Status и типом короткое целое.
import arcpy
arcpy.AddNetworkAttribute_un("Utility Network", "Device Status", "SHORT",
"INLINE", "NOT_APPORTIONABLE", "",
"ElectricDistributionDeviceStatus",
"NOT_OVERRIDABLE")
Добавление сетевого атрибута для использования в качестве замены.
import arcpy
arcpy.AddNetworkAttribute_un("Utility Network",
"Phases", "LONG", "NOT_INLINE",
"NOT_APPORTIONABLE",
"ElectricDistributionDeviceStatus", "",
"NOT_NULLABLE", "SUBSTITUTION",
"Phases current")
Environments
Информация о лицензиях
- Basic: Нет
- Standard: Да
- Advanced: Да