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

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

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

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

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

Внимание:

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

Примечание:

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

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

Этот инструмент не поддерживается при работе с сервисом инженерной сети или сети трассировки. Вы должны работать с инженерной сетью или с сетью трассировки в файловой или мобильной базе геоданных, либо с подключением базы данных к инженерной сети или сети трассировки в многопользовательской базе геоданных. При работе с многопользовательской базой геоданных необходимо соблюдать следующие требования:
- Значение параметра Входная сеть должно быть из подключения к базе данных, установленного от имени владельца базы данных инженерной сети или владельца базы данных сети трассировки.
- Учетная запись подключенного портала ArcGIS Enterprise должна быть записью владельца инженерной сети портала или владельца сети трассировки портала.
- Этот инструмент должен быть подключен к версии по умолчанию, которая скорее всего будет общедоступной и незащищенной.
Чтобы предварительно настроить параметры алгоритмов компоновки для любой схемы на основе шаблона схемы, снимите отметку у параметра Активный (is_active = "INACTIVE" в Python).
Запустите инструмент с включенной опцией Активный (is_active = "ACTIVE" в Python), если хотите, чтобы алгоритм компоновки добавился к списку компоновок, он автоматически добавится в конец очереди при создании схемы на основе входного шаблона схемы.

Подпись	Объяснение	Тип данных
Входная сеть	Инженерная сеть или сеть трассировки, в которой будет находиться изменяемый шаблон схемы.	Utility Network; Trace Network
Входной шаблон схемы	Имя шаблона схемы, который будет изменяться.	String
Active	Задает, будет ли алгоритм компоновки автоматически запускаться при создании схем на основе указанного шаблона. Отмечено–Добавленный алгоритм компоновки будет автоматически запускаться во время создания любой схемы на основе входного шаблона. Используется по умолчанию. В качестве значений параметров, указанные для алгоритма компоновки, используются те, что были применены во время создания схемы. Они также загружаются по умолчанию, когда алгоритм запускается на любых схемах, основанных на входном шаблоне. Не отмечено–Все значения параметров, указанные в текущий момент для добавляемого алгоритма компоновки, будут значениями, которые загружаются по умолчанию, когда алгоритм готовится к запуску на любой схеме, основанной на входном шаблоне.	Boolean
Сохранить компоновку контейнера (Дополнительный)	Указывает, как алгоритм компоновки будет работать с контейнерами. Отмечено–Алгоритм компоновки будет применяться к верхнему графу схемы, поэтому компоновки контейнеров будут сохранены. Не отмечено–Алгоритм компоновки будет применяться к объектам с содержанием и без на схеме. Используется по умолчанию.	Boolean
Направление дерева (Дополнительный)	Определяет направление основной линии. Слева направо–Основная линия будет проведена горизонтально, слева направо. Используется по умолчанию. Справа налево–Основная линия будет проведена горизонтально, справа налево. Снизу вверх–Основная линия будет проведена вертикально, снизу вверх. Сверху вниз–Основная линия будет проведена вертикально, сверху вниз.	String
Размещение ветвей (Дополнительный)	Указывает способ относительного размещения ветвей, отходящих от основной линии, в соответствии с их направлением. Обе стороны–Ветви располагаются слева и справа от главной линии. Используется по умолчанию. Слева–Ветви располагаются только слева от главной линии. Справа–Ветви располагаются только справа от главной линии.	String
Значения интервалов, которые принимаются как абсолютные единицы в системе координат схемы (Дополнительный)	Задает, как будут интерпретироваться параметры, представляющие расстояния. Отмечено–Алгоритм компоновки будет интерпретировать значения расстояний в линейных единицах. Не отмечено–Алгоритм компоновки будет интерпретировать значения расстояний как относительные единицы к установленному среднему размеру соединений в текущем экстенте схемы. Используется по умолчанию.	Boolean
Между соединениями перпендикулярно к направлению (Дополнительный)	Расстояния между соединениями схемы, которые отображаются вдоль оси, перпендикулярно главной линии. По умолчанию используется 2 единицы в системе координат схемы. Этот параметр может выражаться только в абсолютных единицах.	Linear Unit
Между соединениями перпендикулярно к направлению (Дополнительный)	Расстояния между соединениями схемы, которые отображаются вдоль оси, перпендикулярно главной линии. Значение по умолчанию равно 2. Этот параметр может выражаться только в относительных единицах.	Double
Между соединениями вдоль по направлению (Дополнительный)	Расстояние между соединениями схемы, которые отображаются вдоль главной линии, а также расстояние между соединениями схемы, которые отображаются вдоль оси, параллельной главной линии. Этот параметр может выражаться только в абсолютных единицах. Значение по умолчанию – 2 единицы в системе координат схемы.	Linear Unit
Между соединениями вдоль по направлению (Дополнительный)	Расстояние между соединениями схемы, которые отображаются вдоль главной линии, а также расстояние между соединениями схемы, отображающимися вдоль оси, параллельной главной линии. Этот параметр может выражаться только в относительных единицах. Значение по умолчанию равно 2.	Double
Между разъединенными схемами (Дополнительный)	Минимальный отступ, который будет разделять объекты, принадлежащие к разъединенным графам, когда схема содержит такие графы. Этот параметр используется для абсолютных единиц измерения. Значение по умолчанию – 4 единиц в системе координат схемы.	Linear Unit
Между разъединенными схемами (Дополнительный)	Минимальный отступ, который будет разделять объекты, принадлежащие к разъединенным графам, когда схема содержит такие графы. Этот параметр может выражаться только в относительных единицах. Значение по умолчанию равно 4.	Double
Под прямым углом к краям изображения (Дополнительный)	Задает, как будут отображаются ребра схемы, связанные с ветвями дерева. Прежние версии: Этот параметр устарел начиная с ArcGIS Pro 3.6. Отображение ветвей дерева теперь контролируется параметром Тип отображения рёбер. Отмечено–Все ребра схемы, связанные с ветвями дерева, будут отображаться под прямыми углами. Не отмечено–Все ребра схемы, связанные с ветвями дерева, не будут отображаться под прямыми углами. Используется по умолчанию.	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

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

Подпись	Объяснение	Тип данных
Выходная сеть	Обновленная инженерная сеть или сеть трассировки.	Utility Network; Trace Network
Выходной шаблон схемы	Имя шаблона схемы.	String

arcpy.nd.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})

Имя	Объяснение	Тип данных
in_utility_network	Инженерная сеть или сеть трассировки, в которой будет находиться изменяемый шаблон схемы.	Utility Network; Trace Network
template_name	Имя шаблона схемы, который будет изменяться.	String
is_active	Задает, будет ли алгоритм компоновки автоматически запускаться при создании схем на основе указанного шаблона. `ACTIVE`–Добавленный алгоритм компоновки будет автоматически запускаться во время создания любой схемы на основе входного шаблона. Используется по умолчанию. В качестве значений параметров, указанные для алгоритма компоновки, используются те, что были применены во время создания схемы. Они также загружаются по умолчанию, когда алгоритм запускается на любых схемах, основанных на входном шаблоне. `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 3.6. Отображение ветвей дерева теперь контролируется параметром `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	Обновленная инженерная сеть или сеть трассировки.	Utility Network; Trace Network
out_template_name	Имя шаблона схемы.	String

Пример кода

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

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

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"

arcpy.nd.AddMainlineTreeLayout(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")

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

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

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

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

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

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

Внимание:

Примечание:

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

Параметры

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

Примечание:

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

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

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

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