Resumen
Crea una capa agrupada de clases de entidad que describe entidades de cuadrícula, retícula y borde utilizando especificaciones cartográficas predefinidas. Las capas de cuadrícula son perfectas para las definiciones de cuadrícula avanzadas que son específicas de extensión y escala.
Cada capa de cuadrícula puede estar compuesta por un polígono de máscara, un polígono de recorte, segmentos (línea), líneas de cuadrícula (línea), marcas divisorias (línea), extremos (punto), puntos (punto) y clases de entidad de anotación. Estos componentes se almacenan como entidades en las clases de entidad correspondientes. Estas clases de entidad se guardan dentro de un dataset de entidades especificado en una geodatabase. Hay siete clases de entidad que almacenan los componentes básicos de una cuadrícula. Cada clase de entidad se nombra con un prefijo de tres letras que ayuda a identificar el componente de la cuadrícula contenido en la clase de entidad. Las clases de entidad/componentes son los siguientes:
- ANO_ es la clase de entidad de anotación.
- EPT_ es la clase de entidad de los extremos.
- GLN_ es la clase de entidad de las líneas de cuadrícula.
- MSK_ es la clase de entidad de las máscaras.
- PNT_ es la clase de entidad de los puntos.
- SEG_ es la clase de entidad de los segmentos.
- TKS_ es la clase de entidad de las marcas divisorias.
Estas clases de entidad pueden almacenar información para diversas cuadrículas. Una octava clase de entidad (GRD_) contiene información de organización como, por ejemplo, el nombre de mapa y los tipos de cuadrícula que se utilizan para organizar las cuadrículas.
La plantilla de definición de cuadrícula se almacena en un archivo XML predefinido. Este archivo almacena las propiedades de la especificación de cada cuadrícula, como el número, color y peso de línea de las líneas de cuadrícula. Cuando se aplica la plantilla de definición, las entidades se crean de acuerdo a la especificación basada en la extensión actual o la extensión de una entidad seleccionada (área de interés), escala y sistemas de coordenadas.
Uso
Esta herramienta está diseñada para mapas proyectados que se imprimirán o exportarán. No está pensada para crear cuadrículas o retículas que se actualicen dinámicamente a medida que el usuario navegue por el mapa.
Debe introducir un área de interés para determinar la extensión de la capa de cuadrícula que se creará. Si está utilizando una capa de entidad para definir el área de interés, esta debe ser una clase de entidad poligonal o una capa de polígono.
Una vez definido el parámetro Plantilla de cuadrícula (archivo XML), desplácese sobre el área contextual que se encuentra inmediatamente a la izquierda del nombre del parámetro o haga clic en ella para mostrar información del tipo de cuadrícula, descripción, tipo de rotación y tipo de escala de la plantilla de definición de cuadrícula XML definida.
El archivo XML de la plantilla de cuadrícula especifica los componentes de la cuadrícula que describen mediciones o ubicaciones para los sistemas de coordenadas primario y auxiliar. Todos los sistemas de coordenadas que se especifican deben compartir un sistema de coordenadas geográficas en común. Si desea cambiar el sistema de coordenadas primario a uno que utilice un datum diferente al predeterminado (por ejemplo, si usted cambia el sistema de coordenadas de uno que utiliza WGS 1984 a uno que utiliza NAD 1983), también debe cambiar cada sistema de coordenadas auxiliar predeterminado a NAD 1983.
La plantilla de cuadrícula, el área de interés (AOI), el dataset de entidades de entrada y los parámetros del sistema de coordenadas principal o auxiliar deben utilizar el mismo datum, por ejemplo, WGS 1984 o NAD 1983.
El archivo XML de la plantilla de cuadrícula crea componentes de cuadrícula para hasta cuatro sistemas de coordenadas auxiliares. El archivo XML especifica el número de cuadrículas auxiliares. No puede agregar ni eliminar sistemas de coordenadas auxiliares, pero puede invalidar los valores predeterminados.
El Sistema de coordenadas principal debe ser un sistema de coordenadas proyectadas.
Los sistemas de coordenadas auxiliares pueden ser sistemas de coordenadas proyectadas o sistemas de coordenadas geográficas.
La referencia espacial del Dataset de entidades de entrada debe tener el mismo sistema de coordenadas geográficas especificado en el archivo XML de la plantilla de cuadrícula.
La referencia espacial del Área de interés de entrada debe tener el mismo sistema de coordenadas geográficas que el especificado en el archivo XML de la plantilla de cuadrícula.
Si está accediendo a la herramienta desde ArcMap, activando la casilla de verificación Configurar el marco de datos y el diseño mediante la configuración de cuadrícula, se asegurará de que el marco de datos del diseño se ajuste de la mejor manera posible a la cuadrícula creada. Para respetar la especificación de la cuadrícula XML, se pueden modificar el recorte, la extensión, el tamaño, la rotación, la escala y el sistema de coordenadas del marco de datos. Esta configuración solo está disponible cuando la herramienta se ejecuta desde la vista de diseño de ArcMap y no se ejecuta en segundo plano. La opción predeterminada es dejar esta casilla de verificación desactivada, lo cual no cambiará ninguna de las propiedades del marco de datos.
Cuando especifique un nombre de la cuadrícula que ya existe en la ubicación de salida, la cuadrícula existente se sobrescribirá.
Los siguientes valores de parámetros se derivan automáticamente del XML de la plantilla de cuadrícula:
- Capa de salida
- Nombre con el valor de cadena de caracteres
- Escala de referencia
- Rotación
- Tamaño de la máscara
- Tolerancia XY
- Sistema de coordenadas primario
- Sistema de coordenadas auxiliar
Sin embargo, todos estos valores predeterminados se pueden invalidar con nuevos valores.
Sintaxis
arcpy.cartography.MakeGridsAndGraticulesLayer(in_template, in_aoi, input_feature_dataset, output_layer, {name}, {refscale}, {rotation}, {mask_size}, {xy_tolerance}, {primary_coordinate_system}, {configure_layout}, {ancillary_coordinate_system_1}, {ancillary_coordinate_system_2}, {ancillary_coordinate_system_3}, {ancillary_coordinate_system_4})| Parámetro | Explicación | Tipo de datos |
in_template | La plantilla de definición de cuadrícula XML almacena las propiedades gráficas de la especificación para cada capa de cuadrícula. Además de las propiedades gráficas, que no se pueden modificar antes de la ejecución, la definición tiene valores predeterminados específicos, expuestos como parámetros, que se pueden modificar antes de la ejecución. Los archivos de plantilla se encuentran en el directorio de GridTemplates. A través de ArcGIS Resource Center se pueden obtener y compartir plantillas de cuadrícula adicionales. La extensión Production Mapping también ofrece un diseñador de cuadrículas que le permite crear nuevas plantillas, además de modificar las existentes. | File |
in_aoi | La capa de entidad o extensión x,y utilizada para determinar la extensión de la capa de cuadrícula creada.
| Feature Layer; Extent |
input_feature_dataset | El dataset de entidades que almacenará las entidades. Las clases de entidad específicas de cuadrícula se crearán si aún no existen. Si ya existen, y además hay una cuadrícula con el mismo nombre y tipo que la cuadrícula que se está creando, se sobrescribirá. | Feature Dataset |
output_layer | La capa agrupada de clases de entidad que describen entidades de cuadrícula, retícula y borde. Cada capa de cuadrícula puede estar compuesta por un polígono de máscara, un polígono de recorte, segmentos (línea), líneas de cuadrícula (línea), marcas divisorias (línea), extremos (punto), puntos (punto) y clases de entidad de anotación. | Group Layer |
name (Opcional) | El nombre de la cuadrícula cartográfica creada que permite distinguir entre las cuadrículas almacenadas en el mismo dataset de entidades y el conjunto de clases de entidad, expresado en uno de los siguientes formatos:
El nombre de la cuadrícula no puede contener los siguientes caracteres especiales:
| String; Field |
refscale (Opcional) | La escala en la que se crea y debe visualizarse la cuadrícula. Cuando la escala de referencia del archivo de definición de cuadrícula XML se define como Utilizar entorno, la escala de referencia se deriva en el siguiente orden:
| Double |
rotation (Opcional) | El ángulo de rotación para los componentes de la cuadrícula. La rotación se utiliza para proporcionar una anotación que esté al mismo nivel de la página. A menos que se especifique de otra manera, la rotación se calcula utilizando la entidad de área de interés. Cuando el tipo de rotación del archivo de definición de cuadrícula XML se define como Utilizar entorno, la rotación se deriva en el siguiente orden:
| Double |
mask_size (Opcional) | La máscara es una entidad poligonal que forma un anillo exterior alrededor de la extensión del borde interior y se usa para enmascarar datos que estén en el área reservada para las etiquetas de coordenadas. El Tamaño de máscara define el ancho de la entidad de máscara de polígono en unidades de mapa o unidades de página. Tal vez deba cambiar el tamaño del marco de datos para que se ajuste alrededor del borde de la máscara y también incluya las etiquetas de coordenadas. | Linear Unit |
xy_tolerance (Opcional) | La distancia mínima tolerada entre las entidades de geodatabase, expresada en unidades lineales. Este valor toma el valor predeterminado establecido en el XML. Puede establecer un valor que sea mayor para los datos que tengan coordenadas menos exactas y un valor menor para los datos con una exactitud extremadamente alta. Las entidades que estén dentro de la tolerancia XY se considerarán coincidentes. | Linear Unit |
primary_coordinate_system (Opcional) | El archivo XML de plantilla de cuadrícula crea componentes de cuadrícula que describen las coordenadas o ubicaciones para un sistema de coordenadas primario y hasta cuatro sistemas de coordenadas auxiliares. El archivo especifica el número de cuadrículas auxiliares. No puede agregar ni eliminar sistemas de coordenadas auxiliares. Todos los sistemas de coordenadas que se especifican deben compartir un sistema de coordenadas geográficas en común. Si desea cambiar el sistema de coordenadas primario a uno que utilice un datum diferente al predeterminado (por ejemplo, si usted cambia el sistema de coordenadas de uno que utiliza WGS 1984 a uno que utiliza NAD 1983), también debe cambiar cada sistema de coordenadas auxiliar predeterminado a NAD 1983. Este es el sistema de coordenadas primario para la capa de cuadrícula que se está creando. Generalmente, será el sistema de coordenadas del producto final o del marco de datos. Este sistema de coordenadas debe ser un sistema de coordenadas proyectadas. Cuando el Sistema de coordenadas principal en el archivo de definición de cuadrícula XML se define como Utilizar entorno, el Sistema principal de coordenadas se deriva en el siguiente orden:
En todos los casos, la entrada de un usuario tiene la máxima prioridad. | Spatial Reference |
configure_layout (Opcional) | Ajusta la configuración del marco de datos para garantizar que concuerde con la capa de cuadrícula. Para aplicar consistencia, se pueden modificar el recorte, la extensión, el tamaño, la rotación, la escala y el sistema de coordenadas del marco de datos. Esta configuración solo está disponible cuando la herramienta se ejecuta desde la vista de diseño de ArcMap y no se ejecuta en segundo plano.
| Boolean |
ancillary_coordinate_system_1 (Opcional) | El archivo XML de plantilla de cuadrícula crea componentes de cuadrícula que describen las coordenadas o ubicaciones para un sistema de coordenadas primario y hasta cuatro sistemas de coordenadas auxiliares. El archivo especifica la cantidad de cuadrículas auxiliares. No puede agregar ni eliminar sistemas de coordenadas auxiliares. Todos los sistemas de coordenadas que se especifican deben compartir un sistema de coordenadas geográficas en común. Si desea cambiar el sistema de coordenadas primario a uno que utilice un datum diferente al predeterminado (por ejemplo, si usted cambia el sistema de coordenadas de uno que utiliza WGS 1984 a uno que utiliza NAD 1983), también debe cambiar cada sistema de coordenadas auxiliar predeterminado a NAD 1983. Este es el primer sistema de coordenadas auxiliar. | Spatial Reference |
ancillary_coordinate_system_2 (Opcional) | El archivo XML de plantilla de cuadrícula crea componentes de cuadrícula que describen las coordenadas o ubicaciones para un sistema de coordenadas primario y hasta cuatro sistemas de coordenadas auxiliares. El archivo especifica la cantidad de cuadrículas auxiliares. No puede agregar ni eliminar sistemas de coordenadas auxiliares. Todos los sistemas de coordenadas que se especifican deben compartir un sistema de coordenadas geográficas en común. Si desea cambiar el sistema de coordenadas primario a uno que utilice un datum diferente al predeterminado (por ejemplo, si usted cambia el sistema de coordenadas de uno que utiliza WGS 1984 a uno que utiliza NAD 1983), también debe cambiar cada sistema de coordenadas auxiliar predeterminado a NAD 1983. Este es el segundo sistema de coordenadas auxiliar. | Spatial Reference |
ancillary_coordinate_system_3 (Opcional) | El archivo XML de plantilla de cuadrícula crea componentes de cuadrícula que describen las coordenadas o ubicaciones para un sistema de coordenadas primario y hasta cuatro sistemas de coordenadas auxiliares. El archivo especifica la cantidad de cuadrículas auxiliares. No puede agregar ni eliminar sistemas de coordenadas auxiliares. Todos los sistemas de coordenadas que se especifican deben compartir un sistema de coordenadas geográficas en común. Si desea cambiar el sistema de coordenadas primario a uno que utilice un datum diferente al predeterminado (por ejemplo, si usted cambia el sistema de coordenadas de uno que utiliza WGS 1984 a uno que utiliza NAD 1983), también debe cambiar cada sistema de coordenadas auxiliar predeterminado a NAD 1983. Este es el tercer sistema de coordenadas auxiliar. | Spatial Reference |
ancillary_coordinate_system_4 (Opcional) | El archivo XML de plantilla de cuadrícula crea componentes de cuadrícula que describen las coordenadas o ubicaciones para un sistema de coordenadas primario y hasta cuatro sistemas de coordenadas auxiliares. El archivo especifica la cantidad de cuadrículas auxiliares. No puede agregar ni eliminar sistemas de coordenadas auxiliares. Todos los sistemas de coordenadas que se especifican deben compartir un sistema de coordenadas geográficas en común. Si desea cambiar el sistema de coordenadas primario a uno que utilice un datum diferente al predeterminado (por ejemplo, si usted cambia el sistema de coordenadas de uno que utiliza WGS 1984 a uno que utiliza NAD 1983), también debe cambiar cada sistema de coordenadas auxiliar predeterminado a NAD 1983. Este es el cuarto sistema de coordenadas auxiliar. | Spatial Reference |
Muestra de código
Ejemplo 1 de la herramienta MakeGridsAndGraticulesLayer (secuencia de comandos independiente)
En esta secuencia de comandos independiente se muestra un ejemplo del uso de la herramienta MakeGridsAndGraticulesLayer para hacer una cuadrícula cartográfica.
# Name: MakeGridsAndGraticulesLayer.py
# Description: Create grid for a selected area of interest in a file
# geodatabase
# Import system module
import arcpy
import os
# Create a feature layer from the input area of interest feature class
# to pass to the Selection geoprocess below
arcpy.MakeFeatureLayer_management("C:/Base_Data/AOIs.gdb/QUAD_24K",
"QUAD_24K")
# Select a feature from the area of interest feature layer based on a
# definition query (this query, formatted for a file geodatabase, has
# been adjusted for use in python, in particular the use of \ in
# conjunction with the double quotes surrounding the field name in the
# definition query)
arcpy.SelectLayerByAttribute_management("QUAD_24K", "NEW_SELECTION",
"\"MSNAME\" = 'Swift Minnesota'")
# Set the values of the tool's parameters using one of the grid
# definition XML files located under the GridTemplates directory
template = os.path.join(arcpy.GetInstallInfo()['InstallDir'],
"GridTemplates/Quad_24K_NAD83.xml")
in_aoi = "QUAD_24K"
input_feature_dataset = "C:/Python_Output/grid_layers.gdb/QUAD_24K"
output_layer = "QUAD_24K_NAD83_Grid"
name = "MSNAME"
# Process: Make Grids and Graticules Layer
arcpy.MakeGridsAndGraticulesLayer_cartography(template, in_aoi,
input_feature_dataset,
output_layer, name)
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí