TensorFlow kembali hadir di Google I/O pada 14 Mei! Daftar sekarang

Halaman ini diterjemahkan oleh Cloud Translation API.

ImageSearcher

ImageSearcher kelas akhir publik

Melakukan pencarian kesamaan pada gambar.

API mengharapkan model TFLite dengan Metadata Model TFLite opsional, namun sangat disarankan. .

Tensor gambar masukan ( kTfLiteUInt8 / kTfLiteFloat32 )
- masukan gambar dengan ukuran [batch x height x width x channels] .
- inferensi batch tidak didukung ( batch harus 1).
- hanya input RGB yang didukung ( channels harus ada 3).
- jika tipenya adalah kTfLiteFloat32 , NormalizationOptions harus dilampirkan ke metadata untuk normalisasi input.
Tensor keluaran ( kTfLiteUInt8 / kTfLiteFloat32 )
- N komponen yang sesuai dengan N dimensi vektor fitur yang dikembalikan untuk lapisan keluaran ini.
- Bisa 2 atau 4 dimensi, yaitu [1 x N] atau [1 x 1 x 1 x N] .

TODO(b/180502532): menambahkan penunjuk ke model contoh.

TODO(b/222671076): menambahkan metode pembuatan pabrik tanpa opsi, seperti `createFromFile`, setelah format file tunggal (file indeks yang dikemas dalam model) didukung.

Kelas Bersarang

kelas ImageSearcher.ImageSearcherOptions Opsi untuk menyiapkan ImageSearcher.

Metode Publik

Pencari Gambar statis	createFromBufferAndOptions ( opsi ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions ) Membuat instance `ImageSearcher` dengan buffer model dan `ImageSearcher.ImageSearcherOptions` .
Pencari Gambar statis	createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, opsi ImageSearcher.ImageSearcherOptions , int indexFd)
Pencari Gambar statis	createFromFileAndOptions (Konteks konteks, String modelPath, opsi ImageSearcher.ImageSearcherOptions ) Membuat instance `ImageSearcher` dari `ImageSearcher.ImageSearcherOptions` .
Pencari Gambar statis	createFromFileAndOptions ( Opsi file modelFile, ImageSearcher.ImageSearcherOptions ) Membuat instance `ImageSearcher` .
Daftar < Tetangga Terdekat >	pencarian (gambar TensorImage , opsi ImageProcessingOptions ) Melakukan ekstraksi penyematan pada `TensorImage` yang disediakan dengan `ImageProcessingOptions` , diikuti dengan penelusuran tetangga terdekat dalam indeks.
Daftar < Tetangga Terdekat >	cari (gambar MlImage ) Melakukan ekstraksi penyematan pada `MlImage` yang disediakan, diikuti dengan pencarian tetangga terdekat di indeks.
Daftar < Tetangga Terdekat >	pencarian (gambar MlImage , opsi ImageProcessingOptions ) Melakukan ekstraksi penyematan pada `MlImage` yang disediakan dengan `ImageProcessingOptions` , diikuti dengan pencarian tetangga terdekat di indeks.
Daftar < Tetangga Terdekat >	pencarian (gambar TensorImage ) Melakukan ekstraksi penyematan pada `TensorImage` yang disediakan, diikuti dengan penelusuran tetangga terdekat dalam indeks.

Metode Warisan

Dari kelas org.tensorflow.lite.task.core.BaseTaskApi

kekosongan yang disinkronkan	menutup () Lepaskan memori yang dialokasikan dari C++ dan batalkan pendaftaran perpustakaan dari dudukan statis.
panjang	dapatkanNativeHandle ()
boolean	ditutup ()

Dari kelas java.lang.Object

boolean	sama dengan ( Objek arg0)
Kelas terakhir <?>	dapatkan Kelas ()
ke dalam	Kode hash ()
kekosongan terakhir	memberitahu ()
kekosongan terakhir	beri tahuSemua ()
Rangkaian	keString ()
kekosongan terakhir	tunggu (arg0 panjang, int arg1)
kekosongan terakhir	tunggu (argumen panjang0)
kekosongan terakhir	Tunggu ()

Dari antarmuka java.io.Closeable

kekosongan abstrak

menutup ()

Dari antarmuka java.lang.AutoCloseable

kekosongan abstrak

menutup ()

Metode Publik

ImageSearcher statis publik createFromBufferAndOptions (Opsi ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions )

Membuat instance ImageSearcher dengan buffer model dan ImageSearcher.ImageSearcherOptions .

Parameter

modelBuffer	`ByteBuffer` langsung atau `MappedByteBuffer` dari model pencarian
pilihan

Melempar

Pengecualian Argumen Ilegal	jika buffer model bukan `ByteBuffer` langsung atau `MappedByteBuffer`
Pengecualian IO	jika terjadi kesalahan I/O saat memuat file indeks
IlegalStateException	jika ada kesalahan internal
Pengecualian Waktu Proses	jika ada kesalahan yang tidak ditentukan

ImageSearcher statis publik createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, opsi ImageSearcher.ImageSearcherOptions , int indexFd)

Parameter

modelBuffer
pilihan
indeksFd

public static ImageSearcher createFromFileAndOptions (Konteks konteks, String modelPath, opsi ImageSearcher.ImageSearcherOptions )

Membuat instance ImageSearcher dari ImageSearcher.ImageSearcherOptions .

Parameter

konteks
modelPath	jalur model pencarian dengan metadata di aset
pilihan

Melempar

Pengecualian IO	jika terjadi kesalahan I/O saat memuat model tflite atau file indeks
Pengecualian Argumen Ilegal	jika suatu argumen tidak valid
IlegalStateException	jika ada kesalahan internal
Pengecualian Waktu Proses	jika ada kesalahan yang tidak ditentukan

ImageSearcher statis publik createFromFileAndOptions ( File modelFile, opsi ImageSearcher.ImageSearcherOptions )

Membuat instance ImageSearcher .

Parameter

file model	contoh `File` model pencarian
pilihan

Melempar

Pengecualian IO	jika terjadi kesalahan I/O saat memuat model tflite atau file indeks
Pengecualian Argumen Ilegal	jika suatu argumen tidak valid
IlegalStateException	jika ada kesalahan internal
Pengecualian Waktu Proses	jika ada kesalahan yang tidak ditentukan

Daftar publik <NearestNeighbor> pencarian (gambar TensorImage , opsi ImageProcessingOptions )

Melakukan ekstraksi penyematan pada TensorImage yang disediakan dengan ImageProcessingOptions , diikuti dengan penelusuran tetangga terdekat dalam indeks.

ImageSearcher mendukung opsi berikut:

Wilayah minat (ROI) (melalui ImageProcessingOptions.Builder.setRoi(Rect) ). Ini default untuk seluruh gambar.
rotasi gambar (melalui ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation) ). Standarnya adalah ImageProcessingOptions.Orientation.TOP_LEFT .

ImageSearcher mendukung jenis ruang warna TensorImage berikut:

Parameter

gambar	objek `TensorImage` UINT8 yang mewakili gambar RGB atau YUV
pilihan

Melempar

Pengecualian Argumen Ilegal	jika jenis ruang warna gambar tidak didukung

Daftar publik <NearestNeighbor> cari (gambar MlImage )

Melakukan ekstraksi penyematan pada MlImage yang disediakan, diikuti dengan pencarian tetangga terdekat di indeks.

Parameter

gambar	objek `MlImage` yang mewakili gambar

Melempar

Pengecualian Argumen Ilegal	jika jenis penyimpanan atau format gambar tidak didukung

Daftar publik <NearestNeighbor> pencarian (gambar MlImage , opsi ImageProcessingOptions )

Melakukan ekstraksi penyematan pada MlImage yang disediakan dengan ImageProcessingOptions , diikuti dengan pencarian tetangga terdekat di indeks.

ImageSearcher mendukung opsi berikut:

Wilayah minat (ROI) (melalui ImageProcessingOptions.Builder.setRoi(Rect) ). Ini default untuk seluruh gambar.
rotasi gambar (melalui ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation) ). Standarnya adalah ImageProcessingOptions.Orientation.TOP_LEFT . MlImage.getRotation() tidak efektif.

Parameter

gambar	objek `MlImage` yang mewakili gambar
pilihan	mengonfigurasi opsi termasuk ROI dan rotasi

Melempar

Pengecualian Argumen Ilegal	jika jenis penyimpanan atau format gambar tidak didukung

Daftar publik <NearestNeighbor> pencarian (gambar TensorImage )

Melakukan ekstraksi penyematan pada TensorImage yang disediakan, diikuti dengan penelusuran tetangga terdekat dalam indeks.

ImageSearcher mendukung jenis ruang warna TensorImage berikut:

Parameter

gambar	objek `TensorImage` UINT8 yang mewakili gambar RGB atau YUV

Melempar

Pengecualian Argumen Ilegal	jika jenis ruang warna gambar tidak didukung