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ámetro | Explicación | Tipo 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:
| 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
| Boolean |
use_page_unit (Opcional) | Especifica si la entrada de tamaño del polígono de índice está en unidades de página.
| 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).
| Boolean |
Muestra de código
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")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")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")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")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")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)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)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)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)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í