Generar teselación (Administración de datos)

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

Ilustración de la herramienta Generar teselació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.

    Valores del campo GRID_ID para hexágonos H3 con un valor de tamaño de 3

    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:

    ShapeFórmulaEjemplo

    Hexágono o Hexágono transversal

    Área de una fórmula de hexágono

    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

    Área de una fórmula de 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

    Área de una fórmula de 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

    Área de una fórmula de 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.

    Más información sobre las resoluciones H3

Parámetros

EtiquetaExplicaciónTipo 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
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.

  • Extensión de visualización actual Vista de mapa: la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo.
  • Extensión de dibujo Cuadrar y terminar: la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa.
    Nota:

    Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta.

    Nota:

    Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión.

  • Extensión de mapa Capa: la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas.

    Cada capa de mapas tiene las opciones siguientes:

    • Todas las entidades Selecciona todo: extensión de todas las entidades en una capa.
    • Entidades seleccionadasÁrea de entidades seleccionadas: extensión de las entidades seleccionadas en la capa.
    • Entidades visibles Extent Indicator: extensión de las entidades visibles en la capa.
      Nota:

      Las extensiones de las opciones Entidades seleccionadas Área de entidades seleccionadas y Entidades visibles Extent Indicator solo están disponibles para capas de entidades.

  • Examinar Examinar: la extensión se basará en un dataset existente.
  • Portapapeles Pegar: la extensión puede copiarse y pegarse desde el portapapeles.
    • Copiar extensión Copiar: copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles.
    • Usar Pegar extensión Pegar: pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa.
    Nota:

    Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial.

  • Restablecer extensión Restablecer: la extensión se restablecerá al valor predeterminado.
  • Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo.
    Precaución:

    El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.

Extent
Tipo de forma
(Opcional)

Especifica la forma que se generará.

  • HexágonoSe generarán entidades con forma de hexágono. Los lados superior e inferior de cada hexágono serán paralelos al eje x del sistema de coordenadas (las partes superior e inferior son planas).
  • Hexágono transversalSe generarán entidades transversales con forma de hexágono. Los lados derecho e izquierdo de cada hexágono serán paralelos al eje y del sistema de coordenadas del dataset (las partes superior e inferior quedan en punta).
  • CuadradoSe generarán entidades con forma cuadrada. Los lados superior e inferior de cada cuadrado serán paralelos al eje x del sistema de coordenadas y los lados derecho e izquierdo son paralelos al eje y del sistema de coordenadas.
  • RomboSe generarán entidades con forma de rombo. Los lados de cada polígono se rotarán 45 grados respecto de los ejes x e y del sistema de coordenadas.
  • TriánguloSe generarán entidades con forma triangular. Cada triángulo será un polígono equilateral normal de tres caras.
  • Hexágono H3Las entidades con forma de hexágono se generarán según el sistema de indexación geoespacial jerárquico hexagonal H3.
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.

  • 0: se crearán hexágonos con la resolución H3 de 0, con un área promedio de 4.357.449,416078381 kilómetros cuadrados.
  • 1: se crearán hexágonos con la resolución H3 de 1, con un área promedio de 609.788,441794133 kilómetros cuadrados.
  • 2: se crearán hexágonos con la resolución H3 de 2, con un área promedio de 86.801,780398997 kilómetros cuadrados.
  • 3: se crearán hexágonos con la resolución H3 de 3, con un área promedio de 12.393,434655088 kilómetros cuadrados.
  • 4: se crearán hexágonos con la resolución H3 de 4, con un área promedio de 1.770,347654491 kilómetros cuadrados.
  • 5: se crearán hexágonos con la resolución H3 de 5, con un área promedio de 252,903858182 kilómetros cuadrados.
  • 6: se crearán hexágonos con la resolución H3 de 6, con un área promedio de 36,129062164 kilómetros cuadrados.
  • 7: se crearán hexágonos con la resolución H3 de 7, con un área promedio de 5,161293360 kilómetros cuadrados. Esta es la opción predeterminada.
  • 8: se crearán hexágonos con la resolución H3 de 8, con un área promedio de 0,737327598 kilómetros cuadrados.
  • 9: se crearán hexágonos con la resolución H3 de 9, con un área promedio de 0,105332513 kilómetros cuadrados.
  • 10: se crearán hexágonos con la resolución H3 de 10, con un área promedio de 0,015047502 kilómetros cuadrados.
  • 11: se crearán hexágonos con la resolución H3 de 11, con un área promedio de 0,002149643 kilómetros cuadrados.
  • 12: se crearán hexágonos con la resolución H3 de 12, con un área promedio de 0,000307092 kilómetros cuadrados.
  • 13: se crearán hexágonos con la resolución H3 de 13, con un área promedio de 0,000043870 kilómetros cuadrados.
  • 14: se crearán hexágonos con la resolución H3 de 14, con un área promedio de 0,000006267 kilómetros cuadrados.
  • 15: se crearán hexágonos con la resolución H3 de 15, con un área promedio de 0,000000895 kilómetros cuadrados.

Este parámetro solo está activo cuando el parámetro Tipo de forma se configura como Hexágono H3.

Long

arcpy.management.GenerateTessellation(Output_Feature_Class, Extent, {Shape_Type}, {Size}, {Spatial_Reference}, {H3_Resolution})
NombreExplicaciónTipo 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.

  • MAXOF: se usará la extensión máxima de todas las entradas.
  • MINOF: se usará el área mínima común a todas las entradas.
  • DISPLAY: la extensión es igual a la visualización visible.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.
Extent
Shape_Type
(Opcional)

Especifica la forma que se generará.

  • HEXAGONSe generarán entidades con forma de hexágono. Los lados superior e inferior de cada hexágono serán paralelos al eje x del sistema de coordenadas (las partes superior e inferior son planas).
  • TRANSVERSE_HEXAGONSe generarán entidades transversales con forma de hexágono. Los lados derecho e izquierdo de cada hexágono serán paralelos al eje y del sistema de coordenadas del dataset (las partes superior e inferior quedan en punta).
  • SQUARESe generarán entidades con forma cuadrada. Los lados superior e inferior de cada cuadrado serán paralelos al eje x del sistema de coordenadas y los lados derecho e izquierdo son paralelos al eje y del sistema de coordenadas.
  • DIAMONDSe generarán entidades con forma de rombo. Los lados de cada polígono se rotarán 45 grados respecto de los ejes x e y del sistema de coordenadas.
  • TRIANGLESe generarán entidades con forma triangular. Cada triángulo será un polígono equilateral normal de tres caras.
  • H3_HEXAGONLas entidades con forma de hexágono se generarán según el sistema de indexación geoespacial jerárquico hexagonal H3.
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.

  • 0: se crearán hexágonos con la resolución H3 de 0, con un área promedio de 4.357.449,416078381 kilómetros cuadrados.
  • 1: se crearán hexágonos con la resolución H3 de 1, con un área promedio de 609.788,441794133 kilómetros cuadrados.
  • 2: se crearán hexágonos con la resolución H3 de 2, con un área promedio de 86.801,780398997 kilómetros cuadrados.
  • 3: se crearán hexágonos con la resolución H3 de 3, con un área promedio de 12.393,434655088 kilómetros cuadrados.
  • 4: se crearán hexágonos con la resolución H3 de 4, con un área promedio de 1.770,347654491 kilómetros cuadrados.
  • 5: se crearán hexágonos con la resolución H3 de 5, con un área promedio de 252,903858182 kilómetros cuadrados.
  • 6: se crearán hexágonos con la resolución H3 de 6, con un área promedio de 36,129062164 kilómetros cuadrados.
  • 7: se crearán hexágonos con la resolución H3 de 7, con un área promedio de 5,161293360 kilómetros cuadrados. Esta es la opción predeterminada.
  • 8: se crearán hexágonos con la resolución H3 de 8, con un área promedio de 0,737327598 kilómetros cuadrados.
  • 9: se crearán hexágonos con la resolución H3 de 9, con un área promedio de 0,105332513 kilómetros cuadrados.
  • 10: se crearán hexágonos con la resolución H3 de 10, con un área promedio de 0,015047502 kilómetros cuadrados.
  • 11: se crearán hexágonos con la resolución H3 de 11, con un área promedio de 0,002149643 kilómetros cuadrados.
  • 12: se crearán hexágonos con la resolución H3 de 12, con un área promedio de 0,000307092 kilómetros cuadrados.
  • 13: se crearán hexágonos con la resolución H3 de 13, con un área promedio de 0,000043870 kilómetros cuadrados.
  • 14: se crearán hexágonos con la resolución H3 de 14, con un área promedio de 0,000006267 kilómetros cuadrados.
  • 15: se crearán hexágonos con la resolución H3 de 15, con un área promedio de 0,000000895 kilómetros cuadrados.

Este parámetro está habilitado cuando el parámetro Shape_Type tiene el valor H3_HEXAGON.

Long

Muestra de código

Ejemplo 1 de GenerateTessellation (ventana de Python)

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)
Ejemplo 2 de GenerateTessellation (ventana de Python)

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)
Ejemplo 3 de GenerateTessellation (script independiente)

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)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados