トップへ戻る

フィーチャクラス → フィーチャクラス (Feature Class to Feature Class) (変換)

このトピックの内容

  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報

サマリー

フィーチャクラスまたはフィーチャ レイヤーをフィーチャクラスに変換します。

使用法

  • 出力データセット内のフィールドとそれらのフィールドの内容を管理するには、[フィールド マップ] パラメーターを使用します。

    • フィールドの順序を変更するには、フィールド名を選択して、新しい位置にドラッグします。
    • 出力フィールドのデフォルトのデータ タイプは、最初に検出した (その名前の) 入力フィールドのデータ タイプと同じになります。 データ タイプをいつでも手動で他の任意の有効なデータ タイプに変更できます。
    • 使用できるマージ ルールは、最初、最後、結合、合計、平均、中央値、最頻値、最小、最大、標準偏差、個数です。
    • [結合] マージ ルールを使用している場合、スペース、カンマ、ピリオド、ダッシュなど、区切り文字を指定できます。 スペースを使用する場合は、入力ボックスの先頭にポインターを置き、Space キーを 1 回押してください。
    • 書式設定オプションを使用して、テキスト フィールドの開始位置と終了位置を指定できます。
    • 1 個しかないデータの標準偏差を計算しないでください。ゼロによる除算が発生するからです。したがって、入力ソースがただ 1 つである場合には、標準偏差オプションを使用すべきではありません。

    スクリプトでフィールドをマッピングする方法の詳細

  • フィーチャのサブセットを選択するために、SQL 式を使用できます。 [式] パラメーターの構文の詳細については、「クエリ式に使用されるエレメントの SQL リファレンス」をご参照ください。

  • サブタイプあるいはドメインを持つジオデータベース データをシェープファイルに変換すると、サブタイプとドメインのコードと説明の両方を出力に含むことができます。 この振舞いを制御するため、フィールド ドメイン情報の転送ジオプロセシング環境を使用してください。 デフォルトでは、ドメインとサブタイプのみが出力に含まれ、説明には含まれません。

    注意:

    サブタイプの説明とドメインの説明を含めてシェープファイルに変換すると、説明を含めない場合に比べて時間がかかる (パフォーマンスが低下する) 場合があります。 シェープファイルの出力にサブタイプの説明とドメインの説明が必要ない場合、パフォーマンスを最適化するためにチェックボックスをオフにして[フィールド ドメイン情報の転送] 環境 (Python では False または NOT_TRANSFER_DOMAINS) をデフォルトの振舞いにすることをお勧めします。

パラメーター

ダイアログPython

ラベル説明データ タイプ
入力フィーチャ

変換されるフィーチャクラスまたはフィーチャ レイヤー。

Feature Layer
出力場所

出力フィーチャクラスを作成する場所。 ジオデータベースまたはフォルダーを指定することができます。 [出力場所] がフォルダーの場合、出力はシェープファイルになります。

Workspace;Feature Dataset
出力名

出力フィーチャクラスの名前。

String
式
(オプション)

フィーチャのサブセットを選択するために使用する SQL 式。

SQL Expression
フィールド マップ
(オプション)

出力に含まれる属性フィールド、およびそれに対応するフィールド プロパティとソース フィールド。 デフォルトでは、入力のすべてのフィールドが含まれます。

フィールドの追加、削除、名前変更、並べ替えを行うことができ、フィールドのプロパティを変更することもできます。

マージ ルールによって、複数の入力フィールドの値を単一の出力値にマージまたは結合する方法を指定できます。 出力フィールドの値を指定する方法を決定するために使用できるマージ ルールは複数あります。

  • 最初 - 入力フィールドの最初の値を使用します。
  • 最後 - 入力フィールドの最後の値を使用します。
  • 結合 - 入力フィールドの値を結合します。
  • 合計 - 入力フィールドの値の合計を計算します。
  • 平均 - 入力フィールドの値の平均を計算します。
  • 中央値 - 入力フィールドの値の中央値を計算します。
  • 最頻値 - 最も頻度が高い値を使用します。
  • 最小 - すべての入力フィールドの値のうちの最小値を使用します。
  • 最大 - すべての入力フィールドの値のうちの最大値を使用します。
  • 標準偏差 - すべての入力フィールドの値に、標準偏差の分類法を使用します。
  • 個数 - 計算に含まれるレコード数を検出します。

Field Mappings
コンフィグレーション キーワード
(オプション)

リレーショナル データベース管理システム (RDBMS) 内のジオデータベース用のデフォルト ストレージ パラメーター (コンフィグレーション) を指定します。この設定は、エンタープライズ ジオデータベース テーブルを使用している場合にのみ適用可能です。

コンフィグレーション キーワードは、データベース管理者によって設定されます。

コンフィグレーション キーワードの詳細

String

派生した出力

ラベル説明データ タイプ
出力フィーチャクラス

出力フィーチャクラス。

Feature Class

arcpy.conversion.FeatureClassToFeatureClass(in_features, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})
名前説明データ タイプ
in_features

変換されるフィーチャクラスまたはフィーチャ レイヤー。

Feature Layer
out_path

出力フィーチャクラスを作成する場所。 ジオデータベースまたはフォルダーを指定することができます。 [出力場所] がフォルダーの場合、出力はシェープファイルになります。

Workspace;Feature Dataset
out_name

出力フィーチャクラスの名前。

String
where_clause
(オプション)

フィーチャのサブセットを選択するために使用する SQL 式。SQL 構文の詳細については、「ArcGIS で使用される条件式の SQL リファレンス」をご参照ください。

SQL Expression
field_mapping
(オプション)

出力に含まれる属性フィールド、およびそれに対応するフィールド プロパティとソース フィールド。 デフォルトでは、入力のすべてのフィールドが含まれます。

フィールドの追加、削除、名前変更、並べ替えを行うことができ、フィールドのプロパティを変更することもできます。

マージ ルールによって、複数の入力フィールドの値を単一の出力値にマージまたは結合する方法を指定できます。 出力フィールドの値を指定する方法を決定するために使用できるマージ ルールは複数あります。

  • 最初 - 入力フィールドの最初の値を使用します。
  • 最後 - 入力フィールドの最後の値を使用します。
  • 結合 - 入力フィールドの値を結合します。
  • 合計 - 入力フィールドの値の合計を計算します。
  • 平均 - 入力フィールドの値の平均を計算します。
  • 中央値 - 入力フィールドの値の中央値を計算します。
  • 最頻値 - 最も頻度が高い値を使用します。
  • 最小 - すべての入力フィールドの値のうちの最小値を使用します。
  • 最大 - すべての入力フィールドの値のうちの最大値を使用します。
  • 標準偏差 - すべての入力フィールドの値に、標準偏差の分類法を使用します。
  • 個数 - 計算に含まれるレコード数を検出します。

このパラメーターを定義するには、Python で FieldMappings クラスを使用します。

Field Mappings
config_keyword
(オプション)

リレーショナル データベース管理システム (RDBMS) 内のジオデータベース用のデフォルト ストレージ パラメーター (コンフィグレーション) を指定します。この設定は、エンタープライズ ジオデータベース テーブルを使用している場合にのみ適用可能です。

コンフィグレーション キーワードは、データベース管理者によって設定されます。

コンフィグレーション キーワードの詳細

String

派生した出力

名前説明データ タイプ
out_feature_class

出力フィーチャクラス。

Feature Class

コードのサンプル

FeatureClassToFeatureClass (フィーチャクラス → フィーチャクラス) の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで FeatureClassToFeatureClass 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/Public Buildings"
arcpy.FeatureClassToFeatureClass_conversion("buildings_point", 
                                            "C:/output/output.gdb", 
                                            "buildings_point")
FeatureClassToFeatureClass (フィーチャクラス → フィーチャクラス) の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、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
 
# Set environment settings
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/Public Buildings"
 
# Set local variables
inFeatures = "buildings_point"
outLocation = "C:/output/output.gdb"
outFeatureClass = "postoffices"
delimitedField = arcpy.AddFieldDelimiters(arcpy.env.workspace, "NAME")
expression = delimitedField + " = 'Post Office'"
 
# Execute FeatureClassToFeatureClass
arcpy.FeatureClassToFeatureClass_conversion(inFeatures, outLocation, 
                                            outFeatureClass, expression)

環境

現在のワークスペース, 出力座標系, 範囲, 地理座標系変換, XY 座標精度, XY 許容値, 出力に M 値がある, M 座標精度, M 許容値, 出力に Z 値がある, 出力データのデフォルト Z 値, Z 座標精度, Z 許容値, 修飾されたフィールド名, 出力データのコンフィグレーション キーワード, アタッチメントの保持, 自動コミット, 出力データの XY ドメイン, 出力データの M ドメイン, 出力データの Z ドメイン, フィールド ドメインの説明を転送, Global ID を維持

特殊なケース

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック

  • フィーチャのコピー (Copy Features)
  • ジオデータベースへ変換ツールセットの概要
  • ジオプロセシング ツールの検索
  • 属性フィールドの割り当て
  • 入力フィールドから出力フィールドへのマッピング

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報