フィーチャクラス → フィーチャクラス(Feature Class to Feature Class) (変換)
サマリ
シェープファイル、カバレッジ フィーチャクラスまたはジオデータベース フィーチャクラスを、シェープファイルやジオデータベース フィーチャクラスに変換します。
使用法
-
[フィールド マップ] パラメータは、[入力フィーチャ] 内の入力フィールドを [出力フィーチャ] に書き込む方法を制御します。
- 変換中にフィールドをドロップするには、[フィールド マップ] から入力フィールドを削除します。これにより、入力フィーチャクラスは影響を受けません。
- 新しいフィールドが作成され、出力フィールドの内容が複数の(異なる名前の)フィールドから生成された場合、複数の入力フィールドから、1 つの出力フィールドを生成できます。
- デフォルトでは、出力フィールドのデータ タイプは、最初に検出した(その名前の)入力フィールドのデータ タイプと同じになります。データ タイプは、任意の有効なデータ タイプに手動でいつでも変更できます。ツール ダイアログ ボックスを使用している場合、有効なデータ タイプはすべて一覧表示されます。
- マージ ルールを使用している場合、スペース、カンマ、ピリオド、ダッシュなど、区切り文字を独自に指定できます。スペースを使用する場合は、入力ボックスの先頭でマウス ポインタを置き、スペース バーを 1 回クリックしてください。
- 最初、最後、結合、合計、平均、中間、最小、最大、標準偏差と、多くのマージ ルールが使用できます。
- [形式] オプションは、入力フィールドがテキスト タイプ(および [結合] マージ ルール)の場合のみ使用できます。始点、終点などを指定できます。形式の変更は、選択した入力フィールドにだけ適用することも、同じ名前の入力フィールドすべてに適用することも可能です。
- 1 個しかないデータの標準偏差を計算することはできません。ゼロによる除算が発生するからです。したがって、入力ソースがただ 1 つである場合には、[標準偏差] オプションを使用すべきではありません。
-
[フィーチャのコピー(Copy Features)] ツールを使用しても、シェープファイル、カバレッジ フィーチャクラス、ジオデータベース(ファイル、パーソナル、ArcSDE)フィーチャクラスをシェープファイルやジオデータベース(ファイル、パーソナル、ArcSDE)フィーチャクラスに変換することができます。
-
フィーチャのサブセットを選択するために、SQL 式を使用できます。[条件式] パラメータの構文の詳細については、「SQL 式の作成について」または「SQL リファレンス」をご参照ください。
サブタイプあるいはドメインを持つジオデータベース データをシェープファイルに変換すると、サブタイプとドメインのコードと説明の両方を出力に含むことができます。この振舞いを制御するため、フィールド ドメイン情報の転送ジオプロセシング環境を使ってください。デフォルトでは、ドメインとサブタイプのみが出力に含まれ、説明には含まれません。
注意:サブタイプの説明とドメインの説明を含めてシェープファイルに変換すると、説明を含めない場合に比べて時間がかかる(パフォーマンスが低下する)場合があります。シェープファイルの出力にサブタイプの説明とドメインの説明が必要ない場合、パフォーマンスを最適化するためにチェックボックスをオフにして(スクリプト中では False あるいは NOT_TRANSFER_DOMAINS)フィールド ドメイン情報の転送環境をデフォルトの振舞いにすることをおすすめします。
構文
パラメータ | 説明 | データ タイプ |
in_features |
変換されるフィーチャクラスまたはフィーチャ レイヤ。 | Feature Layer |
out_path |
出力フィーチャクラスを作成する場所。ジオデータベースまたはフォルダを指定することができます。[出力場所] がフォルダの場合、出力はシェープファイルになります。 | Workspace;Feature Dataset |
out_name |
出力フィーチャクラスの名前。 | String |
where_clause (オプション) |
フィーチャのサブセットを選択するために使用する SQL 式。この式の構文はデータ ソースによって多少異なります。たとえば、クエリ対象がファイル ジオデータベース、ArcSDE ジオデータベース、シェープファイル、またはカバレッジの場合は、フィールド名を二重引用符で囲みます。 "MY_FIELD" クエリ対象がパーソナル ジオデータベースの場合は、以下のようにフィールドを角括弧で囲みます。 [MY_FIELD] Python では、文字列を単一引用符または二重引用符で囲みます。SQL 式の WHERE 句などで通常行われるように、引用符を含む文字列を作成する場合は、引用符を円記号(\)でエスケープするか、文字列を三重引用符で囲みます。たとえば、次のような WHERE 句を記述する場合、 "CITY_NAME" = 'Chicago' 次のように文字列全体を二重引用符で囲み、内部の二重引用符をエスケープします。 " \"CITY_NAME\" = 'Chicago' " または、次のように文字列全体を単一引用符で囲み、内部の単一引用符をエスケープします。 ' "CITY_NAME" = \'Chicago\' ' あるいは、次のようにエスケープしないで文字列全体を三重引用符で囲みます。 """ "CITY_NAME" = 'Chicago' """ SQL 構文の詳細とデータ ソースによる違いについては、ヘルプ トピックの「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。 | SQL Expression |
field_mapping (オプション) |
入力フィーチャクラスから選択されたフィールドとフィールドの内容です。出力フィールドの追加、名前変更、削除に加えて、データ タイプやマージ ルールなどのプロパティの設定を行うことができます。 | Field Mappings |
config_keyword (オプション) |
ファイル ジオデータベースおよび ArcSDE ジオデータベースの格納パラメータ(コンフィグレーション)を指定します。パーソナル ジオデータベースは、コンフィグレーション キーワードを使用しません。 ArcSDE Enterprise Edition の ArcSDE コンフィグレーション キーワードは、データベース管理者によって設定されます。 | String |
コードのサンプル
次の Python ウィンドウ スクリプトで、FeatureClassToFeatureClass(フィーチャクラス → フィーチャクラス)ツールをイミディエイト モードで使用する方法を示します。
import arcpy
from arcpy import env
env.workspace = "C:/data/GreenvalleyDB.mdb/Public Buildings"
arcpy.FeatureClassToFeatureClass_conversion("buildings_point",
"C:/output/output.gdb",
"buildings_point")
次のスタンドアロン スクリプトで、FeatureClassToFeatureClass(フィーチャクラス → フィーチャクラス)ツールの使用方法を示します。
# Name: FeatureClassToFeatureClass_Example2.py
# Description: Use FeatureClassToFeatureClass with an expression to create a subset
# of the original feature class.
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data/GreenvalleyDB.mdb/Public Buildings"
# Set local variables
inFeatures = "buildings_point"
outLocation = "C:/output/output.gdb"
outFeatureClass = "postoffices"
delimitedField = arcpy.AddFieldDelimiters(env.workspace, "NAME")
expression = delimitedField + " = 'Post Office'"
# Execute FeatureClassToFeatureClass
arcpy.FeatureClassToFeatureClass_conversion(inFeatures, outLocation,
outFeatureClass, expression)