Créer des polygones de Thiessen (Analyse)

Disponible avec une licence Advanced.

Résumé

Crée des polygones de Thiessen à partir d'entités ponctuelles.

Chaque polygone de Thiessen contient uniquement une seule entité ponctuelle en entrée. Tout emplacement dans un polygone de Thiessen est plus proche de son point associé que de toute autre entité ponctuelle en entrée.

Illustration

Utilisation

• Cet outil permet de diviser la surface couverte par les entités ponctuelles en entrée en zones Thiessen ou zones proximales. Ces zones représentent des surfaces complètes dont tout emplacement est plus proche de son point en entrée associé que de tout autre point en entrée.

Approfondissement :

La création de polygones de Thiessen repose sur la base théorique suivante :

• Soit S un ensemble de points dans l'espace de coordonnées ou l'espace Euclidien (x, y), pour tout point p de cet espace, il existe un point de S le plus proche de p, sauf lorsque le point p est équidistant de deux points ou plus de S.
• Un seul polygone proximal (cellule de Voronoï) est défini par l'ensemble des points p les plus proches d'un seul point de S, autrement dit, la surface totale dans laquelle tous les points p sont plus proches d'un point donné de S que de tout autre point de S.

• Les polygones proximaux de Thiessen sont construits de la manière suivante :

  • Tous les points sont triangulés dans un TIN (Triangulated Irregular Network) qui vérifie la condition de Delaunay.
  • Les bissectrices perpendiculaires sont générées pour chaque tronçon de triangle, formant ainsi les tronçons des polygones de Thiessen. Les emplacements où les bissectrices se croisent déterminent les positions des sommets du polygone de Thiessen.

• La limite extérieure de la classe d'entités surfaciques de Thiessen en sortie est l'étendue des entités ponctuelles en entrée plus 10 % supplémentaires. Si l'environnement Etendue est défini sur une fenêtre d'étendue spécifique, cet outil utilise le paramètre d'environnement pour définir sa limite extérieure.

Attention :

Cet outil peut produire des résultats inattendus avec les données d'un système de coordonnées géographiques, puisque la méthode de triangulation de Delaunay utilisée par l'outil convient le mieux aux données dans un système de coordonnées projetées.

Syntaxe

arcpy.analysis.CreateThiessenPolygons(in_features, out_feature_class, {fields_to_copy})

Paramètre	Explication	Type de données
in_features	Entités ponctuelles en entrée à partir desquelles sont générés les polygones de Thiessen.	Feature Layer
out_feature_class	Classe d'entités en sortie contenant les polygones de Thiessen générés à partir des entités ponctuelles en entrée.	Feature Class
fields_to_copy (Facultatif)	Identifie les champs des entités en entrée qui sont transférés vers la classe d'entités en sortie. ONLY_FID —Seul le champ FID des entités en entrée est transféré vers la classe d'entités en sortie. Il s'agit de l'option par défaut. ALL —Tous les champs provenant des entités en entrée sont transférés vers la classe d'entités en sortie.	String

Exemple de code

Exemple d'utilisation de l'outil CreateThiessenPolygons (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil CreateThiessenPolygons en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.CreateThiessenPolygons_analysis("schools", "c:/output/output.gdb/thiessen1", "ALL")

Exemple d'utilisation de l'outil CreateThiessenPolygons 2 (script autonome)

Le script autonome ci-dessous illustre l'utilisation de la fonction CreateThiessenPolygons.

# Name: CreateThiessenPolygons_Example2.py
# Description: Creates Thiessen polygons
 
# Import system modules
#
import arcpy
from arcpy import env
 
# Set environment settings
#
env.workspace = "C:/data/data.gdb"
 
# Set local variables
#
inFeatures = "schools"
outFeatureClass = "c:/output/output.gdb/thiessen1"
outFields = "ALL"
 
# Execute CreateThiessenPolygons
#
arcpy.CreateThiessenPolygons_analysis(inFeatures, outFeatureClass, outFields)

Environnements

Valeur Z en sortie par défaut, Résolution M, Tolérance M, Domaine M en sortie, Domaine XY en sortie, Domaine Z en sortie, Système de coordonnées en sortie, Etendue, Espace de travail courant, Transformations géographiques, Espace de travail temporaire, Valeurs M en sortie, Valeurs Z en sortie, Résolution Z, Tolérance Z, Tolérance XY, Résolution XY

Informations de licence

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