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.

  • Además de la simbología, la herramienta también transferirá las propiedades campo de tiempo, elevación y desplazamiento 3D, clase de etiqueta y HTML emergente.

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

  • Puede 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. La opción Mantener rangos utilizará los mismos valores que la capa de simbología. La opción Actualizar rangos utilizará el método de clasificación de cortes naturales de cinco clases a partir del campo Shape_Area de la capa de entrada.

    Ilustración de la herramienta Aplicar simbología de capa

    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 del valor de Capa de simbología en el valor de Capa de entrada. Si el parámetro se establece en Actualizar rangos, las etiquetas se volverán a calcular.

  • La simbología persiste solo lo que dure la capa. Una capa se puede retener guardando la sesión de AllSource o guardándola en un archivo de capa con la herramienta Guardar capa en archivo.

    Para ver la simbología creada en una herramienta de script, la herramienta debe incluir la capa como un parámetro de salida derivado. Del mismo modo, el valor del parámetro Capa de entrada actualizada se debe agregar como una herramienta de modelo de parámetro de modelo derivada para ver los cambios en la simbología.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de entrada

Capa a la que se aplicará la simbología.

Feature Layer; Raster Layer; Layer
Simbología capa

La capa que contiene la simbología que se aplicará a la capa de entrada. Se admiten los archivos .lyrx y .lyr.

Layer
Campos de simbología
(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: 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:

  • Campo de valor: el campo principal utilizado para simbolizar valores
  • Campo de normalización: el campo utilizado para normalizar valores cuantitativos
  • Campo de cláusula de exclusión: el campo utilizado para la cláusula de exclusión de simbología
  • Campo de tamaño de gráfico circular del renderizador de gráficos: campo utilizado para definir el tamaño de los símbolos de gráfico circular
  • Campo de expresión de rotación X: el campo utilizado para definir la rotación de los símbolos en el eje x
  • Campo de expresión de rotación Y: el campo utilizado para definir la rotación de los símbolos en el eje y
  • Campo de expresión de rotación Z: el campo utilizado para definir la rotación de los símbolos en el eje z
  • Campo de expresión de transparencia: el campo utilizado para definir la transparencia de los símbolos
  • Campo de normalización de transparencia: el campo utilizado para normalizar valores de transparencia
  • Campo de expresión de tamaño: el campo utilizado para definir el tamaño o el ancho de los símbolos
  • Campo de expresión de color: el campo utilizado para definir el color de los símbolos
  • Campo de expresión de excepción primitiva: el campo utilizado para definir distintas propiedades de capas de símbolos individuales

Value Table
Actualizar rangos de simbología en función de los datos
(Opcional)

Especifica si se actualizarán los rangos de simbología.

  • PredeterminadoLos rangos de simbología se actualizarán, excepto: 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, o bien si la capa de simbología utiliza valores únicos y la opción Mostrar el resto de valores está activada.
  • Actualizar rangosLos rangos de simbología se actualizarán.
  • Mantener rangosLos rangos de simbología no se actualizarán, sino que se mantendrán.
String

Salida derivada

EtiquetaExplicaciónTipo de datos
Capa de entrada actualizada

La capa de entrada actualizada.

Layer

arcpy.management.ApplySymbologyFromLayer(in_layer, in_symbology_layer, {symbology_fields}, {update_symbology})
NombreExplicaciónTipo de datos
in_layer

Capa a la que se aplicará la simbología.

Feature Layer; Raster Layer; Layer
in_symbology_layer

La capa que contiene la simbología que 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: 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.

  • DEFAULTLos rangos de simbología se actualizarán, excepto en las siguientes situaciones:
  • UPDATELos rangos de simbología se actualizarán.
  • MAINTAINLos rangos de simbología no se actualizarán, sino que se mantendrán.
String

Salida derivada

NombreExplicaciónTipo de datos
out_layer

La capa de entrada actualizada.

Layer

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 de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data.gdb"
arcpy.management.ApplySymbologyFromLayer("sf_points", "sf_points_water.lyrx")
Ejemplo 2 de ApplySymbologyFromLayer (script independiente)

Lo siguiente 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.management.ApplySymbologyFromLayer(inputLayer, symbologyLayer)
Ejemplo 3 de ApplySymbologyFromLayer (secuencia de comandos independiente)

Lo siguiente 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.management.ApplySymbologyFromLayer(inputLayer, symbologyLayer, 
                                         symbologyFields)
Ejemplo 3 de ApplySymbologyFromLayer (herramienta de script)

En una herramienta de script, aplique simbología a varias capas de entidades de salida derivadas. La herramienta de ejemplo tiene estos parámetros:

  • Capas de entrada
    • Tipo de datos: capa de entidades (multivalor)
    • Tipo: requerido
    • Dirección: entrada
  • Simbología
    • Tipo de datos: capa de entidades
    • Tipo: requerido
    • Dirección: entrada
  • Salida derivada
    • Tipo de datos: capa de entidades (multivalor)
    • Tipo: derivado
    • Dirección: salida

# Import system modules
import os
import arcpy

# Get Parameters
layers = arcpy.GetParameter(0)  # Accepts Feature Layers (multivalue)
sym = arcpy.GetParameter(1)  # Accepts a Feature Layer

# Apply symbology to each input layer, store the result objects in a list
results = []
for layer in layers:

    # Derive the name of the output featureclass
    layername = arcpy.Describe(layer).baseName
    outfeature = os.path.join(arcpy.env.scratchGDB, layername + "_out")

    # Copy feature to get output. This step could be replaced by other
				# steps that produce or manipulate a featureclass.
    arcpy.management.CopyFeatures(layer, outfeature)

				# Apply symbology to the each final output
    res = arcpy.management.ApplySymbologyFromLayer(outfeature, sym)

    # Append multivalue feature
    results.append(res)

# Set the symbology of the derived output parameter using the 
# list of result objects
arcpy.SetParameter(2, results)