ObjectDetector

ObjectDetector המעמד הסופי הציבור

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

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

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

  • מותח תמונת קלט ( kTfLiteUInt8 / kTfLiteFloat32 )
    • קלט תמונה בגודל [batch x height x width x channels] .
    • מסקנה אצווה אינה נתמכת ( batch נדרש להיות 1).
    • תשומות RGB בלבד נתמכות ( channels נדרשו להיות 3).
    • אם סוג הוא kTfLiteFloat32 , NormalizationOptions נדרש להיות מחובר metadata עבור נורמליזצית קלט.
  • Tensors פלט חייב להיות 4 יציאות של DetectionPostProcess op, כלומר:
    • מותח מיקום ( kTfLiteFloat32 ):
      • מותח של גודל [1 x num_results x 4] , המערך הפנימי המייצג תיבות תוחמות בצורה [העליונה, שמאלה, ימינה, למטה].
      • BoundingBoxProperties נדרש להיות מחובר metadata וחייב לציין 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
סטטי ObjectDetector
createFromFile (הקשר, מחרוזת modelPath)
יוצר ObjectDetector למשל מברירת המחדל ObjectDetector.ObjectDetectorOptions .
סטטי ObjectDetector
createFromFile ( קובץ modelFile)
יוצר ObjectDetector למשל מברירת המחדל ObjectDetector.ObjectDetectorOptions .
סטטי ObjectDetector
סטטי ObjectDetector
רשימה < איתור >
לאתר ( MlImage תמונה)
מבצע איתור בפועל על ספק MlImage .
רשימה < איתור >
לאתר ( TensorImage תמונה, ImageProcessingOptions אופציות)
מבצע זיהוי בפועל על התמונה המסופקת.
רשימה < איתור >
לאתר ( MlImage תמונה, ImageProcessingOptions אופציות)
מבצע איתור בפועל על ספק MlImage עם ImageProcessingOptions .
רשימה < איתור >
לאתר ( TensorImage תמונה)
מבצע זיהוי בפועל על התמונה המסופקת.

שיטות תורשתיות

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

סטטי הציבור ObjectDetector createFromBuffer ( ByteBuffer modelBuffer)

יוצר ObjectDetector למשל עם חיץ מודל ואת ברירת המחדל ObjectDetector.ObjectDetectorOptions .

פרמטרים
modelBuffer ישיר ByteBuffer או MappedByteBuffer של מודל זיהוי
זורק
IllegalArgumentException אם חיץ המודל אינו ישיר ByteBuffer או MappedByteBuffer IllegalStateException @throws * אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה

הציבור סטטי ObjectDetector createFromBufferAndOptions ( ByteBuffer modelBuffer, ObjectDetector.ObjectDetectorOptions אופציות)

יוצר ObjectDetector למשל עם חיץ מודל ObjectDetector.ObjectDetectorOptions .

פרמטרים
modelBuffer ישיר ByteBuffer או MappedByteBuffer של מודל זיהוי
אפשרויות
זורק
IllegalArgumentException אם חיץ המודל אינו ישיר ByteBuffer או MappedByteBuffer
חריגה מ- IllegalStateException אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה

הציבור סטטי ObjectDetector createFromFile (ההקשר, מחרוזת modelPath)

יוצר ObjectDetector למשל מברירת המחדל ObjectDetector.ObjectDetectorOptions .

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

סטטי הציבור ObjectDetector createFromFile ( קובץ modelFile)

יוצר ObjectDetector למשל מברירת המחדל ObjectDetector.ObjectDetectorOptions .

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

סטטי הציבור ObjectDetector createFromFileAndOptions (ההקשר, מחרוזת modelPath, ObjectDetector.ObjectDetectorOptions אופציות)

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

סטטי הציבור ObjectDetector createFromFileAndOptions ( קובץ modelFile, ObjectDetector.ObjectDetectorOptions אופציות)

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

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

מבצע איתור בפועל על ספק MlImage .

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

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

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

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

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

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

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

מבצע איתור בפועל על ספק MlImage עם ImageProcessingOptions .

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

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

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

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

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

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