Resumen
Crea una cuadrícula rectangular de entidades poligonales que se puede utilizar como índice para especificar las páginas de un libro de mapas que use páginas controladas por datos. La cuadrícula se puede crear de manera que contenga solo entidades de polígono que intersequen a otra capa de entidades.
Uso
El sistema de coordenadas de la clase de entidad de salida se determina en este orden.
- Si la variable Sistema de coordenadas de salida de Configuración del entorno especifica un sistema de coordenadas, la clase de entidad de salida utilizará este sistema de coordenadas.
- Si la variable Sistema de coordenadas de salida no especifica un sistema de coordenadas, la clase de entidad de salida utilizará el sistema de coordenadas del marco de datos activo (ArcMap está abierto).
- Si la variable Sistema de coordenadas de salida no especifica un sistema de coordenadas y no hay un marco de datos activo (ArcMap no está abierto), la clase de entidad de salida utilizará el sistema de coordenadas de la primera entidad de entrada.
- Si la variable Sistema de coordenadas de salida no especifica un sistema de coordenadas, no hay un marco de datos activo (ArcMap no está abierto) y no hay entidades de entrada especificadas, el sistema de coordenadas de la clase de entidad de salida será desconocido.
Las entidades de entrada pueden ser puntos, líneas, polígonos o rásters.
Cuando selecciona Utilizar escala y unidad de página, Escala de mapa se convierte en un parámetro requerido.
Cuando se utiliza el cuadro de diálogo de la herramienta para cambiar los valores de ancho o altura del polígono cuando se especificaron las Coordenadas de origen de la cuadrícula, el número de filas y columnas cambia automáticamente.
Cuando agrega Entidades de entrada, las Coordenadas de origen de la cuadrícula se calculan automáticamente.
Considere guardar la clase de entidad de salida en una geodatabase. Aunque está permitido guardar la salida en un shapefile, si intenta calcular las referencias espaciales para las entidades de la capa de índice utilizando las herramientas Calcular meridiano central y paralelos o Calcular zona UTM, los resultados de la cadena de coordenadas generada pueden exceder el límite de caracteres de campo (255) de un shapefile.
Cuando Utilizar escala y unidad de página está seleccionado, 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 documento de mapa activo. Si está utilizando la herramienta fuera de una sesión de ArcMap, 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, debe utilizar las unidades apropiadas para la página.
Cuando Utilizar escala y unidad de página está seleccionado, la escala del mapa vuelve al valor de escala predeterminado del marco de datos activo en el diseño de página del documento de ArcMap activo. Si está utilizando la herramienta fuera de una sesión de ArcMap, la escala se muestra en el valor predeterminado, es decir, 1.
Para obtener mejores resultados, todas las capas de entidad de entrada y las clases de entidad deben estar en el mismo sistema de coordenadas que el marco de datos, o, si está usando la herramienta fuera de una sesión de ArcMap, todas las capas de entidad de entrada y las clases de entidad deben estar en el mismo sistema de coordenadas que la primera capa de entidad de entrada o clase de entidad 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ámetro | Explicación | Tipo de datos |
out_feature_class | 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 este orden.
| Feature Class |
in_features [in_features,...] (Opcional) | Las entidades de entrada se pueden utilizar para definir la extensión de la cuadrícula de polígonos que se crea. | Feature Layer; Raster Layer |
intersect_feature (Opcional) | Limita la clase de entidad de cuadrícula de salida a solo áreas que intersequen datasets o capas de entidades de entrada. Cuando se especifican las entidades de entrada, el valor predeterminado es INTERSECTFEATURE. La intersección de las entidades de entrada se usará para crear entidades de índice
| Boolean |
use_page_unit (Opcional) | Indica si la entrada de tamaño del polígono de índice está en unidades de página. El valor predeterminado es NO_USEPAGEUNIT. La herramienta utiliza unidades de mapa por defecto.
| Boolean |
scale (Opcional) | Se debe especificar una escala si desea que la altura y el ancho del polígono de índice se calculen en unidades de página. Si la herramienta se está utilizando fuera de una sesión de ArcMap activa, el valor de escala predeterminado es 1. | Long |
polygon_width (Opcional) | Ancho del polígono de índice especificado en unidades de mapa o de página. Si se están usando unidades de página, el valor predeterminado es 1 pulgada. Si se están usando unidades de mapa, el valor predeterminado es 1 grado. | Linear unit |
polygon_height (Opcional) | Altura del polígono de índice especificada en unidades de mapa o de página. Si se están usando unidades de página, el valor predeterminado es 1 pulgada. Si se están usando unidades de mapa, el valor predeterminado es 1 grado. | Linear unit |
origin_coord (Opcional) | Coordenada 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) | Número de filas para crear en la dirección y desde el punto de origen. El valor predeterminado es 10. | Long |
number_columns (Opcional) | Número de columnas para 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) | Los números de página (etiquetas) que empiezan con el número de página inicial especificado (el predeterminado es 1) comienzan con la celda en la esquina inferior izquierda de la cuadrícula de salida. El valor predeterminado es NO_LABELFROMORIGIN.
| Boolean |
Muestra de código
Ejemplo Nº 1 de la herramienta GridIndexFeatures (ventana de Python)
Crea GridIndexFeatures usando la intersección de las dimensiones de las entidades de índice especificadas y las entidades de entrada en unidades de mapa.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters","1000 meters")
Ejemplo Nº 2 de la herramienta GridIndexFeatures (ventana de Python)
Crea GridIndexFeatures 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
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly",
"NO_INTERSECTFEATURE","USEPAGEUNIT",
"100000", "5 inches","5 inches")
Ejemplo Nº 3 de la herramienta GridIndexFeatures (ventana de Python)
Crea GridIndexFeatures 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
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters", "1000 meters", "", "",
"", "5")
Ejemplo Nº 4 de la herramienta GridIndexFeatures (ventana de Python)
Crea GridIndexFeatures al especificar 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
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "", "",
"1000 meters","1000 meters",
"-6000000 -1600000", "15", "20",)
Ejemplo Nº 5 de la herramienta GridIndexFeatures (ventana de Python)
Crea GridIndexFeatures al especificar 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
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "USEPAGEUNIT",
"100000", "5 inches", "5 inches",
"-6000000 -1600000", "5",
"LABELFROMORIGIN")
Ejemplo Nº 1 de la herramienta GridIndexFeatures (secuencia de comandos de Python independiente)
Crea GridIndexFeatures 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 Nº 2 de la herramienta GridIndexFeatures (secuencia de comandos de Python independiente)
Crea GridIndexFeatures 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 Nº 3 de la herramienta GridIndexFeatures (secuencia de comandos de Python independiente)
Crea GridIndexFeatures 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 Nº 4 de la herramienta GridIndexFeatures (secuencia de comandos de Python independiente)
Crea GridIndexFeatures al especificar 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 Nº 5 de la herramienta GridIndexFeatures (secuencia de comandos de Python independiente)
Crea GridIndexFeatures al especificar 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)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí