Ładuje metadane z TFLite Model FlatBuffer.
TFLite Model FlatBuffer można wygenerować przy użyciu pliku schematu modelu TFLite.
Niektóre modele zawierają płaski bufor metadanych TFLite, który rejestruje więcej informacji o tym, co robi model i jak go interpretować. Płaski bufor metadanych TFLite można wygenerować przy użyciu pliku schematu metadanych TFLite.
Dopuszczalne jest przekazywanie modelu FlatBuffer bez metadanych TFLite. Jednak wywoływanie metod odczytujących metadane TFLite spowoduje błędy w czasie wykonywania.
Podobnie dozwolone jest przekazywanie modelu FlatBuffer bez powiązanych plików. Jednak wywołanie metod odczytujących powiązane pliki spowoduje błędy w czasie wykonywania.
Chociaż model TFLite FlatBuffer obsługuje wiele podgrafów, TFLite Interpreter obsługuje jak dotąd tylko jeden podgraf. Więcej informacji znajdziesz w instrukcji określania podgrafu podczas konwersji. Dlatego MetadataExtractor
pomija indeks podgrafów jako dane wejściowe w swoich metodach.
Klasy zagnieżdżone
klasa | MetadataExtractor.QuantizationParams | Parametry kwantyzacji odpowiadające tabeli QuantizationParameters w pliku schematu modelu TFLite. |
Konstruktorzy publiczni
Metody publiczne
Strumień wejściowy | getAssociatedFile ( ciąg znaków nazwa_pliku) Pobiera spakowany skojarzony plik z określonym fileName . |
Ustaw < Ciąg > | getAssociatedFileNames () Pobiera nazwy plików skojarzonych plików. |
wew | getInputTensorCount () Pobiera liczbę tensorów wejściowych w modelu. |
TensorMetadane | getInputTensorMetadata (int inputIndex) Pobiera metadane dla tensora wejściowego określonego przez inputIndex . |
MetadataExtractor.QuantizationParams | getInputTensorQuantizationParams (int inputIndex) Pobiera parametry kwantyzacji dla tensora wejściowego określonego przez inputIndex . |
int[] | getInputTensorShape (int inputIndex) Pobiera kształt tensora wejściowego za pomocą inputIndex . |
bajt | getInputTensorType (int inputIndex) Pobiera ERROR(/TensorType) tensora wejściowego z inputIndex . |
ModelMetadane | getModelMetadata () Pobiera procedurę obsługi głównej dla metadanych modelu. |
wew | getOutputTensorCount () Pobiera liczbę tensorów wyjściowych w modelu. |
TensorMetadane | getOutputTensorMetadata (int wynikIndex) Pobiera metadane dla tensora wyjściowego określonego przez outputIndex . |
MetadataExtractor.QuantizationParams | getOutputTensorQuantizationParams (int OutputIndex) Pobiera parametry kwantyzacji dla tensora wyjściowego określonego przez outputIndex . |
int[] | getOutputTensorShape (int wynikIndex) Pobiera kształt tensora wyjściowego z outputIndex . |
bajt | getOutputTensorType (int wynikIndex) Pobiera ERROR(/TensorType) tensora wyjściowego z outputIndex . |
wartość logiczna | maMetadane () Zwraca wartość true , jeśli model zawiera metadane. |
końcowa wartość logiczna | isMinimumParserVersionSatisfied () Zwraca true , jeśli minimalna wersja analizatora składni wymagana przez dany bufor płaski metadanych poprzedza wersję analizatora metadanych, na którym opiera się ta biblioteka MetadataExtractor, lub jest jej równa. |
Metody dziedziczone
Konstruktorzy publiczni
publiczny MetadataExtractor (bufor ByteBuffer )
Tworzy MetadataExtractor
z modelem TFLite FlatBuffer.
Parametry
bufor | model TFLite FlatBuffer |
---|
Rzuca
Wyjątek IllegalArgument | jeśli liczba tensorów wejściowych lub wyjściowych w modelu nie odpowiada liczbie w metadanych |
---|---|
Wyjątek IO | jeśli wystąpi błąd podczas odczytu modelu w postaci pliku ZIP |
Metody publiczne
public InputStream getAssociatedFile ( ciąg nazwapliku)
Pobiera spakowany skojarzony plik z określonym fileName
.
Parametry
Nazwa pliku | nazwa powiązanego pliku |
---|
Zwroty
- surowy strumień wejściowy zawierający określony plik
Rzuca
Wyjątek IllegalStateException | jeśli model nie jest plikiem ZIP |
---|---|
Wyjątek IllegalArgument | jeśli określony plik nie istnieje w modelu |
public Set <String> getAssociatedFileNames ()
Pobiera nazwy plików skojarzonych plików.
Zwroty
- nazwy plików powiązanych plików
Rzuca
Wyjątek IllegalStateException | jeśli model nie jest plikiem ZIP |
---|
publiczny int getInputTensorCount ()
Pobiera liczbę tensorów wejściowych w modelu.
publiczny TensorMetadata getInputTensorMetadata (int inputIndex)
Pobiera metadane dla tensora wejściowego określonego przez inputIndex
.
Parametry
Indeks wejściowy | indeks żądanego tensora wejściowego |
---|
Rzuca
Wyjątek IllegalStateException | jeśli ten model nie zawiera metadanych modelu |
---|
public MetadataExtractor.QuantizationParams getInputTensorQuantizationParams (int inputIndex)
Pobiera parametry kwantyzacji dla tensora wejściowego określonego przez inputIndex
.
Parametry
Indeks wejściowy | indeks żądanego tensora wejściowego |
---|
public int[] getInputTensorShape (int inputIndex)
Pobiera kształt tensora wejściowego za pomocą inputIndex
.
Parametry
Indeks wejściowy | indeks żądanego tensora wejściowego |
---|
bajt publiczny getInputTensorType (int inputIndex)
Pobiera ERROR(/TensorType)
tensora wejściowego z inputIndex
.
Parametry
Indeks wejściowy | indeks żądanego tensora wejściowego |
---|
publiczny ModelMetadata getModelMetadata ()
Pobiera procedurę obsługi głównej dla metadanych modelu.
Rzuca
Wyjątek IllegalStateException | jeśli ten model nie zawiera metadanych modelu |
---|
publiczny int getOutputTensorCount ()
Pobiera liczbę tensorów wyjściowych w modelu.
publiczny TensorMetadata getOutputTensorMetadata (int OutputIndex)
Pobiera metadane dla tensora wyjściowego określonego przez outputIndex
.
Parametry
indeks wyjściowy | indeks żądanego tensora wyjściowego |
---|
Rzuca
Wyjątek IllegalStateException | jeśli ten model nie zawiera metadanych modelu |
---|
public MetadataExtractor.QuantizationParams getOutputTensorQuantizationParams (int OutputIndex)
Pobiera parametry kwantyzacji dla tensora wyjściowego określonego przez outputIndex
.
Parametry
indeks wyjściowy | indeks żądanego tensora wyjściowego |
---|
public int[] getOutputTensorShape (int wynikIndex)
Pobiera kształt tensora wyjściowego z outputIndex
.
Parametry
indeks wyjściowy | indeks żądanego tensora wyjściowego |
---|
bajt publiczny getOutputTensorType (int OutputIndex)
Pobiera ERROR(/TensorType)
tensora wyjściowego z outputIndex
.
Parametry
indeks wyjściowy | indeks żądanego tensora wyjściowego |
---|
publiczna wartość logiczna hasMetadata ()
Zwraca wartość true
, jeśli model zawiera metadane. W przeciwnym razie zwraca false
.
publiczna końcowa wartość logiczna isMinimumParserVersionSatisfied ()
Zwraca true
, jeśli minimalna wersja analizatora składni wymagana przez dany bufor płaski metadanych poprzedza wersję analizatora metadanych, na którym opiera się ta biblioteka MetadataExtractor, lub jest jej równa. W tym przypadku wszystkie pola metadanych można poprawnie przeanalizować za pomocą tej biblioteki ekstraktora metadanych. W przeciwnym razie zwraca false
.
Załóżmy na przykład, że podstawowa wersja analizatora metadanych to 1.14.1
,
- zwraca
true
, jeśli wymagana minimalna wersja parsera jest taka sama lub starsza, np.1.14.1
lub1.14.0
. Wersja null poprzedza wszystkie wersje numeryczne, ponieważ niektóre płaskie bufory metadanych są generowane przed pierwszą wersją wersjonowaną; - zwraca
false
, jeśli wymagana minimalna wersja parsera jest nowsza, np.1.14.2
.