ObjectDetector

genel son sınıf ObjectDetector

Görüntüler üzerinde nesne tespiti gerçekleştirir.

API , TFLite Model Meta Verilerine sahip bir TFLite modeli beklemektedir. .

API, bir görüntü giriş tensörü ve dört çıkış tensörlü modelleri destekler. Daha spesifik olmak gerekirse, gereksinimler şunlardır.

  • Giriş görüntüsü tensörü ( kTfLiteUInt8 / kTfLiteFloat32 )
    • boyut görüntü girişi [batch x height x width x channels] .
    • toplu çıkarım desteklenmiyor ( batch 1 olması gerekiyor).
    • yalnızca RGB girişleri desteklenir ( channels 3 olması gerekir).
    • tür kTfLiteFloat32 ise, giriş normalleştirmesi için normalizationOptions'ın meta verilere eklenmesi gerekir.
  • Çıkış tensörleri bir DetectionPostProcess işleminin 4 çıkışı olmalıdır, yani:
    • Konum tensörü ( kTfLiteFloat32 ):
      • boyut tensörü [1 x num_results x 4] , [top, left, right, Bottom] formundaki sınırlayıcı kutuları temsil eden iç dizi.
      • BoundingBoxProperties meta verilere eklenmesi gerekir ve type=BOUNDARIES ve coordinate_type=RATIO belirtilmelidir.
    • Sınıflar tensörü ( kTfLiteFloat32 ):
      • boyut tensörü [1 x num_results] , her değer bir sınıfın tamsayı indeksini temsil eder.
      • etiket haritaları meta verilere TENSOR_VALUE_LABELS ilişkili dosyalar olarak eklenirse tensör değerlerini etiketlere dönüştürmek için kullanılırlar.
    • puan tensörü ( kTfLiteFloat32 ):
      • boyut tensörü [1 x num_results] , her değer algılanan nesnenin puanını temsil eder.
    • Algılama tensörünün sayısı ( kTfLiteFloat32 ):
      • [1] boyutunda bir tensör olarak num_results tamsayı.

Böyle bir modelin bir örneğini TensorFlow Hub'da bulabilirsiniz. .

İç İçe Sınıflar

sınıf ObjectDetector.ObjectDetectorOptions ObjectDetector'ı ayarlama seçenekleri.

Genel Yöntemler

Statik Nesne Algılayıcı
createFromBuffer ( ByteBuffer modelBuffer)
Model arabelleği ve varsayılan ObjectDetector.ObjectDetectorOptions ile bir ObjectDetector örneği oluşturur.
Statik Nesne Algılayıcı
createFromBufferAndOptions ( ByteBuffer modelBuffer, ObjectDetector.ObjectDetectorOptions seçenekleri)
Model arabelleği ve ObjectDetector.ObjectDetectorOptions ile bir ObjectDetector örneği oluşturur.
Statik Nesne Algılayıcı
createFromFile (Bağlam bağlamı, String modelPath)
Varsayılan ObjectDetector.ObjectDetectorOptions öğesinden bir ObjectDetector örneği oluşturur.
Statik Nesne Algılayıcı
createFromFile ( Dosya modeliDosya)
Varsayılan ObjectDetector.ObjectDetectorOptions öğesinden bir ObjectDetector örneği oluşturur.
Statik Nesne Algılayıcı
createFromFileAndOptions (Bağlam bağlamı, String modelPath, ObjectDetector.ObjectDetectorOptions seçenekleri)
ObjectDetector.ObjectDetectorOptions öğesinden bir ObjectDetector örneği oluşturur.
Statik Nesne Algılayıcı
Liste < Algılama >
tespit et ( MlImage görüntüsü)
Sağlanan MlImage üzerinde gerçek algılamayı gerçekleştirir.
Liste < Algılama >
algılama ( TensorImage görüntüsü, ImageProcessingOptions seçenekleri)
Sağlanan görüntü üzerinde gerçek algılamayı gerçekleştirir.
Liste < Algılama >
algılama ( MlImage görüntüsü, ImageProcessingOptions seçenekleri)
ImageProcessingOptions ile sağlanan MlImage üzerinde gerçek algılamayı gerçekleştirir.
Liste < Algılama >
tespit et ( TensorImage görüntüsü)
Sağlanan görüntü üzerinde gerçek algılamayı gerçekleştirir.

Kalıtsal Yöntemler

Genel Yöntemler

genel statik ObjectDetector createFromBuffer ( ByteBuffer modelBuffer)

Model arabelleği ve varsayılan ObjectDetector.ObjectDetectorOptions ile bir ObjectDetector örneği oluşturur.

Parametreler
modelTampon algılama modelinin doğrudan ByteBuffer veya MappedByteBuffer
Atar
YasadışıTartışmaİstisna model arabelleği doğrudan bir ByteBuffer veya MappedByteBuffer değilse * @throws IllegalStateException dahili bir hata varsa
Çalışma zamanı istisnası aksi takdirde belirtilmeyen bir hata varsa

public static ObjectDetector createFromBufferAndOptions ( ByteBuffer modelBuffer, ObjectDetector.ObjectDetectorOptions seçenekleri)

Model arabelleği ve ObjectDetector.ObjectDetectorOptions ile bir ObjectDetector örneği oluşturur.

Parametreler
modelTampon algılama modelinin doğrudan ByteBuffer veya MappedByteBuffer
seçenekler
Atar
YasadışıTartışmaİstisna model arabelleği doğrudan bir ByteBuffer veya MappedByteBuffer değilse
Yasadışı Durum İstisnası dahili bir hata varsa
Çalışma zamanı istisnası aksi takdirde belirtilmeyen bir hata varsa

public static ObjectDetector createFromFile (Bağlam bağlamı, String modelPath)

Varsayılan ObjectDetector.ObjectDetectorOptions öğesinden bir ObjectDetector örneği oluşturur.

Parametreler
bağlam
modelYol Varlıklardaki meta verileri içeren algılama modelinin yolu
Atar
IO İstisnası tflite modeli yüklenirken bir G/Ç hatası oluşursa
YasadışıTartışmaİstisna eğer bir argüman geçersizse
Yasadışı Durum İstisnası dahili bir hata varsa
Çalışma zamanı istisnası aksi takdirde belirtilmeyen bir hata varsa

public static ObjectDetector createFromFile ( Dosya modelFile)

Varsayılan ObjectDetector.ObjectDetectorOptions öğesinden bir ObjectDetector örneği oluşturur.

Parametreler
modelDosya algılama modeli File örneği
Atar
IO İstisnası tflite modeli yüklenirken bir G/Ç hatası oluşursa
YasadışıTartışmaİstisna eğer bir argüman geçersizse
Yasadışı Durum İstisnası dahili bir hata varsa
Çalışma zamanı istisnası aksi takdirde belirtilmeyen bir hata varsa

public static ObjectDetector createFromFileAndOptions (Bağlam bağlamı, String modelPath, ObjectDetector.ObjectDetectorOptions seçenekleri)

ObjectDetector.ObjectDetectorOptions öğesinden bir ObjectDetector örneği oluşturur.

Parametreler
bağlam
modelYol Varlıklardaki meta verileri içeren algılama modelinin yolu
seçenekler
Atar
IO İstisnası tflite modeli yüklenirken bir G/Ç hatası oluşursa
YasadışıTartışmaİstisna eğer bir argüman geçersizse
Yasadışı Durum İstisnası dahili bir hata varsa
Çalışma zamanı istisnası aksi takdirde belirtilmeyen bir hata varsa

public static ObjectDetector createFromFileAndOptions ( Dosya modelFile, ObjectDetector.ObjectDetectorOptions seçenekleri)

ObjectDetector.ObjectDetectorOptions öğesinden bir ObjectDetector örneği oluşturur.

Parametreler
modelDosya algılama modeli File örneği
seçenekler
Atar
IO İstisnası tflite modeli yüklenirken bir G/Ç hatası oluşursa
YasadışıTartışmaİstisna eğer bir argüman geçersizse
Yasadışı Durum İstisnası dahili bir hata varsa
Çalışma zamanı istisnası aksi takdirde belirtilmeyen bir hata varsa

genel Liste < Algılama > algılama ( MlImage görüntüsü)

Sağlanan MlImage üzerinde gerçek algılamayı gerçekleştirir.

Parametreler
görüntü bir görüntüyü temsil eden bir MlImage nesnesi
Atar
Yasadışı Durum İstisnası dahili bir hata varsa
Çalışma zamanı istisnası aksi takdirde belirtilmeyen bir hata varsa
YasadışıTartışmaİstisna görüntünün depolama türü veya formatı desteklenmiyorsa

genel Liste < Algılama > algılama ( TensorImage görüntüsü, ImageProcessingOptions seçenekleri)

Sağlanan görüntü üzerinde gerçek algılamayı gerçekleştirir.

ObjectDetector aşağıdaki TensorImage renk alanı türlerini destekler:

ObjectDetector aşağıdaki seçenekleri destekler:

Parametreler
görüntü bir RGB veya YUV görüntüsünü temsil eden bir UINT8 TensorImage nesnesi
seçenekler görüntünün nasıl ön işleneceğini yapılandırma seçenekleri
Atar
Yasadışı Durum İstisnası dahili bir hata varsa
Çalışma zamanı istisnası aksi takdirde belirtilmeyen bir hata varsa
YasadışıTartışmaİstisna görüntünün renk alanı türü desteklenmiyorsa

genel Liste < Algılama > algılama ( MlImage görüntüsü, ImageProcessingOptions seçenekleri)

ImageProcessingOptions ile sağlanan MlImage üzerinde gerçek algılamayı gerçekleştirir.

ObjectDetector aşağıdaki seçenekleri destekler:

Parametreler
görüntü bir görüntüyü temsil eden bir MlImage nesnesi
seçenekler görüntünün nasıl ön işleneceğini yapılandırma seçenekleri
Atar
Yasadışı Durum İstisnası dahili bir hata varsa
Çalışma zamanı istisnası aksi takdirde belirtilmeyen bir hata varsa
YasadışıTartışmaİstisna görüntünün depolama türü veya formatı desteklenmiyorsa

genel Liste < Algılama > algılama ( TensorImage görüntüsü)

Sağlanan görüntü üzerinde gerçek algılamayı gerçekleştirir.

ObjectDetector aşağıdaki TensorImage renk alanı türlerini destekler:

Parametreler
görüntü bir RGB veya YUV görüntüsünü temsil eden bir UINT8 TensorImage nesnesi
Atar
Yasadışı Durum İstisnası dahili bir hata varsa
Çalışma zamanı istisnası aksi takdirde belirtilmeyen bir hata varsa
YasadışıTartışmaİstisna görüntünün renk alanı türü desteklenmiyorsa