Generar capa de retículas y cuadrículas (Cartografía)

Nivel de licencia:BasicStandardAdvanced

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 entidades 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:

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 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

Sintaxis

MakeGridsAndGraticulesLayer_cartography (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ámetroExplicaciónTipo 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 \ArcGIS\Desktop10.1\GridTemplates. A través de ArcGIS Resource Center se pueden obtener y compartir plantillas de cuadrícula adicionales.

La extensión de representación cartográfica de producción de Esri ofrece un diseñador de cuadrículas que permite crear nuevas plantillas, además de modificar las plantillas 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.

  • Capa de entidad—Indica que puede elegir la capa que usará para el área de interés. Solo se utilizará una entidad seleccionada en esta capa. Para las capas que tienen más de una entidad, la herramienta Solo creará una capa de cuadrícula basada en la primera entidad. La primera entidad se basa en el Id. de objeto. Todas las entidades restantes se ignoran.
  • Extensión—Indica que puede usar una de las siguientes como el área de interés:
    • El área de interés predeterminada del marco de datos.
    • Como se especifica en la parte inferior: cuando se especifica una extensión mediante la adición directa de coordenadas, se deriva una referencia espacial para esas coordenadas de lo siguiente, por orden: (1) el marco de datos centrado de ArcMap (2) si ArcMap no está activo, el parámetro de entorno Sistema de coordenadas cartográficas.
    • La misma área de interés (AOI) que la visualización.

NotaNota:

Las únicas opciones de extensión válidas para esta herramienta son Predeterminada, Como se especifica en la parte inferior y Como la visualización. Si selecciona cualquier otra opción, aparecerá un error.

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á.

NotaNota:

Una cuadrícula con el mismo nombre y tipo que la cuadrícula creada se sobrescribirá siempre, sin importar la configuración de salida de sobrescritura del geoprocesamiento.

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.

NotaNota:

Esta es una capa temporal que debe guardar en el documento de ArcMap o como un archivo de capa.

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:

  • Cadena de texto—Introduzca una cadena de texto para el nombre de la cuadrícula.
  • Campo—Introduzca un campo de la capa de entidad. El valor del campo de la entidad seleccionada se usa para nombrar a la cuadrícula. Se puede utilizar el nombre de campo de un área de interés cuando el parámetro Área de Interés de entrada está definido como Capa de entidad.

El nombre de la cuadrícula no puede contener caracteres especiales. Entre ellas se incluyen:

  • '
  • "
  • ~
  • \
  • /
  • |
  • #
  • @
  • $
  • %
  • ^
  • &
  • *
  • (
  • )

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:

  • La configuración del entorno Escala de referencia de geoprocesamiento.
  • La escala de referencia del marco de datos activo
  • La escala del marco de datos activo
  • El valor del archivo de definición de cuadrícula XML

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:

  • La rotación del marco de datos activo
  • El valor del archivo de definición de cuadrícula XML

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:

  • La configuración del entorno del Sistema de coordenadas cartográficas de geoprocesamiento
  • El sistema de coordenadas del marco de datos activo, si es un sistema de coordenadas proyectado
  • El valor fijo del archivo de definición de cuadrícula XML

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. Por defecto, esta casilla de verificación está desmarcada.

  • CONFIGURELAYOUTIndica que el marco de datos y el diseño están configurados mediante la configuración de cuadrícula.
  • NO_CONFIGURELAYOUTIndica que el marco de datos y el diseño no están configurados. Esta es la opción predeterminada.
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

Ejemplo de código

Ejemplo de la herramienta MakeGridsAndGraticulesLayer (secuencia de comandos de Python independiente)

Esta secuencia de comandos independiente 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

# Enabling logging of the results
arcpy.logHistory = True

# Enable background geoprocessing 
# arcpy.Command("force_run_in_background yes")  #uncomment this to run the
# GP tool in the background

# Set overwrite outputs of geoprocessing operations to true
arcpy.gp.overwriteOutput = 1

# 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
t = "C:/Program Files/ArcGIS/Desktop10.1/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 (the '#' indicates use
# default values)
arcpy.MakeGridsAndGraticulesLayer_cartography(t, in_aoi,
                                              input_feature_dataset,
                                              output_layer, name, "#", "#",
                                              "#", "#", "#")

Entornos

Sistema de coordenadas cartográficas

Los parámetros de los sistemas de coordenadas primarios y auxiliares usarán esta configuración cuando el archivo de definición de cuadrícula XML se defina como Utilizar entorno.

Escala de referencia

El parámetro de la escala de referencia usará esta configuración cuando el archivo de definición de cuadrícula XML se defina como Utilizar entorno.

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: Sí
ArcGIS for Desktop Advanced: Sí
5/9/2014