概要
コントロール ポイントを既存のコントロール ポイント テーブルに結合します。
追加されるポイントは、[タイ ポイントの計算 (Compute Tie Points)] ツールの結果、[コントロール ポイントの計算 (Compute Control Points)] ツールの結果、またはポイント フィーチャクラスです。
使用法
[Z 値フィールド名] パラメーターと [入力 DEM] パラメーターの両方が設定されている場合は、[Z 値フィールド名] が優先されます。[Z 値フィールド名] パラメーターも [入力 DEM] パラメーターも設定されていない場合は、地上コントロール ポイント (GCP) とチェック ポイントの Z 値がすべて 0 に設定されます。
[追加オプション] を呼び出す際には注意が必要です。つまり、この操作を実行できるのは、入力コントロール ポイント テーブルとターゲット コントロール ポイント テーブル内のタイ ポイントに同じ変換が存在する場合に限ります。
構文
arcpy.management.AppendControlPoints(in_master_control_points, in_input_control_points, {in_z_field}, {in_tag_field}, {in_dem}, {in_xy_accuracy}, {in_z_accuracy}, {Geoid}, {area_of_interest}, {append_option})| パラメーター | 説明 | データ タイプ |
in_master_control_points | ターゲット コントロール ポイント テーブル。通常、これは [タイ ポイントの計算 (Compute Tie Points)] ツールの出力です。 | Feature Class; Feature Layer |
in_input_control_points | コントロール ポイントが格納されているポイント フィーチャクラス。これには、[コントロール ポイントの計算 (Compute Control Points)] ツールまたは [タイ ポイントの計算 (Compute Tie Points)] ツールから作成されたコントロール ポイント テーブル、あるいは地上コントロール ポイントが含まれるポイント フィーチャクラスを使用できます。 | Feature Class; Feature Layer; File; String |
in_z_field (オプション) | コントロール ポイントの Z 値が格納されているフィールド。 [Z 値フィールド名] パラメーターと [入力 DEM] パラメーターの両方が設定されている場合は、Z 値フィールドが使用されます。[Z 値フィールド名] パラメーターも [入力 DEM] パラメーターも設定されていない場合は、地上コントロール ポイントとチェック ポイントの Z 値がすべて 0 に設定されます。 | Field |
in_tag_field (オプション) | 一意の値が格納されている、ターゲット コントロール ポイント テーブル内のフィールド。このフィールドは、ターゲット コントロール ポイント テーブルに追加されます。タグ フィールドは、地上コントロール ポイントに関連付けられた識別子を取り込むために使用できます。 | Field |
in_dem (オプション) | ターゲット コントロール ポイント テーブル内のコントロール ポイントの Z 値を取得するために使用される DEM。 [Z 値フィールド名] パラメーターと [入力 DEM] パラメーターの両方が設定されている場合は、Z 値フィールドが使用されます。[Z 値フィールド名] パラメーターも [入力 DEM] パラメーターも設定されていない場合は、地上コントロール ポイントとチェック ポイントの Z 値がすべて 0 に設定されます。 | Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer |
in_xy_accuracy (オプション) | X 座標および Y 座標の入力精度。この精度の単位は、in_input_control_points と同じです。 この情報は、データ プロバイダーが提供する必要があります。精度情報を使用できない場合は、このオプション パラメーターをスキップします。 | Double |
in_z_accuracy (オプション) | 鉛直座標の入力精度。この精度の単位は、in_input_control_points の単位です。 この情報は、データ プロバイダーが提供する必要があります。精度情報を使用できない場合は、このオプション パラメーターをスキップします。 | Double |
Geoid (オプション) | 楕円体高を参照する有理多項式係数 (RPC) には、ジオイド補正が必要です。ほとんどの標高データセットは海面の海抜を基準にしているため、これらの場合に楕円体高に変換するために、この補正が必要になります。
| Boolean |
area_of_interest (オプション) | 入力コントロール ポイント テーブルの空間参照に最小 XY 座標と最大 XY 座標を入力して、対象地域の範囲を定義します。 | Envelope; Feature Layer; Feature Class |
append_option (オプション) | コントロール ポイントをコントロール ポイント テーブルに追加する方法を指定します。
| String |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_master_control_points | 更新済みコントロール ポイントです。 | フィーチャクラス; フィーチャ レイヤー |
コードのサンプル
以下は、AppendControlPoints ツールを実行する Python サンプルです。
#===========================
#AppendControlPoints
'''Usage: AppendControlPoints_management(in_master_control_points,
{in_z_field}, {in_tag_field}, {in_dem}, {in_xy_accuracy},
{in_z_accuracy}, {Geoid}, {area_of_interest}, {append_option}
'''
import arcpy
arcpy.env.workspace = "C:/Workspace"
arcpy.management.AppendControlPoints("calval_allpoints_dem1",
"C:\test\calval_allpoints_dem1", "Score", "Ways", "calval",1, 2, "NONE",
"-79.6407162269889 43.4853802421312 -79.094324938576 44.0836924137218", "GCP")以下は、AppendControlPoints ツールを実行する Python スクリプト サンプルです。
#append control points
import arcpy
arcpy.env.workspace = "c:/workspace"
#append the control points and tie points
target = "BD.gdb/tiePoints"
in_controlPoints = "BD.gdb/controlPoints"
dem = "BD.gdb/dem"
AOI = "-79.6407162269889 43.4853802421312 -79.094324938576 44.0836924137218"
AppOpt = "GCP"
arcpy.AppendControlPoints_management(target, in_controlPoints, "", dem, "", "", "", AOI, appOpt)環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい