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

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

Иерархически выравнивает соединения и ребра схемы вдоль главной линии.

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

Внимание:

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

Примечание:

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

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

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

• Входной слой схемы сети должен быть либо из инженерной сети или сети трассировки в файловой или мобильной базе геоданных, либо из сервиса схемы сети.

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

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

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

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

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

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

• Рассмотрите возможность применения компоновки в асинхронном режиме на сервере при работе с очень большими схемами.

Параметры

Диалог

Подпись	Описание	Тип данных
Входной слой схемы сети	Схема сети, к которой будет применена компоновка.	Diagram Layer
Сохранить компоновку контейнера (Дополнительный)	Указывает, как алгоритм будет работать с контейнерами. Отмечено – алгоритм компоновки будет применяться к верхнему графу схемы, поэтому контейнеры будут сохранены. Не отмечено – алгоритм компоновки будет применяться к объектам с содержанием и без на схеме. Это значение по умолчанию	Boolean
Направление дерева (Дополнительный)	Определяет направление основной линии. Слева направо—Основная линия будет проведена горизонтально, слева направо. Это значение по умолчанию. Справа налево—Основная линия будет проведена горизонтально, справа налево. Снизу вверх—Основная линия будет проведена вертикально, снизу вверх. Сверху вниз—Основная линия будет проведена вертикально, сверху вниз.	String
Размещение ветвей (Дополнительный)	Указывает способ относительного размещения ветвей, отходящих от основной линии, в соответствии с их направлением. Обе стороны—Ветви располагаются слева и справа от главной линии. Это значение по умолчанию. Слева—Ветви располагаются только слева от главной линии. Справа—Ветви располагаются только справа от главной линии.	String
Значения интервалов, которые принимаются как абсолютные единицы в системе координат схемы (Дополнительный)	Задает, как будут интерпретироваться параметры, представляющие расстояния. Отмечено – алгоритм компоновки будет интерпретировать значения расстояний в линейных единицах. Не отмечено - алгоритм компоновки будет интерпретировать значения расстояний как относительные единицы к установленному среднему размеру соединений в текущем экстенте схемы. Это значение по умолчанию	Boolean
Между соединениями перпендикулярно к направлению (Дополнительный)	Расстояния между соединениями схемы, которые отображаются вдоль оси, перпендикулярно главной линии. По умолчанию используется 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
Запустить в асинхронном режиме на сервере (Дополнительный)	Указывает, будет ли алгоритм компоновки выполняться асинхронно или синхронно на сервере. Отмечено — алгоритм компоновки будет выполняться асинхронно на сервере. Эта опция выделяет ресурсы сервера для запуска алгоритма компоновки с более длительным временем ожидания. Асинхронный запуск рекомендуется при использовании компоновок, на которые затрачивается большое количество времени и возможно превышение времени ожидания сервера (например, компоновки Частично перекрывающиеся ребра), и применении их к большим схемам, содержащим более 25 000 объектов. Не отмечено – алгоритм компоновки будет выполняться синхронно на сервере. Он может завершиться сбоем без завершения, если превышает значение тайм-аута сервиса по умолчанию, равное 600 секундам. Это значение по умолчанию	Boolean
Абсолютный отступ (Дополнительный)	Смещение, которое будет использоваться для разделения перекрывающихся сегментов при использовании абсолютных единиц измерения, когда параметру Тип отображения ребер задано значение Ортогональные ребра. Это значение не может превышать 10 процентов от наименьшего значения, указанного для других параметров интервала. По умолчанию - 0.	Linear Unit
Пропорциональный отступ (Дополнительный)	Смещение, которое будет использоваться для разделения перекрывающихся сегментов при использовании пропорциональных единиц измерения, и если Тип отображения ребер - Ортогональные ребра. Это значение double не может превышать 10 процентов от наименьшего значения, указанного для других параметров интервала. По умолчанию - 0.	Double

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

Подпись	Описание	Тип данных
Выходная схема сети	Обновленный слой схемы сети.	Слой схемы

Python

arcpy.nd.ApplyMainlineTreeLayout(in_network_diagram_layer, {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}, {run_async}, {offset_absolute}, {offset_proportional})

Имя	Описание	Тип данных
in_network_diagram_layer	Схема сети, к которой будет применена компоновка.	Diagram Layer
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.3. Он систематически игнорируется, независимо от своего значения, если задан параметр 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
run_async (Дополнительный)	Указывает, будет ли алгоритм компоновки выполняться асинхронно или синхронно на сервере. RUN_ASYNCHRONOUSLY—Алгоритм компоновки будет выполняться асинхронно на сервере. Эта опция выделяет ресурсы сервера для запуска алгоритма компоновки с более длительным временем ожидания. Асинхронный запуск рекомендуется при использовании компоновок, на которые затрачивается большое количество времени и возможно превышение времени ожидания сервера (например, компоновки Частично перекрывающиеся ребра), и применении их к большим схемам, содержащим более 25 000 объектов. RUN_SYNCHRONOUSLY—Алгоритм компоновки будет выполняться синхронно на сервере. Он может завершиться сбоем без завершения, если превышает значение тайм-аута сервиса по умолчанию, равное 600 секундам. Это значение по умолчанию	Boolean
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_network_diagram_layer	Обновленный слой схемы сети.	Слой схемы

Пример кода

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

Применение алгоритма компоновки Дерево главной линии к схеме Temporary Diagram.

import arcpy
arcpy.ApplyMainlineTreeLayout_nd("Temporary Diagram", "PRESERVE_CONTAINERS", 
                                 "FROM_LEFT_TO_RIGHT", "BOTH_SIDES", 
                                 "ABSOLUTE_UNIT", "100 Feet", "" , "100 Feet", 
                                 "", "200 Feet", "", "", 30, "ORTHOGONAL_EDGES", 
                                 "RUN_SYNCHRONOUSLY", "10 Feet", "")

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

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

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

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