MetadataExtractor

パブリック クラスMetadataExtractor

TFLite モデル FlatBuffer からメタデータを読み込みます。

TFLite モデル FlatBuffer は、 TFLite モデル スキーマ ファイルを使用して生成できます。

一部のモデルには TFLite メタデータ フラットバッファーが含まれており、モデルの動作とモデルの解釈方法に関する詳細情報が記録されます。 TFLite メタデータ フラットバッファは、TFLite メタデータ スキーマ ファイルを使用して生成できます。

TFLite メタデータなしでモデル FlatBuffer を渡すことができます。ただし、TFLite メタデータから読み取るメソッドを呼び出すと、ランタイム エラーが発生します。

同様に、関連ファイルなしでモデル FlatBuffer を渡すことができます。ただし、関連ファイルを読み取るメソッドを呼び出すと、実行時エラーが発生します。

TFLite モデルの FlatBuffer は複数のサブグラフをサポートしていますが、TFLite インタープリターは今のところ単一のサブグラフのみをサポートしています。詳細については、変換中にサブグラフを指定する方法の説明を参照してください。したがって、 MetadataExtractorメソッドの入力としてサブグラフ インデックスを省略します。

ネストされたクラス

クラスMetadataExtractor.QuantizationParams TFLite モデル スキーマ ファイル内のテーブルQuantizationParametersに対応する量子化パラメーター。

パブリックコンストラクター

MetadataExtractor ( ByteBufferバッファ)
TFLite モデル FlatBuffer を使用してMetadataExtractorを作成します。

パブリックメソッド

入力ストリーム
getAssociatedFile (文字列ファイル名)
指定されたfileNameを持つパックされた関連ファイルを取得します。
<文字列>を設定します
getAssociatedFileNames ()
関連付けられたファイルのファイル名を取得します。
整数
getInputTensorCount ()
モデル内の入力テンソルの数を取得します。
テンソルメタデータ
getInputTensorMetadata (int inputIndex)
inputIndexで指定された入力テンソルのメタデータを取得します。
MetadataExtractor.QuantizationParams
getInputTensorQuantizationParams (int inputIndex)
inputIndexで指定された入力テンソルの量子化パラメータを取得します。
int[]
getInputTensorShape (int inputIndex)
inputIndexを使用して入力テンソルの形状を取得します。
バイト
getInputTensorType (int inputIndex)
inputIndexを使用して入力テンソルのERROR(/TensorType)を取得します。
モデルメタデータ
getModelMetadata ()
モデルメタデータのルートハンドラーを取得します。
整数
getOutputTensorCount ()
モデル内の出力テンソルの数を取得します。
テンソルメタデータ
getOutputTensorMetadata (int OutputIndex)
outputIndexで指定された出力テンソルのメタデータを取得します。
MetadataExtractor.QuantizationParams
getOutputTensorQuantizationParams (int OutputIndex)
outputIndexで指定された出力テンソルの量子化パラメータを取得します。
int[]
getOutputTensorShape (int OutputIndex)
outputIndexを使用して出力テンソルの形状を取得します。
バイト
getOutputTensorType (int OutputIndex)
outputIndexを使用して出力テンソルのERROR(/TensorType)を取得します。
ブール値
メタデータあり()
モデルにメタデータがある場合はtrueを返します。
最終ブール値
isMinimumParserVersionSatisfied ()
指定されたメタデータ フラットバッファで必要なパーサーの最小バージョンが、この MetadataExtractor ライブラリが依存しているメタデータ パーサーのバージョンよりも前か、それと等しい場合はtrueを返します。

継承されたメソッド

パブリックコンストラクター

public MetadataExtractor ( ByteBufferバッファ)

TFLite モデル FlatBuffer を使用してMetadataExtractorを作成します。

パラメーター
バッファTFLite モデル FlatBuffer
投げる
IllegalArgumentExceptionモデル内の入力または出力テンソルの数がメタデータ内の数と一致しない場合
IO例外モデルを Zip ファイルとして読み取るときにエラーが発生した場合

パブリックメソッド

public InputStream getAssociatedFile ( String fileName)

指定されたfileNameを持つパックされた関連ファイルを取得します。

パラメーター
ファイル名関連するファイルの名前
戻り値
  • 指定されたファイルを含む生の入力ストリーム
投げる
IllegalStateExceptionモデルが zip ファイルではない場合
IllegalArgumentException指定されたファイルがモデルに存在しない場合

public Set < String > getAssociatedFileNames ()

関連付けられたファイルのファイル名を取得します。

戻り値
  • 関連するファイルのファイル名
投げる
IllegalStateExceptionモデルが zip ファイルではない場合

public int getInputTensorCount ()

モデル内の入力テンソルの数を取得します。

public TensorMetadata getInputTensorMetadata (int inputIndex)

inputIndexで指定された入力テンソルのメタデータを取得します。

パラメーター
入力インデックス目的の入力テンソルのインデックス
投げる
IllegalStateExceptionこのモデルにモデル メタデータが含まれていない場合

public MetadataExtractor.QuantizationParams getInputTensorQuantizationParams (int inputIndex)

inputIndexで指定された入力テンソルの量子化パラメータを取得します。

パラメーター
入力インデックス目的の入力テンソルのインデックス

public int[] getInputTensorShape (int inputIndex)

inputIndexを使用して入力テンソルの形状を取得します。

パラメーター
入力インデックス目的の入力テンソルのインデックス

パブリック バイトgetInputTensorType (int inputIndex)

inputIndexを使用して入力テンソルのERROR(/TensorType)を取得します。

パラメーター
入力インデックス目的の入力テンソルのインデックス

public ModelMetadata getModelMetadata ()

モデルメタデータのルートハンドラーを取得します。

投げる
IllegalStateExceptionこのモデルにモデル メタデータが含まれていない場合

public int getOutputTensorCount ()

モデル内の出力テンソルの数を取得します。

public TensorMetadata getOutputTensorMetadata (int OutputIndex)

outputIndexで指定された出力テンソルのメタデータを取得します。

パラメーター
出力インデックス目的の出力テンソルのインデックス
投げる
IllegalStateExceptionこのモデルにモデル メタデータが含まれていない場合

public MetadataExtractor.QuantizationParams getOutputTensorQuantizationParams (int OutputIndex)

outputIndexで指定された出力テンソルの量子化パラメータを取得します。

パラメーター
出力インデックス目的の出力テンソルのインデックス

public int[] getOutputTensorShape (int OutputIndex)

outputIndexを使用して出力テンソルの形状を取得します。

パラメーター
出力インデックス目的の出力テンソルのインデックス

パブリック バイトgetOutputTensorType (int OutputIndex)

outputIndexを使用して出力テンソルのERROR(/TensorType)を取得します。

パラメーター
出力インデックス目的の出力テンソルのインデックス

public boolean hasMetadata ()

モデルにメタデータがある場合はtrueを返します。それ以外の場合は、 falseを返します。

public Final boolean isMinimumParserVersionSatisfied ()

指定されたメタデータ フラットバッファで必要なパーサーの最小バージョンが、この MetadataExtractor ライブラリが依存しているメタデータ パーサーのバージョンよりも前か、それと等しい場合はtrueを返します。この場合、メタデータ内のすべてのフィールドは、このメタデータ抽出ライブラリを使用して正しく解析できます。それ以外の場合は、 falseを返します。

たとえば、基礎となるメタデータ パーサーのバージョンが1.14.1であると仮定します。

  • 必要なパーサーの最小バージョンが1.14.1や1.14.0など、同じかそれより古い場合、 trueを返します。一部のメタデータ フラットバッファは最初のバージョン付けされたリリースより前に生成されるため、Null バージョンはすべての数値バージョンよりも優先されます。
  • 必要な最小パーサー バージョンが新しい場合 ( 1.14.2など)、 falseを返します。