Calculer un champ de théorème des couleurs (Cartographie)

Synthèse

Renseigne un champ de type entier à utiliser pour symboliser les polygones avec un faible nombre de couleurs et s’assurer que deux polygones adjacents ne sont pas de la même couleur.

Des valeurs sont attribuées à chaque polygone sur la base du théorème selon lequel seul un petit nombre de couleurs, souvent quatre ou cinq, est nécessaire pour garantir que deux polygones adjacents dans une carte bidimensionnelle ne sont pas de la même couleur. Les polygones superposés et multi-parties peuvent augmenter le nombre de couleurs nécessaires. Les valeurs attribuées sont des entiers compris entre 1 et le nombre de valeurs uniques attribuées.

Illustration

Des valeurs entières sont attribuées à chaque entité et sont utilisées pour symboliser la couche de telle sorte que deux polygones adjacents ne soient pas de la même couleur.

Utilisation

• Cet outil ne génère pas nouvelle sortie. Il modifie l’entrée en attribuant des valeurs entières dans un champ nouveau ou existant qui peut être utilisé dans une symbologie de valeurs uniques pour symboliser les entités.

• Les polygones sont considérés comme adjacents si l’une des conditions suivantes est vraie :

  • Les polygones partagent un segment de bordure comprenant au moins deux sommets.
  • Les polygones se superposent.
  • Les polygones sont séparés par un petit espace vide (par exemple, des îles à proximité).

• Il est possible d’attribuer la même valeur aux polygones qui se touchent en un seul sommet.

• Il est possible d’attribuer la même valeur aux polygones qui sont séparés par un petit espace vide, mais qui ne se touchent pas en fonction de leur forme et de leur proximité.

• Il n’est possible d’attribuer qu’une seule valeur aux entités multi-parties. Une fois symbolisées, toutes les parties d’une entité multi-parties sont donc de la même couleur. Vous pouvez convertir des entités multi-parties en entités individuelles pour attribuer une couleur différente à chaque partie si nécessaire. Inversement, vous pouvez combiner des entités individuelles en entités multi-parties pour leur attribuer la même valeur si nécessaire.

• L’outil tente d’égaliser le nombre d’instances de chaque valeur unique. Il n’est pas garanti que les valeurs uniques soient distribuées de manière homogène dans l’espace.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Polygones en entrée qui utilisent les résultats de l’outil pour symboliser les entités.	Feature Layer
Nom du champ (existant ou nouveau)	Champ destiné à stocker les résultats de l’outil. Un entier compris entre 1 et le nombre de valeurs uniques créées est attribué à chaque entité de telle sorte que deux polygones adjacents n’aient pas de la même valeur. Si le champ n’existe pas, il est créé avec le type de données entier court. Si un champ existant est spécifié, il doit avoir un type de données entier court, long ou très grand. Les valeurs existantes sont écrasées par les résultats de l’outil.	Field

Sortie obtenue

Étiquette	Explication	Type de données
Entités en sortie	Entités en entrée mises à jour.	Feature Layer

Python

arcpy.cartography.CalculateColorTheoremField(in_features, field_name)

Nom	Explication	Type de données
in_features	Polygones en entrée qui utilisent les résultats de l’outil pour symboliser les entités.	Feature Layer
field_name	Champ destiné à stocker les résultats de l’outil. Un entier compris entre 1 et le nombre de valeurs uniques créées est attribué à chaque entité de telle sorte que deux polygones adjacents n’aient pas de la même valeur. Si le champ n’existe pas, il est créé avec le type de données entier court. Si un champ existant est spécifié, il doit avoir un type de données entier court, long ou très grand. Les valeurs existantes sont écrasées par les résultats de l’outil.	Field

Sortie obtenue

Nom	Explication	Type de données
out_features	Entités en entrée mises à jour.	Feature Layer

Exemple de code

Exemple d’utilisation de la fonction CalculateColorTheoremField (fenêtre Python)

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction CalculateColorTheoremField en mode immédiat.

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

Exemple 2 d’utilisation de la fonction CalculateColorTheoremField (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction 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)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Non
• Standard: Oui
• Advanced: Oui