טוען מטא נתונים מדגם TFLite FlatBuffer.
ניתן ליצור TFLite Model FlatBuffer באמצעות קובץ הסכימה TFLite Model.
דגמים מסוימים מכילים TFLite Metadata Flatbuffer, אשר מתעד מידע נוסף על מה המודל עושה וכיצד לפרש את המודל. ניתן ליצור TFLite Metadata Flatbuffer באמצעות קובץ הסכימה TFLite Metadata.
מותר לעבור בדגם FlatBuffer ללא מטא נתונים של TFLite. עם זאת, הפעלת שיטות שקוראות ממטא נתונים של TFLite יגרום לשגיאות זמן ריצה.
באופן דומה, מותר לעבור בדגם FlatBuffer ללא קבצים משויכים. עם זאת, הפעלת שיטות שקוראות את הקבצים המשויכים תגרום לשגיאות זמן ריצה.
למרות שדגם TFLite FlatBuffer תומך במספר תת-גרפים, TFLite Interpreter תומך רק בתת-גרף בודד עד כה. עיין בהוראה כיצד לציין תת-גרף במהלך ההמרה למידע נוסף. לכן, MetadataExtractor משמיט את אינדקס המשנה כקלט בשיטות שלו.
כיתות מקוננות
| מעמד | MetadataExtractor.QuantizationParams | פרמטרי קוונטיזציה התואמים לטבלה, QuantizationParameters , בקובץ הסכימה של TFLite Model. | |
בונים ציבוריים
שיטות ציבוריות
| InputStream | |
| הגדר < מחרוזת > | getAssociatedFileNames () מקבל את שמות הקבצים של הקבצים המשויכים. |
| int | getInputTensorCount () מקבל את ספירת טנסור הקלט במודל. |
| TensorMetadata | getInputTensorMetadata (int inputIndex) מקבל את המטא נתונים עבור טנסור הקלט שצוין על ידי inputIndex . |
| MetadataExtractor.QuantizationParams | getInputTensorQuantizationParams (int inputIndex) מקבל את פרמטרי הקוונטיזציה עבור טנסור הקלט שצוין על ידי inputIndex . |
| int[] | getInputTensorShape (int inputIndex) מקבל את הצורה של טנסור הקלט עם inputIndex . |
| בייט | getInputTensorType (int inputIndex) מקבל את ERROR(/TensorType) של טנסור הקלט עם inputIndex . |
| ModelMetadata | getModelMetadata () מקבל את המטפל בשורש עבור המטא נתונים של המודל. |
| int | getOutputTensorCount () מקבל את ספירת טנסור הפלט במודל. |
| TensorMetadata | getOutputTensorMetadata (int outputIndex) מקבל את המטא נתונים עבור טנסור הפלט שצוין על ידי outputIndex . |
| MetadataExtractor.QuantizationParams | getOutputTensorQuantizationParams (int outputIndex) מקבל את פרמטרי הקוונטיזציה עבור טנסור הפלט שצוין על ידי outputIndex . |
| int[] | getOutputTensorShape (int outputIndex) מקבל את הצורה של טנסור הפלט עם outputIndex . |
| בייט | getOutputTensorType (int outputIndex) מקבל את ERROR(/TensorType) של טנסור הפלט עם outputIndex . |
| בוליאני | hasMetadata () מחזירה true אם למודל יש מטא נתונים. |
| בוליאנית סופית | isMinimumParserVersion Satisfied () מחזירה true אם גרסת המנתח המינימלית הנדרשת על ידי ה-flatbuffer של המטא נתונים קודמת או שווה לגרסה של מנתח המטא נתונים שעליו מסתמכת ספריית MetadataExtractor זו. |
שיטות בירושה
בונים ציבוריים
Public MetadataExtractor (חיץ ByteBuffer )
יוצר MetadataExtractor עם דגם TFLite FlatBuffer.
פרמטרים
| בַּלָם | דגם TFLite FlatBuffer |
|---|
זורק
| חריג טיעון לא חוקי | אם מספר טנסור הקלט או הפלט במודל אינו תואם את זה במטא נתונים |
|---|---|
| IOException | אם מתרחשת שגיאה בעת קריאת הדגם כקובץ Zip |
שיטות ציבוריות
public InputStream getAssociatedFile ( String fileName)
מקבל את הקובץ המשויך הארוז עם fileName שצוין.
פרמטרים
| שם קובץ | שם הקובץ המשויך |
|---|
החזרות
- זרם הקלט הגולמי המכיל את הקובץ שצוין
זורק
| חריגה של מדינה בלתי חוקית | אם הדגם אינו קובץ zip |
|---|---|
| חריג טיעון לא חוקי | אם הקובץ שצוין לא קיים במודל |
קבוצה ציבורית < String > getAssociatedFileNames ()
מקבל את שמות הקבצים של הקבצים המשויכים.
החזרות
- שמות הקבצים של הקבצים המשויכים
זורק
| חריגה של מדינה בלתי חוקית | אם הדגם אינו קובץ zip |
|---|
public int getInputTensorCount ()
מקבל את ספירת טנסור הקלט במודל.
public TensorMetadata getInputTensorMetadata (int inputIndex)
מקבל את המטא נתונים עבור טנסור הקלט שצוין על ידי inputIndex .
פרמטרים
| inputIndex | האינדקס של טנסור הקלט הרצוי |
|---|
זורק
| חריגה של מדינה בלתי חוקית | אם מודל זה אינו מכיל מטא נתונים של מודל |
|---|
public MetadataExtractor.QuantizationParams getInputTensorQuantizationParams (int inputIndex)
מקבל את פרמטרי הקוונטיזציה עבור טנסור הקלט שצוין על ידי inputIndex .
פרמטרים
| inputIndex | האינדקס של טנסור הקלט הרצוי |
|---|
public int[] getInputTensorShape (int inputIndex)
מקבל את הצורה של טנסור הקלט עם inputIndex .
פרמטרים
| inputIndex | האינדקס של טנסור הקלט הרצוי |
|---|
byte public getInputTensorType (int inputIndex)
מקבל את ERROR(/TensorType) של טנסור הקלט עם inputIndex .
פרמטרים
| inputIndex | האינדקס של טנסור הקלט הרצוי |
|---|
Public ModelMetadata getModelMetadata ()
מקבל את המטפל בשורש עבור המטא נתונים של המודל.
זורק
| חריגה של מדינה בלתי חוקית | אם מודל זה אינו מכיל מטא נתונים של מודל |
|---|
public int getOutputTensorCount ()
מקבל את ספירת טנסור הפלט במודל.
public TensorMetadata getOutputTensorMetadata (int outputIndex)
מקבל את המטא נתונים עבור טנסור הפלט שצוין על ידי outputIndex .
פרמטרים
| outputIndex | המדד של טנסור הפלט הרצוי |
|---|
זורק
| חריגה של מדינה בלתי חוקית | אם מודל זה אינו מכיל מטא נתונים של מודל |
|---|
public MetadataExtractor.QuantizationParams getOutputTensorQuantizationParams (int outputIndex)
מקבל את פרמטרי הקוונטיזציה עבור טנסור הפלט שצוין על ידי outputIndex .
פרמטרים
| outputIndex | המדד של טנסור הפלט הרצוי |
|---|
public int[] getOutputTensorShape (int outputIndex)
מקבל את הצורה של טנסור הפלט עם outputIndex .
פרמטרים
| outputIndex | המדד של טנסור הפלט הרצוי |
|---|
byte public getOutputTensorType (int outputIndex)
מקבל את ERROR(/TensorType) של טנסור הפלט עם outputIndex .
פרמטרים
| outputIndex | המדד של טנסור הפלט הרצוי |
|---|
hasMetadata בוליאני ציבורי ()
מחזירה true אם למודל יש מטא נתונים. אחרת, מחזירה false .
בוליאני הגמר הציבורי הואMinimumParserVersion Satisfied ()
מחזירה true אם גרסת המנתח המינימלית הנדרשת על ידי ה-flatbuffer של המטא נתונים קודמת או שווה לגרסה של מנתח המטא נתונים שעליו מסתמכת ספריית MetadataExtractor זו. במקרה זה ניתן לנתח נכון את כל השדות במטא נתונים באמצעות ספריית מחלץ המטא נתונים. אחרת, הוא מחזיר false .
לדוגמה, נניח שגרסת מנתח המטא נתונים הבסיסית היא 1.14.1 ,
- הוא מחזיר
true, אם גרסת המנתח המינימלית הנדרשת זהה או ישנה יותר, כגון1.14.1או1.14.0. גרסת Nul קודמת לכל הגרסאות המספריות, מכיוון שחלק מהמאגרים שטוחים של מטא נתונים נוצרים לפני המהדורה הראשונה בגרסה; - הוא מחזיר
false, אם גרסת המנתח המינימלית הנדרשת היא חדשה יותר, כגון1.14.2.