TF Hub のモデル形式
TF Hub は TensorFlow プログラムで再読み込み、構築、再トレーニングできる再利用可能なモデル片を提供します。これらのモデル片には 2 種類の形式があります。
- 独自の TF1 Hub 形式。主に TF1(または TF2 の TF1 互換モード)で hub.Module API を介して使用されることを想定したものです。互換性に関する完全な情報は、以下をご覧ください。
- ネイティブな TF2 SavedModel 形式。主に TF2 で hub.load および hub.KerasLayer API を介して使用されることを想定したものです。互換性に関する完全な情報は、以下をご覧ください。
モデル形式は、tfhub.dev のモデルページで確認できます。モデルの読み込み/推論、ファインチューニング、作成は、モデル形式に基づく TF1/2 ではサポートされていない場合があります。
TF1 Hub 形式の互換性
演算 | TF1/ TF2 の TF1 互換モード [1] | TF2 |
読み込み / 推論 | 完全サポート(包括的な TF1 Hub 形式の読み込みガイド) m = hub.Module(handle) outputs = m(inputs)
|
hub.load m = hub.load(handle) outputs = m.signatures["sig"](inputs) または hub.KerasLayer m = hub.KerasLayer(handle, signature="sig") outputs = m(inputs) のいずれかを使用することをお勧めします。 |
ファインチューニング | 完全サポート(包括的な TF1 Hub 形式のファインチューニングガイド) m = hub.Module(handle, trainable=True, tags=["train"]*is_training) outputs = m(inputs) 注意: 個別の train グラフを必要としないモジュールには train タグがありません。
|
サポートされていません |
作成 | 完全サポート(包括的な TF1 Hub 形式の作成ガイドをご覧ください) 注意: TF1 Hub 形式は TF1 向けであり、TF2 では部分的にのみサポートされています。TF2 SavedModel の作成を検討してください。
|
サポートされていません |
TF2 SavedModel の互換性
TF1.15 以前はサポートされていません。
演算 | TF1.15/ TF2 の TF1 互換モード [1] | TF2 |
読み込み / 推論 | hub.load m = hub.load(handle)
outputs = m(inputs) または hub.KerasLayer m = hub.KerasLayer(handle)
outputs = m(inputs) のいずれかを使用することをお勧めします。 |
完全サポート(包括的な TF2 SavedModel の読み込みガイド)。hub.load m = hub.load(handle)
outputs = m(inputs) または hub.KerasLayer m = hub.KerasLayer(handle)
outputs = m(inputs) のいずれかを使用してください。 |
ファインチューニング | Model.fit() でトレーニングされる場合、または カスタム model_fn ガイド に従って Model をラップする model_fn を持つ Estimator でトレーニングされる場合にtf.keras.Model で使用される hub.KerasLayer でサポートされます。 注意: hub.KerasLayer は古い tf.compat.v1.layers または hub.Module API のようにグラフコレクションを埋めません。
|
完全サポート(包括的な TF2 SavedModel の微調整ガイド)。hub.load: m = hub.load(handle)
outputs = m(inputs, training=is_training) または hub.KerasLayer: m = hub.KerasLayer(handle, trainable=True)
outputs = m(inputs) のいずれかを使用してください。 |
作成 | TF2 API tf.saved_model.save() は互換モード内から呼び出すことができます。 | 完全サポート(包括的な TF2 SavedModel の作成ガイド をご覧ください) |
[1] "TF2 の TF1 互換モード" とは、TensorFlow 移行ガイドに記載されているように TF2 を import tensorflow.compat.v1 as tf
でインポートして tf.disable_v2_behavior()
を実行する場合の複合効果を指します。