概要
このツールは、指定したレイヤーまたはレイヤー ファイルから入力レイヤーにシンボル情報を適用します。フィーチャ、ラスター、ネットワーク解析、TIN、および Geostatistical レイヤーに適用することができます。
使用法
シンボル レイヤーは入力レイヤーのデータ タイプに一致する必要があります。たとえば、フィーチャ レイヤーをラスター レイヤーに適用することはできません。その逆も同様です。
シンボル情報は同じジオメトリのフィーチャだけに適用することができます。たとえば、ポイント シンボルをポリゴン レイヤーに適用することはできません。
このツールでは、立ち上げやオフセットなどの 3D プロパティはサポートされません。
入力がフィーチャクラスまたはデータセット パスの場合、このツールは、ツールの結果が適用された新しいレイヤーを自動的に作成して返します。
[データごとにシンボル範囲を更新] パラメーターでシンボル情報を維持または更新するか、デフォルトのままにしておくことができます。デフォルトでは、シンボル情報の処理は動的です。たとえば、以下で示されているように、シンボル情報は更新されて、入力レイヤーの特性が反映されます。この例では、シンボル レイヤーの 5 段階の自然分類方式が入力レイヤーに適用され、範囲の値が更新されて、入力レイヤーの Shape_Area の値が反映されています。
![[レイヤーのシンボル情報を適用 (Apply Symbology From Layer)] の例](GUID-DF9CF951-6EB0-454D-A0EF-23EAEFEACE4A-web.png "[レイヤーのシンボル情報を適用 (Apply Symbology From Layer)] の例")
次の処理が動的に行われます。
- フィーチャに対する個別値のシンボル表示
- 個別値が更新されて、入力レイヤーの値が反映されます。
- 個別値分類が更新されないようにするには、シンボル レイヤーで [<その他の値すべて>] のデフォルト シンボルを選択します。
- フィーチャに対する等級色のシンボル表示
- 範囲の値が入力レイヤーの値に更新されます。
- 範囲出力が更新されないようにするには、手動分類を選択します。
- ラスターに対する分類値のレンダリング
- 範囲の値が更新され、入力レイヤーの値が反映されます。
- 範囲出力が更新されないようにするには、手動分類を選択します。
- フィーチャに対する個別値のシンボル表示
[データごとにシンボル範囲を更新] パラメーターの値にかかわらず、すべてのラベル クラスが [シンボル レイヤー] から [入力レイヤー] にコピーされます。
構文
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 | 更新された入力レイヤー。 | レイヤー |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで ApplySymbologyFromLayer 関数を使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data.gdb"
arcpy.ApplySymbologyFromLayer_management("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.ApplySymbologyFromLayer_management(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.ApplySymbologyFromLayer_management (inputLayer, symbologyLayer, symbologyFields)環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい