מבצע סיווג על תמונות.
ה-API מצפה לדגם TFLite עם מטא נתונים אופציונליים, אך מומלץ בחום, של מודל TFLite. .
ה-API תומך בדגמים עם טנסור קלט תמונה אחד וטנסור פלט סיווג אחד. ליתר דיוק, הנה הדרישות.
- טנזור תמונה קלט (
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 המייצג תמונה |
|---|---|
| אפשרויות | מגדיר אפשרויות כולל החזר ROI וסיבוב |
זורק
| חריג טיעון לא חוקי | אם סוג האחסון או הפורמט של התמונה אינם נתמכים |
|---|
Public static ImageClassifier createFromBuffer ( ByteBuffer modelBuffer)
יוצר מופע ImageClassifier עם מאגר מודל ועם ברירת המחדל ImageClassifier.ImageClassifierOptions .
פרמטרים
| דגםBuffer | ByteBuffer ישיר או MappedByteBuffer של מודל הסיווג |
|---|
זורק
| חריג טיעון לא חוקי | אם מאגר המודל אינו ByteBuffer ישיר או MappedByteBuffer |
|---|---|
| חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
| חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public static ImageClassifier createFromBufferAndOptions (אפשרויות ByteBuffer modelBuffer, ImageClassifier.ImageClassifierOptions )
יוצר מופע ImageClassifier עם מאגר מודל ו- ImageClassifier.ImageClassifierOptions .
פרמטרים
| דגםBuffer | ByteBuffer ישיר או MappedByteBuffer של מודל הסיווג |
|---|---|
| אפשרויות |
זורק
| חריג טיעון לא חוקי | אם מאגר המודל אינו ByteBuffer ישיר או MappedByteBuffer |
|---|---|
| חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
| חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public static ImageClassifier createFromFile (הקשר הקשר, דגם מחרוזת נתיב)
יוצר מופע ImageClassifier מברירת המחדל של ImageClassifier.ImageClassifierOptions .
פרמטרים
| הֶקשֵׁר | |
|---|---|
| modelPath | נתיב מודל הסיווג עם מטא נתונים בנכסים |
זורק
| IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
|---|---|
| חריג טיעון לא חוקי | אם טיעון אינו חוקי |
| חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
| חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public static ImageClassifier createFromFile ( קובץ modelFile)
יוצר מופע ImageClassifier מברירת המחדל של ImageClassifier.ImageClassifierOptions .
פרמטרים
| modelFile | מודל הסיווג File מופע |
|---|
זורק
| IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
|---|---|
| חריג טיעון לא חוקי | אם טיעון אינו חוקי |
| חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
| חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public static ImageClassifier createFromFileAndOptions (הקשר הקשר, דגם StringPath , ImageClassifier.ImageClassifierOptions אפשרויות)
יוצר מופע ImageClassifier מתוך ImageClassifier.ImageClassifierOptions .
פרמטרים
| הֶקשֵׁר | |
|---|---|
| modelPath | נתיב מודל הסיווג עם מטא נתונים בנכסים |
| אפשרויות |
זורק
| IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
|---|---|
| חריג טיעון לא חוקי | אם טיעון אינו חוקי |
| חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
| חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public static ImageClassifier createFromFileAndOptions (אפשרויות דגם FileFile , ImageClassifier.ImageClassifierOptions )
יוצר מופע ImageClassifier .
פרמטרים
| modelFile | מודל הסיווג File מופע |
|---|---|
| אפשרויות |
זורק
| IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
|---|---|
| חריג טיעון לא חוקי | אם טיעון אינו חוקי |
| חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
| חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |