Calcular campo de teorema de color (Cartografía)

Resumen

Rellena un campo de tipo entero para simbolizar polígonos con una pequeña cantidad de colores y garantizar que no haya dos polígonos adyacentes del mismo color.

Se asignan valores a cada polígono según el teorema de que solo se necesita una pequeña cantidad de colores, generalmente cuatro o cinco, para garantizar que no haya dos polígonos adyacentes en un mapa bidimensional del mismo color. Los polígonos superpuestos y multiparte pueden aumentar la cantidad de colores necesarios. Los valores asignados serán números enteros que van desde 1 hasta el número de valores únicos asignados.

Ilustración

Se asignan valores de tipo entero a cada entidad, que se utilizan para simbolizar la capa de modo que no haya dos polígonos adyacentes del mismo color.

Uso

• Esta herramienta no crea una salida nueva. Modifica la entrada asignando valores enteros a un campo nuevo o existente que se pueden usar en la simbología de valores únicos para simbolizar las entidades.

• Los polígonos se considerarán adyacentes si se cumple alguna de las siguientes condiciones:

  • Los polígonos comparten un segmento de borde compuesto por al menos dos vértices.
  • Los polígonos se superponen.
  • Los polígonos están separados por una pequeña cantidad de espacio vacío (como islas cercanas).

• A los polígonos que se tocan en un solo vértice se les puede asignar el mismo valor.

• A los polígonos que están separados por una pequeña cantidad de espacio vacío, pero que no se tocan, se les puede asignar el mismo valor dependiendo de su forma y proximidad.

• A las entidades multiparte solo se les puede asignar un valor, por lo que todas las partes de una entidad multiparte tendrán el mismo color cuando se simbolicen. Puede convertir entidades multiparte en entidades individuales para permitir que cada parte reciba un valor diferente si es necesario. Por el contrario, puede combinar entidades individuales en entidades multiparte para garantizar que reciban el mismo valor si es necesario.

• La herramienta intentará igualar el número de instancias de cada valor único. No se garantiza una distribución espacialmente uniforme de valores únicos.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de entrada	Los polígonos de entrada que utilizarán los resultados de la herramienta para simbolizar las entidades.	Feature Layer
Nombre de campo (existente o nuevo)	El campo que almacenará los resultados de la herramienta. A cada entidad se le asignará un entero entre 1 y el número de valores únicos creados para garantizar que no haya dos polígonos adyacentes que tengan el mismo valor. Si el campo no existe, este se creará con el tipo de datos entero corto. Si se especifica un campo existente, este debe ser de tipo de datos entero corto, largo o grande. Los valores existentes se sobrescribirán con los resultados de la herramienta.	Field

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidades de salida	Las entidades de entrada actualizadas.	Feature Layer

Python

arcpy.cartography.CalculateColorTheoremField(in_features, field_name)

Nombre	Explicación	Tipo de datos
in_features	Los polígonos de entrada que utilizarán los resultados de la herramienta para simbolizar las entidades.	Feature Layer
field_name	El campo que almacenará los resultados de la herramienta. A cada entidad se le asignará un entero entre 1 y el número de valores únicos creados para garantizar que no haya dos polígonos adyacentes que tengan el mismo valor. Si el campo no existe, este se creará con el tipo de datos entero corto. Si se especifica un campo existente, este debe ser de tipo de datos entero corto, largo o grande. Los valores existentes se sobrescribirán con los resultados de la herramienta.	Field

Salida derivada

Nombre	Explicación	Tipo de datos
out_features	Las entidades de entrada actualizadas.	Feature Layer

Muestra de código

Ejemplo de CalculateColorTheoremField example (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función CalculateColorTheoremField de modo inmediato.

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

Ejemplo 2 de CalculateColorTheoremField (secuencia de comandos independiente)

El siguiente script independiente muestra cómo utilizar la función 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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: No
• Standard: Sí
• Advanced: Sí