ينفذ التصنيف على الصور.
تتوقع واجهة برمجة التطبيقات (API) نموذج TFLite مع بيانات تعريف نموذج TFLite الاختيارية، ولكن يوصى بها بشدة. .
تدعم واجهة برمجة التطبيقات النماذج التي تحتوي على موتر إدخال صورة واحد وموتر إخراج تصنيف واحد. لنكون أكثر تحديدا، وهنا المتطلبات.
- موتر صورة الإدخال (
kTfLiteUInt8
/kTfLiteFloat32
)- حجم إدخال الصورة
[batch x height x width x channels]
. - استنتاج الدُفعة غير مدعوم (يُشترط أن تكون
batch
1). - يتم دعم مدخلات RGB فقط (يجب أن تكون
channels
3). - إذا كان النوع هو
kTfLiteFloat32
، فيجب إرفاق خيارات التسوية بالبيانات الوصفية لتطبيع الإدخال.
- حجم إدخال الصورة
kTfLiteUInt8
/ kTfLiteFloat32
)- مع فئات
N
ذات أبعاد 2 أو 4، مثل[1 x N]
أو[1 x 1 x 1 x N]
- مطلوب ملف التسمية ليتم تعبئته في البيانات الوصفية. راجع مثال إنشاء البيانات التعريفية لمصنف الصور . إذا لم يتم تعبئة أي ملفات تسمية، فسيتم استخدام الفهرس كتسمية في النتيجة.
يمكن العثور على مثال لهذا النموذج على TensorFlow Hub. .
فئات متداخلة
فصل | ImageClassifier.ImageClassifierOptions | خيارات لإعداد ImageClassifier. |
الأساليب العامة
الطرق الموروثة
الأساليب العامة
القائمة العامة < التصنيفات > التصنيف (صورة TensorImage )
ينفذ التصنيف الفعلي على TensorImage
المقدم.
يدعم ImageClassifier
أنواع مساحات الألوان TensorImage
التالية:
حدود
صورة | كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV |
---|
رميات
غير الشرعيين استثناء حجة | إذا كان نوع مساحة اللون للصورة غير مدعوم |
---|
القائمة العامة < التصنيفات > التصنيف (صورة TensorImage ، خيارات ImageProcessingOptions )
ينفذ التصنيف الفعلي على TensorImage
المزود باستخدام ImageProcessingOptions
.
يدعم ImageClassifier
الخيارات التالية:
- منطقة الاهتمام (ROI) (من خلال
ImageProcessingOptions.Builder.setRoi(Rect)
). إنه افتراضي للصورة بأكملها. - تدوير الصورة (من خلال
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). الافتراضي هوImageProcessingOptions.Orientation.TOP_LEFT
.
يدعم ImageClassifier
أنواع مساحات الألوان TensorImage
التالية:
حدود
صورة | كائن UINT8 TensorImage الذي يمثل صورة RGB أو YUV |
---|---|
خيارات |
رميات
غير الشرعيين استثناء حجة | إذا كان نوع مساحة اللون للصورة غير مدعوم |
---|
القائمة العامة < التصنيفات > التصنيف (صورة MlImage )
ينفذ التصنيف الفعلي على MlImage
المقدمة.
حدود
صورة | كائن MlImage الذي يمثل صورة |
---|
رميات
غير الشرعيين استثناء حجة | إذا كان نوع تخزين الصورة أو تنسيقها غير مدعوم |
---|
القائمة العامة < التصنيفات > التصنيف (صورة MlImage ، خيارات ImageProcessingOptions )
ينفذ التصنيف الفعلي على MlImage
المزود باستخدام ImageProcessingOptions
.
يدعم ImageClassifier
الخيارات التالية:
- منطقة الاهتمام (ROI) (من خلال
ImageProcessingOptions.Builder.setRoi(Rect)
). إنه افتراضي للصورة بأكملها. - تدوير الصورة (من خلال
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). الافتراضي هوImageProcessingOptions.Orientation.TOP_LEFT
.MlImage.getRotation()
غير فعال.
حدود
صورة | كائن MlImage الذي يمثل صورة |
---|---|
خيارات | يقوم بتكوين الخيارات بما في ذلك عائد الاستثمار والتناوب |
رميات
غير الشرعيين استثناء حجة | إذا كان نوع تخزين الصورة أو تنسيقها غير مدعوم |
---|
ImageClassifier ثابت عام createFromBuffer ( ByteBuffer modelBuffer)
ينشئ نسخة ImageClassifier
بمخزن مؤقت للنموذج و ImageClassifier.ImageClassifierOptions
الافتراضي.
حدود
modelBuffer | ByteBuffer مباشر أو MappedByteBuffer لنموذج التصنيف |
---|
رميات
غير الشرعيين استثناء حجة | إذا كان المخزن المؤقت للنموذج ليس ByteBuffer مباشرًا أو MappedByteBuffer |
---|---|
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
ImageClassifier ثابت عام createFromBufferAndOptions (خيارات ByteBuffer modelBuffer، ImageClassifier.ImageClassifierOptions )
ينشئ نسخة ImageClassifier
مع مخزن مؤقت للنموذج و ImageClassifier.ImageClassifierOptions
.
حدود
modelBuffer | ByteBuffer مباشر أو MappedByteBuffer لنموذج التصنيف |
---|---|
خيارات |
رميات
غير الشرعيين استثناء حجة | إذا كان المخزن المؤقت للنموذج ليس ByteBuffer مباشرًا أو MappedByteBuffer |
---|---|
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
ImageClassifier العام الثابت createFromFile (سياق السياق، String modelPath)
ينشئ نسخة ImageClassifier
من ImageClassifier.ImageClassifierOptions
الافتراضي.
حدود
سياق | |
---|---|
modelPath | مسار نموذج التصنيف مع البيانات الوصفية في الأصول |
رميات
IOEException | في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite |
---|---|
غير الشرعيين استثناء حجة | إذا كانت الوسيطة غير صالحة |
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
ImageClassifier ثابت عام createFromFile ( ملف modelFile)
ينشئ نسخة ImageClassifier
من ImageClassifier.ImageClassifierOptions
الافتراضي.
حدود
modelFile | مثيل File نموذج التصنيف |
---|
رميات
IOEException | في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite |
---|---|
غير الشرعيين استثناء حجة | إذا كانت الوسيطة غير صالحة |
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
ImageClassifier العام الثابت createFromFileAndOptions (سياق السياق، String modelPath، خيارات ImageClassifier.ImageClassifierOptions )
ينشئ مثيل ImageClassifier
من ImageClassifier.ImageClassifierOptions
.
حدود
سياق | |
---|---|
modelPath | مسار نموذج التصنيف مع البيانات الوصفية في الأصول |
خيارات |
رميات
IOEException | في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite |
---|---|
غير الشرعيين استثناء حجة | إذا كانت الوسيطة غير صالحة |
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |
ImageClassifier ثابت عام createFromFileAndOptions ( ملف modelFile، خيارات ImageClassifier.ImageClassifierOptions )
إنشاء مثيل ImageClassifier
.
حدود
modelFile | مثيل File نموذج التصنيف |
---|---|
خيارات |
رميات
IOEException | في حالة حدوث خطأ في الإدخال/الإخراج عند تحميل نموذج tflite |
---|---|
غير الشرعيين استثناء حجة | إذا كانت الوسيطة غير صالحة |
استثناء الدولة غير القانوني | إذا كان هناك خطأ داخلي |
استثناء وقت التشغيل | إذا كان هناك خطأ غير محدد |