MetadataExtractor

مستخرج البيانات الوصفية من الفئة العامة

يقوم بتحميل البيانات التعريفية من نموذج TFLite FlatBuffer.

يمكن إنشاء TFLite Model FlatBuffer باستخدام ملف مخطط TFLite Model.

تحتوي بعض النماذج على TFLite Metadata Flatbuffer، الذي يسجل المزيد من المعلومات حول ما يفعله النموذج وكيفية تفسير النموذج. يمكن إنشاء بيانات تعريف TFLite Flatbuffer باستخدام ملف مخطط بيانات تعريف TFLite.

يُسمح بتمرير نموذج FlatBuffer بدون بيانات تعريف TFLite. ومع ذلك، فإن استدعاء الأساليب التي يتم قراءتها من بيانات تعريف TFLite سوف يتسبب في حدوث أخطاء في وقت التشغيل.

وبالمثل، يُسمح بتمرير نموذج FlatBuffer بدون الملفات المرتبطة به. ومع ذلك، فإن استدعاء الأساليب التي تقرأ الملفات المرتبطة سيؤدي إلى حدوث أخطاء في وقت التشغيل.

على الرغم من أن طراز TFLite FlatBuffer يدعم العديد من الرسوم البيانية الفرعية، إلا أن TFLite Interpreter يدعم فقط رسمًا بيانيًا فرعيًا واحدًا حتى الآن. راجع تعليمات كيفية تحديد رسم بياني فرعي أثناء التحويل لمزيد من المعلومات. ولذلك، يحذف MetadataExtractor فهرس الرسم البياني الفرعي كمدخل في أساليبه.

فئات متداخلة

فصل MetadataExtractor.QuantizationParams معلمات القياس التي تتوافق مع الجدول، QuantizationParameters ، في ملف مخطط نموذج TFLite.

المقاولون العامون

مستخرج البيانات الوصفية (المخزن المؤقت ByteBuffer )
إنشاء MetadataExtractor باستخدام نموذج TFLite FlatBuffer.

الأساليب العامة

تيار الإدخال
getAssociatedFile (اسم ملف السلسلة )
يحصل على الملف المرتبط المعبأ باسم fileName المحدد.
اضبط < سلسلة >
الحصول على أسماء الملفات المرتبطة ()
يحصل على أسماء الملفات من الملفات المرتبطة.
كثافة العمليات
getInputTensorCount ()
الحصول على عدد موترات الإدخال في النموذج.
TensorMetadata
getInputTensorMetadata (int inputIndex)
يحصل على البيانات التعريفية لموتر الإدخال المحدد بواسطة inputIndex .
MetadataExtractor.QuantizationParams
getInputTensorQuantizationParams (int inputIndex)
يحصل على معلمات التكميم لموتر الإدخال المحدد بواسطة inputIndex .
كثافة العمليات []
getInputTensorShape (int inputIndex)
يحصل على شكل موتر الإدخال باستخدام inputIndex .
بايت
getInputTensorType (int inputIndex)
يحصل على ERROR(/TensorType) لموتر الإدخال باستخدام inputIndex .
ModelMetadata
الحصول على نموذج البيانات الوصفية ()
الحصول على المعالج الجذري لبيانات تعريف النموذج.
كثافة العمليات
getOutputTensorCount ()
الحصول على عدد موترات الإخراج في النموذج.
TensorMetadata
getOutputTensorMetadata (intputIndex)
يحصل على البيانات التعريفية لموتر الإخراج المحدد بواسطة outputIndex .
MetadataExtractor.QuantizationParams
getOutputTensorQuantizationParams (مؤشر الإخراج int)
يحصل على معلمات التكميم لموتر الإخراج المحدد بواسطة outputIndex .
كثافة العمليات []
getOutputTensorShape (intputIndex)
يحصل على شكل موتر الإخراج باستخدام outputIndex .
بايت
getOutputTensorType (مؤشر الإخراج int)
يحصل على ERROR(/TensorType) لموتر الإخراج باستخدام outputIndex .
منطقية
بيانات التعريف ()
يُرجع true إذا كان النموذج يحتوي على بيانات وصفية.
منطقية نهائية
isMinimumParserVersionSatisfied ()
يُرجع true إذا كان الحد الأدنى من إصدار المحلل اللغوي المطلوب بواسطة المخزن المؤقت المسطح للبيانات التعريفية يسبق أو يساوي إصدار محلل البيانات التعريفية الذي تعتمد عليه مكتبة MetadataExtractor هذه.

الطرق الموروثة

المقاولون العامون

مستخرج البيانات الوصفية العامة (المخزن المؤقت ByteBuffer )

إنشاء MetadataExtractor باستخدام نموذج TFLite FlatBuffer.

حدود
متعادل نموذج TFLite FlatBuffer
رميات
غير الشرعيين استثناء حجة إذا كان عدد موترات الإدخال أو الإخراج في النموذج لا يتطابق مع البيانات الوصفية
IOEException إذا حدث خطأ أثناء قراءة النموذج كملف مضغوط

الأساليب العامة

public InputStream getAssociatedFile (اسم ملف السلسلة )

يحصل على الملف المرتبط المعبأ باسم fileName المحدد.

حدود
اسم الملف اسم الملف المرتبط
عائدات
  • دفق الإدخال الخام الذي يحتوي على الملف المحدد
رميات
استثناء الدولة غير القانوني إذا كان النموذج ليس ملف مضغوط
غير الشرعيين استثناء حجة إذا كان الملف المحدد غير موجود في النموذج

المجموعة العامة < سلسلة > getAssociatedFileNames ()

يحصل على أسماء الملفات من الملفات المرتبطة.

عائدات
  • أسماء الملفات من الملفات المرتبطة
رميات
استثناء الدولة غير القانوني إذا كان النموذج ليس ملف مضغوط

int public getInputTensorCount ()

الحصول على عدد موترات الإدخال في النموذج.

getInputTensorMetadata العامة لـ TensorMetadata (int inputIndex)

يحصل على البيانات التعريفية لموتر الإدخال المحدد بواسطة inputIndex .

حدود
inputIndex مؤشر موتر الإدخال المطلوب
رميات
استثناء الدولة غير القانوني إذا كان هذا النموذج لا يحتوي على بيانات تعريف النموذج

MetadataExtractor.QuantizationParams العامة getInputTensorQuantizationParams (int inputIndex)

يحصل على معلمات التكميم لموتر الإدخال المحدد بواسطة inputIndex .

حدود
inputIndex مؤشر موتر الإدخال المطلوب

كثافة العمليات العامة [] getInputTensorShape (int inputIndex)

يحصل على شكل موتر الإدخال باستخدام inputIndex .

حدود
inputIndex مؤشر موتر الإدخال المطلوب

البايت العام getInputTensorType (int inputIndex)

يحصل على ERROR(/TensorType) لموتر الإدخال باستخدام inputIndex .

حدود
inputIndex مؤشر موتر الإدخال المطلوب

public ModelMetadata getModelMetadata ()

الحصول على المعالج الجذري لبيانات تعريف النموذج.

رميات
استثناء الدولة غير القانوني إذا كان هذا النموذج لا يحتوي على بيانات تعريف النموذج

int public getOutputTensorCount ()

الحصول على عدد موترات الإخراج في النموذج.

getOutputTensorMetadata العامة لـ TensorMetadata (intputIndex)

يحصل على البيانات التعريفية لموتر الإخراج المحدد بواسطة outputIndex .

حدود
inputIndex مؤشر موتر الإخراج المطلوب
رميات
استثناء الدولة غير القانوني إذا كان هذا النموذج لا يحتوي على بيانات تعريف النموذج

MetadataExtractor.QuantizationParams العامة getOutputTensorQuantizationParams (int OutputIndex)

يحصل على معلمات التكميم لموتر الإخراج المحدد بواسطة outputIndex .

حدود
inputIndex مؤشر موتر الإخراج المطلوب

كثافة العمليات العامة [] getOutputTensorShape (int OutputIndex)

يحصل على شكل موتر الإخراج باستخدام outputIndex .

حدود
inputIndex مؤشر موتر الإخراج المطلوب

البايت العام getOutputTensorType (intputIndex)

يحصل على ERROR(/TensorType) لموتر الإخراج باستخدام outputIndex .

حدود
inputIndex مؤشر موتر الإخراج المطلوب

البيانات المنطقية العامة ()

يُرجع true إذا كان النموذج يحتوي على بيانات وصفية. خلاف ذلك، ترجع false .

المنطق المنطقي النهائي العام هوMinimumParserVersionSatisfied ()

يُرجع true إذا كان الحد الأدنى من إصدار المحلل اللغوي المطلوب بواسطة المخزن المؤقت المسطح للبيانات التعريفية يسبق أو يساوي إصدار محلل البيانات التعريفية الذي تعتمد عليه مكتبة MetadataExtractor هذه. يمكن تحليل جميع الحقول الموجودة في البيانات التعريفية بشكل صحيح باستخدام مكتبة مستخرج البيانات التعريفية هذه في هذه الحالة. وإلا فإنها ترجع false .

على سبيل المثال، افترض أن إصدار محلل البيانات التعريفية الأساسي هو 1.14.1 ،

  • يُرجع true ، إذا كان الحد الأدنى المطلوب لإصدار المحلل هو نفسه أو أقدم، مثل 1.14.1 أو 1.14.0 . يسبق الإصدار Null جميع الإصدارات الرقمية، لأنه يتم إنشاء بعض المخزن المؤقت للبيانات الوصفية قبل الإصدار الأول؛
  • تقوم بإرجاع false إذا كان الحد الأدنى المطلوب لإصدار المحلل اللغوي أحدث، مثل 1.14.2 .