コントロールポイントの追加 (データ管理ツール)

サマリー

コントロールポイントを既存のコントロールポイントテーブルに結合します。

追加されるポイントは、タイポイントの計算 ツールの結果、コントロールポイントの計算 ツールの結果、またはポイントフィーチャクラスです。

使用法

Z 値フィールド名 パラメーターと 入力 DEM パラメーターの両方が設定されている場合は、Z 値フィールド名 が優先されます。 Z 値フィールド名 パラメーターも 入力 DEM パラメーターも設定されていない場合は、地上コントロールポイント (GCP) とチェックポイントの Z 値がすべて 0 に設定されます。
Use caution when invoking the 追加オプション - このオプションを使用できるのは、入力コントロールポイントテーブルとターゲットコントロールポイントテーブル内のタイポイントに同じ変換が存在する場合に限ります。

ラベル	説明	データタイプ
ターゲットコントロールポイント	ターゲットコントロールポイントテーブル。通常、これはタイポイントの計算ツールの出力です。	Feature Class; Feature Layer
入力コントロールポイント	コントロールポイントが格納されているポイントフィーチャクラス。これには、コントロールポイントの計算ツールまたはタイポイントの計算ツールから作成されたコントロールポイントテーブル、あるいは地上コントロールポイントが含まれるポイントフィーチャクラスを使用できます。	Feature Class; Feature Layer; File; String
Z 値フィールド名 (オプション)	コントロールポイントの Z 値が格納されているフィールド。 Z 値フィールド名パラメーターと入力 DEM パラメーターの両方が設定されている場合は、Z 値フィールドが使用されます。 Z 値フィールド名パラメーターも入力 DEM パラメーターも設定されていない場合は、地上コントロールポイントとチェックポイントの Z 値がすべて 0 に設定されます。	Field
タグフィールド名 (オプション)	一意の値が格納されている、ターゲットコントロールポイントテーブル内のフィールド。このフィールドは、ターゲットコントロールポイントテーブルに追加されます。タグフィールドは、地上コントロールポイントに関連付けられた識別子を取り込むために使用できます。	Field
入力 DEM (オプション)	入力コントロールポイントテーブル内のコントロールポイントの Z 値を取得するために使用される DEM。 Z 値フィールド名パラメーターと入力 DEM パラメーターの両方が設定されている場合は、Z 値フィールドが使用されます。 Z 値フィールド名パラメーターも入力 DEM パラメーターも設定されていない場合は、地上コントロールポイントとチェックポイントの Z 値がすべて 0 に設定されます。	Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
XY 精度 (オプション)	X 座標および Y 座標の入力精度。この精度の単位は、入力コントロールポイントと同じです。この情報は、データプロバイダーが提供する必要があります。精度情報を使用できない場合は、このオプションパラメーターを空白のままにします。	Double
Z 精度 (オプション)	鉛直座標の入力精度。この精度の単位は、入力コントロールポイントの単位です。この情報は、データプロバイダーが提供する必要があります。精度情報を使用できない場合は、このオプションパラメーターを空白のままにします。	Double
ジオイド (オプション)	楕円体高を参照する有理多項式係数 (RPC) には、ジオイド補正が必要です。ほとんどの標高データセットは海面の海抜を基準にしているため、これらの場合に楕円体高に変換するために、この補正が必要になります。オン—ジオイド補正を実行して、海抜高度を (EGM96 ジオイドに基づいて) 楕円体高に変換します。オフ—ジオイド補正は行われません。このオプションは、DEM がすでに楕円体高で表現されている場合のみ使用します。これがデフォルトです。	Boolean
対象地域 (オプション)	入力コントロールポイントテーブルの空間参照に最小 XY 座標と最大 XY 座標を入力して、対象地域の範囲を定義します。	Envelope; Feature Layer; Feature Class
追加オプション (オプション)	コントロールポイントをコントロールポイントテーブルに追加する方法を指定します。すべてのポイントを追加—入力コントロールポイントテーブル内のすべてのポイント (GCP、チェックポイント、タイポイントなど) をターゲットコントロールポイントテーブルに追加します。これがデフォルトです。 GCP のみ追加—入力コントロールポイントテーブル内の GCP のみをターゲットコントロールポイントテーブルに追加します。 GCP とタイポイントを追加—GCP とこれらの GCP にのみ関連付けられているタイポイントをターゲットコントロールポイントテーブルに追加します。このオプションを使用する際には注意が必要です。つまり、このオプションを使用できるのは、入力コントロールポイントテーブルとターゲットコントロールポイントテーブル内のタイポイントに同じ変換が存在する場合に限ります。タイポイントは、別の調整処理で計算された場合には、目的の位置に配置されない可能性があります。	String

派生した出力

ラベル	説明	データタイプ
更新されたコントロールポイント	更新済みコントロールポイントです。	Feature Class; Feature Layer

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	ターゲットコントロールポイントテーブル。通常、これはタイポイントの計算ツールの出力です。	Feature Class; Feature Layer
in_input_control_points	コントロールポイントが格納されているポイントフィーチャクラス。これには、コントロールポイントの計算ツールまたはタイポイントの計算ツールから作成されたコントロールポイントテーブル、あるいは地上コントロールポイントが含まれるポイントフィーチャクラスを使用できます。	Feature Class; Feature Layer; File; String
in_z_field (オプション)	コントロールポイントの Z 値が格納されているフィールド。 `in_z_field` パラメーターと `in_dem` パラメーターの両方が設定されている場合は、Z 値フィールドが使用されます。 `in_z_field` パラメーターも `in_dem` パラメーターも設定されていない場合は、地上コントロールポイントとチェックポイントの Z 値がすべて 0 に設定されます。	Field
in_tag_field (オプション)	一意の値が格納されている、ターゲットコントロールポイントテーブル内のフィールド。このフィールドは、ターゲットコントロールポイントテーブルに追加されます。タグフィールドは、地上コントロールポイントに関連付けられた識別子を取り込むために使用できます。	Field
in_dem (オプション)	入力コントロールポイントテーブル内のコントロールポイントの Z 値を取得するために使用される DEM。 `in_z_field` パラメーターと `in_dem` パラメーターの両方が設定されている場合は、Z 値フィールドが使用されます。 `in_z_field` パラメーターも `in_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) には、ジオイド補正が必要です。ほとんどの標高データセットは海面の海抜を基準にしているため、これらの場合に楕円体高に変換するために、この補正が必要になります。 `GEOID`—ジオイド補正を実行して、海抜高度を (EGM96 ジオイドに基づいて) 楕円体高に変換します。 `NONE`—ジオイド補正は行われません。このオプションは、DEM がすでに楕円体高で表現されている場合のみ使用します。これがデフォルトです。	Boolean
area_of_interest (オプション)	入力コントロールポイントテーブルの空間参照に最小 XY 座標と最大 XY 座標を入力して、対象地域の範囲を定義します。	Envelope; Feature Layer; Feature Class
append_option (オプション)	コントロールポイントをコントロールポイントテーブルに追加する方法を指定します。 `ALL`—入力コントロールポイントテーブル内のすべてのポイント (GCP、チェックポイント、タイポイントなど) をターゲットコントロールポイントテーブルに追加します。これがデフォルトです。 `GCP`—入力コントロールポイントテーブル内の GCP のみをターゲットコントロールポイントテーブルに追加します。 `GCPSET`—GCP とこれらの GCP にのみ関連付けられているタイポイントをターゲットコントロールポイントテーブルに追加します。このオプションを使用する際には注意が必要です。つまり、このオプションを使用できるのは、入力コントロールポイントテーブルとターゲットコントロールポイントテーブル内のタイポイントに同じ変換が存在する場合に限ります。タイポイントは、別の調整処理で計算された場合には、目的の位置に配置されない可能性があります。	String

派生した出力

名前	説明	データタイプ
out_master_control_points	更新済みコントロールポイントです。	Feature Class; Feature Layer

コードのサンプル

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

以下は、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 の例 2 (スタンドアロンスクリプト)

以下は、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.management.AppendControlPoints(target, in_controlPoints, "", dem, "", "", "", AOI, appOpt)

環境

このツールは、ジオプロセシング環境を一切使用しません。

ライセンス情報

Basic: いいえ
Standard: はい
Advanced: はい

コントロール ポイントの追加 (データ管理ツール)

サマリー

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック

コントロールポイントの追加 (データ管理ツール)