Étiquette | Explication | Type 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.
| Extent |
Type de forme (Facultatif) | Spécifie la forme de groupe générée.
| 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.
Ce paramètre est actif si le paramètre Type de forme est défini sur Hexagone H3. | Long |
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
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.
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 :
Forme Formule Exemple Hexagone ou Hexagone transversal
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é
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
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
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.
Paramètres
arcpy.management.GenerateTessellation(Output_Feature_Class, Extent, {Shape_Type}, {Size}, {Spatial_Reference}, {H3_Resolution})
Nom | Explication | Type 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.
| Extent |
Shape_Type (Facultatif) | Spécifie la forme de groupe générée.
| 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.
Ce paramètre est activé lorsque le paramètre Shape_Type est défini sur H3_HEXAGON. | Long |
Exemple de code
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)
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)
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)
Environnements
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?