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

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

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

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

Более подробно об алгоритме компоновки Направленная сила

Внимание:

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

Примечание:

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

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

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

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

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

Параметры

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

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

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

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

String
Активный

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

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

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

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

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

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

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

Boolean
Число итераций
(Дополнительный)

Количество итераций для обработки. Значение по умолчанию равно 20.

Long
Коэффициент отталкивания
(Дополнительный)

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

Double
Степень свободы
(Дополнительный)

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

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

Относительное положение двух точек отражения, которые будут вставлены вдоль ребер диаграммы для вычисления геометрии изогнутых ребер, если для Типа отображения ребер задано значение Изогнутые ребра (edges_display_type = "CURVED_EDGES" в Python). Это процент между 15 и 100, значение по умолчанию - 30. Например, при значении Связанного местоположения точки разрыва (%) N между 15 и 40, верно следующее:

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

Примечание:

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

Этот параметр игнорируется, когда Тип отображения ребер задан как Нормальные ребра (edges_display_type = "REGULAR_EDGES" в Python).

Double
Тип отображения ребер
(Дополнительный)

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

  • Нормальные ребраВсе ребра схемы отображаются как прямые линии. Это значение по умолчанию.
  • Изогнутые ребраВсе ребра схемы – кривые.
String

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

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

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

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

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

Строковое

arcpy.nd.AddForceDirectedLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {iterations_number}, {repel_factor}, {degree_freedom}, {breakpoint_position}, {edge_display_type})
ИмяОписаниеТип данных
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
iterations_number
(Дополнительный)

Количество итераций для обработки. Значение по умолчанию равно 20.

Long
repel_factor
(Дополнительный)

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

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

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

  • LOWОбласть для перемещения соединений схемы будет ограниченной. Это значение по умолчанию.
  • HIGHОбласть для перемещения соединений схемы будет большой.
  • MEDIUMОбласть для перемещения соединений схемы будет умеренной.
String
breakpoint_position
(Дополнительный)

Относительное положение двух точек отражения, которые будут вставлены вдоль ребер диаграммы для вычисления геометрии изогнутых ребер, если для Типа отображения ребер задано значение Изогнутые ребра (edges_display_type = "CURVED_EDGES" в Python). Это процент между 15 и 100, значение по умолчанию - 30. Например, при значении Связанного местоположения точки разрыва (%) N между 15 и 40, верно следующее:

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

Примечание:

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

Этот параметр игнорируется, когда Тип отображения ребер задан как Нормальные ребра (edges_display_type = "REGULAR_EDGES" в Python).

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

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

  • REGULAR_EDGESВсе ребра схемы отображаются как прямые линии. Это значение по умолчанию.
  • CURVED_EDGESВсе ребра схемы – кривые.
String

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

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

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

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

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

Строковое

Пример кода

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

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

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddForceDirectedLayout_nd(input_Network, "MyTemplate1", "ACTIVE", 
                                "PRESERVE_CONTAINERS", 20, 1, "LOW", "25", 
                                "CURVED_EDGES")

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

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

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

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

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