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.
- boyut görüntü girişi
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 vetype=BOUNDARIES
vecoordinate_type=RATIO
belirtilmelidir.
- boyut 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.
kTfLiteFloat32
):- boyut tensörü
[1 x num_results]
, her değer algılanan nesnenin puanını temsil eder.
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
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:
- görüntü döndürme (
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
aracılığıyla). Varsayılan olarakImageProcessingOptions.Orientation.TOP_LEFT
şeklindedir.
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:
- görüntü döndürme (
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
aracılığıyla). Varsayılan olarakImageProcessingOptions.Orientation.TOP_LEFT
şeklindedir.MlImage.getRotation()
etkili değil.
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 |