フィーチャのエクスポート (Export Features) (変換)

サマリー

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

使用法

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

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

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

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

  • 行は、[並べ替えフィールド] のパラメーター値を指定することにより、昇順または降順で並べ替えできます。 2 つ以上のフィールドを指定した場合、最初のフィールドによって行が並べ替えられ、次にその順序内で 2 番目のフィールドによって並べ替えられ、以降、同様に並べ替えが続けられます。

  • サブタイプあるいはドメインを持つジオデータベース データを変換し、出力ワークスペースがジオデータベースではない場合、サブタイプとドメインのコードおよび説明の両方を出力に含むことができます。 「フィールド ドメインの説明を転送」環境を使用してこれを行います。 デフォルトでは、ドメインとサブタイプのみが出力に含まれ、説明には含まれません。

    注意:

    サブタイプの説明とドメインの説明を含めてシェープファイルに変換すると、説明を含めない場合に比べて時間がかかる (パフォーマンスが低下する) 場合があります。 出力にサブタイプの説明とドメインの説明が必要ない場合、パフォーマンスを最適化するために、フィールド ドメインの説明環境をオフのままにします。

パラメーター

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

新しいフィーチャクラスにエクスポートする入力フィーチャ。

Feature Layer
出力フィーチャクラス

エクスポートされたフィーチャを格納する出力フィーチャクラス。

Feature Class
(オプション)

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

SQL Expression
フィールド エイリアスを名前として使用する
(オプション)

入力のフィールド名またはフィールド エイリアスを出力フィールド名として使用するかどうかを指定します。

  • オフ - 入力のフィールド名を出力フィールド名として使用します。 これがデフォルトです。
  • オン - 入力のフィールド エイリアスを出力フィールド名として使用します。
Boolean
フィールド マップ
(オプション)

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

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

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

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

Field Mappings
並べ替えフィールド
(オプション)

入力レコードを並べ替えるために値を使用するフィールドと、レコードを格納する方向。

  • 昇順 - レコードは最小値から最大値まで順に並べ替えられます。
  • 降順 - レコードは最大値から最小値まで順に並べ替えられます。

Value Table

arcpy.conversion.ExportFeatures(in_features, out_features, {where_clause}, {use_field_alias_as_name}, {field_mapping}, {sort_field})
名前説明データ タイプ
in_features

新しいフィーチャクラスにエクスポートする入力フィーチャ。

Feature Layer
out_features

エクスポートされたフィーチャを格納する出力フィーチャクラス。

Feature Class
where_clause
(オプション)

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

SQL Expression
use_field_alias_as_name
(オプション)

入力のフィールド名またはフィールド エイリアスを出力フィールド名として使用するかどうかを指定します。

  • NOT_USE_ALIAS入力のフィールド名を出力フィールド名として使用します。 これがデフォルトです。
  • USE_ALIAS入力のフィールド エイリアスを出力フィールド名として使用します。
Boolean
field_mapping
(オプション)

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

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

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

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

Field Mappings
sort_field
[sort_field,...]
(オプション)

入力レコードを並べ替えるために値を使用するフィールドと、レコードを格納する方向。

  • ASCENDING - レコードは最小値から最大値まで順に並べ替えられます。
  • DESCENDING - レコードは最大値から最小値まで順に並べ替えられます。

Value Table

コードのサンプル

ExportFeatures の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.env.workspace = "C:/data/SFValley.gdb"
arcpy.conversion.ExportFeatures("streets", "C:/output/output.gdb/streets")
ExportFeatures の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、ExportFeatures 関数を使用する方法を示します。

# Name: ExportFeatures_Example2.py
# Description: Use Export Features 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/SFValley.gdb"

# Set local variables
inFeatures = "streets"
outFeatureClass =  "C:/output/output.gdb/arterials"
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "Category") + " = 'Arterials'"

# Run ExportFeatures
arcpy.conversion.ExportFeatures(inFeatures, outFeatureClass, expression,
                               "NOT_USE_ALIAS")