ObjectDetector

ObjectDetector kelas akhir publik

Melakukan deteksi objek pada gambar.

API mengharapkan model TFLite dengan Metadata Model TFLite. .

API mendukung model dengan satu tensor masukan gambar dan empat tensor keluaran. Untuk lebih spesifiknya, berikut persyaratannya.

  • 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 harus berupa 4 keluaran dari operasi DetectionPostProcess , yaitu:
    • Tensor lokasi ( kTfLiteFloat32 ):
      • tensor berukuran [1 x num_results x 4] , array bagian dalam mewakili kotak pembatas dalam bentuk [atas, kiri, kanan, bawah].
      • BoundingBoxProperties harus dilampirkan ke metadata dan harus menentukan type=BOUNDARIES dan coordinate_type=RATIO .
    • Tensor kelas ( kTfLiteFloat32 ):
      • tensor berukuran [1 x num_results] , setiap nilai mewakili indeks bilangan bulat suatu kelas.
      • jika peta label dilampirkan ke metadata sebagai file terkait TENSOR_VALUE_LABELS , peta tersebut digunakan untuk mengonversi nilai tensor menjadi label.
    • skor tensor ( kTfLiteFloat32 ):
      • tensor berukuran [1 x num_results] , masing-masing nilai mewakili skor objek yang terdeteksi.
    • Jumlah tensor deteksi ( kTfLiteFloat32 ):
      • integer num_results sebagai tensor ukuran [1] .

Contoh model tersebut dapat ditemukan di TensorFlow Hub. .

Kelas Bersarang

kelas ObjectDetector.ObjectDetectorOptions Opsi untuk menyiapkan ObjectDetector.

Metode Publik

ObjectDetector statis
buatDariBuffer ( ByteBuffer modelBuffer)
Membuat instance ObjectDetector dengan buffer model dan ObjectDetector.ObjectDetectorOptions default.
ObjectDetector statis
ObjectDetector statis
createFromFile (Konteks konteks, String modelPath)
ObjectDetector statis
buatDariFile ( File modelFile)
ObjectDetector statis
ObjectDetector statis
Daftar <Deteksi>
deteksi (gambar MlImage )
Melakukan deteksi aktual pada MlImage yang disediakan.
Daftar <Deteksi>
deteksi (gambar TensorImage , opsi ImageProcessingOptions )
Melakukan deteksi aktual pada gambar yang disediakan.
Daftar <Deteksi>
deteksi (gambar MlImage , opsi ImageProcessingOptions )
Melakukan deteksi aktual pada MlImage yang disediakan dengan ImageProcessingOptions .
Daftar <Deteksi>
deteksi (gambar TensorImage )
Melakukan deteksi aktual pada gambar yang disediakan.

Metode Warisan

Metode Publik

ObjectDetector statis publik createFromBuffer ( ByteBuffer modelBuffer)

Membuat instance ObjectDetector dengan buffer model dan ObjectDetector.ObjectDetectorOptions default.

Parameter
modelBuffer ByteBuffer langsung atau MappedByteBuffer dari model deteksi
Melempar
Pengecualian Argumen Ilegal jika buffer model bukan ByteBuffer langsung atau MappedByteBuffer * @throws IllegalStateException jika ada kesalahan internal
Pengecualian Waktu Proses jika ada kesalahan yang tidak ditentukan

public static ObjectDetector createFromBufferAndOptions ( Opsi ByteBuffer modelBuffer, ObjectDetector.ObjectDetectorOptions )

Membuat instance ObjectDetector dengan buffer model dan ObjectDetector.ObjectDetectorOptions .

Parameter
modelBuffer ByteBuffer langsung atau MappedByteBuffer dari model deteksi
pilihan
Melempar
Pengecualian Argumen Ilegal jika buffer model bukan ByteBuffer langsung atau MappedByteBuffer
IlegalStateException jika ada kesalahan internal
Pengecualian Waktu Proses jika ada kesalahan yang tidak ditentukan

public static ObjectDetector createFromFile (Konteks konteks, String modelPath)

Membuat instance ObjectDetector dari ObjectDetector.ObjectDetectorOptions default.

Parameter
konteks
modelPath jalur ke model deteksi dengan metadata di aset
Melempar
Pengecualian IO jika terjadi kesalahan I/O saat memuat model tflite
Pengecualian Argumen Ilegal jika suatu argumen tidak valid
IlegalStateException jika ada kesalahan internal
Pengecualian Waktu Proses jika ada kesalahan yang tidak ditentukan

ObjectDetector statis publik createFromFile ( File modelFile)

Membuat instance ObjectDetector dari ObjectDetector.ObjectDetectorOptions default.

Parameter
file model contoh File model deteksi
Melempar
Pengecualian IO jika terjadi kesalahan I/O saat memuat model tflite
Pengecualian Argumen Ilegal jika suatu argumen tidak valid
IlegalStateException jika ada kesalahan internal
Pengecualian Waktu Proses jika ada kesalahan yang tidak ditentukan

public static ObjectDetector createFromFileAndOptions (Konteks konteks, String modelPath, opsi ObjectDetector.ObjectDetectorOptions )

Parameter
konteks
modelPath jalur ke model deteksi dengan metadata di aset
pilihan
Melempar
Pengecualian IO jika terjadi kesalahan I/O saat memuat model tflite
Pengecualian Argumen Ilegal jika suatu argumen tidak valid
IlegalStateException jika ada kesalahan internal
Pengecualian Waktu Proses jika ada kesalahan yang tidak ditentukan

public static ObjectDetector createFromFileAndOptions ( File modelFile, opsi ObjectDetector.ObjectDetectorOptions )

Parameter
file model contoh File model deteksi
pilihan
Melempar
Pengecualian IO jika terjadi kesalahan I/O saat memuat model tflite
Pengecualian Argumen Ilegal jika suatu argumen tidak valid
IlegalStateException jika ada kesalahan internal
Pengecualian Waktu Proses jika ada kesalahan yang tidak ditentukan

Daftar publik <Deteksi> deteksi (gambar MlImage )

Melakukan deteksi aktual pada MlImage yang disediakan.

Parameter
gambar objek MlImage yang mewakili gambar
Melempar
IlegalStateException jika ada kesalahan internal
Pengecualian Waktu Proses jika ada kesalahan yang tidak ditentukan
Pengecualian Argumen Ilegal jika jenis penyimpanan atau format gambar tidak didukung

Daftar publik <Deteksi> deteksi (gambar TensorImage , opsi ImageProcessingOptions )

Parameter
gambar objek TensorImage UINT8 yang mewakili gambar RGB atau YUV
pilihan opsi untuk mengonfigurasi cara melakukan praproses gambar
Melempar
IlegalStateException jika ada kesalahan internal
Pengecualian Waktu Proses jika ada kesalahan yang tidak ditentukan
Pengecualian Argumen Ilegal jika jenis ruang warna gambar tidak didukung

Daftar publik <Deteksi> deteksi (gambar MlImage , opsi ImageProcessingOptions )

Melakukan deteksi aktual pada MlImage yang disediakan dengan ImageProcessingOptions .

ObjectDetector mendukung opsi berikut:

Parameter
gambar objek MlImage yang mewakili gambar
pilihan opsi untuk mengonfigurasi cara melakukan praproses gambar
Melempar
IlegalStateException jika ada kesalahan internal
Pengecualian Waktu Proses jika ada kesalahan yang tidak ditentukan
Pengecualian Argumen Ilegal jika jenis penyimpanan atau format gambar tidak didukung

Daftar publik <Deteksi> deteksi (gambar TensorImage )

Melakukan deteksi aktual pada gambar yang disediakan.

ObjectDetector mendukung tipe ruang warna TensorImage berikut:

Parameter
gambar objek TensorImage UINT8 yang mewakili gambar RGB atau YUV
Melempar
IlegalStateException jika ada kesalahan internal
Pengecualian Waktu Proses jika ada kesalahan yang tidak ditentukan
Pengecualian Argumen Ilegal jika jenis ruang warna gambar tidak didukung