Aplicar simbología de capa (Administración de datos)

Resumen

Aplica la simbología de una capa o archivo de capa especificados a la entrada. Se puede aplicar a las capas de entidades, ráster, análisis de red, TIN y de estadísticas geográficas.

Uso

• La capa de simbología debe coincidir con el tipo de datos de la capa de entrada; por ejemplo, una capa de entidades no puede aplicarse a una capa ráster, y viceversa.

• La simbología solo se puede aplicar a entidades de la misma geometría; por ejemplo, una simbología de punto no se puede aplicar a una capa de polígono.

• Las propiedades de 3D como extrusión y desplazamiento no están habilitadas con esta herramienta.

• Si la entrada es una clase de entidad o una ruta de dataset, esta herramienta creará y devolverá automáticamente una nueva capa con el resultado de la herramienta aplicada.

• Tiene la opción de mantener o actualizar los rangos de simbología con el parámetro Actualizar rangos de simbología en función de los datos. Los métodos de simbología predeterminados son dinámicos. Por ejemplo, el método de clasificación de cortes naturales de cinco clases de la capa de simbología se aplica a la capa de entrada y los valores de rango se actualizan para reflejar los valores de Shape_Area de la capa de entrada. Mantener rangos utilizará los mismos valores que la capa de simbología. Actualizar hará el método de clasificación de cortes naturales de cinco clases a partir del campo Shape_Area de capas de entrada.

  

  Los siguientes métodos son dinámicos:

  • Simbología de valores únicos para una entidad
    • Los valores únicos se actualizan para reflejar los valores de la capa de entrada.
    • Si no desea que se actualice la clasificación de valores únicos, elija el símbolo predeterminado <todos los demás valores> en la capa de simbología.
  • Simbología de colores graduados para una entidad
    • Los valores del rango se actualizan con los valores de la capa de entrada.
    • Si no desea actualizar la salida del rango, elija la clasificación manual.
  • Valor clasificado que representa un ráster
    • Los valores del rango se actualizan para reflejar los valores de la capa de entrada.
    • Si no desea actualizar la salida del rango, elija la clasificación manual.

• Al configurar el parámetro Actualizar rangos de simbología en función de los datos como Mantener rangos, se copiarán las etiquetas desde la Capa de simbología a la Capa de entrada. Si el parámetro se establece en Actualizar rangos, las etiquetas se volverán a calcular.

Sintaxis

arcpy.management.ApplySymbologyFromLayer(in_layer, in_symbology_layer, {symbology_fields}, {update_symbology})

Parámetro	Explicación	Tipo de datos
in_layer	Capa a la que se aplicará la simbología.	Feature Layer; Raster Layer; Layer
in_symbology_layer	La simbología de esta capa se aplicará a la capa de entrada. Se admiten los archivos .lyrx y .lyr.	Layer
symbology_fields [[field_type, source_field, target_field],...] (Opcional)	Los campos de la capa de entrada que coinciden con los campos de simbología utilizados en la capa de simbología. Los campos de simbología contienen tres propiedades: Tipo de campo: especifica el tipo de campo (valor de simbología, normalización u otro tipo). Campo de origen: el campo de simbología utilizado por la capa de simbología. Utilice un valor vacío o "#" si no conoce el campo de origen y desea usar el predeterminado. Campo de destino: el campo de la capa de entrada que se va a utilizar al aplicar la simbología. Los tipos de campos admitidos son: VALUE_FIELD: el campo principal utilizado para simbolizar valores NORMALIZATION_FIELD: el campo utilizado para normalizar valores cuantitativos EXCLUSION_CLAUSE_FIELD: el campo utilizado para la cláusula de exclusión de simbología CHART_RENDERER_PIE_SIZE_FIELD: el campo utilizado para definir el tamaño de los símbolos de gráfico circular ROTATION_XEXPRESSION_FIELD: el campo utilizado para definir la rotación de los símbolos en el eje x ROTATION_YEXPRESSION_FIELD: el campo utilizado para definir la rotación de los símbolos en el eje y ROTATION_ZEXPRESSION_FIELD: el campo utilizado para definir la rotación de los símbolos en el eje z TRANSPARENCY_EXPRESSION_FIELD: el campo utilizado para definir la transparencia de los símbolos TRANSPARENCY_NORMALIZATION_FIELD: el campo utilizado para normalizar valores de transparencia SIZE_EXPRESSION_FIELD: el campo utilizado para definir el tamaño o el ancho de los símbolos COLOR_EXPRESSION_FIELD: el campo utilizado para definir el color de los símbolos PRIMITIVE_OVERRIDE_EXPRESSION_FIELD: el campo utilizado para definir distintas propiedades de capas de símbolos individuales	Value Table
update_symbology (Opcional)	Especifica si se actualizarán los rangos de simbología. DEFAULT —Los rangos de simbología se actualizarán, excepto en las siguientes situaciones: Si la capa de entrada está vacía Si la capa de simbología utiliza rupturas de clase (por ejemplo, colores graduados o símbolos graduados), y el método de clasificación es manual o un intervalo definido Si la capa de simbología utiliza valores únicos y la opción Mostrar el resto de valores está activada UPDATE —Los rangos de simbología se actualizarán. MAINTAIN —Los rangos de simbología no se actualizarán, sino que se mantendrán.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_layer	La capa de entrada actualizada.	Capa

Muestra de código

Ejemplo 1 de ApplySymbologyFromLayer (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función ApplySymbologyFromLayer en modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data.gdb"
arcpy.ApplySymbologyFromLayer_management("sf_points", "sf_points_water.lyrx")

Ejemplo 2 de ApplySymbologyFromLayer (script independiente)

El siguiente script independiente muestra cómo utilizar la función ApplySymbologyFromLayer en un script independiente.

# Import system modules
import arcpy
# Set the current workspace
arcpy.env.workspace = "C:/data.gdb"
# Set layer to apply symbology to
inputLayer = "sf_points"
# Set layer that output symbology will be based on
symbologyLayer = "water_symbols_pnt.lyrx"
# Apply the symbology from the symbology layer to the input layer
arcpy.ApplySymbologyFromLayer_management(inputLayer, symbologyLayer)

Ejemplo 3 de ApplySymbologyFromLayer (script independiente)

El siguiente script independiente muestra cómo utilizar la función ApplySymbologyFromLayer en un script independiente.

# Import system modules
import arcpy
# Set the current workspace
arcpy.env.workspace = "C:/data.gdb"
# Set layer to apply symbology to
inputLayer = "InlandEmpireBlocks"
# Set layer that output symbology will be based on
symbologyLayer = "USCensusBlocks.lyrx"
# The symbology layer is symbolized by population normalized by area.
# Symbolize the input by Pop2014 field normalized to Square Miles
symbologyFields = [["VALUE_FIELD", "#", "Pop2014"], 
                   ["NORMALIZATION_FIELD", "#", "SQ_MILES"]]
# Apply the symbology from the symbology layer to the input layer
arcpy.ApplySymbologyFromLayer_management(inputLayer, symbologyLayer, 
                                         symbologyFields)

Entornos

Auto ejecución, Espacio de trabajo actual

Información de licenciamiento

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