ArcGIS Desktop

  • ドキュメント
  • サポート

  • My Profile
  • ヘルプ
  • Sign Out
ArcGIS Desktop

ArcGIS Online

組織のマッピング プラットフォーム

ArcGIS Desktop

完全なプロ仕様の GIS

ArcGIS Enterprise

エンタープライズ GIS

ArcGIS for Developers

位置情報利用アプリの開発ツール

ArcGIS Solutions

各種業界向けの無料のテンプレート マップおよびテンプレート アプリケーション

ArcGIS Marketplace

組織で使えるアプリとデータを取得

  • ドキュメント
  • サポート
Esri
  • サイン イン
user
  • マイ プロフィール
  • サイン アウト

ArcMap

  • ホーム
  • はじめに
  • マップ
  • 解析
  • データ管理
  • ツール
  • エクステンション

アペンド (Append)

  • サマリー
  • 図
  • 使用法
  • 構文
  • コードのサンプル
  • 環境
  • ライセンス情報

サマリー

複数の入力データセットを 1 つの既存のターゲット データセットに追加 (アペンド) します。入力データセットには、ポイント フィーチャクラス、ライン フィーチャクラス、ポリゴン フィーチャクラス、テーブル、ラスター、アノテーション フィーチャクラス、ディメンション フィーチャクラスを指定することができます。

複数の入力データセットを 1 つの新しい出力データセットに結合するには [マージ (Merge)] ツールを使用します。

図

アペンド (Append) の図

使用法

  • このツールは、既存のデータセットに新しいフィーチャ、またはその他のデータを複数のデータセットから追加するときに使用します。このツールは、ポイント フィーチャクラス、ライン フィーチャクラス、ポリゴン フィーチャクラス、テーブル、ラスター、アノテーション フィーチャクラス、ディメンション フィーチャクラスを、同じタイプの既存のデータセットに追加できます。たとえば、複数のテーブルを既存のテーブルに追加したり、複数のラスターを既存のラスター データセットに追加したりすることはできますが、ライン フィーチャクラスをポイント フィーチャクラスに追加することはできません。

  • [アペンド (Append)] ツールの [フィールド マップ] コントロールを使用すると、入力データセットの各フィールドの属性情報をターゲット データセットに転送する方法を制御できます。[フィールド マップ] コントロールは、[スキーマ タイプ] で [フィールド マップを使用してスキーマの違いをリコンサイル] を選択した場合にのみ使用できます。

  • このツールでは、フィーチャがターゲット データセットに追加されるときに、フィーチャのライン分割は行われません。アペンド後にフィーチャが重なった場合でも、入力フィーチャクラスとターゲット フィーチャクラスのすべてのフィーチャがそのまま表示されます。フィーチャ ジオメトリの結合やライン分割を実行するには、[ユニオン (Union)] ツールを使用してください。

  • [スキーマ タイプ] で [入力スキーマはターゲット スキーマと一致] を選択した場合 (Python では schema_type = "TEST")、フィーチャを追加するには、入力データセットのスキーマ (フィールド定義) がターゲット データセットのスキーマと一致している必要があります。[フィールド マップを使用してスキーマの違いをリコンサイル] を選択した場合 (Python では schema_type = "NO_TEST")、入力データセットのスキーマ (フィールド定義) がターゲット データセットのスキーマと一致している必要はありません。ただし、ターゲット データセットのフィールドに一致しない入力データセットのフィールドはすべて、[フィールド マップ] コントロールでマッピングが明示的に設定されていない限り、ターゲット データセットにマッピングされません。

  • 入力データセットのデータは、スキーマ (フィールド定義) があらかじめ定義されている既存のターゲット データセットに書き込まれるため、ターゲット データセットのフィールドの追加や削除は [フィールド マップ] コントロールによって禁止されます。

  • 入力フィーチャクラスとターゲット フィーチャクラスの空間参照が一致しない場合、[アペンド (Append)] ツールでは、ターゲット フィーチャクラスで使用されている座標系に入力フィーチャクラスのフィーチャが投影されます。

  • このツールでは、エッジ マッチが実行されないので、フィーチャのジオメトリに対して調整は行われません。

  • マップ レイヤーは [入力データセット] として使用することができます。レイヤーで選択が行われている場合は、選択されているレコード (フィーチャまたはテーブル行) だけが [アペンド (Append)] ツールの処理対象になります。

  • このツールでは、名前の同じ入力レイヤーを複数使用することはできません。この制限を回避するには、ツール ダイアログ ボックスの参照ボタンを使用して、個々の [入力データセット] の絶対パスを入手してください。

  • [サブタイプ] パラメーターを使用するには、ターゲット データセットにサブタイプ フィールドが定義され、サブタイプ コードが割り当てられている必要があります。[サブタイプ] パラメーターには、ターゲット データセットに追加されるすべての新しいデータにこのサブタイプを割り当てることを示すサブタイプの説明を記述します。

構文

Append_management (inputs, target, {schema_type}, {field_mapping}, {subtype})
パラメーター説明データ タイプ
inputs
[inputs,...]

ターゲット データセットに追加するデータが含まれている入力データセット。入力データセットには、ポイント フィーチャクラス、ライン フィーチャクラス、ポリゴン フィーチャクラス、テーブル、ラスター、アノテーション フィーチャクラス、ディメンション フィーチャクラスを指定することができます。入力データセットのそれぞれがターゲット データセットのデータ タイプに一致する必要があります。

Table View; Raster Layer
target

入力データセットのデータを追加する対象となる既存のデータセット。入力データセットのそれぞれがターゲット データセットのデータ タイプに一致する必要があります。

Table View; Raster Layer
schema_type
(オプション)

データを追加するために、入力データセットのスキーマ (フィールド定義) をターゲット データセットのスキーマに一致させる必要があるかどうかを指定します。

  • TEST —入力データセットのスキーマ (フィールド定義) はターゲット データセットのスキーマに一致する必要があります。スキーマが一致しない場合はエラーが返されます。
  • NO_TEST —入力データセットのスキーマ (フィールド定義) がターゲット データセットのスキーマに一致する必要はありません。ターゲット データセットのフィールドに一致しない入力データセットのフィールドはすべて、[フィールド マップ] コントロールでマッピングが明示的に設定されていない限り、ターゲット データセットにマッピングされません。
String
field_mapping
(オプション)

入力データセットの属性フィールドのターゲット データセットへの転送方法またはマッピング方法を制御します。このパラメーターは、[スキーマ タイプ] NO_TEST が指定されている場合のみ使用できます。

入力データセットのデータは、スキーマ (フィールド名とフィールド タイプ) があらかじめ定義されている既存のターゲット データセットに追加されるため、ターゲット データセットに対するフィールドの追加または削除は行えません。出力フィールドごとにマージ ルールを設定できます。

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

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

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

Field Mapping
subtype
(オプション)

ターゲット データセットに追加されるすべての新しいデータに割り当てるサブタイプの説明

String

コードのサンプル

Append (アペンド) の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトで、Append (アペンド) ツールをイミディエイト モードで使用する方法を示します。

import arcpy
arcpy.env.workspace = "C:/data/"
arcpy.Append_management(["north.shp", "south.shp", "east.shp", "west.shp"], "wholecity.shp", "TEST","","")
Append (アペンド) の例 2 (スタンドアロン Python スクリプト)

次のスクリプトで、Append (アペンド) ツールを使用する方法を示します。

# Name: Append.py
# Description: Use the Append tool to combine several shapefiles
# import system modules 
import arcpy
import os
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
outLocation = "C:/Output"
outName = "MA_towns.shp"
schemaType = "NO_TEST"
fieldMappings = ""
subtype = ""
# Process:  Create a new empty feature class to append shapefiles into
emptyFC = arcpy.CreateFeatureclass_management(outLocation, outName, "POLYGON", "amherst.shp")
# All polygon FCs in the workspace are MA town shapefiles, we want to append these to the empty FC
fcList = arcpy.ListFeatureClasses("","POLYGON")
# list will resemble ["amherst.shp", "hadley.shp", "pelham.shp", "coldspring.shp"] 
# Create FieldMappings object to manage merge output fields
fieldMappings = arcpy.FieldMappings()
# Add the target table to the field mappings class to set the schema
fieldMappings.addTable(emptyFC)
# Add input fields for the town name into TOWNNAME field that matches the target dataset
# since each input dataset has a different field name for this info
fldMap = arcpy.FieldMap()
fldMap.addInputField("amherst.shp","TOWNNAME")
fldMap.addInputField("hadley.shp","NAME")
fldMap.addInputField("pelham.shp","TOWN_NAME")
fldMap.addInputField("coldspring.shp","TOWN")
# Set name of new output field "TOWNNAME"
townName = fldMap.outputField
townName.name, townName.aliasName, townName.type = "TOWNNAME", "TOWNNAME", "TEXT"
fldMap.outputField = townName
# Add output field to field mappings object
fieldMappings.addFieldMap(fldMap)
# Do the same thing for the POPULATION field
fldMap = arcpy.FieldMap()
fldMap.addInputField("amherst.shp","POPULATION")
fldMap.addInputField("hadley.shp","POP")
fldMap.addInputField("pelham.shp","POP_2010")
fldMap.addInputField("coldspring.shp","POP")
# Set name of new output field "POPULATION"
pop = fldMap.outputField
pop.name, pop.aliasName, pop.type = "POPULATION", "POPULATION", "LONG"
fldMap.outputField = pop
# Add output field to field mappings object
fieldMappings.addFieldMap(fldMap)
# Process: Append the feature classes into the empty feature class
arcpy.Append_management(fcList, outLocation + os.sep + emptyFC, schemaType, fieldMappings, subtype)

環境

  • 範囲
  • 現在のワークスペース
  • Global ID を維持
  • アタッチメントの保持

ライセンス情報

  • ArcGIS Desktop Basic: はい
  • ArcGIS Desktop Standard: はい
  • ArcGIS Desktop Advanced: はい

関連トピック

  • 一般ツールセットの概要
  • アペンド (カバレッジ)
  • 入力フィールドから出力フィールドへのマッピング
  • マージ (Merge)
  • ユニオン (Union)
  • フィールド マッピング コントロールの使用
  • レイヤーとテーブル ビューの操作

ArcGIS Desktop

  • ホーム
  • ドキュメント
  • サポート

ArcGIS プラットフォーム

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

Esri について

  • 会社概要
  • 採用情報
  • スタッフ ブログ
  • ユーザ カンファレンス
  • デベロッパ サミット
Esri
ご意見・ご感想をお寄せください。
Copyright © 2018 Esri. | プライバシー | リーガル