Конвертировать размещение маркеров в точки (Картография)

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

Создает точки из размещения маркера в полигональном объекте с символами.

Иллюстрация

Иллюстрация инструмента Конвертировать размещение маркеров в точки
Символы маркеров, размещенные внутри полигонов, конвертируются в точечные объекты. Точки могут быть смещены, чтобы обеспечить сохранение минимального расстояния между маркерами, и могут быть удалены, чтобы избежать конфликта с границами или объектами барьеров.

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

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

  • Система координат по умолчанию для выходных данных совпадает с системой текущего вида карты. Чтобы использовать другую систему координат, воспользуйтесь параметром среды геообработки Картографическая система координат. Когда инструмент запускается в среде сценариев без активной карты, будет использоваться система координат входных объектов.

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входной слой

Полигональный слой, обозначенный символами размещения маркеров.

Layer
Выходной класс объектов

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

Feature Class
Создание мультиточек
(Дополнительный)

Задает, будут ли выходные объекты мультиточечными.

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

Boolean
Опция Граница
(Дополнительный)

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

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

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

Double
Поле расстояния до границы
(Дополнительный)

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

Field
Единицы расстояния до границы
(Дополнительный)

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

  • КилометрыЕдиницами измерения будут километры.
  • МетрыЕдиницами измерения будут метры.
  • ДециметрыЕдиницами измерения будут дециметры.
  • СантиметрыЕдиницами измерения будут сантиметры.
  • МиллиметрыЕдиницами измерения будут миллиметры.
  • Морские милиЕдиницами измерения будут морские мили.
  • Сухопутные милиЕдиницами измерения будут сухопутные мили.
  • ЯрдыЕдиницами измерения будут ярды.
  • ФутыЕдиницами измерения будут футы.
  • ДюймыЕдиницами измерения будут дюймы.
  • ГрадусыЕдиницами измерения будут десятичные градусы.
  • ТочкиЕдиницами измерения будут точки. Это значение по умолчанию
String
Входные слои барьеров
(Дополнительный)

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

  • Слой барьеров - слой с точечными, линейными или полигональными объектами.
  • Расстояние до барьера — числовое значение, определяющее минимальное расстояние между маркерами и барьером. Игнорируется, если задано значение Поле расстояния до барьера. По умолчанию значение равно 0.
  • Поле расстояния до барьера — числовое поле из слоя барьеров, которое будет использоваться в качестве расстояния до барьера. Имеет приоритет над значением Расстояние до барьера. Значение по умолчанию - <Нет>.
  • Единицы измерения расстояния до барьера — линейная единица измерения, которая будет использоваться для значений расстояния до барьера. Значение по умолчанию - Точки.

Value Table
Сохранить хотя бы один маркер
(Дополнительный)

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

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

Boolean
Метод смещения
(Дополнительный)

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

  • Не перемещатьМаркеры не будут смещаться. Это значение по умолчанию
  • Перемещать к сеткеКонфликтующие маркеры будут перемещены в их исходные точки сетки.
  • РаздвинутьКонфликтующие маркеры будут отодвинуты друг от друга.
String
Минимальное расстояние между маркерами
(Дополнительный)

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

Linear Unit

arcpy.cartography.ConvertMarkerPlacementToPoints(in_layer, out_feature_class, {create_multipoints}, {boundary_option}, {boundary_distance}, {boundary_distance_field}, {boundary_distance_unit}, {in_barriers}, {keep_at_least_one_marker}, {displacement_method}, {minimum_marker_distance})
ИмяОписаниеТип данных
in_layer

Полигональный слой, обозначенный символами размещения маркеров.

Layer
out_feature_class

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

Feature Class
create_multipoints
(Дополнительный)

Задает, будут ли выходные объекты мультиточечными.

  • CREATE_MULTIPOINTSДля маркеров в каждом входном полигоне будет создан мультиточечный объект. Это значение по умолчанию
  • CREATE_POINTSДля каждого маркера будет создан точечный объект.
Boolean
boundary_option
(Дополнительный)

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

  • MAY_CROSS_BOUNDARYВыходные точки для входных маркеров, пересекающих границы полигона, будут созданы. Это значение по умолчанию
  • FIXED_DISTANCEВыходные точки не будут созданы для входных маркеров, которые находятся на расстоянии от границ полигона, указанном в параметре boundary_distance.
  • VALUE_FROM_FIELDВыходные точки не будут созданы для входных маркеров, которые находятся на расстоянии от границ полигона, указанном в параметре boundary_distance_field.
String
boundary_distance
(Дополнительный)

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

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

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

Field
boundary_distance_unit
(Дополнительный)

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

  • KilometersЕдиницами измерения будут километры.
  • MetersЕдиницами измерения будут метры.
  • DecimetersЕдиницами измерения будут дециметры.
  • CentimetersЕдиницами измерения будут сантиметры.
  • MillimetersЕдиницами измерения будут миллиметры.
  • Nautical MilesЕдиницами измерения будут морские мили.
  • Statute MilesЕдиницами измерения будут сухопутные мили.
  • YardsЕдиницами измерения будут ярды.
  • FeetЕдиницами измерения будут футы.
  • InchesЕдиницами измерения будут дюймы.
  • DegreesЕдиницами измерения будут десятичные градусы.
  • PointsЕдиницами измерения будут точки. Это значение по умолчанию
String
in_barriers
[[barrier_layer, {barrier_distance}, {barrier_distance_field}, {barrier_distance_unit}],...]
(Дополнительный)

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

  • barrier_layer - слой с точечными, линейными или полигональными объектами.
  • barrier_distance - числовое значение, определяющее минимальное расстояние между маркерами и барьером. Игнорируется, если задано значение barrier_distance_field. По умолчанию значение равно 0.
  • barrier_distance_field - числовое поле из слоя барьеров, которое будет использоваться в качестве расстояния до барьера. Имеет приоритет над значением barrier_distance. Значение по умолчанию равно <None>.
  • barrier_distance_unit - линейная единица измерения, которая будет использоваться для значений расстояния до барьера. Значение по умолчанию равно Points.

Value Table
keep_at_least_one_marker
(Дополнительный)

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

  • KEEP_AT_LEAST_ONE_MARKERБудет создан один маркер для входных полигонов, когда все маркеры конфликтуют с границами или барьерами.
  • DO_NOT_KEEP_AT_LEAST_ONE_MARKERМаркеры для входных полигонов, когда все маркеры конфликтуют с границами или барьерами, создаваться не будут. Это значение по умолчанию
Boolean
displacement_method
(Дополнительный)

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

  • DO_NOT_DISPLACEМаркеры не будут смещаться. Это значение по умолчанию
  • DISPLACE_TOWARD_GRIDКонфликтующие маркеры будут перемещены в их исходные точки сетки.
  • DISPLACE_APARTКонфликтующие маркеры будут отодвинуты друг от друга.
String
minimum_marker_distance
(Дополнительный)

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

Linear Unit

Пример кода

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

Пример скрипта окна Python для использования функции ConvertMarkerPlacementToPoints в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.env.referenceScale = 5000
arcpy.cartography.ConvertMarkerPlacementToPoints("parks.lyrx", "cartography.gdb/tree_markers")
ConvertMarkerPlacementToPoints, пример 2 (автономный скрипт)

Этот автономный скрипт демонстрирует пример использования функции ConvertMarkerPlacementToPoints.

# Name: ConvertMarkerPlacementToPoints_standalone_script.py
# Description: Converts markers in a marker placement into point features.

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"
env.referenceScale = "5000"

# Set local variables
in_layer = "parks.lyrx"
out_feature_class = "cartography.gdb/tree_markers"
create_multipoints = "CREATE_MULTIPOINTS"
boundary_option = "VALUE_FROM_FIELD"
boundary_distance = ""
boundary_distance_field = "distance"
boundary_distance_unit = "Points"
in_barriers = [["roads.lyrx", 1, "", "Points"],["rivers.lyrx", 0, "distance", "Points"]]
keep_at_least_one_marker = "KEEP_AT_LEAST_ONE_MARKER"
displacement_method = "DISPLACE_APART"
minimum_marker_distance = "2 Points"


arcpy.cartography.ConvertMarkerPlacementToPoints(in_layer,
                                                 out_feature_class,
                                                 create_multipoints,
                                                 boundary_option,
                                                 boundary_distance,
                                                 boundary_distance_field,
                                                 boundary_distance_unit,
                                                 in_barriers,
                                                 keep_at_least_one_marker,
                                                 displacement_method,
                                                 minimum_marker_distance
)

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

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

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