方向付き画像データセットに画像を追加 (Add Images To Oriented Imagery Dataset) (方向付き画像)

サマリー

ファイル、フォルダー、テーブル、画像パスのリスト、またはポイント フィーチャ レイヤーなど、複数の入力ソースから方向付き画像データセットに画像を追加します。

使用法

• 追加された画像は、方向付き画像データセットでは管理されません。データセットは画像が格納されている場所を参照します。 画像が削除または移動された場合、その画像は方向付き画像ビューアーには読み込まれません。

• ツールは [入力データ] パラメーターの値に基づいて、データを方向付き画像データセットに読み込むために必要なメタデータを識別します。 方向付き画像の機能はメタデータ情報によって異なります。

• すべての入力データ オプションで JPEG 形式がサポートされています。 次のような場合、方向付き画像テーブル スキーマに従った .csv ファイル、方向付き画像属性テーブル スキーマに従ったフィーチャ レイヤー、または方向付き画像レイヤーを使用して画像を追加する必要があります。

  • 画像形式が TIF または MRF の場合。
  • 画像メタデータが、画像ファイルとは別に格納されているか、画像を追加する前に編集する必要がある場合。
  • カメラの方向を追加して、画像から地表、および地表から画像への変換の精度を向上させる場合。

• 画像ファイル、画像を含むフォルダー、または画像パスのリストを含むテキスト ファイルから直接データを追加する場合、メタデータ情報は画像の EXIF および XMP データから抽出されます。 少なくとも、EXIF データには地理的な位置情報が含まれている必要があります。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
方向付き画像データセット	画像が追加される方向付き画像データセットのパスと名前。	Oriented Imagery Layer
画像カテゴリ	使用する入力画像のタイプを指定し、方向付き画像データセットのデフォルト プロパティを設定します。 同等の属性が方向付き画像データセットの属性テーブルに存在しない場合、デフォルト プロパティが使用されます。 Horizontal - 露出が地表に対して平行で、水平方向を向いた画像が使用されます。 Oblique - 露出が地表に対して斜め (通常、約 45 度) で、オブジェクトの側面が見えている画像が使用されます。 Nadir - 露出が地表に対して垂直で、真下を向いた画像が使用されます。 オブジェクトの上部のみが見えます。 360 - 360 度の球状の全方位ビューを撮影できる専用のカメラを使用して撮影された画像、または複数のカメラで撮影された 360 度のビューをつなぎ合わせた画像が使用されます。 Inspection - 対象物の近接画像 (カメラから 5 メートル未満) が使用されます。	String
入力データ	入力データのパスと名前。 サポートされているバージョンは以下のとおりです。 JPEG 形式の 1 つ以上の画像。 画像を含むフォルダー。 JPEG 画像のみがフォルダーからデータセットに追加されます。 JPEG 画像のパスを含む .txt ファイル。 各画像パスは、個別の行に入れる必要があります。 方向付き画像テーブル スキーマを使用した .csv ファイル。 方向付き画像属性テーブル スキーマを使用したフィーチャ レイヤー。 方向付き画像レイヤー。	Folder; Oriented Imagery Layer; Table; Raster Layer; File
サブフォルダーを含める (オプション)	サブフォルダーを再帰的に検索するかどうかを指定します。 オン - すべてのサブフォルダーでデータを再帰的に探します。 これがデフォルトです。 オフ - トップレベル フォルダーのみでデータを探します。	Boolean
入力フォルダー フィルター (オプション)	入力フォルダー内の画像をフィルター処理して追加する際に使用される式。 たとえば、特定の文字列を含む画像のみを追加するには、文字列の値の前後にパーセント記号を追加します (%value%)。	String
入力テーブル フィルター (オプション)	レコードのサブセットを選択するために使用される SQL 式。 SQL 構文の詳細については、「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。	SQL Expression
入力テーブルのすべてのフィールドを含める (オプション)	必須スキーマ以外の入力テーブルのすべてのフィールドをデータセットの属性テーブルに追加するかどうかを指定します。 オフ - 方向付き画像のスキーマ固有のフィールドのみがデータセットの属性テーブルに追加されます。 これがデフォルトです。 オン - 入力テーブルのすべてのフィールドがデータセットの属性テーブルに追加されます。	Boolean

派生した出力

ラベル	説明	データ タイプ
更新された方向付き画像データセット	更新された方向付き画像データセット。	Oriented Imagery Layer

Python

arcpy.management.AddImagesToOrientedImageryDataset(in_oriented_imagery_dataset, imagery_category, input_data, {include_sub_folders}, {folder_filter}, {where_clause}, {include_all_fields})

名前	説明	データ タイプ
in_oriented_imagery_dataset	画像が追加される方向付き画像データセットのパスと名前。	Oriented Imagery Layer
imagery_category	使用する入力画像のタイプを指定し、方向付き画像データセットのデフォルト プロパティを設定します。 同等の属性が方向付き画像データセットの属性テーブルに存在しない場合、デフォルト プロパティが使用されます。 Horizontal - 露出が地表に対して平行で、水平方向を向いた画像が使用されます。 Oblique - 露出が地表に対して斜め (通常、約 45 度) で、オブジェクトの側面が見えている画像が使用されます。 Nadir - 露出が地表に対して垂直で、真下を向いた画像が使用されます。 オブジェクトの上部のみが見えます。 360 - 360 度の球状の全方位ビューを撮影できる専用のカメラを使用して撮影された画像、または複数のカメラで撮影された 360 度のビューをつなぎ合わせた画像が使用されます。 Inspection - 対象物の近接画像 (カメラから 5 メートル未満) が使用されます。	String
input_data [input_data,...]	入力データのパスと名前。 サポートされているバージョンは以下のとおりです。 JPEG 形式の 1 つ以上の画像。 画像を含むフォルダー。 JPEG 画像のみがフォルダーからデータセットに追加されます。 JPEG 画像のパスを含む .txt ファイル。 各画像パスは、個別の行に入れる必要があります。 方向付き画像テーブル スキーマを使用した .csv ファイル。 方向付き画像属性テーブル スキーマを使用したフィーチャ レイヤー。 方向付き画像レイヤー。	Folder; Oriented Imagery Layer; Table; Raster Layer; File
include_sub_folders (オプション)	サブフォルダーを再帰的に検索するかどうかを指定します。 SUBFOLDERS—すべてのサブフォルダーでデータを再帰的に探します。 これがデフォルトです。 NOSUBFOLDERS—トップレベル フォルダーのみでデータを探します。	Boolean
folder_filter (オプション)	入力フォルダー内の画像をフィルター処理して追加する際に使用される式。 たとえば、特定の文字列を含む画像のみを追加するには、文字列の値の前後にパーセント記号を追加します (%value%)。	String
where_clause (オプション)	レコードのサブセットを選択するために使用される SQL 式。 SQL 構文の詳細については、「ArcGIS で使用されるクエリ式への SQL リファレンス」をご参照ください。	SQL Expression
include_all_fields (オプション)	必須スキーマ以外の入力テーブルのすべてのフィールドをデータセットの属性テーブルに追加するかどうかを指定します。 NO_INCLUDE_ALL_FIELDS—方向付き画像のスキーマ固有のフィールドのみがデータセットの属性テーブルに追加されます。 これがデフォルトです。 INCLUDE_ALL_FIELDS—入力テーブルのすべてのフィールドがデータセットの属性テーブルに追加されます。	Boolean

派生した出力

名前	説明	データ タイプ
out_oriented_imagery_dataset	更新された方向付き画像データセット。	Oriented Imagery Layer

コードのサンプル

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.AddImagesToOrientedImageryDataset(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset", 
    imagery_category="Oblique",
    input_data='C:/OrientedImageryExample/Samples/img1.jpg;C:/OrientedImageryExample/Samples/img2.jpg')

環境

出力座標系, 地理座標系変換, 範囲