Convertir etiquetas en gráficos (Cartografía)

Resumen

Convierte las etiquetas de una sola capa o de todo el mapa en gráficos.

Uso

  • Es posible convertir etiquetas en gráficos para una sola capa o para todo el mapa. Si se selecciona la opción de una sola capa, es necesario especificar la capa, y debe estar en el mapa.

  • Se respetarán los rangos de escala de la clase de etiqueta. Cuando la herramienta genere un gráfico para una escala de mapa específica, solo convertirá las clases de etiqueta que estén activadas y visibles en esa escala.

    Nota:

    Los rangos de escala de la clase de etiqueta se establecen en la pestaña Etiquetado en ArcGIS Pro.

  • El formato para la denominación de las capas gráficas es <layer name><graphics layer suffix>.

    Los nombres de las capas gráficas duplicadas no se sobrescriben.

  • Una de las salidas de esta herramienta es una capa de grupo. Puede usar la herramienta Guardar en archivo de capa para escribir la capa de grupo de salida en un archivo de capa. Si utiliza la herramienta en ArcGIS Pro, la herramienta agrega la capa de grupo a la visualización. El grupo de capas que se crea es temporal y, una vez finalizada la sesión, no permanece en el sistema a menos que se guarde el proyecto.

  • Una capa de grupo existente se sobrescribirá si se especifica el mismo nombre de capa y se activa la opción Permitir que las herramientas de geoprocesamiento sobrescriban los datasets existentes en las opciones de geoprocesamiento.

  • El parámetro Convertir las etiquetas de todas las capas en una sola capa de gráficos de salida permite crear una sola capa de gráficos para todo el mapa.

  • Algunas etiquetas quizá no aparezcan en el mapa porque no hay espacio. Active la casilla de verificación del parámetro Convertir etiquetas no colocadas en gráficos, para guardar las etiquetas no colocadas en la capa de gráficos, lo que permite hacerlas visibles y posicionarlas más tarde.

Parámetros

EtiquetaExplicaciónTipo de datos
Mapa de entrada

El nombre del mapa de entrada.

Map
Escala de conversión

La escala a la que se van a convertir las etiquetas. Si se ha establecido una escala de referencia en el mapa, esta se utilizará para el cambio de tamaño de los símbolos y la creación de la capa de gráficos, pero la conversión se producirá a esta escala.

Double
Convertir
(Opcional)

Especifica si se convertirán los gráficos para todas las capas del mapa o solo para una.

  • Todas las capas del mapaLas etiquetas se convierten en gráficos para todas las capas del mapa. Esta es la opción predeterminada.
  • Una sola capaLas etiquetas se convierten en gráficos en una sola capa. La capa se debe especificar en el parámetro Capa de entidades (single_layer en Python).
String
Capa de entidades
(Opcional)

La capa que contiene las etiquetas que hay que convertir cuando el parámetro Convertir se define como Una sola capa. Esta capa debe estar presente en el mapa.

Feature Layer
Sufijo de capa de gráficos
(Opcional)

El sufijo que se agrega a cada nueva capa de gráficos. Este sufijo se incorpora al nombre de la clase de entidad de origen para nueva capa de gráficos.

String
Extensión
(Opcional)

Especifica la extensión que contiene las etiquetas que se convertirán en gráficos.

  • Valor predeterminado: la extensión se basará en la extensión máxima de todas las entradas participantes. Esta es la opción predeterminada.
  • Combinación de entradas: la extensión se basará en la extensión máxima de todas las entradas.
  • Intersección de entradas: la extensión se basará en el área mínima en común de todas las entradas.
  • Extensión de visualización actual: la extensión es igual a la visualización actual. La opción no está disponible cuando no hay ningún mapa activo.
  • Como se especifica en la parte inferior: la extensión se basará en los valores mínimo y máximo de extensión que se especifiquen.
  • Examinar: la extensión se basará en un dataset existente.
Extent
Convertir etiquetas de todas las capas en una sola capa de salida de gráficos
(Opcional)

Especifica si las etiquetas se convertirán en capas de gráficos individuales o una sola capa de gráficos.

  • Activado: las etiquetas de todas las capas se convertirán en una sola capa de gráficos.
  • Desactivado: las etiquetas se convertirán en capas de gráficos individuales que se corresponden con sus capas. Esta es la opción predeterminada.

Boolean
Convertir las etiquetas no colocadas en gráficos
(Opcional)

Especifica si se crearán gráficos a partir de las etiquetas no colocadas.

  • Desactivado: solo se crean gráficos para las entidades que estén etiquetadas. Esta es la opción predeterminada.
  • Activado: los gráficos no colocados se almacenan en la capa de gráficos con su visibilidad desactivada.

Boolean
Capa de salida
(Opcional)

La capa de grupo que contiene los gráficos generados. Cuando esté trabajando en el panel Catálogo, puede usar la herramienta Guardar en archivo de capas para escribir la capa de grupo de salida en un archivo de capas. Cuando utiliza ArcGIS Pro con un mapa abierto, la herramienta agrega la capa de grupo a la visualización si la opción Agregar datasets de salida a un mapa abierto está activada en las opciones de geoprocesamiento. El grupo de capas que se crea es temporal y, una vez finalizada la sesión, no permanece en el sistema a menos que se guarde el proyecto.

Group Layer

arcpy.cartography.ConvertLabelsToGraphics(input_map, conversion_scale, {which_layers}, {single_layer}, {graphics_suffix}, {extent}, {multiple_graphics_layers}, {generate_unplaced}, {output_group_layer})
NombreExplicaciónTipo de datos
input_map

El objeto de mapa de entrada.

Map
conversion_scale

La escala a la que se van a convertir las etiquetas. Si se ha establecido una escala de referencia en el mapa, esta se utilizará para el cambio de tamaño de los símbolos y la creación de la capa de gráficos, pero la conversión se producirá a esta escala.

Double
which_layers
(Opcional)

Especifica si se convertirán los gráficos para todas las capas del mapa o solo para una.

  • ALL_LAYERSLas etiquetas se convierten en gráficos para todas las capas del mapa. Esta es la opción predeterminada.
  • SINGLE_LAYERLas etiquetas se convierten en gráficos en una sola capa. La capa se debe especificar en el parámetro Capa de entidades (single_layer en Python).
String
single_layer
(Opcional)

La capa que contiene las etiquetas que hay que convertir cuando el parámetro which_layers se define como SINGLE_LAYER. Esta capa debe estar presente en el mapa.

Feature Layer
graphics_suffix
(Opcional)

El sufijo que se agrega a cada nueva capa de gráficos. Este sufijo se incorpora al nombre de la clase de entidad de origen para nueva capa de gráficos.

String
extent
(Opcional)

Especifica la extensión que contiene las etiquetas que se convertirán en gráficos.

  • MAXOF: se utilizará la extensión máxima de todas las entradas.
  • MINOF: se utilizará el área mínima en común de todas las entradas.
  • DISPLAY: la extensión es igual a la visualización actual.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.
Extent
multiple_graphics_layers
(Opcional)

Especifica si las etiquetas se convertirán en capas de gráficos individuales o una sola capa de gráficos.

  • SINGLE_GRAPHICS_LAYERLas etiquetas de todas las capas se convertirán en una sola capa de gráficos.
  • GRAPHICS_LAYER_PER_FEATURE_LAYERLas etiquetas se convertirán en capas de gráficos individuales que se corresponden con sus capas. Esta es la opción predeterminada.
Boolean
generate_unplaced
(Opcional)

Especifica si se crearán gráficos a partir de las etiquetas no colocadas.

  • ONLY_PLACEDSolo se crean gráficos para las entidades que estén etiquetadas. Esta es la opción predeterminada.
  • GENERATE_UNPLACEDLos gráficos no colocados se almacenan en la capa de gráficos con su visibilidad desactivada.
Boolean
output_group_layer
(Opcional)

La capa de grupo que contiene los gráficos generados. Puede usar la herramienta Guardar en archivo de capa para escribir el grupo de capas de salida en un archivo de capa.

Group Layer

Muestra de código

Ejemplo de ConvertLabelsToGraphics (ventana de Python)

Ejemplo de Python de la función ConvertLabelsToGraphics que convierte etiquetas en gráficos para una sola capa del mapa.

import arcpy
arcpy.cartography.ConvertLabelsToGraphics(
    'Map1', 10000, 'SINGLE_LAYER', 'Schools', 'Graphics', 'MAXOF', 
    'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED', 'GroupGraphics')
Ejemplo 2 de ConvertLabelsToGraphics (script independiente)

Script independiente que convierte etiquetas en gráficos para el mapa mediante la función ConvertLabelsToGraphics.

# Name: ConvertLabelsToGraphics.py
# Description: Find all the maps in the project and
#              convert labels to graphics for each map
# import system modules
import arcpy
# Loop through the project, find all the maps, and
#   convert labels to graphics for each map,
#   using the name of the map as part of the graphics layer suffix 
project = arcpy.mp.ArcGISProject("D:\\data\\myproject.aprx")
for mp in project.listMaps():
    print("Converting labels to graphics for: " + mp.name)
    arcpy.cartography.ConvertLabelsToGraphics(
            mp, 10000, 'ALL_LAYERS', '', 'Graphics_' + mp.name, 'MAXOF', 
            'GRAPHICS_LAYER_PER_FEATURE_LAYER', 'ONLY_PLACED',  
            'GraphicsLayers_' + mp.name)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados