טעינת מטא-נתונים מ-TFLite Model FlatBuffer.
אפשר ליצור את TFLite Model FlatBuffer באמצעות קובץ הסכימה של TFLite.
חלק מהמודלים כוללים את TFLite Metadata Flatbuffer, שמתעד מידע נוסף על פעולת המודל ואיך לפרש אותו. כדי ליצור TFLite Metadata Flatbuffer, אפשר להשתמש בקובץ הסכימה של TFLite Metadata.
מותר להעביר במודל FlatBuffer ללא מטא-נתונים של TFLite. עם זאת, הפעלת שיטות שיקראו מהמטא-נתונים של TFLite תגרום לשגיאות בזמן הריצה.
באופן דומה, מותר להעביר במודל FlatBuffer ללא קבצים משויכים. עם זאת, הפעלת שיטות שיקראו את הקבצים המשויכים תגרום לשגיאות בזמן הריצה.
על אף שהמודל של TFLite תומך במספר תתי-תרשימים, בתרגום ל-TFLite יש תמיכה רק
בתת-תרשים אחד עד עכשיו. למידע נוסף, אפשר לעיין בהוראות לציון תת-תרשים במהלך ההמרה. לכן, MetadataExtractor
משמיטה את אינדקס המשנה כקלט בשיטות שלו.
מחלקות מקננות
מחלקה | MetadataExtractor.QuantizationParams | הפרמטרים של הכמות שתואמים לטבלה, QuantizationParameters , בקובץ הסכימה של TFLite . |
בנאים ציבוריים
MetadataExtractor(מאגר נתונים זמני ByteBuffer)
יצירת
MetadataExtractor עם מודל TFLite של FlatBuffer. |
שיטות ציבוריות
InputStream | |
הגדרה<מחרוזת> |
getAssociatedFileNames()
הפונקציה מקבלת את שמות הקבצים של הקבצים המשויכים.
|
int |
getInputTensorCount()
מקבלת את מספר רכיבי ה-tensor של הקלט במודל.
|
TensorMetadata |
getInputTensorMetadata(אינדקס קלט ל-int)
קבלת המטא-נתונים של tensor הקלט שצוין על ידי
inputIndex . |
MetadataExtractor.QuantizationParams |
getInputTensorQuantizationParams(intinputIndex)
הפונקציה מקבלת את הפרמטרים של הקוונטיזציה של Tensor הקלט שצוין ב-
inputIndex . |
int[] |
getInputTensorShape(אינדקס קלט)
הפונקציה מקבלת את הצורה של tensor הקלט עם
inputIndex . |
בייט |
getInputTensorType(אינדקס קלט)
הפונקציה מקבלת את
ERROR(/TensorType) של Tensor הקלט עם inputIndex . |
ModelMetadata |
getModelMetadata()
הפונקציה מקבלת את ה-handler הבסיסי (root) של המטא-נתונים של המודל.
|
int |
getOutputTensorCount()
מקבלת את מספר רכיבי ה-tensor של הפלט במודל.
|
TensorMetadata |
getOutputTensorMetadata(int outputIndex)
הפונקציה מקבלת את המטא-נתונים של Tensor הפלט שצוין על ידי
outputIndex . |
MetadataExtractor.QuantizationParams |
getOutputTensorQuantizationParams(intoutputIndex)
הפונקציה מקבלת את הפרמטרים של הקוונטיזציה של Tensor הפלט שצוין ב-
outputIndex . |
int[] |
getOutputTensorShape(אינדקס פלט ב-int)
הפונקציה מקבלת את הצורה של tensor הפלט עם
outputIndex . |
בייט |
getOutputTensorType(אינדקס פלט ב-int)
הפונקציה מקבלת את
ERROR(/TensorType) של Tensor הפלט עם outputIndex . |
boolean |
hasMetadata()
הפונקציה מחזירה את הערך
true אם למודל יש מטא-נתונים. |
סופי בוליאני |
isMinimumParserVersionSatisfied()
הפונקציה מחזירה את הערך
true אם גרסת הניתוח המינימלית שנדרשת על ידי מאגר המטא-נתונים המוצפן הנתון
קודמת לגרסה של מנתח המטא-נתונים שעליה מסתמכת ספריית ה-Metadata מהאתר הזו. |
שיטות שעברו בירושה
בנאים ציבוריים
Public MetadataExtractor (מאגר אחסון ByteBuffer)
יצירת MetadataExtractor
עם מודל TFLite של FlatBuffer.
פרמטרים
buffer | דגם FlatBuffer של TFLite |
---|
קליעות
IllegalArgumentException | אם מספר רכיבי ה-tensor של הקלט או הפלט במודל לא תואם לזה במטא-נתונים |
---|---|
IOException | אם מתרחשת שגיאה בעת קריאת המודל כקובץ Zip |
שיטות ציבוריות
ציבורי InputStream getAssociatedFile (String fileName)
הפונקציה מקבלת את הקובץ הארוז המשויך עם fileName
שצוין.
פרמטרים
fileName | שם הקובץ המשויך |
---|
החזרות
- זרם הקלט הגולמי שמכיל את הקובץ שצוין
קליעות
IllegalStateException | אם המודל הוא לא קובץ ZIP |
---|---|
IllegalArgumentException | אם הקובץ שצוין לא קיים במודל |
Public Set<String> getAssociatedFileNames ()
הפונקציה מקבלת את שמות הקבצים של הקבצים המשויכים.
החזרות
- שמות הקבצים של הקבצים המשויכים
קליעות
IllegalStateException | אם המודל הוא לא קובץ ZIP |
---|
Public int getInputTensorCount ()
מקבלת את מספר רכיבי ה-tensor של הקלט במודל.
ציבורי TensorMetadata getInputTensorMetadata (intinputIndex)
קבלת המטא-נתונים של tensor הקלט שצוין על ידי inputIndex
.
פרמטרים
inputIndex | האינדקס של Tensor הקלט הרצוי |
---|
קליעות
IllegalStateException | אם המודל הזה לא מכיל מטא-נתונים של המודל |
---|
public MetadataExtractor.QuantizationParams getInputTensorQuantizationParams (int feedbackIndex)
הפונקציה מקבלת את הפרמטרים של הקוונטיזציה של Tensor הקלט שצוין ב-inputIndex
.
פרמטרים
inputIndex | האינדקס של Tensor הקלט הרצוי |
---|
public int[] getInputTensorShape (intinputIndex)
הפונקציה מקבלת את הצורה של tensor הקלט עם inputIndex
.
פרמטרים
inputIndex | האינדקס של Tensor הקלט הרצוי |
---|
Public byte getInputTensorType (int variableIndex)
הפונקציה מקבלת את ERROR(/TensorType)
של Tensor הקלט עם inputIndex
.
פרמטרים
inputIndex | האינדקס של Tensor הקלט הרצוי |
---|
Public ModelMetadata getModelMetadata ()
הפונקציה מקבלת את ה-handler הבסיסי (root) של המטא-נתונים של המודל.
קליעות
IllegalStateException | אם המודל הזה לא מכיל מטא-נתונים של המודל |
---|
Public int getOutputTensorCount ()
מקבלת את מספר רכיבי ה-tensor של הפלט במודל.
Public TensorMetadata getOutputTensorMetadata (intoutputIndex)
הפונקציה מקבלת את המטא-נתונים של Tensor הפלט שצוין על ידי outputIndex
.
פרמטרים
outputIndex | האינדקס של Tensor הפלט הרצוי |
---|
קליעות
IllegalStateException | אם המודל הזה לא מכיל מטא-נתונים של המודל |
---|
Public MetadataExtractor.QuantizationParams getOutputTensorQuantizationParams (intoutputIndex)
הפונקציה מקבלת את הפרמטרים של הקוונטיזציה של Tensor הפלט שצוין ב-outputIndex
.
פרמטרים
outputIndex | האינדקס של Tensor הפלט הרצוי |
---|
Public int[] getOutputTensorShape (intoutputIndex)
הפונקציה מקבלת את הצורה של tensor הפלט עם outputIndex
.
פרמטרים
outputIndex | האינדקס של Tensor הפלט הרצוי |
---|
Public byte getOutputTensorType (intoutputIndex)
הפונקציה מקבלת את ERROR(/TensorType)
של Tensor הפלט עם outputIndex
.
פרמטרים
outputIndex | האינדקס של Tensor הפלט הרצוי |
---|
public בוליאני hasMetadata ()
הפונקציה מחזירה את הערך true
אם למודל יש מטא-נתונים. אחרת, הפונקציה מחזירה false
.
public final בוליאני isMinimumParserVersionSatisfied ()
הפונקציה מחזירה את הערך true
אם גרסת הניתוח המינימלית שנדרשת על ידי מאגר המטא-נתונים המוצפן הנתון
קודמת לגרסה של מנתח המטא-נתונים שעליה מסתמכת ספריית ה-Metadata מהאתר הזו. במקרה הזה, אפשר לנתח בצורה נכונה את כל השדות במטא-נתונים באמצעות הספרייה
של חילוץ המטא-נתונים. אחרת, הוא יחזיר false
.
לדוגמה, נניח שהגרסה של מנתח המטא-נתונים הבסיסי היא 1.14.1
,
- הפונקציה מחזירה את הערך
true
, אם גרסת הניתוח המינימלית הנדרשת היא זהה או ישנה יותר, כמו1.14.1
או1.14.0
. גרסת null קודמת לכל הגרסאות המספריות, מכיוון שחלק מרכיבי ה-flatטופ של המטא-נתונים נוצרים לפני הגרסה הראשונה של הגרסה;
- הפונקציה מחזירה את הערך
false
, אם גרסת הניתוח המינימלית הנדרשת היא חדשה יותר, כמו1.14.2
.