Вычислить поле теоремы о цвете (Картография)

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

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

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

Иллюстрация

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

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

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

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

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

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

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

• Составным объектам можно присвоить только одно значение, поэтому все части составного объекта будут иметь один и тот же цвет при обозначении. Вы можете преобразовать составные объекты в отдельные объекты, чтобы при необходимости каждая часть могла получать разные значения. И наоборот, вы можете объединить отдельные объекты в составные объекты, чтобы при необходимости они гарантированно получили одинаковое значение.

• Инструмент попытается выровнять количество экземпляров каждого уникального значения. Равномерное распределение уникальных значений в пространстве не гарантируется.

Параметры

Диалог

Подпись	Описание	Тип данных
Входные объекты	Входные полигоны, которые будут использовать результаты инструмента для условных обозначений объектов.	Feature Layer
Имя поля (существующего или нового)	Поле, в котором будут храниться результаты инструмента. Каждому объекту будет присвоено целое число от 1 до количества созданных уникальных значений, чтобы гарантировать, что два соседних полигона не будут иметь одинаковое значение. Если поле не существует, оно будет создано, тип данных - короткое целое. Если указано существующее поле, оно должно иметь тип данных короткое целое, длинное целое или большое целое число. Существующие значения будут перезаписаны на результаты инструмента.	Field

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

Подпись	Описание	Тип данных
Выходные объекты	Обновленные входные объекты.	Feature Layer

Python

arcpy.cartography.CalculateColorTheoremField(in_features, field_name)

Имя	Описание	Тип данных
in_features	Входные полигоны, которые будут использовать результаты инструмента для условных обозначений объектов.	Feature Layer
field_name	Поле, в котором будут храниться результаты инструмента. Каждому объекту будет присвоено целое число от 1 до количества созданных уникальных значений, чтобы гарантировать, что два соседних полигона не будут иметь одинаковое значение. Если поле не существует, оно будет создано, тип данных - короткое целое. Если указано существующее поле, оно должно иметь тип данных короткое целое, длинное целое или большое целое число. Существующие значения будут перезаписаны на результаты инструмента.	Field

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

Имя	Описание	Тип данных
out_features	Обновленные входные объекты.	Feature Layer

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.cartography.CalculateColorTheoremField("countries", "color_index")

CalculateColorTheoremField, пример 2 (автономный скрипт)

В следующем автономном скрипте показано использование функции CalculateColorTheoremField.

# Name: CalculateColorTheorem_standalone_script.py
# Description: Populates a number field to use for symbolizing 
# polygons with a small number of colors and ensuring no two adjacent 
# polygons are the same color.

# Import system modules
import arcpy

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

# Set local variables
inPolygonFeatures = "countries"
fieldName = "color_index"

# Execute Calculate Color Theorem Field
arcpy.cartography.CalculateColorTheoremField(inPolygonFeatures, 
                                             fieldName)

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

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

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

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