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

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

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

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

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

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

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

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

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

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

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

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

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

    Short

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

    Long

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

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

    Double

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

    Дата

    Отметка

Параметры

ПодписьОписаниеТип данных
Входная инженерная сеть

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

Utility Network; Utility Network Layer
Имя атрибута

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

String
Тип атрибута

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

  • Short (16-разрядное целочисленное)Тип поля будет установлен на short.
  • Long (32-разрядное целочисленное)Тип поля будет установлен на long.
  • Double (64-разрядное с плавающей точкой)Тип поля будет установлен на double.
  • ДатаТип поля будет установлен на date.
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

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.
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: Да

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