Добавить компоновку Дерево главной линии (Схема сети)

Сводка

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

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

Более подробно об алгоритме компоновки Дерево главной линии

Внимание:

Этот инструмент является инструментом настройки и администрирования.

Примечание:

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

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

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

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

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

  • Чтобы предварительно установить параметры алгоритма компоновки для любой схемы, основанной на шаблоне схемы, снимите флажок с параметра Активный (is_active = "INACTIVE"в Python).

  • Запустите инструмент с включенной опцией Активный (по умолчанию) (is_active = "ACTIVE" в Python), если хотите, чтобы алгоритм компоновки добавился к списку компоновок, он автоматически добавится в конец очереди при создании схемы на основе входного шаблона схемы.

Синтаксис

AddMainlineTreeLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {tree_direction}, {branches_placement}, {is_unit_absolute}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {disjoined_graph_absolute}, {disjoined_graph_proportional}, {are_edges_orthogonal}, {breakpoint_position}, {edge_display_type}, {offset_absolute}, {offset_proportional})
ParameterОбъяснениеТип данных
in_utility_network

Инженерная сеть или сеть трассировки, в которой находится изменяемый шаблон схемы.

Utility Network; Trace Network
template_name

Имя изменяемого шаблона схемы.

String
is_active

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

  • ACTIVEДобавленный алгоритм компоновки будет автоматически запускаться в процессе создания любой схемы, которая основана на параметре template_name. Это значение по умолчанию.В качестве значений параметров, указанные для алгоритма компоновки, используются те, что были применены во время создания схемы. Они также загружаются по умолчанию, когда алгоритм запускается на любых схемах, основанных на входном шаблоне.
  • INACTIVEВсе значения параметров, указанные в текущий момент для добавляемого алгоритма компоновки, будут значениями, которые загружаются по умолчанию, когда алгоритм готовится к запуску на любой схеме, основанной на входном шаблоне.
Boolean
are_containers_preserved
(Дополнительный)

Указывает, как алгоритм будет работать с контейнерами.

  • PRESERVE_CONTAINERS Алгоритм компоновки будет выполняться в верхнем графе схемы, чтобы сохранить контейнеры.
  • IGNORE_CONTAINERSАлгоритм компоновки будет выполняться для объектов схемы с содержимым и без. Это значение по умолчанию.
Boolean
tree_direction
(Дополнительный)

Определяет направление основной линии.

  • FROM_LEFT_TO_RIGHTОсновная линия будет проведена горизонтально, слева направо. Это значение по умолчанию.
  • FROM_RIGHT_TO_LEFTОсновная линия будет проведена горизонтально, справа налево.
  • FROM_BOTTOM_TO_TOPОсновная линия будет проведена вертикально, снизу вверх.
  • FROM_TOP_TO_BOTTOMОсновная линия будет проведена вертикально, сверху вниз.
String
branches_placement
(Дополнительный)

Указывает способ относительного размещения ветвей, отходящих от основной линии, в соответствии с их направлением.

  • BOTH_SIDESВетви располагаются слева и справа от главной линии. Это значение по умолчанию.
  • LEFT_SIDEВетви располагаются только слева от главной линии.
  • RIGHT_SIDEВетви располагаются только справа от главной линии.
String
is_unit_absolute
(Дополнительный)

Задает, как будут интерпретироваться параметры, представляющие расстояния.

  • ABSOLUTE_UNITАлгоритм компоновки будет интерпретировать любые значения расстояний в линейных единицах.
  • PROPORTIONAL_UNITАлгоритм компоновки будет интерпретировать любые значения расстояний как относительные единицы к установленному среднему размеру соединений в текущем экстенте схемы. Это значение по умолчанию.
Boolean
perpendicular_absolute
(Дополнительный)

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

Linear Unit
perpendicular_proportional
(Дополнительный)

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

Double
along_absolute
(Дополнительный)

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

Linear Unit
along_proportional
(Дополнительный)

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

Double
disjoined_graph_absolute
(Дополнительный)

Минимальный отступ, который будет разделять объекты, принадлежащие к разъединенным графам, когда схема содержит такие графы. Этот параметр используется для абсолютных единиц измерения. Значение по умолчанию – 4 единиц в системе координат схемы.

Linear Unit
disjoined_graph_proportional
(Дополнительный)

Минимальный отступ, который будет разделять объекты, принадлежащие к разъединенным графам, когда схема содержит такие графы. Этот параметр используется для пропорциональных единиц измерения. Значение по умолчанию равно 4.

Double
are_edges_orthogonal
(Дополнительный)

Задает, как будут отображаются ребра схемы, связанные с ветвями дерева.

Прежние версии:

В ArcGIS Pro 2.6 параметр отнесен к устаревшим. Он систематически игнорируется, независимо от своего значения, если задан параметр edge_display_type. Однако для сохранения совместимости с ArcGIS Pro 2.1, он остается включенным, если параметр edge_display_type не указан.

  • ORTHOGONAL_EDGESВсе ребра схемы, связанные с ветвями дерева, будут отображаться под прямыми углами.
  • SLANTED_EDGESВсе ребра схемы, связанные с ветвями дерева, не будут отображаться под прямыми углами. Это значение по умолчанию.
Boolean
breakpoint_position
(Дополнительный)

Относительное положение точки перегиба, которая будет вставлена на ребра схемы, если Тип отображения ребер задан как Нормальные ребра (edge_display_type = "REGULAR_EDGES" in Python) или Тип отображения ребер задан как Ортогональные ребра (edge_display_type = "ORTHOGONAL_EDGES" in Python). Значение дается в процентах от 0 до 100.

  • Если у Относительной позиции точки разрыва (%) значение 0, точка разрыва устанавливается в x-координате соединения «От» ребра и в y-координате соединения «К» ребра для горизонтального дерева. Она устанавливается на y-координате соединения «От» ребра и на x-координате соединения «К» ребра для вертикального дерева.
  • Если у Относительной позиции точки разрыва (%) значение 100, точка разрыва не вставляется в на ребра схемы; каждое ребро схемы напрямую соединяет его соединения «От» и «К».
  • Если у Относительной позиции точки разрыва (%) значение N между 0 и 100, точка разрыва устанавливается в N% длины сегмента [XY], где X – это x-координата соединения «От» ребра, а Y – y-координата соединения «К» ребра для горизонтального дерева. Она устанавливается на N% длины сегмента [XY], где Y – это y-координата соединения «От» ребра, а X – это x-координата соединения "К"ребра для вертикального дерева.

Относительное положение двух точек перегиба, которые будут вставлены на ребрах схемы для вычисления геометрии изогнутых ребер, если для Типа отображения ребер задано значение Изогнутые ребра (edge_display_type = "CURVED_EDGES" в Python). Значение дается в процентах от 15 до 40. При значении Связанного местоположения точки разрыва (%) N между 15 и 40:

  • X -– это x-координата соединения «От» ребра, а Y – y-координата соединения «К» ребра для горизонтального дерева:
    • Первая точка изгиба будет расположена на расстоянии N% длины сегмента [XY].
    • Вторая точка изгиба будет расположена на расстоянии (100 – N)% длины сегмента [XY].
  • Y – это y-координата соединения «От» ребра, а X -– x-координата соединения «К» ребра для вертикального дерева:
    • Первая точка изгиба будет расположена на расстоянии N% длины сегмента [YX].
    • Вторая точка изгиба будет расположена на расстоянии (100 – N)% длины сегмента [XY].

Примечание:

Указанная выше концепция соединений «От» и «До» связана с направлением дерева; это не относится к реальной топологии объекта в сети.

Double
edge_display_type
(Дополнительный)

Задает тип отображения ребер схемы, связанных с ветвями дерева.

  • REGULAR_EDGESВсе ребра схемы, связанные с ветвями дерева, не будут отображаться под прямыми углами. Это значение по умолчанию.
  • ORTHOGONAL_EDGESВсе ребра схемы, связанные с ветвями дерева, будут отображаться под прямыми углами.
  • CURVED_EDGESВсе ребра схемы, связанные с ветвями дерева, будут отображаться под изогнутыми.
String
offset_absolute
(Дополнительный)

Смещение, используемое для разделения перекрывающихся сегментов, когда заданы is_unit_absolute = "ABSOLUTE_UNIT" и edge_display_type = "ORTHOGONAL_EDGES". Это значение не может превышать 10 процентов от наименьшего значения, указанного для других параметров интервала. Значение по умолчанию равно 0.

Linear Unit
offset_proportional
(Дополнительный)

Смещение, используемое для разделения перекрывающихся сегментов, когда заданы is_unit_absolute = "PROPORTIONAL_UNIT" и edge_display_type = "ORTHOGONAL_EDGES". Это значение double не может превышать 10 процентов от наименьшего значения, указанного для других параметров интервала. Значение по умолчанию равно 0.

Double

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

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

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

Инженерная сеть; Трассировка сети
out_template_name

Имя шаблона схемы.

Строковое

Пример кода

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

В этом примере алгоритм компоновки Дерево главной линии добавляется как автоматическая компоновка в шаблон MyTemplate1, существующий для заданной инженерной сети.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddMainlineTreeLayout_nd(input_Network, input_DiagramTemplate, 
                               "ACTIVE", "PRESERVE_CONTAINERS", 
                               "FROM_LEFT_TO_RIGHT", "BOTH_SIDES", 
                               "ABSOLUTE_UNIT", "100 Feet", "", "100 Feet", "", 
                               "200 Feet", "", "", 30, "ORTHOGONAL_EDGES", 
                               "10 Feet")

Environments

Этот инструмент не использует параметры среды геообработки

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

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

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