لتحميل البيانات الوصفية من نموذج TFLite FlatBuffer.
يمكن إنشاء FlatBuffer لنموذج TFLite باستخدام ملف مخطط نموذج TFLite.
تحتوي بعض النماذج على فراغ ثابت للبيانات الوصفية بتنسيق TFLite، الذي يسجّل المزيد من المعلومات حول وظيفة النموذج وكيفية تفسير النموذج. يمكن إنشاء Flatbuffer للبيانات الوصفية TFLite باستخدام ملف مخطط البيانات الوصفية TFLite.
يُسمح بتمرير نموذج FlatBuffer بدون بيانات التعريف TFLite. ومع ذلك، فإنّ طُرق الاستدعاء التي تقرأ من البيانات الوصفية في TFLite ستؤدي إلى حدوث أخطاء في وقت التشغيل.
وبالمثل، يُسمح بتمرير نموذج FlatBuffer بدون الملفات المرتبطة. ومع ذلك، سيؤدي استخدام طرق الاستدعاء التي تقرأ الملفات المرتبطة إلى حدوث أخطاء في وقت التشغيل.
مع أنّ نموذج TFLite FlatBuffer يتوافق مع عدة صور فرعية، لا تتيح ميزة "الترجمة الفورية" استخدام TFLite إلا مع رسم بياني فرعي واحد حتى الآن. لمزيد من المعلومات، يمكنك الاطّلاع على تعليمات
حول كيفية تحديد الكتابة الفرعية أثناء التحويل. لذلك، تحذف MetadataExtractor فهرس الرسم البياني الفرعي كإدخال في الطرق الخاصة بها.
الصفوف المتداخلة
| صنف | MetadataExtractor.QuantizationParams | مَعلَمات الكمية المتوافقة مع الجدول QuantizationParameters في
ملف مخطط نموذج TFLite |
|
الإنشاء العام
|
MetadataExtractor(المخزن المؤقت ByteBuffer)
تنشئ
MetadataExtractor باستخدام نموذج TFLite FlatBuffer. |
الطرق العامة
| InputStream | |
| ضبط<سلسلة> |
getAssociatedFileNames()
الحصول على أسماء الملفات المرتبطة بالملفات
|
| int |
getInputTensorCount()
للحصول على عدد موترات الإدخال في النموذج.
|
| TensorMetadata |
getInputTensorMetadata(int enterIndex)
للحصول على البيانات الوصفية لشدة الإدخال المحددة بواسطة
inputIndex. |
| MetadataExtractor.QuantizationParams |
getInputTensorQuantizationParams(int enterIndex)
للحصول على معلمات تحديد الكم لمعامل الإدخال المحدد بواسطة
inputIndex. |
| int[] |
getInputTensorShape(int enterIndex)
للحصول على شكل مشد الإدخال باستخدام
inputIndex. |
| بايت |
getInputTensorType(int enterIndex)
للحصول على
ERROR(/TensorType) لشد الإدخال باستخدام inputIndex. |
| ModelMetadata |
getModelMetadata()
الحصول على المعالج الجذر للبيانات الوصفية للنموذج.
|
| int |
getOutputTensorCount()
للحصول على عدد مشدات الإخراج في النموذج.
|
| TensorMetadata |
getOutputTensorMetadata(int generateIndex)
للحصول على البيانات الوصفية لمعيار الإخراج المحدد بواسطة
outputIndex. |
| MetadataExtractor.QuantizationParams |
getOutputTensorQuantizationParams(int generateIndex)
للحصول على معلمات تحديد الكمي لمتورد الإخراج المحدد بواسطة
outputIndex. |
| int[] |
getOutputTensorShape(int generateIndex)
للحصول على شكل متوتر الإخراج باستخدام
outputIndex. |
| بايت |
getOutputTensorType(int generateIndex)
نحصل على
ERROR(/TensorType) لشد الإخراج باستخدام outputIndex. |
| boolean |
hasMetadata()
تعرض
true إذا كان النموذج يحتوي على بيانات وصفية. |
| أخير منطقي |
isMinimumParserVersionSatisfied()
تعرض
true إذا كان الإصدار الأدنى المطلوب للمحلل اللغوي المطلوب من خلال المخزن المؤقت للبيانات الوصفية المحدد قبل أو يساوي إصدار محلل البيانات الوصفية الذي تعتمد عليه مكتبة استخراج البيانات الوصفية هذه. |
الطرق المكتسَبة
الإنشاء العام
public MetadataExtractor (ByteBuffer buffer)
تنشئ MetadataExtractor باستخدام نموذج TFLite FlatBuffer.
المَعلمات
| المخزن المؤقت | نموذج TFLite FlatBuffer |
|---|
الرميات
| IllegalArgumentException | إذا كان عدد متوترات الإدخال أو الإخراج في النموذج لا يتطابق مع العدد الوارد في البيانات الوصفية |
|---|---|
| IOException | إذا حدث خطأ أثناء قراءة النموذج كملف Zip |
الطرق العامة
public InputStream getAssociatedFile (سلسلة اسم الملف)
للحصول على الملف المرتبط المجمَّع مع السمة fileName المحدّدة
المَعلمات
| fileName | اسم الملف المرتبط |
|---|
المرتجعات
- مصدر البيانات الأولي الذي يحتوي على الملف المحدَّد
الرميات
| IllegalStateException | إذا لم يكن النموذج ملفًا بتنسيق ZIP |
|---|---|
| IllegalArgumentException | إذا لم يكن الملف المحدّد متوفّرًا في النموذج |
public Set<String> getAssociatedFileNames ()
الحصول على أسماء الملفات المرتبطة بالملفات
المرتجعات
- أسماء الملفات للملفات المرتبطة
الرميات
| IllegalStateException | إذا لم يكن النموذج ملفًا بتنسيق ZIP |
|---|
public int getInputTensorCount ()
للحصول على عدد موترات الإدخال في النموذج.
public TensorMetadata getInputTensorMetadata (int enterIndex)
للحصول على البيانات الوصفية لشدة الإدخال المحددة بواسطة inputIndex.
المَعلمات
| inputIndex | فهرس موصّل الإدخال المطلوب |
|---|
الرميات
| IllegalStateException | إذا كان هذا النموذج لا يحتوي على بيانات وصفية للنموذج |
|---|
public MetadataExtractor.QuantizationParams getInputTensorQuantizationParams (int enterIndex)
للحصول على معلمات تحديد الكم لمعامل الإدخال المحدد بواسطة inputIndex.
المَعلمات
| inputIndex | فهرس موصّل الإدخال المطلوب |
|---|
public int[] getInputTensorShape (int enterIndex)
للحصول على شكل مشد الإدخال باستخدام inputIndex.
المَعلمات
| inputIndex | فهرس موصّل الإدخال المطلوب |
|---|
عام بايت getInputTensorType (int enterIndex)
للحصول على ERROR(/TensorType) لشد الإدخال باستخدام inputIndex.
المَعلمات
| inputIndex | فهرس موصّل الإدخال المطلوب |
|---|
Public ModelMetadata getModelMetadata ()
الحصول على المعالج الجذر للبيانات الوصفية للنموذج.
الرميات
| IllegalStateException | إذا كان هذا النموذج لا يحتوي على بيانات وصفية للنموذج |
|---|
public int getOutputTensorCount ()
للحصول على عدد مشدات الإخراج في النموذج.
public TensorMetadata getOutputTensorMetadata (int الناتجةIndex)
للحصول على البيانات الوصفية لمعيار الإخراج المحدد بواسطة outputIndex.
المَعلمات
| outputIndex | فهرس شد الإخراج المطلوب |
|---|
الرميات
| IllegalStateException | إذا كان هذا النموذج لا يحتوي على بيانات وصفية للنموذج |
|---|
public MetadataExtractor.QuantizationParams getOutputTensorQuantizationParams (int generateIndex)
للحصول على معلمات تحديد الكمي لمتورد الإخراج المحدد بواسطة outputIndex.
المَعلمات
| outputIndex | فهرس شد الإخراج المطلوب |
|---|
public int[] getOutputTensorShape (int مماثلIndex)
للحصول على شكل متوتر الإخراج باستخدام outputIndex.
المَعلمات
| outputIndex | فهرس شد الإخراج المطلوب |
|---|
عام بايت getOutputTensorType (int generateIndex)
نحصل على ERROR(/TensorType) لشد الإخراج باستخدام outputIndex.
المَعلمات
| outputIndex | فهرس شد الإخراج المطلوب |
|---|
public منطقي hasMetadata ()
تعرض true إذا كان النموذج يحتوي على بيانات وصفية. وفي حال عدم حدوث ذلك، سيتم عرض false.
public last منطقي isMinimumParserVersionSatisfied ()
تعرض true إذا كان الإصدار الأدنى المطلوب للمحلل اللغوي المطلوب من خلال المخزن المؤقت للبيانات الوصفية المحدد قبل أو يساوي إصدار محلل البيانات الوصفية الذي تعتمد عليه مكتبة استخراج البيانات الوصفية هذه. يمكن تحليل جميع الحقول في البيانات الوصفية بشكل صحيح باستخدام مكتبة أداة استخراج البيانات الوصفية هذه في هذه الحالة. وبخلاف ذلك، سيتم عرض false.
على سبيل المثال، لنفترض أنّ إصدار محلّل البيانات الوصفية الأساسي هو 1.14.1،
- تعرض القيمة
trueإذا كان أدنى إصدار مطلوب للمحلل اللغوي هو نفسه أو أقدم، مثل1.14.1أو1.14.0. تسبق النسخة الخالية جميع النسخ الرقمية، لأنّ بعض الموارد الاحتياطية للبيانات الوصفية يتم إنشاؤها قبل الإصدار الأول من النسخة.
- تعرض القيمة
false، إذا كان الإصدار الأدنى المطلوب للمحلل اللغوي أحدث، مثل1.14.2.