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

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

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

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

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

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

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

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

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

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

Лицензия:

Для использования этого инструмента в многопользовательском развертывании активной учетной записи портала должна быть назначена лицензия с расширением типа пользователя ArcGIS Advanced Editing.

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

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

  Тип атрибута	Встроенный	Делимый	Может содержать значение NULL	Замена
  Short
  Long				(Только внешний)
  Double
  Дата
  Большое целое Примечание: Сетевые атрибуты типа Big Integer поддерживаются Инженерной сетью версии 7 и новее.

Параметры

Диалог

Подпись	Описание	Тип данных
Входная инженерная сеть	Входная инженерная сеть, куда будет добавлен сетевой атрибут.	Utility Network; Utility Network Layer
Имя атрибута	Имя сетевого атрибута, который будет добавлен в инженерную сеть.	String
Тип атрибута	Определяет тип данных сетевого атрибута. Short (16-разрядное целочисленное)—Тип поля будет установлен на short. Long (32-разрядное целочисленное)—Тип поля будет установлен на long. Double (64-разрядное с плавающей точкой)—Тип поля будет установлен на double. Дата—Тип поля будет установлен на date. Big integer (64-разрядное целое число)—Типом поля будет большое целочисленное.	String
Встраиваемый (Дополнительный)	Указывает, будет ли сетевой атрибут сохранен как встроенный. Встроенные сетевые атрибуты немного более эффективны, но количество битов для заданных пользователем встроенных атрибутов ограничено 28 на каждую инженерную сеть. Наиболее часто используемые сетевые атрибуты (например, фаза для электрических сетей, давление для газовых и водных сетей) должны быть встроенные, если это возможно. Размер битов определен параметром домена. Встроенные атрибуты поддерживаются только для целочисленных атрибутов сети (короткое или длинное целое). Отмечено – атрибут будет добавлен непосредственно в топологию, и тогда его будет легче извлечь. Не отмечено – атрибут будет храниться во внешней таблице, его вызов потребует обращения к внешней таблице весов. Это значение по умолчанию	Boolean
Делимый (Дополнительный)	Указывает, будет ли сетевой атрибут пропорционально разделен между несколькими ребрами, принадлежащими одному объекту. Распределенное поведение поддерживается только с сетевыми атрибутами типа double. Сетевые атрибуты со свойством делимости могут быть назначены полям в классах объектов линий или соединений, но только у линейных объектов будет поведение делимости. Например, с сетевым атрибутом shape_length и линейным объектом, состоящим из пяти элементов ребер по 20 футов каждый, в которых общая длина этого линейного объекта составляет 100 футов, атрибут будет распределен по всем ребрам. Например, использование функции в соединенных объектах для вычисления атрибута shape length для этой линии вернет значение 5, поскольку она учитывает каждый отдельный элемент ребра, а не всю линию. Распределение значения зависит от распределения процента каждого элемента ребра относительно начальной точки объекта. Отмечено – атрибут сети будет делимым. Не отмечено – атрибут сети не будет делимым. Это значение по умолчанию	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

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

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

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—Тип поля будет установлен на short. LONG—Тип поля будет установлен на long. DOUBLE—Тип поля будет установлен на double. DATE—Тип поля будет установлен на date. BIGINTEGER—Типом поля будет большое целочисленное.	String
is_inline (Дополнительный)	Указывает, будет ли сетевой атрибут сохранен как встроенный. Встроенные сетевые атрибуты немного более эффективны, но количество битов для заданных пользователем встроенных атрибутов ограничено 28 на каждую инженерную сеть. Наиболее часто используемые сетевые атрибуты (например, фаза для электрических сетей, давление для газовых и водных сетей) должны быть встроенные, если это возможно. Размер битов определен параметром домена. Встроенные атрибуты поддерживаются только для целочисленных атрибутов сети (короткое или длинное целое). INLINE—Атрибут будет добавлен непосредственно в топологию, и тогда его будет легче извлечь. NOT_INLINE—Атрибут будет храниться во внешней таблице, его вызов потребует обращения к внешней таблице весов. Это значение по умолчанию	Boolean
is_apportionable (Дополнительный)	Указывает, будет ли сетевой атрибут пропорционально разделен между несколькими ребрами, принадлежащими одному объекту. Распределенное поведение поддерживается только с сетевыми атрибутами типа double. Сетевые атрибуты со свойством делимости могут быть назначены полям в классах объектов линий или соединений, но только у линейных объектов будет поведение делимости. Например, с сетевым атрибутом shape_length и линейным объектом, состоящим из пяти элементов ребер по 20 футов каждый, в которых общая длина этого линейного объекта составляет 100 футов, атрибут будет распределен по всем ребрам. Например, использование функции в соединенных объектах для вычисления атрибута shape_length для этой линии вернет значение 5, поскольку она учитывает каждый отдельный элемент ребра, а не всю линию. Распределение значения зависит от распределения процента каждого элемента ребра относительно начальной точки объекта. APPORTIONABLE—Атрибут сети будет делимым. NOT_APPORTIONABLE—Атрибут сети не будет делимым. Это значение по умолчанию	Boolean
domain (Дополнительный)	Домен, с которым будет связан новый сетевой атрибут. Это обязательный параметр, если is_inline = "INLINE". Этот домен используется для определения количества бит, которые должны быть выделены для атрибута, записанного в строку. Этот домен по своему типу должен быть доменом кодированных значений. Например, домен 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	Обновленная инженерная сеть	Utility Network

Пример кода

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

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

import arcpy
arcpy.un.AddNetworkAttribute("Utility Network", "Device Status", "SHORT", 
                             "INLINE", "NOT_APPORTIONABLE", "", 
                             "ElectricDistributionDeviceStatus", 
                             "NOT_OVERRIDABLE")

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

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

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

Параметры среды

Текущая рабочая область

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

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