方向付き画像データセットに画像を追加 (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

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')