Hacer coincidir la simbología de capa con un estilo (Administración de datos)

Resumen

Crea simbología de valor único para la capa de entrada basándose en el campo o la expresión de entrada, al hacer coincidir las cadenas del campo o la expresión de entrada con los nombres de los símbolos del estilo de entrada.

Uso

  • Se crea una simbología de Valores únicos para la capa de entrada. Si la capa está en el mapa actual, esta se actualiza. De lo contrario, la capa simbolizada se agrega al mapa. De un modo u otro, la simbología de capa existente se sobrescribe.

  • Se crean clases de símbolo de valores únicos con el parámetro Valores de coincidencia (campo o expresión) y se simbolizan con un símbolo del parámetro Estilo de entrada, cuyo nombre coincide con el valor del campo o el valor de la expresión resultante. Cuando la herramienta asigna valores de un solo campo y dicho campo es un campo de subtipo o tiene un dominio de valor codificado, los símbolos se asignan a la descripción de subtipo o dominio.

  • Las capas de entidades de puntos y multipunto se asignan a los símbolos de punto del estilo. Las capas de entidades de polilíneas se asignan a símbolos de línea. Las capas de entidades poligonales se asignan a símbolos de polígono. Las capas de entidades multiparche se asignan a símbolos de malla.

  • Si no se encuentra ninguna coincidencia, la clase de símbolo se dibuja con el símbolo predeterminado del resto de valores.

Sintaxis

arcpy.management.MatchLayerSymbologyToAStyle(in_layer, match_values, in_style)
ParámetroExplicaciónTipo de datos
in_layer

La capa o el archivo de capa de entrada a los que se aplican símbolos asignados como clases de símbolo de valores únicos. La capa de entrada puede contener simbología de puntos, líneas, polígonos, multipunto o multiparche. La simbología existente de la capa se sobrescribe.

Feature Layer
match_values

El campo o la expresión en los que se simboliza la capa de entrada. Los valores de campo o valores de expresión resultantes se asignan a nombres de símbolos del estilo especificado para asignar símbolos a las clases de símbolo resultantes.

Calculator Expression
in_style

El estilo que contiene los símbolos con nombres que coinciden con los valores de expresión o campo.

String

Salida derivada

NombreExplicaciónTipo de datos
out_layer

La capa simbolizada actualizada.

Capa de entidades

Muestra de código

Ejemplo de MatchLayerSymbologyToAStyle (ventana de Python)

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

import arcpy
arcpy.management.MatchLayerSymbologyToAStyle("Streets", "$feature.RoadClass", 
                                             r"C:\RoadClasses.stylx")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados