Geoprocessing tool that applies the symbology from a specified layer to the input.
The symbology layer must match the data type of the input layer; for example, a feature layer cannot be applied to a raster layer and vice versa.
The symbology can only be applied to features of the same geometry; for example, point symbology cannot be applied to a polygon layer.
3D properties such as extrusion and offset are not supported with this tool.
If the input is a feature class or dataset path, this tool will automatically create and return a new layer with the result of the tool applied.
You can choose to maintain or update the symbology in the Update Symbology Ranges by Data parameter, or leave the default. By default, symbology methods can be dynamic; for example, the symbology is updated to reflect the characteristics of the input layer as shown below. The five-class Natural Breaks classification method from the symbology layer is applied to the input layer, and the range values are updated to reflect the Shape_Area values of the input layer.
The following methods are dynamic:
Labels can be applied from the symbology layer by setting theUpdate Symbology Ranges by Data parameter to Maintain ranges.
| Parameter | Explanation |
|---|---|
| in_layer | The layer to which the symbology will be applied. |
| in_symbology_layer | The symbology of this layer is applied to the input layer. Both .lyrx and .lyr files are supported. |
| update_symbology (Optional) | Specifies how symbology ranges are updated.Default—Symbology ranges will be updated, except in the following situations: when the input layer is empty; when the symbology layer uses class breaks (for example, graduated colors or graduated symbols), and the classification method is manual or defined interval; or when the symbology layer uses unique values, and the Show all other values option is checked.Update ranges—Update the symbology ranges.Maintain ranges—Maintain the symbology ranges. |
ApplySymbologyFromLayer example 1 (Python window)
The following Python window script demonstrates how to use the ApplySymbologyFromLayer function in immediate mode.
import arcpy
arcpy.env.workspace = "C:/data.gdb"
arcpy.ApplySymbologyFromLayer_management("sf_points", "sf_points_water.lyrx")
ApplySymbologyFromLayer example 2 (stand-alone script)
The following stand-alone script shows how to use the ApplySymbologyFromLayer function in scripting.
# 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)
ApplySymbologyFromLayer example 3 (stand-alone script)
The following stand-alone script shows how to use the ApplySymbologyFromLayer function in scripting.
# 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)
There are no tags for this item.
There are no credits for this item.
There are no use limitations for this item.