ImageSearcher

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

מבצע חיפוש דמיון בתמונות.

ה-API מצפה לדגם TFLite עם מטא נתונים אופציונליים, אך מומלץ בחום, של מודל TFLite. .

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

TODO(b/180502532): הוסף מצביע למודל לדוגמה.

TODO(b/222671076): הוסף שיטות יצירת מפעל ללא אפשרויות, כגון `createFromFile`, ברגע שפורמט הקובץ היחיד (קובץ האינדקס ארוז במודל) נתמך.

כיתות מקוננות

מעמד ImageSearcher.ImageSearcherOptions אפשרויות להגדרת ImageSearcher.

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

סטטי ImageSearcher
createFromBufferAndOptions (אפשרויות ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions )
יוצר מופע ImageSearcher עם מאגר מודל ו- ImageSearcher.ImageSearcherOptions .
סטטי ImageSearcher
סטטי ImageSearcher
createFromFileAndOptions (הקשר הקשר, דגם מחרוזת נתיב, אפשרויות ImageSearcher.ImageSearcherOptions )
סטטי ImageSearcher
רשימה < NearestNeighbor >
חיפוש (תמונת TensorImage , אפשרויות ImageProcessingOptions )
מבצע חילוץ הטמעה ב- TensorImage שסופק עם ImageProcessingOptions , ואחריו חיפוש של השכן הקרוב באינדקס.
רשימה < NearestNeighbor >
חיפוש (תמונה MlImage )
מבצע חילוץ הטבעה ב- MlImage שסופק, ואחריו חיפוש של השכן הקרוב באינדקס.
רשימה < NearestNeighbor >
חיפוש (תמונה MlImage , אפשרויות ImageProcessingOptions )
מבצע מיצוי הטמעה ב- MlImage שסופק עם ImageProcessingOptions , ואחריו חיפוש של השכן הקרוב באינדקס.
רשימה < NearestNeighbor >
חיפוש (תמונה של TensorImage )
מבצע חילוץ הטבעה על TensorImage שסופק, ולאחר מכן חיפוש של השכן הקרוב באינדקס.

שיטות בירושה

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

ImageSearcher סטטי ציבורי createFromBufferAndOptions (אפשרויות ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions )

יוצר מופע ImageSearcher עם מאגר מודל ו- ImageSearcher.ImageSearcherOptions .

פרמטרים
דגםBuffer ByteBuffer ישיר או MappedByteBuffer של מודל החיפוש
אפשרויות
זורק
חריג טיעון לא חוקי אם מאגר המודל אינו ByteBuffer ישיר או MappedByteBuffer
IOException אם מתרחשת שגיאת קלט/פלט בעת טעינת קובץ האינדקס
חריגה של מדינה בלתי חוקית אם יש שגיאה פנימית
חריגת זמן ריצה אם יש שגיאה אחרת שלא צוינה

Public static ImageSearcher createFromBufferAndOptionsImpl ( ByteBuffer modelBuffer, ImageSearcher.ImageSearcherOptions options, int indexFd)

פרמטרים
דגםBuffer
אפשרויות
indexFd

ImageSearcher סטטי ציבורי createFromFileAndOptions (הקשר הקשר, דגם מחרוזת נתיב, אפשרויות ImageSearcher.ImageSearcherOptions )

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

ImageSearcher סטטי ציבורי createFromFileAndOptions (אפשרויות דגם FileFile , ImageSearcher.ImageSearcherOptions )

יוצר מופע ImageSearcher .

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

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

מבצע חילוץ הטמעה ב- TensorImage שסופק עם ImageProcessingOptions , ואחריו חיפוש של השכן הקרוב באינדקס.

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

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

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

רשימה ציבורית < NearestNeighbor > חיפוש ( תמונה MlImage )

מבצע חילוץ הטבעה ב- MlImage שסופק, ואחריו חיפוש של השכן הקרוב באינדקס.

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

רשימה ציבורית < NearestNeighbor > חיפוש ( MlImage image, Image ProcessingOptions אפשרויות)

מבצע מיצוי הטמעה ב- MlImage שסופק עם ImageProcessingOptions , ואחריו חיפוש של השכן הקרוב באינדקס.

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

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

רשימה ציבורית < NearestNeighbor > חיפוש ( תמונת TensorImage )

מבצע חילוץ הטבעה על TensorImage שסופק, ולאחר מכן חיפוש של השכן הקרוב באינדקס.

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

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