MetadataExtractor

Ekstraktor metadanych klasy publicznej

Ł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

MetadataExtractor (bufor ByteBuffer )
Tworzy MetadataExtractor z modelem TFLite FlatBuffer.

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 lub 1.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 .