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

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

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

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

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

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

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

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

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

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

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

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

  Тип атрибута	Встроенный	Пропорциональный	Может принимать значение NULL	Замена
  Short
  Long				(Только внешний)
  Double
  Date

Параметры

Диалог

Подпись	Описание	Тип данных
Входная инженерная сеть	Входная инженерная сеть, куда будет добавлен сетевой атрибут.	Utility Network; Utility Network Layer
Имя атрибута	Имя атрибута сети, добавляемого с инженерную сеть.	String
Тип атрибута	Определяет тип данных сетевого атрибута. Short (короткое целое)—Тип короткое целое Long (длинное целое)—Тип Long integer Double—Тип двойная точность Date—Тип Date	String
Встроенный (Дополнительный)	Указывает, будет ли сетевой атрибут сохранен в строку. Сетевые атрибуты в строку немного более эффективны, но количество битов для таких атрибутов ограничено 28 на каждую инженерную сеть. Наиболее часто используемые сетевые атрибуты (например, фаза для электрических сетей, давление для газовых и водных сетей) должны сохраняться как встроенные, если это возможно. Размер битов определен параметром домена. Встроенные атрибуты поддерживаются только для целочисленных атрибутов сети. Отмечено – атрибут будет добавлен непосредственно в топологию, и тогда его будет легче извлечь. Не отмечено – атрибут будет храниться во внешней таблице, его вызов потребует обращения к внешней таблице весов. Используется по умолчанию.	Boolean
Пропорциональный (Дополнительный)	Указывает, будет ли сетевой атрибут пропорционально разделен между несколькими ребрами, принадлежащими одному объекту. Сетевые атрибуты со свойством делимости могут быть назначены полям в классах объектов линий или соединений, но только у линейных объектов будет поведение делимости. Например, в случае, если сетевой атрибут – shape_length, и один линейный объект состоит из пяти элементов ребер, и если общая длина этого линейного объекта равна 100 метрам, этот атрибут сети будет распределен между всеми ребрами, по 20 метров на каждое ребро. Распределение значения зависит от распределения процента каждого элемента ребра относительно начальной точки объекта. Отмечено – атрибут сети будет делимым. Не отмечено – атрибут сети не будет делимым. Используется по умолчанию.	Boolean
Имя домена (Дополнительный)	Домен, с которым будет связан новый сетевой атрибут. Этот параметр необходим, если включена опция В строку. Этот домен используется для определения количества бит, которые должны быть выделены для атрибута, записанного в строку. Этот домен по своему типу должен быть доменом кодированных значений. Например, домен LifeCycleStatusDomain (0, Unknown | 1, In-Service | 2, Proposed | 3, Abandoned) содержит четыре записи, то есть для хранения встроенного атрибута требуется 2 бита. Домен кодированных значений должен содержать последовательные значения кодов, начинающиеся с 0.	String
Является перезаписываемым (Дополнительный)	Примечание: Этот параметр не используется, и в текущей версии любое введенное значение будет проигнорировано. Функциональность этого параметра пока находится в разработке и будет реализована в будущих версиях. Определяет, имеет ли данный сетевой атрибут внешнюю таблицу перезаписи, в которой сетевая топология считывает и перезаписывает текущее значение, сохраненное в топологии. Это можно использовать для ввода оперативных данных из внешних систем, например, текущего расположения для электрических сетей или значения давления для газовых сетей. Например, система SCADA производит обновление изменяемых положений Устройства A в перезаписываемой таблице атрибута сети DeviceStatus, которую затем механизм топологии использует для перезаписи текущего значения статуса для Устройства A. Отмечено – перезаписывает текущее значение, хранящееся в топологии. Не отмечено – текущее значение, хранящееся в топологии, не будет перезаписано. Используется по умолчанию.	Boolean
Может принимать значение NULL (Дополнительный)	Определяет, поддерживает ли данный сетевой атрибут значения null. Отмечено – атрибут сети поддерживает значения null. Не отмечено – атрибут сети не поддерживает значения null. Используется по умолчанию.	Boolean
Замена (Дополнительный)	Определяет, может ли данный атрибут сети использоваться в качестве замены. Сетевые атрибуты замены позволяют использовать замененные значения вместо значений битового множества атрибутов сети во время прохождения в операции трассировки. Отмечено – атрибут сети будет использоваться в качестве замены. Не отмечено – атрибут сети не будет использоваться в качестве замены. Используется по умолчанию.	Boolean
Атрибут сети для замены (Дополнительный)	Сетевой атрибут, используемый для замены. Замены являются кодированными на основании числа битов в передаваемом сетевом атрибуте. Атрибут сети должен быть встроенным, с целочисленным типом поля менее и равным 8 битам.	String

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

Подпись	Описание	Тип данных
Обновленная инженерная сеть	Обновленная инженерная сеть	Инженерная сеть

Python

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

Имя	Описание	Тип данных
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

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

Имя	Описание	Тип данных
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: Да