Etiqueta | Explicación | Tipo de datos |
Clase de entidad de salida | La ruta y el nombre de la clase de entidad de salida que contiene la cuadrícula en teselas. | Feature Class |
Extensión | La extensión que cubrirá la teselación. Esta puede ser el área que esté visible actualmente, la extensión de un dataset o valores introducidos manualmente.
| Extent |
Tipo de forma (Opcional) | Especifica la forma que se generará.
| String |
Tamaño (Opcional) | El área de cada forma individual que compone la teselación. | Areal Unit |
Referencia espacial (Opcional) | La referencia espacial con la que se proyectará el dataset de salida. Si no se proporciona una referencia espacial, la salida se proyectará en la referencia espacial de la extensión de entrada. Si no hay ninguna referencia espacial, la salida se proyectará en GCS_WGS_1984. | Spatial Reference |
Resolución H3 (Opcional) | Especifica la resolución H3 de los hexágonos. Con cada valor de resolución creciente, el área de los polígonos será uno séptimo del tamaño.
Este parámetro solo está activo cuando el parámetro Tipo de forma se configura como Hexágono H3. | Long |
Resumen
Genera una cuadrícula teselada de entidades poligonales normales para cubrir una determinada extensión. La teselación puede ser de triángulos, cuadrados, rombos, hexágonos, hexágonos H3 o hexágonos transversales.
Ilustración
Uso
Para garantizar que toda la extensión de entrada queda cubierta por la cuadrícula teselada, las entidades de salida se extienden intencionadamente más allá de la extensión de entrada. Esto ocurre porque los bordes de la cuadrícula en teselas no siempre tendrán líneas rectas y podrían generarse espacios si la cuadrícula estuviera limitada por la extensión de entrada.
El campo GRID_ID se agregará a la salida.
Si el valor del parámetro Tipo de forma es hexágono H3, los valores de campo GRID_ID serán un índice jerárquico único para cada celda.
Para todos los demás valores del parámetro Tipo de forma, el campo GRID_ID será un Id. único para cada entidad. El formato de los Id. es A-1, A-2, B-1, B-2, etcétera. Así, se pueden seleccionar fácilmente filas y columnas mediante consultas con la herramienta Seleccionar capa por atributo. Por ejemplo, seleccione todas las entidades de la columna A con GRID_ID like 'A-%' o seleccione todas las entidades de la fila 1 con GRID_ID like '%-1'.
Para generar una cuadrícula en la que se excluyan las entidades de teselación que no intersecan entidades de otro dataset, utilice la herramienta Seleccionar capa por ubicación para seleccionar polígonos de salida que contengan las entidades de origen y utilice la herramienta Copiar entidades para realizar una copia permanente de las entidades de salida seleccionadas en una nueva clase de entidad.
La herramienta genera formas mediante unidades de área. Para determinar el área de una forma en función de la longitud de un lado, utilice una de las siguientes fórmulas para calcular el valor del parámetro Tamaño:
Shape Fórmula Ejemplo Hexágono o Hexágono transversal
Para generar hexágonos con una longitud lateral de 100 metros, especifique el valor del parámetro Tamaño de 25980,76211353316 metros cuadrados (100 elevado a la potencia de 2 multiplicado por 3 multiplicado por la raíz cuadrada de 3 dividido entre 2).
Cuadrado
Para generar cuadrados con una longitud lateral de 100 metros, especifique el valor de parámetro Tamaño de 10.000 metros cuadrados (100 elevado a la potencia de 2).
Rombo
Para generar rombos con una longitud lateral de 100 metros, especifique el valor de parámetro Tamaño de 10.000 metros cuadrados (100 elevado a la potencia de 2).
Triángulo
Para generar triángulos con una longitud lateral de 100 metros, especifique el valor del parámetro Tamaño de 4330,127018922193 metros cuadrados (100 elevado a la potencia de 2 multiplicado por la raíz cuadrada de 3 dividido entre 4).
La opción Hexágono H3 del valor del parámetro Tipo de forma ignora el parámetro Tamaño. El área del hexágono se basará en el valor del parámetro Resolución H3.
Parámetros
arcpy.management.GenerateTessellation(Output_Feature_Class, Extent, {Shape_Type}, {Size}, {Spatial_Reference}, {H3_Resolution})
Nombre | Explicación | Tipo de datos |
Output_Feature_Class | La ruta y el nombre de la clase de entidad de salida que contiene la cuadrícula en teselas. | Feature Class |
Extent | La extensión que cubrirá la teselación. Esta puede ser el área que esté visible actualmente, la extensión de un dataset o valores introducidos manualmente.
| Extent |
Shape_Type (Opcional) | Especifica la forma que se generará.
| String |
Size (Opcional) | El área de cada forma individual que compone la teselación. | Areal Unit |
Spatial_Reference (Opcional) | La referencia espacial con la que se proyectará el dataset de salida. Si no se proporciona una referencia espacial, la salida se proyectará en la referencia espacial de la extensión de entrada. Si no hay ninguna referencia espacial, la salida se proyectará en GCS_WGS_1984. | Spatial Reference |
H3_Resolution (Opcional) | Especifica la resolución H3 de los hexágonos. Con cada valor de resolución creciente, el área de los polígonos será uno séptimo del tamaño.
Este parámetro está habilitado cuando el parámetro Shape_Type tiene el valor H3_HEXAGON. | Long |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función GenerateTessellation de modo inmediato.
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)
El siguiente script de la ventana de Python muestra cómo utilizar la función GenerateTessellation para crear hexágonos 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)
El siguiente script independiente de Python muestra cómo extraer, mediante programación, una extensión de una clase de entidad y cómo utilizar esa extensión para rellenar los parámetros de la función 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)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí