リプレゼンテーションの追加（Add Representation） (カートグラフィ)
サマリ
フィーチャクラス リプレゼンテーションをジオデータベース フィーチャクラスに追加します。
使用法
-
ジオデータベース フィーチャクラスを、入力として使用する必要があります。
指定したフィールド名の付いた新しいフィールド 2 つが、入力フィーチャクラス属性テーブルの末尾に付加されます。これにより、フィーチャの各カテゴリの描画方法を管理するリプレゼンテーション ルールが識別されるようになり、フィーチャに特化したリプレゼンテーション ルールのオーバーライドを保持できるようになります。
-
インポート ルール レイヤを指定して、レイヤ ファイル上に指定されているレンダラ タイプ（例: カテゴリ固有の値）の下に一覧表示されるシンボル選択肢をインポートします。シンボル選択肢はすべて新しいリプレゼンテーション ルールとして、このフィーチャクラス リプレゼンテーションにコピーされます。インポート ルール レイヤが指定されていない場合、すべてのフィーチャが 1 つのデフォルト リプレゼンテーション ルールに割り当てられます。
-
インポート ルール レイヤに入力フィーチャクラスと同じソース フィーチャクラスが存在している場合は、[ルール ID の割り当て] パラメータを使用してフィーチャにリプレゼンテーション ルールを割り当てておくことにより、対象のフィーチャがインポート ルール レイヤのルール ID の割り当てと照合されるようになります。
-
インポート ルール レイヤが指定されていて、[ルール ID の割り当て] パラメータが ASSIGN に設定されている場合、レンダラ タイプの下に一覧表示されたシンボル選択肢に基づいて、すべてのフィーチャがリプレゼンテーション ルールに割り当てられます。インポート ルール レイヤを指定した場合でも、[ルール ID の割り当て] パラメータが NO_ASSIGN に設定してあるときは、すべてのフィーチャが 1 つのデフォルト リプレゼンテーション ルールに割り当てられます。
-
<その他の値すべて> を使用して入力レイヤ内のフィーチャがシンボル表示されている場合、リプレゼンテーションを追加したときに、そのシンボルはルール ID 1 になります。
構文
| パラメータ | 説明 | データ タイプ |
in_features |
新しいフィーチャクラス リプレゼンテーションの追加先となる入力ジオデータベース フィーチャクラス | Feature Layer |
representation_name |
追加対象となるフィーチャクラス リプレゼンテーションの名前 | String |
rule_id_field_name （オプション） |
各フィーチャのリプレゼンテーション ルールへの参照を保持する、ルール ID フィールドの名前 | String |
override_field_name （オプション） |
各フィーチャのリプレゼンテーション ルールへの参照を保持する、オーバーライド フィールドの名前 | String |
geometry_editing_option （オプション） |
リプレゼンテーション編集ツールでフィーチャを変更したときの、対応フィーチャクラス ジオメトリに対する処理を指定します。
| String |
import_rule_layer （オプション） |
フィーチャをフィーチャクラス リプレゼンテーションでシンボル表示するフィーチャ レイヤ。このフィーチャ レイヤからリプレゼンテーション ルールがインポートされます。 | Layer |
assign_rule_id_option （オプション） |
フィーチャにリプレゼンテーション ルールを割り当てるかどうかを指定します。ここでリプレゼンテーション ルールを割り当てておくと、対象のフィーチャがインポート ルール レイヤのルール ID の割り当てと照合されるようになります。このオプションが適用されるのは、[ルール レイヤのインポート] を指定した場合のみです。
| String |
コードのサンプル
次の Python ウィンドウ スクリプトは、AddRepresentation（リプレゼンテーションの追加）ツールをイミディエイト モードで使用する方法を、例を挙げて示したものです。
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.AddRepresentation_cartography("C:/data/cartography.gdb/buildings/footprints",
"footprints_Rep", "RuleID", "Override",
"STORE_CHANGE_AS_OVERRIDE", "C:/data/footprints.lyr", "ASSIGN")
このスタンドアロン スクリプトは、AddRepresentation（リプレゼンテーションの追加）ツールの使用例を示しています。
# Name: AddRepresentation_standalone_script.py # Description: Adds a feature class representation to a geodatabase feature class. # Import system modules import arcpy from arcpy import env # Set environment settings env.workspace = "C:/data" # Set local variables in_features = "C:/data/cartography.gdb/buildings/footprints" representation_name = "footprints_Rep" rule_id_field_name = "RuleID" override_field_name = "Override" geometry_editing_option = "STORE_CHANGE_AS_OVERRIDE" import_rule_layer = "C:/data/footprints.lyr" assign_rule_id_option = "ASSIGN" # Execute Add Representation arcpy.AddRepresentation_cartography(in_features, representation_name, rule_id_field_name, override_field_name, geometry_editing_option, import_rule_layer, assign_rule_id_option)