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.

  • Current Display Extent (Étendue actuellement affichée) Vue cartographique : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active.
  • Extent of a Layer (Étendue d’une couche) Layer : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active.
  • Browse (Parcourir) Parcourir : l’étendue repose sur un jeu de données existant.
  • Intersection of Inputs (Intersection des entrées) Intersecter : l’étendue repose sur l’étendue minimale ou l’étendue d’intersection de toutes les entrées. S’il n’existe aucune intersection entre les entrées, il en résulte une étendue nulle avec uniquement des zéros.
  • Union of Inputs (Union des entrées) Agréger : l’étendue est basée sur l’étendue maximale ou combinée de toutes les entrées.
  • Reset Extent (Réinitialiser l’étendue) Réinitialiser : la valeur par défaut de l’étendue est rétablie.
  • Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active.

    La carte peut utiliser des unités d’affichage différentes

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 commune à 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)