ImageSearcher

パブリック最終クラスImageSearcher

画像の類似検索を実行します。

API は、オプションではあるが強く推奨される TFLiteモデル メタデータを備えた TFLite モデルを想定しています。

  • 入力画像テンソル ( kTfLiteUInt8 / kTfLiteFloat32 )
    • サイズ[batch x height x width x channels]の画像入力。
    • バッチ推論はサポートされていません ( batch 1 である必要があります)。
    • RGB 入力のみがサポートされています ( channels 3 である必要があります)。
    • type がkTfLiteFloat32の場合、入力正規化のために NormalizationOptions をメタデータに付加する必要があります。
  • 出力テンソル ( kTfLiteUInt8 / kTfLiteFloat32 )
    • この出力層に対して返された特徴ベクトルのN次元に対応するN個のコンポーネント。
    • 2 次元または 4 次元、つまり[1 x N]または[1 x 1 x 1 x N]

TODO(b/180502532): サンプル モデルへのポインターを追加します。

TODO(b/222671076): 単一のファイル形式 (モデルにパックされたインデックス ファイル) がサポートされたら、`createFromFile` などのオプションなしのファクトリ作成メソッドを追加します。

ネストされたクラス

クラスImageSearcher.ImageSearcherOptions ImageSearcher をセットアップするためのオプション。

パブリックメソッド

静的イメージサーチャー
createFromBufferAndOptions ( ByteBuffer modelBuffer、 ImageSearcher.ImageSearcherOptionsオプション)
モデル バッファーとImageSearcher.ImageSearcherOptionsを使用してImageSearcherインスタンスを作成します。
静的イメージサーチャー
静的イメージサーチャー
createFromFileAndOptions (コンテキスト コンテキスト、文字列モデルパス、 ImageSearcher.ImageSearcherOptionsオプション)
ImageSearcher.ImageSearcherOptionsからImageSearcherインスタンスを作成します。
静的イメージサーチャー
createFromFileAndOptions (ファイルモデルファイル、 ImageSearcher.ImageSearcherOptionsオプション)
ImageSearcherインスタンスを作成します。
リスト<最近隣>
検索( TensorImage画像、 ImageProcessingOptionsオプション)
ImageProcessingOptionsを使用して、指定されたTensorImageに対して埋め込み抽出を実行し、続いてインデックス内の最近傍検索を実行します。
リスト<最近隣>
検索( MlImage画像)
提供されたMlImageに対して埋め込み抽出を実行し、続いてインデックス内の最近傍検索を実行します。
リスト<最近隣>
検索( MlImage画像、 ImageProcessingOptionsオプション)
ImageProcessingOptionsを使用して、指定されたMlImageに対して埋め込み抽出を実行し、続いてインデックス内の最近傍検索を実行します。
リスト<最近隣>
検索( TensorImage画像)
提供されたTensorImageに対して埋め込み抽出を実行し、続いてインデックス内で最近傍検索を実行します。

継承されたメソッド

パブリックメソッド

public static ImageSearcher createFromBufferAndOptions ( ByteBuffer modelBuffer、 ImageSearcher.ImageSearcherOptionsオプション)

モデル バッファーとImageSearcher.ImageSearcherOptionsを使用してImageSearcherインスタンスを作成します。

パラメーター
モデルバッファ検索モデルの直接ByteBufferまたはMappedByteBuffer
オプション
投げる
IllegalArgumentExceptionモデル バッファーが直接ByteBufferまたはMappedByteBufferではない場合
IO例外インデックスファイルのロード時にI/Oエラーが発生した場合
IllegalStateException内部エラーがある場合
ランタイム例外他に特定されていないエラーがある場合

public static ImageSearcher createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions options, intindexFd)

パラメーター
モデルバッファ
オプション
インデックスFD

public static ImageSearcher createFromFileAndOptions (Context context、 String modelPath、 ImageSearcher.ImageSearcherOptionsオプション)

ImageSearcher.ImageSearcherOptionsからImageSearcherインスタンスを作成します。

パラメーター
コンテクスト
モデルパスアセット内のメタデータを含む検索モデルのパス
オプション
投げる
IO例外tflite モデルまたはインデックス ファイルのロード時に I/O エラーが発生した場合
IllegalArgumentException引数が無効な場合
IllegalStateException内部エラーがある場合
ランタイム例外他に特定されていないエラーがある場合

public static ImageSearcher createFromFileAndOptions (ファイルモデルファイル、 ImageSearcher.ImageSearcherOptionsオプション)

ImageSearcherインスタンスを作成します。

パラメーター
モデルファイル検索モデルFileインスタンス
オプション
投げる
IO例外tflite モデルまたはインデックス ファイルのロード時に I/O エラーが発生した場合
IllegalArgumentException引数が無効な場合
IllegalStateException内部エラーがある場合
ランタイム例外他に特定されていないエラーがある場合

public List <NearestNeighbor>検索( TensorImage画像、 ImageProcessingOptionsオプション)

ImageProcessingOptionsを使用して、指定されたTensorImageに対して埋め込み抽出を実行し、続いてインデックス内の最近傍検索を実行します。

ImageSearcher次のオプションをサポートしています。

ImageSearcher次のTensorImage色空間タイプをサポートします。

パラメーター
画像RGB または YUV イメージを表す UINT8 TensorImageオブジェクト
オプション
投げる
IllegalArgumentException画像の色空間タイプがサポートされていない場合

パブリックリスト<NearestNeighbor>検索( MlImage画像)

提供されたMlImageに対して埋め込み抽出を実行し、続いてインデックス内の最近傍検索を実行します。

パラメーター
画像画像を表すMlImageオブジェクト
投げる
IllegalArgumentException画像のストレージ タイプまたは形式がサポートされていない場合

public List < NearestNeighbor >検索( MlImage画像、 ImageProcessingOptionsオプション)

ImageProcessingOptionsを使用して、指定されたMlImageに対して埋め込み抽出を実行し、続いてインデックス内の最近傍検索を実行します。

ImageSearcher次のオプションをサポートしています。

パラメーター
画像画像を表すMlImageオブジェクト
オプションROI や回転などのオプションを構成します
投げる
IllegalArgumentException画像のストレージ タイプまたは形式がサポートされていない場合

public List <NearestNeighbor>検索( TensorImage画像)

提供されたTensorImageに対して埋め込み抽出を実行し、続いてインデックス内で最近傍検索を実行します。

ImageSearcher次のTensorImage色空間タイプをサポートします。

パラメーター
画像RGB または YUV イメージを表す UINT8 TensorImageオブジェクト
投げる
IllegalArgumentException画像の色空間タイプがサポートされていない場合