מבצע זיהוי אובייקטים בתמונות.
ה-API מצפה למודל TFLite עם Metadata של מודל TFLite. .
ה-API תומך בדגמים עם טנסור קלט תמונה אחד וארבעה טנסור פלט. ליתר דיוק, הנה הדרישות.
- טנזור תמונה קלט (
kTfLiteUInt8
/kTfLiteFloat32
)- קלט תמונה בגודל
[batch x height x width x channels]
. - הסקת אצווה אינה נתמכת (
batch
נדרשת להיות 1). - רק כניסות RGB נתמכות (
channels
נדרשים להיות 3). - אם הסוג הוא
kTfLiteFloat32
, נדרשות לצרף אפשרויות נורמליזציה למטא נתונים לצורך נורמליזציה של קלט.
- קלט תמונה בגודל
DetectionPostProcess
op, כלומר:- טנזור מיקום (
kTfLiteFloat32
):- טנסור בגודל
[1 x num_results x 4]
, המערך הפנימי המייצג תיבות תוחמות בצורה [למעלה, שמאל, ימין, תחתון]. - נדרשים לצרף את
BoundingBoxProperties
למטא נתונים ועליהם לצייןtype=BOUNDARIES
ו-coordinate_type=RATIO
.
- טנסור בגודל
kTfLiteFloat32
):- טנסור בגודל
[1 x num_results]
, כל ערך מייצג את אינדקס המספרים השלמים של מחלקה. - אם מפות תוויות מצורפות למטא נתונים בתור
TENSOR_VALUE_LABELS
קבצים משויכים, הם משמשים להמרת ערכי הטנזור לתוויות.
kTfLiteFloat32
):- טנסור בגודל
[1 x num_results]
, כל ערך מייצג את הניקוד של האובייקט שזוהה.
kTfLiteFloat32
):- מספר שלם num_results כטנזור בגודל
[1]
.
דוגמה למודל כזה ניתן למצוא ב- TensorFlow Hub. .
כיתות מקוננות
מעמד | ObjectDetector.ObjectDetectorOptions | אפשרויות להגדרת ObjectDetector. |
שיטות ציבוריות
שיטות בירושה
שיטות ציבוריות
Public Static ObjectDetector createFromBuffer ( ByteBuffer modelBuffer)
יוצר מופע ObjectDetector
עם מאגר מודל ועם ברירת המחדל ObjectDetector.ObjectDetectorOptions
.
פרמטרים
דגםBuffer | ByteBuffer ישיר או MappedByteBuffer של מודל הזיהוי |
---|
זורק
חריג טיעון לא חוקי | אם מאגר המודל אינו ByteBuffer ישיר או MappedByteBuffer * @throws IllegalStateException אם יש שגיאה פנימית |
---|---|
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public static ObjectDetector createFromBufferAndOptions (אפשרויות ByteBuffer modelBuffer, ObjectDetector.ObjectDetectorOptions )
יוצר מופע ObjectDetector
עם מאגר מודל ו- ObjectDetector.ObjectDetectorOptions
.
פרמטרים
דגםBuffer | ByteBuffer ישיר או MappedByteBuffer של מודל הזיהוי |
---|---|
אפשרויות |
זורק
חריג טיעון לא חוקי | אם מאגר המודל אינו ByteBuffer ישיר או MappedByteBuffer |
---|---|
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public Static ObjectDetector createFromFile (הקשר הקשר, דגם מחרוזת נתיב)
יוצר מופע ObjectDetector
מברירת המחדל של ObjectDetector.ObjectDetectorOptions
.
פרמטרים
הֶקשֵׁר | |
---|---|
modelPath | נתיב למודל הזיהוי עם מטא נתונים בנכסים |
זורק
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
---|---|
חריג טיעון לא חוקי | אם טיעון אינו חוקי |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public Static ObjectDetector createFromFile ( קובץ modelFile)
יוצר מופע ObjectDetector
מברירת המחדל של ObjectDetector.ObjectDetectorOptions
.
פרמטרים
modelFile | מודל הזיהוי File instance |
---|
זורק
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
---|---|
חריג טיעון לא חוקי | אם טיעון אינו חוקי |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
Public Static ObjectDetector createFromFileAndOptions (הקשר הקשר, דגם מחרוזת נתיב, אפשרויות ObjectDetector.ObjectDetectorOptions )
יוצר מופע ObjectDetector
מ- ObjectDetector.ObjectDetectorOptions
.
פרמטרים
הֶקשֵׁר | |
---|---|
modelPath | נתיב למודל הזיהוי עם מטא נתונים בנכסים |
אפשרויות |
זורק
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
---|---|
חריג טיעון לא חוקי | אם טיעון אינו חוקי |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
public static ObjectDetector createFromFileAndOptions (אפשרויות מודל קובץ File , ObjectDetector.ObjectDetectorOptions )
יוצר מופע ObjectDetector
מ- ObjectDetector.ObjectDetectorOptions
.
פרמטרים
modelFile | מודל הזיהוי File instance |
---|---|
אפשרויות |
זורק
IOException | אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite |
---|---|
חריג טיעון לא חוקי | אם טיעון אינו חוקי |
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
רשימה ציבורית < זיהוי > זיהוי ( תמונת MlImage )
מבצע זיהוי ממשי ב- MlImage
שסופק.
פרמטרים
תמונה | אובייקט MlImage המייצג תמונה |
---|
זורק
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
---|---|
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
חריג טיעון לא חוקי | אם סוג האחסון או הפורמט של התמונה אינם נתמכים |
רשימה ציבורית < זיהוי > זיהוי (תמונת TensorImage , אפשרויות ImageProcessingOptions )
מבצע זיהוי בפועל על התמונה שסופקה.
ObjectDetector
תומך בסוגי מרחב הצבעים הבאים TensorImage
:
ObjectDetector
תומך באפשרויות הבאות:
- סיבוב תמונה (דרך
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). ברירת המחדל היאImageProcessingOptions.Orientation.TOP_LEFT
.
פרמטרים
תמונה | אובייקט UINT8 TensorImage המייצג תמונת RGB או YUV |
---|---|
אפשרויות | האפשרויות להגדיר כיצד לעבד את התמונה מראש |
זורק
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
---|---|
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
חריג טיעון לא חוקי | אם סוג מרחב הצבע של התמונה אינו נתמך |
רשימה ציבורית < זיהוי > זיהוי (תמונת MlImage , אפשרויות ImageProcessingOptions )
מבצע זיהוי ממשי ב- MlImage
שסופק עם ImageProcessingOptions
.
ObjectDetector
תומך באפשרויות הבאות:
- סיבוב תמונה (דרך
ImageProcessingOptions.Builder.setOrientation(ImageProcessingOptions.Orientation)
). ברירת המחדל היאImageProcessingOptions.Orientation.TOP_LEFT
.MlImage.getRotation()
אינו יעיל.
פרמטרים
תמונה | אובייקט MlImage המייצג תמונה |
---|---|
אפשרויות | האפשרויות להגדיר כיצד לעבד את התמונה מראש |
זורק
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
---|---|
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
חריג טיעון לא חוקי | אם סוג האחסון או הפורמט של התמונה אינם נתמכים |
רשימה ציבורית < זיהוי > זיהוי ( תמונת TensorImage )
מבצע זיהוי בפועל על התמונה שסופקה.
ObjectDetector
תומך בסוגי מרחב הצבעים הבאים TensorImage
:
פרמטרים
תמונה | אובייקט UINT8 TensorImage המייצג תמונת RGB או YUV |
---|
זורק
חריגה של מדינה בלתי חוקית | אם יש שגיאה פנימית |
---|---|
חריגת זמן ריצה | אם יש שגיאה אחרת שלא צוינה |
חריג טיעון לא חוקי | אם סוג מרחב הצבע של התמונה אינו נתמך |