Добавить компоновку Развитое дерево (Схема сети)

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

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

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

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

Внимание:

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

Примечание:

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

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

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

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

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

Параметры

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

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

Utility Network; Trace Network
Входной шаблон схемы

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

String
Активный

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

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

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

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

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

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

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

Boolean
Направление дерева
(Дополнительный)

Задает направление дерева.

  • Слева направоДерево отображается слева направо. Это значение по умолчанию.
  • Справа налевоДерево отображается справа налево.
  • Снизу вверхДерево отображается снизу вверх.
  • Сверху внизДерево отображается сверху вниз.
String
Значения интервалов, которые принимаются как абсолютные единицы в системе координат схемы
(Дополнительный)

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

  • Отмечено – алгоритм компоновки будет интерпретировать значения расстояний в линейных единицах.
  • Не отмечено - алгоритм компоновки будет интерпретировать значения расстояний как относительные единицы к установленному среднему размеру соединений в текущем экстенте схемы. Это значение по умолчанию

Boolean
Между поддеревьями
(Дополнительный)

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

Linear Unit
Между поддеревьями
(Дополнительный)

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

Double
Между соединениями перпендикулярно к направлению
(Дополнительный)

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

Linear Unit
Между соединениями перпендикулярно к направлению
(Дополнительный)

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

Double
Между соединениями вдоль по направлению
(Дополнительный)

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

Linear Unit
Между соединениями вдоль по направлению
(Дополнительный)

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

Double
Между разъединенными диаграммами
(Дополнительный)

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

Linear Unit
Между разъединенными диаграммами
(Дополнительный)

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

Double
Под прямым углом к краям изображения
(Дополнительный)
Boolean
Относительное местоположение точки разрыва (%)
(Дополнительный)

Относительное положение точки перегиба, которая будет вставлена на ребра схемы, если Тип отображения ребер задан как Нормальные ребра (edge_display_type = "REGULAR_EDGES" в Python) или Тип отображения ребер задан как Ортогональные ребра (edge_display_type = "ORTHOGONAL_EDGES" в 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
Тип отображения ребер
(Дополнительный)

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

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

Смещение, которое будет использоваться для разделения перекрывающихся сегментов при использовании абсолютных единиц измерения, и если Тип отображения ребер - Ортогональные ребра. Это значение не может превышать 10 процентов от наименьшего значения, указанного для других параметров интервала. По умолчанию - 0.

Linear Unit
Пропорциональный отступ
(Дополнительный)

Смещение, которое будет использоваться для разделения перекрывающихся сегментов при использовании пропорциональных единиц измерения, и если Тип отображения ребер - Ортогональные ребра. Это значение double не может превышать 10 процентов от наименьшего значения, указанного для других параметров интервала. По умолчанию - 0.

Double

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

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

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

Инженерная сеть; Трассировка сети
Выходной шаблон схемы

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

Строковое

arcpy.nd.AddSmartTreeLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {tree_direction}, {is_unit_absolute}, {subtree_absolute}, {subtree_proportional}, {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})
ИмяОписаниеТип данных
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
is_unit_absolute
(Дополнительный)

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

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

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

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

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

Double
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 3.1. Он систематически игнорируется, независимо от своего значения, если задан параметр edge_display_type. Однако для сохранения совместимости с ArcGIS Pro 2.1, он остается включенным, если параметр edge_display_type не указан.

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

Относительное положение точки перегиба, которая будет вставлена на ребра схемы, если Тип отображения ребер задан как Нормальные ребра (edge_display_type = "REGULAR_EDGES" в Python) или Тип отображения ребер задан как Ортогональные ребра (edge_display_type = "ORTHOGONAL_EDGES" в 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

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

ИмяОписаниеТип данных
out_utility_network

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

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

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

Строковое

Пример кода

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

Пример скрипта, который добавляет алгоритм компоновки Развитое дерево в качестве автоматической компоновки шаблона MyTemplate1 в данной сети.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddSmartTreeLayout_nd(input_Network, input_DiagramTemplate, 
                            "ACTIVE", "PRESERVE_CONTAINERS", 
                            "FROM_LEFT_TO_RIGHT", "PROPORTIONAL_UNIT", "", 8, 
                            "", 5, "", 5, "", 15, "", 25, "CURVED_EDGES")

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

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

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

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

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