ObjectDetector

מחלקה סופית ציבורית ObjectDetector

מבצע זיהוי אובייקטים בתמונות.

ה-API מצפה למודל TFLite עם Metadata של מודל TFLite. .

ה-API תומך בדגמים עם טנסור קלט תמונה אחד וארבעה טנסור פלט. ליתר דיוק, הנה הדרישות.

  • טנזור תמונה קלט ( kTfLiteUInt8 / kTfLiteFloat32 )
    • קלט תמונה בגודל [batch x height x width x channels] .
    • הסקת אצווה אינה נתמכת ( batch נדרשת להיות 1).
    • רק כניסות RGB נתמכות ( channels נדרשים להיות 3).
    • אם הסוג הוא kTfLiteFloat32 , נדרשות לצרף אפשרויות נורמליזציה למטא נתונים לצורך נורמליזציה של קלט.
  • טנסור פלט חייב להיות 4 הפלטים של 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.

שיטות ציבוריות

סטטי ObjectDetector
createFromBuffer ( ByteBuffer modelBuffer)
יוצר מופע ObjectDetector עם מאגר מודל ועם ברירת המחדל ObjectDetector.ObjectDetectorOptions .
סטטי ObjectDetector
createFromBufferAndOptions (אפשרויות ByteBuffer modelBuffer, ObjectDetector.ObjectDetectorOptions )
יוצר מופע ObjectDetector עם מאגר מודל ו- ObjectDetector.ObjectDetectorOptions .
סטטי ObjectDetector
createFromFile (הקשר הקשר, דגם מחרוזת נתיב)
יוצר מופע ObjectDetector מברירת המחדל של ObjectDetector.ObjectDetectorOptions .
סטטי ObjectDetector
createFromFile ( קובץ modelFile)
יוצר מופע ObjectDetector מברירת המחדל של ObjectDetector.ObjectDetectorOptions .
סטטי ObjectDetector
createFromFileAndOptions (הקשר הקשר, דגם מחרוזת נתיב, אפשרויות ObjectDetector.ObjectDetectorOptions )
סטטי ObjectDetector
רשימה < איתור >
לזהות (תמונת MlImage )
מבצע זיהוי ממשי ב- MlImage שסופק.
רשימה < איתור >
לזהות (תמונת TensorImage , אפשרויות ImageProcessingOptions )
מבצע זיהוי בפועל על התמונה שסופקה.
רשימה < איתור >
לזהות (תמונה MlImage , אפשרויות ImageProcessingOptions )
מבצע זיהוי ממשי ב- MlImage שסופק עם ImageProcessingOptions .
רשימה < איתור >
לזהות (תמונה של TensorImage )
מבצע זיהוי בפועל על התמונה שסופקה.

שיטות בירושה

שיטות ציבוריות

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 )

פרמטרים
הֶקשֵׁר
modelPath נתיב למודל הזיהוי עם מטא נתונים בנכסים
אפשרויות
זורק
IOException אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite
חריג טיעון לא חוקי אם טיעון אינו חוקי
חריגה של מדינה בלתי חוקית אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה

public static ObjectDetector createFromFileAndOptions (אפשרויות מודל קובץ File , ObjectDetector.ObjectDetectorOptions )

פרמטרים
modelFile מודל הזיהוי File instance
אפשרויות
זורק
IOException אם מתרחשת שגיאת קלט/פלט בעת טעינת דגם tflite
חריג טיעון לא חוקי אם טיעון אינו חוקי
חריגה של מדינה בלתי חוקית אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה

רשימה ציבורית < זיהוי > זיהוי ( תמונת MlImage )

מבצע זיהוי ממשי ב- MlImage שסופק.

פרמטרים
תמונה אובייקט MlImage המייצג תמונה
זורק
חריגה של מדינה בלתי חוקית אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה
חריג טיעון לא חוקי אם סוג האחסון או הפורמט של התמונה אינם נתמכים

רשימה ציבורית < זיהוי > זיהוי (תמונת TensorImage , אפשרויות ImageProcessingOptions )

מבצע זיהוי בפועל על התמונה שסופקה.

ObjectDetector תומך בסוגי מרחב הצבעים הבאים TensorImage :

ObjectDetector תומך באפשרויות הבאות:

פרמטרים
תמונה אובייקט UINT8 TensorImage המייצג תמונת RGB או YUV
אפשרויות האפשרויות להגדיר כיצד לעבד את התמונה מראש
זורק
חריגה של מדינה בלתי חוקית אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה
חריג טיעון לא חוקי אם סוג מרחב הצבע של התמונה אינו נתמך

רשימה ציבורית < זיהוי > זיהוי (תמונת MlImage , אפשרויות ImageProcessingOptions )

מבצע זיהוי ממשי ב- MlImage שסופק עם ImageProcessingOptions .

ObjectDetector תומך באפשרויות הבאות:

פרמטרים
תמונה אובייקט MlImage המייצג תמונה
אפשרויות האפשרויות להגדיר כיצד לעבד את התמונה מראש
זורק
חריגה של מדינה בלתי חוקית אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה
חריג טיעון לא חוקי אם סוג האחסון או הפורמט של התמונה אינם נתמכים

רשימה ציבורית < זיהוי > זיהוי ( תמונת TensorImage )

מבצע זיהוי בפועל על התמונה שסופקה.

ObjectDetector תומך בסוגי מרחב הצבעים הבאים TensorImage :

פרמטרים
תמונה אובייקט UINT8 TensorImage המייצג תמונת RGB או YUV
זורק
חריגה של מדינה בלתי חוקית אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה
חריג טיעון לא חוקי אם סוג מרחב הצבע של התמונה אינו נתמך