画像の類似検索を実行します。
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 インスタンスを作成します。 |
静的イメージサーチャー | createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer、 ImageSearcher.ImageSearcherOptionsオプション、intindexFd) |
静的イメージサーチャー | createFromFileAndOptions (コンテキスト コンテキスト、文字列モデルパス、 ImageSearcher.ImageSearcherOptionsオプション) ImageSearcher.ImageSearcherOptions からImageSearcher インスタンスを作成します。 |
静的イメージサーチャー | createFromFileAndOptions (ファイルモデルファイル、 ImageSearcher.ImageSearcherOptionsオプション) ImageSearcher インスタンスを作成します。 |
リスト<最近隣> | 検索( TensorImage画像、 ImageProcessingOptionsオプション) ImageProcessingOptions を使用して、指定されたTensorImage に対して埋め込み抽出を実行し、続いてインデックス内の最近傍検索を実行します。 |
リスト<最近隣> | |
リスト<最近隣> | 検索( MlImage画像、 ImageProcessingOptionsオプション) ImageProcessingOptions を使用して、指定されたMlImage に対して埋め込み抽出を実行し、続いてインデックス内の最近傍検索を実行します。 |
リスト<最近隣> |
継承されたメソッド
パブリックメソッド
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
次のオプションをサポートしています。
- 関心領域 (ROI) (
ImageProcessingOptions.Builder.setRoi(Rect)
経由)。デフォルトでは画像全体になります。 - 画像の回転 (
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
による)。デフォルトはImageProcessingOptions.Orientation.TOP_LEFT
です。
ImageSearcher
次のTensorImage
色空間タイプをサポートします。
パラメーター
画像 | RGB または YUV イメージを表す UINT8 TensorImage オブジェクト |
---|---|
オプション |
投げる
IllegalArgumentException | 画像の色空間タイプがサポートされていない場合 |
---|
パブリックリスト<NearestNeighbor>検索( MlImage画像)
提供されたMlImage
に対して埋め込み抽出を実行し、続いてインデックス内の最近傍検索を実行します。
パラメーター
画像 | 画像を表すMlImage オブジェクト |
---|
投げる
IllegalArgumentException | 画像のストレージ タイプまたは形式がサポートされていない場合 |
---|
public List < NearestNeighbor >検索( MlImage画像、 ImageProcessingOptionsオプション)
ImageProcessingOptions
を使用して、指定されたMlImage
に対して埋め込み抽出を実行し、続いてインデックス内の最近傍検索を実行します。
ImageSearcher
次のオプションをサポートしています。
- 関心領域 (ROI) (
ImageProcessingOptions.Builder.setRoi(Rect)
経由)。デフォルトでは画像全体になります。 - 画像の回転 (
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
による)。デフォルトはImageProcessingOptions.Orientation.TOP_LEFT
です。MlImage.getRotation()
は効果がありません。
パラメーター
画像 | 画像を表すMlImage オブジェクト |
---|---|
オプション | ROI や回転などのオプションを構成します |
投げる
IllegalArgumentException | 画像のストレージ タイプまたは形式がサポートされていない場合 |
---|
public List <NearestNeighbor>検索( TensorImage画像)
提供されたTensorImage
に対して埋め込み抽出を実行し、続いてインデックス内で最近傍検索を実行します。
ImageSearcher
次のTensorImage
色空間タイプをサポートします。
パラメーター
画像 | RGB または YUV イメージを表す UINT8 TensorImage オブジェクト |
---|
投げる
IllegalArgumentException | 画像の色空間タイプがサポートされていない場合 |
---|