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

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

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

Иллюстрация

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

Этот инструмент оценивает графические конфликты символов объектов, чтобы определить, какие маркеры будут включены в выходные данные. Экстент символов и базовый масштаб используются вместе друг с другом. Запускайте этот инструмент только после того, как вы закончили настройку оформления символов и убедились, что базовый масштаб соответствует окончательному выходному масштабу.
Система координат по умолчанию для выходных данных совпадает с системой текущего вида карты. Чтобы использовать другую систему координат, воспользуйтесь параметром среды геообработки Картографическая система координат. Когда инструмент запускается в среде сценариев без активной карты, будет использоваться система координат входных объектов.
Во входном слое поддерживаются только варианты Единый символ и Уникальные значения. Настройки сопоставления атрибутов, сохраненные во входном слое, будут соблюдены.
Если указан параметр Сохранить хотя бы один маркер, будет создан файл журнала с входными объектами, для которых был создан один маркер, который в противном случае был бы опущен. Местоположение файла журнала указано в сообщении об описании геообработки.
Точки будут созданы для каждого поддерживаемого слоя маркеров во входных символах. Чтобы гарантировать, что сложные многослойные маркеры обрабатываются как единое целое и создаются в выходных данных как единая точка, сначала создайте символ как точечный и сохраните его в стиле. Затем на вкладке Слои на панели Символы используйте кнопку Стиль в настройках Оформление, чтобы задать символ маркера из этого стиля.
Параметры Метод смещения и Минимальное расстояние маркера доступны, если как минимум, один слой маркеров использует метод случайного размещения. Используйте эти параметры для разрешения конфликтов между перекрывающимися маркерами и сохранения минимального расстояния между ними. Опция Раздвинуть отодвигает маркеры друг от друга до тех пор, пока они не достигнут минимального расстояния, и при необходимости удаляет маркеры, чтобы избежать конфликтов. Опция Перемещать к сетке будет перемещать маркеры, пока они не достигнут минимального расстояния друг от друга, или не достигнут своего исходного расположения в сетке. Опция Перемещать к сетке не приводит к удалению маркеров.

Подпись	Объяснение	Тип данных
Входной слой	Полигональный слой, обозначенный символами размещения маркеров.	Layer
Выходной класс пространственных объектов	Класс точечных объектов, содержащий точки, созданные из маркеров в настройках размещения маркеров входного слоя. Точки будут добавлены на активную карту в виде слоя с применением метода отображения Уникальные символы, использующим символы из входных данных.	Feature Class
Создать мультиточки (Дополнительный)	Задает, будут ли выходные объекты мультиточечными. Отмечено–Для маркеров в каждом входном полигоне будет создан мультиточечный объект. Используется по умолчанию. Не отмечено–Для каждого маркера будет создан точечный объект.	Boolean
Опция Граница (Дополнительный)	Задает, будут ли создаваться выходные точки для входных маркеров, которые пересекают границы полигона. Может пересекать границу–Выходные точки для входных маркеров, пересекающих границы полигона, будут созданы. Используется по умолчанию. Фиксированное расстояние–Выходные точки не будут созданы для входных маркеров, которые находятся на расстоянии от границ полигона, указанном в параметре Расстояние до границы. Значение из поля–Выходные точки не будут созданы для входных маркеров, которые находятся в пределах расстояния от границ полигона, заданном параметром Поле расстояния до границы.	String
Расстояние до границы (Дополнительный)	Минимальное расстояние между символами выходных точек и границами полигона. Этот параметр применяется только в том случае, если для параметра Опция границы задано Фиксированное расстояние. По умолчанию значение равно 0.	Double
Поле расстояния до границы (Дополнительный)	Числовое поле из входных полигонов , которое будет использоваться для определения расстояния до границы. Этот параметр применяется только в том случае, если для параметра Опция Границы задано Значение из поля.	Field
Единицы расстояния до границы (Дополнительный)	Задает линейные единицы измерения, которые будут использоваться со значениями расстояния до границы. Километры–Единицами измерения будут километры. Метры–Единицами измерения будут метры. Дециметры–Единицами измерения будут дециметры. Сантиметры–Единицами измерения будут сантиметры. Миллиметры–Единицами измерения будут миллиметры. Морские мили–Единицами измерения будут морские мили. Сухопутные мили–Единицами измерения будут сухопутные мили. Ярды–Единицами измерения будут ярды. Футы–Единицами измерения будут футы. Геодезические футы США–Единицами измерения будут геодезические футы США. Дюймы–Единицами измерения будут дюймы. Градусы–Единицами измерения будут десятичные градусы. Точки–Единицами измерения будут точки. Используется по умолчанию.	String
Входные слои барьеров (Дополнительный)	Слои, содержащие точечные, линейные или полигональные объекты, являющиеся конфликтующими барьерами для входных маркеров. Маркеры, которые конфликтуют с барьерами, создаваться не будут. Символы слоев барьеров будут учитываться. Столбцы таблицы значений: Barrier Layer–A layer containing points, lines, or polygon features. Barrier Distance–A numeric value specifying the minimum distance between markers and the barrier. This will be ignored if the barrier distance field value is set. The default value is 0. Barrier Distance Field–A numerical field from the barrier layer that will be used as the barrier distance. This will override the barrier distance value. The default value is none. Barrier Distance Unit–The linear unit that will be used for barrier distance values. Kilometers–The unit will be kilometers. Meters–The unit will be meters. Decimeters–The unit will be decimeters. Centimeters–The unit will be centimeters. Millimeters–The unit will be millimeters. Nautical Miles–The unit will be nautical miles. Statute Miles–The unit will be statute miles. Yards–The unit will be yards. Feet–The unit will be feet. Inches–The unit will be inches. Degrees–The unit will be degrees. Points–The unit will be points. This is the default.	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`–Единицами измерения будут футы. `US Survey Feet`–Единицами измерения будут геодезические футы США. `Inches`–Единицами измерения будут дюймы. `Degrees`–Единицами измерения будут десятичные градусы. `Points`–Единицами измерения будут точки. Используется по умолчанию.	String
in_barriers [[barrier_layer, {barrier_distance}, {barrier_distance_field}, {barrier_distance_unit}],...] (Дополнительный)	Слои, содержащие точечные, линейные или полигональные объекты, являющиеся конфликтующими барьерами для входных маркеров. Маркеры, которые конфликтуют с барьерами, создаваться не будут. Символы слоев барьеров будут учитываться. Столбцы таблицы значений: `Barrier Layer`–A layer containing points, lines, or polygon features. `Barrier Distance`–A numeric value specifying the minimum distance between markers and the barrier. This will be ignored if the barrier distance field value is set. The default value is 0. `Barrier Distance Field`–A numerical field from the barrier layer that will be used as the barrier distance. This will override the barrier distance value. The default value is none. `Barrier Distance Unit`–The linear unit that will be used for barrier distance values. `Kilometers`–The unit will be kilometers. `Meters`–The unit will be meters. `Decimeters`–The unit will be decimeters. `Centimeters`–The unit will be centimeters. `Millimeters`–The unit will be millimeters. `NauticalMiles`–The unit will be nautical miles. `StatuteMiles`–The unit will be statute miles. `Yards`–The unit will be yards. `Feet`–The unit will be feet. `Inches`–The unit will be inches. `Degrees`–The unit will be degrees. `Points`–The unit will be points. This is the default.	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: Да