MetadataExtractor

genel sınıf MetadataExtractor

TFLite Model FlatBuffer'dan meta verileri yükler.

TFLite Model FlatBuffer, TFLite Model şema dosyası kullanılarak oluşturulabilir.

Bazı modeller, modelin ne yaptığı ve modelin nasıl yorumlanacağı hakkında daha fazla bilgi kaydeden bir TFLite Meta Veri Düz Arabelleği içerir. TFLite Meta Veri Düz Arabelleği, TFLite Meta Veri şema dosyası kullanılarak oluşturulabilir.

TFLite meta verileri olmayan bir FlatBuffer modelinin aktarılmasına izin verilir. Ancak TFLite meta verilerinden okunan yöntemlerin çağrılması çalışma zamanı hatalarına neden olur.

Benzer şekilde, FlatBuffer modelinin ilişkili dosyalar olmadan aktarılmasına izin verilir. Ancak ilişkili dosyaları okuyan yöntemlerin çağrılması çalışma zamanı hatalarına neden olur.

TFLite modeli FlatBuffer birden fazla alt grafiği desteklese de, TFLite Interpreter şu ana kadar yalnızca tek bir alt grafiği desteklemektedir. Daha fazla bilgi için dönüştürme sırasında alt grafiğin nasıl belirleneceğine ilişkin talimata bakın. Bu nedenle MetadataExtractor yöntemlerinde girdi olarak alt grafik dizinini atlar.

İç İçe Sınıflar

sınıf MetadataExtractor.QuantizationParams TFLite Model şema dosyasındaki QuantizationParameters tablosuna karşılık gelen niceleme parametreleri.

Kamu İnşaatçıları

MetadataExtractor ( ByteBuffer tamponu)
TFLite modeli FlatBuffer ile bir MetadataExtractor oluşturur.

Genel Yöntemler

Giriş Akışı
getAssociatedFile ( Dize dosyaAdı)
Belirtilen fileName ile paketlenmiş ilişkili dosyayı alır.
< Dize > Ayarla
getAssociatedFileNames ()
İlişkili dosyaların dosya adlarını alır.
int
getInputTensorCount ()
Modeldeki giriş tensörlerinin sayısını alır.
TensorMeta Verileri
getInputTensorMetadata (int inputIndex)
inputIndex tarafından belirtilen giriş tensörünün meta verilerini alır.
MetadataExtractor.QuantizationParams
getInputTensorQuantizationParams (int inputIndex)
inputIndex tarafından belirtilen giriş tensörü için niceleme parametrelerini alır.
int[]
getInputTensorShape (int inputIndex)
inputIndex ile giriş tensörünün şeklini alır.
bayt
getInputTensorType (int inputIndex)
inputIndex ile giriş tensörünün ERROR(/TensorType) değerini alır.
ModelMeta Verileri
getModelMetadata ()
Model meta verilerinin kök işleyicisini alır.
int
getOutputTensorCount ()
Modeldeki çıkış tensörlerinin sayısını alır.
TensorMeta Verileri
getOutputTensorMetadata (int çıktıIndex)
outputIndex tarafından belirtilen çıkış tensörünün meta verilerini alır.
MetadataExtractor.QuantizationParams
getOutputTensorQuantizationParams (int çıktıIndex)
outputIndex tarafından belirtilen çıkış tensörü için niceleme parametrelerini alır.
int[]
getOutputTensorShape (int çıktıIndex)
outputIndex ile çıkış tensörünün şeklini alır.
bayt
getOutputTensorType (int çıktıIndex)
outputIndex ile çıkış tensörünün ERROR(/TensorType) değerini alır.
boolean
metaverileri var ()
Modelin meta verileri varsa true değerini döndürür.
son boole değeri
isMinimumParserVersionSatisfied ()
Belirtilen meta veri düz ara belleğinin gerektirdiği minimum ayrıştırıcı sürümü, bu MetadataExtractor kitaplığının güvendiği meta veri ayrıştırıcı sürümünden önce geliyorsa veya bu sürüme eşitse true değerini döndürür.

Kalıtsal Yöntemler

Kamu İnşaatçıları

genel MetadataExtractor ( ByteBuffer arabelleği)

TFLite modeli FlatBuffer ile bir MetadataExtractor oluşturur.

Parametreler
tampon TFLite modeli FlatBuffer
Atar
YasadışıTartışmaİstisna modeldeki giriş veya çıkış tensörlerinin sayısı meta verilerdekiyle eşleşmiyorsa
IOİstisnası modeli Zip dosyası olarak okurken bir hata oluşursa

Genel Yöntemler

public inputStream getAssociatedFile ( String dosyaAdı)

Belirtilen fileName ile paketlenmiş ilişkili dosyayı alır.

Parametreler
dosya adı ilişkili dosyanın adı
İadeler
  • belirtilen dosyayı içeren ham giriş akışı
Atar
Yasadışı Durum İstisnası model bir zip dosyası değilse
YasadışıTartışmaİstisna belirtilen dosya modelde mevcut değilse

public Set < String > getAssociatedFileNames ()

İlişkili dosyaların dosya adlarını alır.

İadeler
  • ilişkili dosyaların dosya adları
Atar
Yasadışı Durum İstisnası model bir zip dosyası değilse

public int getInputTensorCount ()

Modeldeki giriş tensörlerinin sayısını alır.

genel TensorMetadata getInputTensorMetadata (int inputIndex)

inputIndex tarafından belirtilen giriş tensörünün meta verilerini alır.

Parametreler
girişIndex istenilen giriş tensörünün indeksi
Atar
Yasadışı Durum İstisnası bu model model meta verilerini içermiyorsa

genel MetadataExtractor.QuantizationParams getInputTensorQuantizationParams (int inputIndex)

inputIndex tarafından belirtilen giriş tensörü için niceleme parametrelerini alır.

Parametreler
girişIndex istenilen giriş tensörünün indeksi

public int[] getInputTensorShape (int inputIndex)

inputIndex ile giriş tensörünün şeklini alır.

Parametreler
girişIndex istenilen giriş tensörünün indeksi

genel bayt getInputTensorType (int inputIndex)

inputIndex ile giriş tensörünün ERROR(/TensorType) değerini alır.

Parametreler
girişIndex istenilen giriş tensörünün indeksi

genel ModelMetadata getModelMetadata ()

Model meta verilerinin kök işleyicisini alır.

Atar
Yasadışı Durum İstisnası bu model model meta verilerini içermiyorsa

public int getOutputTensorCount ()

Modeldeki çıkış tensörlerinin sayısını alır.

genel TensorMetadata getOutputTensorMetadata (int çıktıIndex)

outputIndex tarafından belirtilen çıkış tensörünün meta verilerini alır.

Parametreler
çıktıIndex istenilen çıkış tensörünün indeksi
Atar
Yasadışı Durum İstisnası bu model model meta verilerini içermiyorsa

genel MetadataExtractor.QuantizationParams getOutputTensorQuantizationParams (int çıktıIndex)

outputIndex tarafından belirtilen çıkış tensörü için niceleme parametrelerini alır.

Parametreler
çıktıIndex istenilen çıkış tensörünün indeksi

public int[] getOutputTensorShape (int çıktıIndex)

outputIndex ile çıkış tensörünün şeklini alır.

Parametreler
çıktıIndex istenilen çıkış tensörünün indeksi

genel bayt getOutputTensorType (int çıktıIndex)

outputIndex ile çıkış tensörünün ERROR(/TensorType) değerini alır.

Parametreler
çıktıIndex istenilen çıkış tensörünün indeksi

genel boolean hasMetadata ()

Modelin meta verileri varsa true değerini döndürür. Aksi halde false değerini döndürür.

genel final boolean isMinimumParserVersionSatisfied ()

Belirtilen meta veri düz ara belleğinin gerektirdiği minimum ayrıştırıcı sürümü, bu MetadataExtractor kitaplığının güvendiği meta veri ayrıştırıcı sürümünden önce geliyorsa veya bu sürüme eşitse true değerini döndürür. Bu durumda, meta verilerdeki tüm alanlar bu meta veri çıkarıcı kitaplığıyla doğru şekilde ayrıştırılabilir. Aksi takdirde false değerini döndürür.

Örneğin, temeldeki meta veri ayrıştırıcı sürümünün 1.14.1 olduğunu varsayalım,

  • gerekli minimum ayrıştırıcı sürümü 1.14.1 veya 1.14.0 gibi aynı veya daha eskiyse true döndürür. Bazı meta veri düz arabellekleri ilk sürümlü sürümden önce oluşturulduğundan boş sürüm tüm sayısal sürümlerden önce gelir;
  • gerekli minimum ayrıştırıcı sürümü 1.14.2 gibi daha yeniyse false değerini döndürür.