MetadataExtractor

classe pubblica MetadataExtractor

Carica i metadati da TFLite Model FlatBuffer.

TFLite Model FlatBuffer può essere generato utilizzando il file di schema del modello TFLite.

Alcuni modelli contengono un TFLite Metadata Flatbuffer, che registra maggiori informazioni sulle operazioni del modello e su come interpretarlo. Il Flatbuffer di metadati TFLite può essere generato utilizzando il file di schema dei metadati TFLite.

È consentito passare in un FlatBuffer del modello senza metadati TFLite. Tuttavia, la chiamata a metodi che leggono dai metadati TFLite causerà errori di runtime.

Analogamente, è consentito passare in un modello FlatBuffer senza file associati. Tuttavia, il richiamo di metodi che leggono i file associati causeranno errori di runtime.

Sebbene il modello TFLite FlatBuffer supporti più sottografi, finora TFLite Interpreter supporta solo un singolo sottografo. Per ulteriori informazioni, consulta le istruzioni su come specificare un sottografico durante la conversione. Di conseguenza, nei metodi MetadataExtractor omette l'indice del sottografo come input.

Corsi nidificati

classe MetadataExtractor.QuantizationParams Parametri di quantizzazione corrispondenti alla tabella QuantizationParameters, nel file di schema del modello TFLite. 

Costruttori pubblici

MetadataExtractor(buffer ByteBuffer)
Crea un elemento MetadataExtractor con FlatBuffer modello TFLite.

Metodi pubblici

InputStream
getAssociatedFile(Stringa fileName)
Recupera il file associato compresso con il fileName specificato.
Imposta<Stringa>
getAssociatedFileNames()
Recupera i nomi dei file associati.
int
getInputTensorCount()
Restituisce il conteggio dei tensori di input nel modello.
TensorMetadata
getInputTensorMetadata(int inputIndex)
Restituisce i metadati per il tensore di input specificato da inputIndex.
MetadataExtractor.QuantizationParams
getInputTensorQuantizationParams(int inputIndex)
Restituisce i parametri di quantizzazione per il tensore di input specificato da inputIndex.
int[]
getInputTensorShape(int inputIndex)
Recupera la forma del tensore di input con inputIndex.
byte
getInputTensorType(int inputIndex)
Recupera il valore ERROR(/TensorType) del tensore di input con inputIndex.
ModelMetadata
getModelMetadata()
Restituisce il gestore principale per i metadati del modello.
int
getOutputTensorCount()
Restituisce il conteggio dei tensori di output nel modello.
TensorMetadata
getOutputTensorMetadata(int outputIndex)
Restituisce i metadati per il tensore di output specificato da outputIndex.
MetadataExtractor.QuantizationParams
getOutputTensorQuantizationParams(int outputIndex)
Restituisce i parametri di quantizzazione per il tensore di output specificato da outputIndex.
int[]
getOutputTensorShape(int outputIndex)
Recupera la forma del tensore di output con outputIndex.
byte
getOutputTensorType(int outputIndex)
Recupera il valore ERROR(/TensorType) del tensore di output con outputIndex.
boolean
hasMetadata()
Restituisce true se il modello ha metadati.
finale booleano
isMinimumParserVersionSatisfied()
Restituisce true se la versione minima del parser richiesta dal flatbuffer di metadati specificato è precedente o uguale alla versione dell'analizzatore sintattico di metadati su cui si basa questa libreria MetadataExtractor.

Metodi ereditati

Costruttori pubblici

pubblico MetadataExtractor (buffer ByteBuffer)

Crea un elemento MetadataExtractor con FlatBuffer modello TFLite.

Parametri
buffer il modello TFLite FlatBuffer
Lanci
IllegalArgumentException se il numero di tensori di input o output nel modello non corrisponde a quello nei metadati
IOException se si verifica un errore durante la lettura del modello come file ZIP

Metodi pubblici

Public InputStream getAssociatedFile (String fileName)

Recupera il file associato compresso con il fileName specificato.

Parametri
fileName il nome del file associato
Ritorni
  • il flusso di input non elaborato contenente il file specificato
Lanci
IllegalStateException se il modello non è un file ZIP
IllegalArgumentException se il file specificato non esiste nel modello

Public Set<String> getAssociatedFileNames ()

Recupera i nomi dei file associati.

Ritorni
  • i nomi dei file associati
Lanci
IllegalStateException se il modello non è un file ZIP

pubblica int getInputTensorCount ()

Restituisce il conteggio dei tensori di input nel modello.

pubblico TensorMetadata getInputTensorMetadata (int inputIndex)

Restituisce i metadati per il tensore di input specificato da inputIndex.

Parametri
inputIndex l'indice del tensore di input desiderato
Lanci
IllegalStateException se il modello non contiene metadati del modello

pubblici MetadataExtractor.QuantizationParams getInputTensorQuantizationParams (int inputIndex)

Restituisce i parametri di quantizzazione per il tensore di input specificato da inputIndex.

Parametri
inputIndex l'indice del tensore di input desiderato

pubblica int[] getInputTensorShape (int inputIndex)

Recupera la forma del tensore di input con inputIndex.

Parametri
inputIndex l'indice del tensore di input desiderato

Public byte getInputTensorType (int inputIndex)

Recupera il valore ERROR(/TensorType) del tensore di input con inputIndex.

Parametri
inputIndex l'indice del tensore di input desiderato

pubblici ModelMetadata getModelMetadata ()

Restituisce il gestore principale per i metadati del modello.

Lanci
IllegalStateException se il modello non contiene metadati del modello

pubblica int getOutputTensorCount ()

Restituisce il conteggio dei tensori di output nel modello.

Public TensorMetadata getOutputTensorMetadata (int outputIndex)

Restituisce i metadati per il tensore di output specificato da outputIndex.

Parametri
outputIndex l'indice del tensore di output desiderato
Lanci
IllegalStateException se il modello non contiene metadati del modello

Public MetadataExtractor.QuantizationParams getOutputTensorQuantizationParams (int outputIndex)

Restituisce i parametri di quantizzazione per il tensore di output specificato da outputIndex.

Parametri
outputIndex l'indice del tensore di output desiderato

Public int[] getOutputTensorShape (int outputIndex)

Recupera la forma del tensore di output con outputIndex.

Parametri
outputIndex l'indice del tensore di output desiderato

pubblico byte getOutputTensorType (int outputIndex)

Recupera il valore ERROR(/TensorType) del tensore di output con outputIndex.

Parametri
outputIndex l'indice del tensore di output desiderato

Public booleano hasMetadata ()

Restituisce true se il modello ha metadati. In caso contrario, restituisce false.

Public final booleano isMinimumParserVersionSatisfied ()

Restituisce true se la versione minima del parser richiesta dal flatbuffer di metadati specificato è precedente o uguale alla versione dell'analizzatore sintattico di metadati su cui si basa questa libreria MetadataExtractor. In questo caso, tutti i campi nei metadati possono essere analizzati correttamente con questa libreria di estrattori di metadati. In caso contrario, viene restituito false.

Ad esempio, supponiamo che la versione sottostante del parser dei metadati sia 1.14.1,

  • restituisce true, se la versione minima richiesta del parser è uguale o precedente, ad esempio 1.14.1 o 1.14.0. La versione null precede tutte le versioni numeriche, poiché alcuni flatbuffer di metadati vengono generati prima della prima release con controllo delle versioni;
  • restituisce false, se la versione minima richiesta del parser è più recente, ad esempio 1.14.2.