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

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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 mapa—Las etiquetas se convierten en gráficos para todas las capas del mapa. Esta es la opción predeterminada. Una sola capa—Las 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. Extensión de visualización actual : la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo. Extensión de dibujo : la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa. Nota: Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta. Nota: Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión. Extensión de mapa : la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas. Cada capa de mapas tiene las opciones siguientes: Todas las entidades : extensión de todas las entidades en una capa. Entidades seleccionadas: extensión de las entidades seleccionadas en la capa. Entidades visibles : extensión de las entidades visibles en la capa. Nota: Las extensiones de las opciones Entidades seleccionadas y Entidades visibles solo están disponibles para capas de entidades. Examinar : la extensión se basará en un dataset existente. Intersección de entradas : la extensión se basará en la extensión mínima o en común de todas las entradas. Si ninguna de las entradas se solapa, podría generarse una extensión nula con todos los valores igual a cero. Combinación de entradas : la extensión se basa en la extensión máxima o combinada de todas las entradas. Portapapeles : la extensión puede copiarse en y desde el portapapeles. Copiar extensión : copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles. Pegar extensión : pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa. Nota: Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial. Restablecer extensión : la extensión se restablecerá al valor predeterminado. Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. Precaución: El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.	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

Python

arcpy.cartography.ConvertLabelsToGraphics(input_map, conversion_scale, {which_layers}, {single_layer}, {graphics_suffix}, {extent}, {multiple_graphics_layers}, {generate_unplaced}, {output_group_layer})

Nombre	Explicación	Tipo 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_LAYERS—Las etiquetas se convierten en gráficos para todas las capas del mapa. Esta es la opción predeterminada. SINGLE_LAYER—Las 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 usará la extensión máxima de todas las entradas. MINOF: se usará el área mínima común a todas las entradas. DISPLAY: la extensión es igual a la visualización visible. 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_LAYER—Las etiquetas de todas las capas se convertirán en una sola capa de gráficos. GRAPHICS_LAYER_PER_FEATURE_LAYER—Las 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_PLACED—Solo se crean gráficos para las entidades que estén etiquetadas. Esta es la opción predeterminada. GENERATE_UNPLACED—Los 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í