Générer une tessellation (Gestion des données)

Synthèse

Génère une grille tessellée d’entités surfaciques régulières pour couvrir une étendue donnée. La tessellation peut être constituée de triangles, carrés, losanges, hexagones, hexagones H3 ou hexagones transversaux.

Illustration

Illustration de l’outil Générer une tessellation

Utilisation

  • Pour garantir la couverture de la totalité de l’étendue en entrée par la grille tessellée, les entités en sortie sont prolongées au-delà de l’étendue en entrée. Cela se produit car les bords de la grille tessellée ne sent pas toujours des lignes droites et que des interruptions apparaissent si la grille est limitée par l'étendue en entrée.

  • Le champ GRID_ID est ajouté à la sortie.

    Si la valeur du paramètre Type de forme est définie sur Hexagone H3, les valeurs de champ GRID_ID désignent un index hiérarchique unique pour chaque cellule.

    Valeurs de champ GRID_ID pour les hexagones H3 avec une valeur de taille égale à 3

    Pour toutes les autres valeurs du paramètre Type de forme, le champ GRID_ID contient un ID unique pour chaque entité. Le format des ID est A-1, A-2, B-1, B-2, etc. Cela permet de sélectionner facilement des lignes et des colonnes par requête via l’outil Sélectionner une couche par attributs. Sélectionnez, par exemple, toutes les entités de la colonne A avec GRID_ID like 'A-%' ou sélectionnez toutes les entités de la ligne 1 avec GRID_ID like '%-1'.

  • Pour générer une grille qui exclut les entités de tessellation ne présentant aucune intersection avec des entités d’un autre jeu de données, utilisez l’outil Sélectionner une couche par emplacement pour sélectionner des polygones en sortie qui contiennent les entités source et utilisez l’outil Copier des entités pour effectuer une copie permanente des entités en sortie sélectionnées dans une nouvelle classe d’entités.

  • L’outil génère des formes par unités surfaciques. Pour déterminer la surface d’une forme en fonction de la longueur d’un côté, utilisez l’une des formules suivantes pour calculer la valeur du paramètre Taille :

    FormeFormuleExemple

    Hexagone ou Hexagone transversal

    Formule de la surface d’un hexagone

    Pour générer des hexagones avec des côtés de 100 mètres de long, spécifiez la valeur 25 980,76211353316 mètres carrés comme valeur du paramètre Taille (100 élevé à la puissance 2, multiplié par 3, multiplié par la racine carrée de 3, divisé par 2).

    Carré

    Formule de la surface d’un carré

    Pour générer des carrés avec des côtés de 100 mètres de long, spécifiez la valeur 10 000 mètres carrés comme valeur du paramètre Taille (100 élevé à la puissance 2).

    Losange

    Formule de la surface d’un losange

    Pour générer des losanges avec des côtés de 100 mètres de long, spécifiez la valeur 10 000 mètres carrés comme valeur du paramètre Taille (100 élevé à la puissance 2).

    Triangle

    Formule de la surface d’un triangle

    Pour générer des triangles avec des côtés de 100 mètres de long, spécifiez la valeur 4 330,127018922193 mètres carrés comme valeur du paramètre Taille (100 élevé à la puissance 2, multiplié par la racine carrée de 3, divisé par 4).

    L’option Hexagone H3 de la valeur du paramètre Type de forme ignore le paramètre Taille. La surface de l’hexagone repose sur la valeur du paramètre Résolution H3.

    En savoir plus sur les résolutions H3

Paramètres

ÉtiquetteExplicationType de données
Classe d’entités en sortie

Chemin et nom de la classe d'entités en sortie qui contient la grille tessellée.

Feature Class
Étendue

Etendue couverte par la tessellation. Il peut s'agir de la zone actuellement visible, de l'étendue d'un jeu de données ou de valeurs saisies manuellement.

  • Default (Par défaut) : l’étendue repose sur l’étendue maximale de toutes les entrées participantes. Il s’agit de l’option par défaut.
  • Union of Inputs (Union des entrées) : l’étendue est basée sur l’étendue maximale de toutes les entrées.
  • Intersection of inputs (Intersection des entrées) : l’étendue est basée sur la surface minimale commune à toutes les entrées.
  • Current Display Extent (Étendue d’affichage actuelle) : l’étendue correspond à l’affichage visible. Cette option n’est pas disponible lorsque aucune carte n’est active.
  • As Specified Below (Comme spécifié ci-dessous) : l’étendue est basée sur les valeurs d’étendue minimale et maximale indiquées.
  • Browse (Parcourir) : l’étendue repose sur un jeu de données existant.
Extent
Type de forme
(Facultatif)

Spécifie la forme de groupe générée.

  • HexagoneDes entités en forme d’hexagone sont générées. Les côtés supérieur et inférieur de chaque hexagone sont parallèles à l’axe x du système de coordonnées (les côtés supérieur et inférieur sont plats).
  • Hexagone transversalDes entités en forme d’hexagone transversal sont générées. Les côtés droit et gauche de chaque hexagone sont parallèles à l’axe y du système de coordonnées du jeu de données (le bas et le haut sont pointus).
  • CarréDes entités en forme de carré sont générées. Les côtés supérieur et inférieur de chaque carré sont parallèles à l’axe x du système de coordonnées et les côtés droit et gauche sont parallèles à l’axe y du système de coordonnées.
  • LosangeDes entités en forme de losange sont générées. Les côtés de chaque polygone font l’objet d’une rotation de 45 degrés par rapport à l’axe x et l’axe y du système de coordonnées.
  • TriangleDes entités en forme de triangle sont générées. Chaque triangle est un polygone équilatéral régulier à trois côtés.
  • Hexagone H3Des entités en forme d’hexagone sont générées reposant sur le système d’indexation géospatial hiérarchique hexagonal H3.
String
Taille
(Facultatif)

Surface de chaque forme individuelle qui constitue la tessellation.

Areal Unit
Référence spatiale
(Facultatif)

Référence spatiale sur laquelle le jeu de données en sortie est projeté. Si aucune référence spatiale n'est fournie, la sortie sera projetée sur la référence spatiale de l'étendue en entrée. En l’absence de référence spatiale, la sortie est projetée dans GCS_WGS_1984.

Spatial Reference
Résolution H3
(Facultatif)

Spécifie la résolution H3 des hexagones.

À chaque augmentation de la valeur de la résolution, la surface des polygones est divisée par sept.

  • 0 - Les hexagones sont créés à une résolution H3 de 0, avec une surface moyenne de 4 357 449,416078381 kilomètres carrés.
  • 1 - Les hexagones sont créés à une résolution H3 d’1, avec une surface moyenne de 609 788,441794133 kilomètres carrés.
  • 2 - Les hexagones sont créés à une résolution H3 de 2, avec une surface moyenne de 86 801,780398997 kilomètres carrés.
  • 3 - Les hexagones sont créés à une résolution H3 de 3, avec une surface moyenne de 12 393,434655088 kilomètres carrés.
  • 4 - Les hexagones sont créés à une résolution H3 de 4, avec une surface moyenne de 1 770,347654491 kilomètres carrés.
  • 5 - Les hexagones sont créés à une résolution H3 de 5, avec une surface moyenne de 252,903858182 kilomètres carrés.
  • 6 - Les hexagones sont créés à une résolution H3 de 6, avec une surface moyenne de 36,129062164 kilomètres carrés.
  • 7 - Les hexagones sont créés à une résolution H3 de 7, avec une surface moyenne de 5,161293360 kilomètres carrés. Il s’agit de l’option par défaut.
  • 8 - Les hexagones sont créés à une résolution H3 de 8, avec une surface moyenne de 0,737327598 kilomètre carré.
  • 9 - Les hexagones sont créés à une résolution H3 de 9, avec une surface moyenne de 0,105332513 kilomètre carré.
  • 10 - Les hexagones sont créés à une résolution H3 de 10, avec une surface moyenne de 0,015047502 kilomètre carré.
  • 11 - Les hexagones sont créés à une résolution H3 de 11, avec une surface moyenne de 0,002149643 kilomètre carré.
  • 12 - Les hexagones sont créés à une résolution H3 de 12, avec une surface moyenne de 0,000307092 kilomètre carré.
  • 13 - Les hexagones sont créés à une résolution H3 de 13, avec une surface moyenne de 0,000043870 kilomètre carré.
  • 14 - Les hexagones sont créés à une résolution H3 de 14, avec une surface moyenne de 0,000006267 kilomètre carré.
  • 15 - Les hexagones sont créés à une résolution H3 de 15, avec une surface moyenne de 0,000000895 kilomètre carré.

Ce paramètre est actif si le paramètre Type de forme est défini sur Hexagone H3.

Long

arcpy.management.GenerateTessellation(Output_Feature_Class, Extent, {Shape_Type}, {Size}, {Spatial_Reference}, {H3_Resolution})
NomExplicationType de données
Output_Feature_Class

Chemin et nom de la classe d'entités en sortie qui contient la grille tessellée.

Feature Class
Extent

Etendue couverte par la tessellation. Il peut s'agir de la zone actuellement visible, de l'étendue d'un jeu de données ou de valeurs saisies manuellement.

  • MAXOF : l’étendue maximale de toutes les entrées est utilisée.
  • MINOF : l’étendue minimale de toutes les entrées est utilisée.
  • DISPLAY : l’étendue est égale à l’affichage visible.
  • Nom de la couche : l’étendue de la couche spécifiée est utilisée.
  • Objet Extent : l’étendue de l’objet spécifié est utilisée.
  • Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.
Extent
Shape_Type
(Facultatif)

Spécifie la forme de groupe générée.

  • HEXAGONDes entités en forme d’hexagone sont générées. Les côtés supérieur et inférieur de chaque hexagone sont parallèles à l’axe x du système de coordonnées (les côtés supérieur et inférieur sont plats).
  • TRANSVERSE_HEXAGONDes entités en forme d’hexagone transversal sont générées. Les côtés droit et gauche de chaque hexagone sont parallèles à l’axe y du système de coordonnées du jeu de données (le bas et le haut sont pointus).
  • SQUAREDes entités en forme de carré sont générées. Les côtés supérieur et inférieur de chaque carré sont parallèles à l’axe x du système de coordonnées et les côtés droit et gauche sont parallèles à l’axe y du système de coordonnées.
  • DIAMONDDes entités en forme de losange sont générées. Les côtés de chaque polygone font l’objet d’une rotation de 45 degrés par rapport à l’axe x et l’axe y du système de coordonnées.
  • TRIANGLEDes entités en forme de triangle sont générées. Chaque triangle est un polygone équilatéral régulier à trois côtés.
  • H3_HEXAGONDes entités en forme d’hexagone sont générées reposant sur le système d’indexation géospatial hiérarchique hexagonal H3.
String
Size
(Facultatif)

Surface de chaque forme individuelle qui constitue la tessellation.

Areal Unit
Spatial_Reference
(Facultatif)

Référence spatiale sur laquelle le jeu de données en sortie est projeté. Si aucune référence spatiale n'est fournie, la sortie sera projetée sur la référence spatiale de l'étendue en entrée. En l’absence de référence spatiale, la sortie est projetée dans GCS_WGS_1984.

Spatial Reference
H3_Resolution
(Facultatif)

Spécifie la résolution H3 des hexagones.

À chaque augmentation de la valeur de la résolution, la surface des polygones est divisée par sept.

  • 0 - Les hexagones sont créés à une résolution H3 de 0, avec une surface moyenne de 4 357 449,416078381 kilomètres carrés.
  • 1 - Les hexagones sont créés à une résolution H3 d’1, avec une surface moyenne de 609 788,441794133 kilomètres carrés.
  • 2 - Les hexagones sont créés à une résolution H3 de 2, avec une surface moyenne de 86 801,780398997 kilomètres carrés.
  • 3 - Les hexagones sont créés à une résolution H3 de 3, avec une surface moyenne de 12 393,434655088 kilomètres carrés.
  • 4 - Les hexagones sont créés à une résolution H3 de 4, avec une surface moyenne de 1 770,347654491 kilomètres carrés.
  • 5 - Les hexagones sont créés à une résolution H3 de 5, avec une surface moyenne de 252,903858182 kilomètres carrés.
  • 6 - Les hexagones sont créés à une résolution H3 de 6, avec une surface moyenne de 36,129062164 kilomètres carrés.
  • 7 - Les hexagones sont créés à une résolution H3 de 7, avec une surface moyenne de 5,161293360 kilomètres carrés. Il s’agit de l’option par défaut.
  • 8 - Les hexagones sont créés à une résolution H3 de 8, avec une surface moyenne de 0,737327598 kilomètre carré.
  • 9 - Les hexagones sont créés à une résolution H3 de 9, avec une surface moyenne de 0,105332513 kilomètre carré.
  • 10 - Les hexagones sont créés à une résolution H3 de 10, avec une surface moyenne de 0,015047502 kilomètre carré.
  • 11 - Les hexagones sont créés à une résolution H3 de 11, avec une surface moyenne de 0,002149643 kilomètre carré.
  • 12 - Les hexagones sont créés à une résolution H3 de 12, avec une surface moyenne de 0,000307092 kilomètre carré.
  • 13 - Les hexagones sont créés à une résolution H3 de 13, avec une surface moyenne de 0,000043870 kilomètre carré.
  • 14 - Les hexagones sont créés à une résolution H3 de 14, avec une surface moyenne de 0,000006267 kilomètre carré.
  • 15 - Les hexagones sont créés à une résolution H3 de 15, avec une surface moyenne de 0,000000895 kilomètre carré.

Ce paramètre est activé lorsque le paramètre Shape_Type est défini sur H3_HEXAGON.

Long

Exemple de code

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

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction GenerateTessellation en mode immédiat.

import arcpy
tessellation_extent = arcpy.Extent(0.0, 0.0, 10.0, 10.0)
spatial_ref = arcpy.SpatialReference(4326)
arcpy.management.GenerateTessellation(r"C:\data\project.gdb\hex_tessellation", 
                                      tessellation_extent, "HEXAGON", 
                                      "100 SquareMiles", spatial_ref)
Exemple 2 d’utilisation de l’outil GenerateTessellation (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction GenerateTessellation pour créer des hexagones H3.

# Import modules
import arcpy

# Create some variables
out_gdb = r"C:\temp\project.gdb\h3_hexagon"
extent = arcpy.Extent(0.0, 0.0, 10.0, 10.0)
sr = arcpy.SpatialReference(4326)

# Generate H3 hexagons
arcpy.management.GenerateTessellation(out_gdb, Extent=extent, Shape_Type="H3_HEXAGON",
                                      H3_Resolution=5, Spatial_Reference=sr)
Exemple 3 d’utilisation de l’outil GenerateTessellation (script autonome)

Le script Python autonome ci-dessous illustre l’extraction par programmation d’une étendue à partir d’une classe d’entités et l’utilisation de l’étendue pour spécifier les paramètres de la fonction GenerateTessellation.

# Name: GenerateDynamicTessellation.py
# Purpose: Generate a grid of squares over the envelope of a provided feature 
# class.

# Import modules
import arcpy 

# Set paths of features
my_feature = r"C:\data\project.gdb\myfeature"
output_feature = r"C:\data\project.gdb\sqtessellation"

# Describe the input feature and extract the extent
description = arcpy.Describe(my_feature)
extent = description.extent

# Find the width, height, and linear unit used by the input feature class' extent
# Divide the width and height value by three.
# Multiply the divided values together and specify an area unit from the linear 
# unit.
# Should result in a 4x4 grid covering the extent. (Not 3x3 since the squares 
# hang over the extent.)
w = extent.width
h = extent.height
u = extent.spatialReference.linearUnitName
area = "{size} Square{unit}s".format(size=w/3 * h/3, unit=u)

# Use the extent's spatial reference to project the output
spatial_ref = extent.spatialReference

arcpy.management.GenerateTessellation(output_feature, extent, "SQUARE", area, 
                                      spatial_ref)

Informations de licence

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

Rubriques connexes