このツールは、指定したレイヤーまたはレイヤー ファイルから入力レイヤーにシンボル情報を適用します。 フィーチャ、ラスター、ネットワーク解析、TIN、および Geostatistical レイヤーに適用することができます。
シンボル レイヤーは入力レイヤーのデータ タイプに一致する必要があります。たとえば、フィーチャ レイヤーをラスター レイヤーに適用することはできません。その逆も同様です。
シンボル情報は同じジオメトリのフィーチャにのみ適用できます。たとえば、ポイント シンボルをポリゴン レイヤーに適用することはできません。
シンボルに加えて、このツールは、時間フィールド、3D 標高とオフセット、ラベル クラス、HTML ポップアップの各プロパティも転送します。
入力がフィーチャクラスまたはデータセット パスの場合、このツールは、ツールの結果が適用された新しいレイヤーを自動的に作成して返します。
[データごとにシンボル範囲を更新] パラメーターでシンボル範囲を維持または更新できます。 デフォルトのシンボル表示方法は動的です。 たとえば、シンボル レイヤーの 5 段階の自然分類方式が入力レイヤーに適用され、範囲の値が更新されて、入力レイヤーの Shape_Area の値が反映されています。 [範囲の維持] オプションでは、シンボル レイヤーと同じ値が使用されます。 [範囲の更新] オプションでは、入力レイヤーの Shape_Area フィールドから 5 段階の自然分類方式を使用します。
次の処理が動的に行われます。
[データごとにシンボル範囲を更新] パラメーターを [範囲の維持] に設定すると、ラベルが [シンボル レイヤー] の値から [入力レイヤー] の値にコピーされます。 パラメーターを [範囲の更新] に設定すると、ラベルは再計算されます。
シンボルはレイヤーの継続期間のみ有効です。 レイヤーは、AllSource セッションを保存するか、[レイヤーをファイルへ保存 (Save Layer To File)] ツールを使用してレイヤーをレイヤー ファイルに保存することで、保持できます。
スクリプト ツールで作成されたシンボルを確認するには、ツールがレイヤーを派生した出力パラメーターとして含む必要があります。 同様に、シンボルの変更を確認するには、モデル ツールで、[更新された入力レイヤー] パラメーター値を派生したモデル パラメーターとして追加する必要があります。
| ラベル | 説明 | データ タイプ |
入力レイヤー | シンボル情報を適用するレイヤー。 | Feature Layer; Raster Layer; Layer |
シンボル レイヤー | 入力レイヤーに適用されるシンボルを含むレイヤー。 .lyrx ファイルと .lyr ファイルの両方をサポートしています。 | Layer |
シンボル フィールド (オプション) | シンボル レイヤーで使用されているシンボル フィールドと一致する入力レイヤーのフィールド。 シンボル フィールドには次の 3 つのプロパティが含まれています:
サポートされているフィールド タイプは次のとおりです。
| Value Table |
データごとにシンボル範囲を更新 (オプション) | シンボル範囲を更新するかどうかを指定します。
| String |
| ラベル | 説明 | データ タイプ |
| 更新された入力レイヤー | 更新された入力レイヤー。 | Layer |
arcpy.management.ApplySymbologyFromLayer(in_layer, in_symbology_layer, {symbology_fields}, {update_symbology})| 名前 | 説明 | データ タイプ |
in_layer | シンボル情報を適用するレイヤー。 | Feature Layer; Raster Layer; Layer |
in_symbology_layer | 入力レイヤーに適用されるシンボルを含むレイヤー。 .lyrx ファイルと .lyr ファイルの両方をサポートしています。 | Layer |
symbology_fields [[field_type, source_field, target_field],...] (オプション) | シンボル レイヤーで使用されているシンボル フィールドと一致する入力レイヤーのフィールド。 シンボル フィールドには次の 3 つのプロパティが含まれています:
サポートされているフィールド タイプは次のとおりです。
| Value Table |
update_symbology (オプション) | シンボル範囲を更新するかどうかを指定します。 | String |
| 名前 | 説明 | データ タイプ |
| out_layer | 更新された入力レイヤー。 | Layer |
次の Python ウィンドウ スクリプトは、イミディエイト モードで ApplySymbologyFromLayer 関数を使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data.gdb"
arcpy.management.ApplySymbologyFromLayer("sf_points", "sf_points_water.lyrx")次のスクリプトは、スタンドアロン スクリプトで ApplySymbologyFromLayer 関数を使用する方法を示しています。
# 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)次のスクリプトは、スタンドアロン スクリプトで ApplySymbologyFromLayer 関数を使用する方法を示しています。
# 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)スクリプト ツールでは、派生された複数の出力フィーチャ レイヤーにシンボルを適用します。 ツール例には、以下のパラメーターがあります。
# 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)