Cuadrícula de entidades de índice (Cartografía)

Resumen

Crea una cuadrícula de entidades poligonales rectangulares que se puede utilizar como índice para especificar páginas en una serie de mapas espaciales. La cuadrícula se puede crear de manera que contenga solo entidades poligonales que intersequen a otra capa de entidades.

Uso

  • El sistema de coordenadas de la clase de entidad de salida se determina en el siguiente orden:

    • Si se especifica un sistema de coordenadas mediante el entorno Sistema de coordenadas de salida, la clase de entidad de salida utilizará este sistema de coordenadas.
    • Si no se especifica ningún sistema de coordenadas en el entorno Sistema de coordenadas de salida, la clase de entidad de salida utilizará el sistema de coordenadas del mapa o marco de mapa activo.
    • Si no se especifica ningún sistema de coordenadas en el entorno Sistema de coordenadas de salida y no hay ningún mapa activo (ArcGIS Pro no está abierto), la clase de entidad de salida utilizará el sistema de coordenadas de la primera entidad de entrada.
    • Si no se especifica ningún sistema de coordenadas en el entorno Sistema de coordenadas de salida, no hay ningún mapa activo (ArcGIS Pro no está abierto) y no hay entidades de entrada especificadas, el sistema de coordenadas de la clase de entidad de salida será desconocido.
  • El parámetro Entidades de entrada puede indicar puntos, líneas, polígonos o rásteres.

  • Si usa el parámetro Utilizar escala y unidad de página, el parámetro Escala de mapa es obligatorio.

  • Utilizar el cuadro de diálogo de la herramienta para cambiar los valores de ancho o altura de polígono cuando se especifica el parámetro Coordenada de origen de la cuadrícula de polígonos provoca que el número de filas y columnas cambie automáticamente. Las filas y columnas se calculan automáticamente según las coordenadas de origen de la cuadrícula de la extensión de la clase de entidad. Si las coordenadas x,y de origen se modifican de forma que incrementen la extensión total, se actualizará el número correspondiente de filas y columnas. Si la extensión total se reduce, los cambios se ignorarán y se utilizará la extensión completa de las entidades.

  • Cuando se agrega el parámetro Entidades de entrada, el valor del parámetro Coordenada de origen de la cuadrícula de polígonos se calcula automáticamente.

  • Si Utilizar escala y unidad de página está activado, las unidades de Ancho de polígono y de Altura de polígono cambian automáticamente a las unidades de página establecidas en el marco de mapa activo. Si está utilizando la herramienta fuera de una sesión de ArcGIS Pro, las unidades se muestran en el valor predeterminado, es decir, pulgadas. Aunque tenga la opción de especificar las unidades de mapa, como metros o millas, utilice las unidades apropiadas para la página.

  • Si Utilizar escala y unidad de página está activado, la escala del mapa vuelve al valor de escala predeterminado del marco del mapa activo en el diseño de página. Si está utilizando la herramienta fuera de una sesión de ArcGIS Pro, la escala se muestra en el valor predeterminado, es decir, 1.

  • Para obtener mejores resultados, todas las capas de entidades de entrada y las clases de entidad deben estar en el mismo sistema de coordenadas que el mapa o marco de mapa, o, si está usando la herramienta fuera de una sesión de ArcGIS Pro, todas las capas de entidad de entrada y las clases de entidad deben estar en el mismo sistema de coordenadas que la primera clase de entidad o capa de entidades de entrada de la lista.

Sintaxis

arcpy.cartography.GridIndexFeatures(out_feature_class, {in_features}, {intersect_feature}, {use_page_unit}, {scale}, {polygon_width}, {polygon_height}, {origin_coord}, {number_rows}, {number_columns}, {starting_page_number}, {label_from_origin})
ParámetroExplicaciónTipo de datos
out_feature_class

La clase de entidad resultante de las entidades de índice de polígono.

El sistema de coordenadas de la clase de entidad de salida se determina en el siguiente orden:

  • Si se especifica un sistema de coordenadas mediante el entorno Sistema de coordenadas de salida, la clase de entidad de salida utilizará este sistema de coordenadas.
  • Si no se especifica ningún sistema de coordenadas en el entorno Sistema de coordenadas de salida, la clase de entidad de salida utilizará el sistema de coordenadas del mapa activo (ArcGIS Pro está abierto).
  • Si no se especifica ningún sistema de coordenadas en el entorno Sistema de coordenadas de salida y no hay ningún mapa activo (ArcGIS Pro no está abierto), la clase de entidad de salida utilizará el sistema de coordenadas de la primera entidad de entrada.
  • Si no se especifica ningún sistema de coordenadas en el entorno Sistema de coordenadas de salida, no hay ningún mapa activo (ArcGIS Pro no está abierto) y no hay entidades de entrada especificadas, el sistema de coordenadas de la clase de entidad de salida será desconocido.
Feature Class
in_features
[in_features,...]
(Opcional)

Las entidades de entrada que se usan para definir la extensión de la cuadrícula de polígonos que se creará.

Feature Layer; Raster Layer
intersect_feature
(Opcional)

Limita la clase de entidad de cuadrícula de salida a áreas que se intersecan con datasets o capas de entidades de entrada. La intersección de las entidades de entrada se usará para crear entidades de índice

  • INTERSECTFEATURELimita la clase de entidad de cuadrícula de salida a áreas que se intersecan con datasets o capas de entidades de entrada. Cuando se especifican las entidades de entrada, se trata del valor predeterminado.
  • NO_INTERSECTFEATURESe crea una clase de entidad de cuadrícula de salida utilizando coordenadas, filas y columnas especificadas.
Boolean
use_page_unit
(Opcional)

Especifica si la entrada de tamaño del polígono de índice está en unidades de página.

  • USEPAGEUNITLa altura y el ancho del polígono de índice se calculan en unidades de página.
  • NO_USEPAGEUNITLa altura y el ancho del polígono de índice se calculan en unidades de mapa. Esta es la opción predeterminada.
Boolean
scale
(Opcional)

La escala de mapa. La escala se debe especificar si se desea que la altura y el ancho del polígono de índice se calculen en unidades de página. Si la herramienta se utiliza fuera de una sesión de ArcGIS Pro activa, el valor de escala predeterminado es 1.

Long
polygon_width
(Opcional)

El ancho del polígono de índice especificado en unidades de mapa o de página. Si se usan unidades de página, el valor predeterminado es 1 pulgada. Si se usan unidades de mapa, el valor predeterminado es 1 grado.

Linear Unit
polygon_height
(Opcional)

La altura del polígono de índice especificada en unidades de mapa o de página. Si se usan unidades de página, el valor predeterminado es 1 pulgada. Si se usan unidades de mapa, el valor predeterminado es 1 grado.

Linear Unit
origin_coord
(Opcional)

El valor de coordenadas para el origen inferior izquierdo de la clase de entidad de cuadrícula de salida. Si se especifican entidades de entrada, el valor predeterminado está determinado por la extensión de la unión de las extensiones de estas entidades. Si no se especifican entidades de entrada, las coordenadas predeterminadas son 0 y 0.

Point
number_rows
(Opcional)

El número de filas que se desean crear en la dirección y desde el punto de origen. El valor predeterminado es 10.

Long
number_columns
(Opcional)

El número de columnas que se desean crear en la dirección x desde el punto de origen. El valor predeterminado es 10.

Long
starting_page_number
(Opcional)

A cada entidad de índice de cuadrícula se le asigna un número de página secuencial que empieza con un número de página inicial especificado. El valor predeterminado es 1.

Long
label_from_origin
(Opcional)

Especifica en qué punto comienzan los números de página (etiquetas).

  • LABELFROMORIGINLos números de página (etiquetas) comienzan con la entidad poligonal en la esquina inferior izquierda de la cuadrícula de salida.
  • NO_LABELFROMORIGINLos números de página (etiquetas) comienzan con la entidad poligonal en la esquina superior izquierda de la cuadrícula de salida. Esta es la opción predeterminada.
Boolean

Muestra de código

Ejemplo 1 de GridIndexFeatures (ventana de Python)

El siguiente ejemplo crea entidades de índice de cuadrícula usando la intersección de las dimensiones de las entidades de índice especificadas y las entidades de entrada en unidades de mapa.

import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
                                    "1000 meters", "1000 meters")
Ejemplo 2 de GridIndexFeatures (ventana de Python)

El siguiente ejemplo crea entidades de índice de cuadrícula usando la extensión completa de las dimensiones de las entidades de índice especificadas y las entidades de entrada en unidades de página.

import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly",
                                    "NO_INTERSECTFEATURE", "USEPAGEUNIT",
                                    "100000", "5 inches", "5 inches")
Ejemplo 3 de GridIndexFeatures (ventana de Python)

El siguiente ejemplo crea entidades de índice de cuadrícula usando la intersección de las entidades de entrada, las dimensiones de las entidades de índice especificadas en unidades de mapa y el 5 como el número de página inicial.

import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
                                    "1000 meters", "1000 meters", "", "",
                                    "", "5")
Ejemplo 4 de GridIndexFeatures (ventana de Python)

El siguiente ejemplo crea entidades de índice de cuadrícula especificando las coordenadas de origen, las dimensiones de las entidades de índice en unidades de mapa, la cantidad de filas y la cantidad de columnas.

import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "", "",
                                    "1000 meters","1000 meters",
                                    "-6000000 -1600000", "15", "20")
Ejemplo 5 de GridIndexFeatures (ventana de Python)

El siguiente ejemplo crea entidades de índice de cuadrícula especificando las coordenadas de origen, las dimensiones de las entidades de índice en unidades de página, la cantidad de filas, la cantidad de columnas, el 5 como el número de página inicial y el etiquetado para comenzar en el origen.

import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "USEPAGEUNIT",
                                    "100000", "5 inches", "5 inches",
                                    "-6000000 -1600000", "15", "20", "5",
                                    "LABELFROMORIGIN")
Ejemplo 6 de GridIndexFeatures (script independiente)

El siguiente ejemplo crea entidades de índice de cuadrícula usando la intersección de las dimensiones de las entidades de índice especificadas y las entidades de entrada en unidades de mapa.

# gridindexfeatures_example1.py
# Description: Creates Grid Index Features using the intersection of input
# features and specified index feature dimensions in map units
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"

# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"

# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass,inFeatures, "", "", "",
                                    polygonWidth, polygonHeight)
Ejemplo 7 de GridIndexFeatures (script independiente)

El siguiente ejemplo crea entidades de índice de cuadrícula usando la extensión completa de las dimensiones de las entidades de índice especificadas y las entidades de entrada en unidades de página.

# gridindexfeatures_example2.py
# Description: Creates Grid Index Features using the entire extent of input
# features and specified index feature dimensions in page units
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"

# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
noIntersect = "NO_INTERSECTFEATURE"
usePageUnit = "USEPAGEUNIT"
scale = "100000"
polygonWidth = "5 inches"
polygonHeight= "5 inches"

# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, inFeatures, noIntersect,
                                    usePageUnit, scale, polygonWidth,
                                    polygonHeight)
Ejemplo 8 de GridIndexFeatures (script independiente)

El siguiente ejemplo crea entidades de índice de cuadrícula usando la intersección de las entidades de entrada, las dimensiones de las entidades de índice especificadas en unidades de mapa y el 5 como el número de página inicial.

# gridindexfeatures_example3.py
# Description: Creates Grid Index Features using the intersection of input
# features, specified index feature dimensions in map units and 5 as the 
# starting page number
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"

# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
startingPageNum = "5"

# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass,inFeatures, "", "", "",
                                    polygonWidth, polygonHeight, "", "", "",
                                    startingPageNum)
Ejemplo 9 de GridIndexFeatures (script independiente)

El siguiente ejemplo crea entidades de índice de cuadrícula especificando las coordenadas de origen, las dimensiones de las entidades de índice en unidades de mapa, la cantidad de filas y la cantidad de columnas.

# gridindexfeatures_example4.py
# Description: Creates Grid Index Features by specifying the origin
# coordinates, the index feature dimensions in map units, the number of
# rows and the number of columns
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:\data\ProjectData.gdb"
env.outputCoordinateSystem = arcpy.SpatialReference("North America Albers Equal Area Conic.prj")

# Set local variables
outFeatureClass = "gridIndexFeatures"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
originCoord = "-6000000 -1600000"
numberRows = "15"
numberColumns = "20"

# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, "", "", "", "",
                                    polygonWidth, polygonHeight, originCoord,
                                    numberRows, numberColumns)
Ejemplo 10 de GridIndexFeatures (script independiente)

El siguiente ejemplo crea entidades de índice de cuadrícula especificando las coordenadas de origen, las dimensiones de las entidades de índice en unidades de página, la cantidad de filas, la cantidad de columnas, el 5 como el número de página inicial y el etiquetado para comenzar en el origen.

# gridindexfeatures_example5.py
# Description: Creates Grid Index Features by specifying the origin
# coordinates, the index feature dimensions in page units, the number of
# rows, the number of columns, 5 as the starting page number and labeling
# to start at the origin
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:\data\ProjectData.gdb"
env.outputCoordinateSystem = arcpy.SpatialReference("North America Albers Equal Area Conic.prj")

# Set local variables
outFeatureClass = "gridIndexFeatures"
usePageUnit = "USEPAGEUNIT"
scale = "100000"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
originCoord = "-6000000 -1600000"
numberRows = "15"
numberColumns = "20"
startingPageNum = "5"
labeling = "LABELFROMORIGIN"


# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, "", "", usePageUnit,
                                    scale, polygonWidth, polygonHeight,
                                    originCoord, numberRows, numberColumns,
                                    startingPageNum, labeling)

Información de licenciamiento

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

Temas relacionados