![]() |
![]() |
![]() |
![]() |
本ドキュメントは、低レベル TensorFlow API のユーザーを対象としています。高レベル API(tf.keras
)をご使用の場合は、コードをTensorFlow 2.0 と完全互換にするためのアクションは殆どまたは全く必要ありません。
- オプティマイザのデフォルトの学習率を確認してください。
- メトリクスが記録される「名前」が変更されている可能性があることに注意してください。
TensorFlow 2.0 で 1.X のコードを未修正で実行することは、(contrib を除き)依然として可能です。
import tensorflow.compat.v1 as tf tf.disable_v2_behavior()
しかし、これでは TensorFlow 2.0 で追加された改善の多くを活用できません。このガイドでは、コードのアップグレード、さらなる単純化、パフォーマンス向上、そしてより容易なメンテナンスについて説明します。
自動変換スクリプト
このドキュメントで説明される変更を実装する前に行うべき最初のステップは、アップグレードスクリプトを実行してみることです。
これはコードを TensorFlow 2.0 にアップグレードする際の初期パスとしては十分ですが、2.0 特有のコードに変換するわけではありません。コードは依然としてtf.compat.v1
エンドポイントを使用して、プレースホルダー、セッション、コレクション、その他 1.x- スタイルの機能へのアクセスが可能です。
トップレベルの動作の変更
tf.compat.v1.disable_v2_behavior()
を使用することで TensorFlow 2.0 でコードが機能する場合でも、対処すべきグローバルな動作の変更があります。主な変更点は次のとおりです。
Eager execution、
v1.enable_eager_execution()
: 暗黙的にtf.Graph
を使用するコードは失敗します。このコードは必ずwith tf.Graph().as_default()
コンテキストでラップしてください。リソース変数、
v1.enable_resource_variables()
: 一部のコードは、TensorFlow 参照変数によって有効化される非決定的な動作に依存する場合があります。 リソース変数は書き込み中にロックされるため、より直感的な一貫性を保証します。- これによりエッジケースでの動作が変わる場合があります。
- これにより余分なコピーが作成されるため、メモリ使用量が増える可能性があります。
- これを無効にするには、
use_resource=False
をtf.Variable
コンストラクタに渡します。
テンソルの形状、
v1.enable_v2_tensorshape()
: TensorFlow 2.0 は、テンソルの形状の動作を簡略化されており、t.shape[0].value
の代わりにt.shape[0]
とすることができます。簡単な変更なので、すぐに修正しておくことをお勧めします。例については TensorShape をご覧ください。制御フロー、
v1.enable_control_flow_v2()
: TensorFlow 2.0 制御フローの実装が簡略化されたため、さまざまなグラフ表現を生成します。問題が生じた場合には、バグを報告してください。
コードを 2.0 ネイティブにする
このガイドでは、TensorFlow 1.x のコードを TensorFlow 2.0 に変換する幾つかの例をウォークスルーします。これらの変更によって、コードがパフォーマンスの最適化および簡略化された API 呼び出しを活用できるようになります。
それぞれのケースのパターンは次のとおりです。
1. v1.Session.run
呼び出しを置き換える
すべてのv1.Session.run
呼び出しは、Python 関数で置き換える必要があります。
feed_dict
およびv1.placeholder
は関数の引数になります。fetches
は関数の戻り値になります。- eager execution では、
pdb
などの標準的な Python ツールを使用して、変換中に簡単にデバッグできます。
次に、tf.function
デコレータを追加して、グラフで効率的に実行できるようにします。 この機能についての詳細は、AutoGraph ガイドをご覧ください。
注意点:
v1.Session.run
とは異なり、tf.function
は固定のリターンシグネチャを持ち、常にすべての出力を返します。これによってパフォーマンスの問題が生じる場合は、2 つの個別の関数を作成します。tf.control_dependencies
または同様の演算は必要ありません。tf.function
は、記述された順序で実行されたかのように動作します。例えば、tf.Variable
割り当てとtf.assert
は自動的に実行されます。
変換モデルセクション{/ a0}には、この変換プロセスの実際の例が含まれています。
2. Python オブジェクトを変数と損失の追跡に使用する
TensorFlow 2.0 では、いかなる名前ベースの変数追跡も全く推奨されていません。 変数の追跡には Python オブジェクトを使用します。
v1.get_variable
の代わりにtf.Variable
を使用してください。
すべてのv1.variable_scope
は Python オブジェクトに変換が可能です。通常は次のうちの 1 つになります。
tf.Graph.get_collection(tf.GraphKeys.VARIABLES)
などの変数のリストを集める必要がある場合には、Layer
およびModel
オブジェクトの.variables
と.trainable_variables
属性を使用します。
これらLayer
クラスとModel
クラスは、グローバルコレクションの必要性を除去した別のプロパティを幾つか実装します。.losses
プロパティは、tf.GraphKeys.LOSSES
コレクション使用の置き換えとなります。
詳細は Keras ガイドをご覧ください。
警告 : 多くのtf.compat.v1
シンボルはグローバルコレクションを暗黙的に使用しています。
3. トレーニングループをアップグレードする
ご利用のユースケースで動作する最高レベルの API を使用してください。独自のトレーニングループを構築するよりも tf.keras.Model.fit
の選択を推奨します。
これらの高レベル関数は、独自のトレーニングループを書く場合に見落とされやすい多くの低レベル詳細を管理します。例えば、それらは自動的に正則化損失を集めて、モデルを呼び出す時にtraining=True
引数を設定します。
4. データ入力パイプラインをアップグレードする
データ入力にはtf.data
データセットを使用してください。それらのオブジェクトは効率的で、表現力があり、TensorFlow とうまく統合します。
次のように、tf.keras.Model.fit
メソッドに直接渡すことができます。
model.fit(dataset, epochs=5)
また、標準的な Python で直接にイテレートすることもできます。
for example_batch, label_batch in dataset: break
5. compat.v1
シンボルを移行する
tf.compat.v1
モジュールには、元のセマンティクスを持つ完全な TensorFlow 1.x API が含まれています。
TensorFlow 2 アップグレードスクリプトは、変換が安全な場合、つまり 2.0 バージョンの動作が完全に同等であると判断できる場合は、シンボルを 2.0 と同等のものに変換します。(例えば、これらは同じ関数なので、v1.arg_max
の名前をtf.argmax
に変更します。)
コードの一部を使用してアップグレードスクリプトを実行した後に、compat.v1
が頻出する可能性があります。 コードを調べ、それらを手動で同等の 2.0 のコードに変換する価値はあります。(該当するものがある場合には、ログに表示されているはずです。)
モデルを変換する
低レベル変数 & 演算子実行
低レベル API の使用例を以下に示します。
変数スコープを使用して再利用を制御する。
v1.get_variable
で変数を作成する。コレクションに明示的にアクセスする。
次のようなメソッドでコレクションに暗黙的にアクセスする。
v1.placeholder
を使用してグラフ入力のセットアップをする。Session.run
でグラフを実行する。変数を手動で初期化する。
変換前
TensorFlow 1.x を使用したコードでは、これらのパターンは以下のように表示されます。
import tensorflow as tf
import tensorflow.compat.v1 as v1
import tensorflow_datasets as tfds
g = v1.Graph()
with g.as_default():
in_a = v1.placeholder(dtype=v1.float32, shape=(2))
in_b = v1.placeholder(dtype=v1.float32, shape=(2))
def forward(x):
with v1.variable_scope("matmul", reuse=v1.AUTO_REUSE):
W = v1.get_variable("W", initializer=v1.ones(shape=(2,2)),
regularizer=lambda x:tf.reduce_mean(x**2))
b = v1.get_variable("b", initializer=v1.zeros(shape=(2)))
return W * x + b
out_a = forward(in_a)
out_b = forward(in_b)
reg_loss=v1.losses.get_regularization_loss(scope="matmul")
with v1.Session(graph=g) as sess:
sess.run(v1.global_variables_initializer())
outs = sess.run([out_a, out_b, reg_loss],
feed_dict={in_a: [1, 0], in_b: [0, 1]})
print(outs[0])
print()
print(outs[1])
print()
print(outs[2])
[[1. 0.] [1. 0.]] [[0. 1.] [0. 1.]] 1.0
変換後
変換されたコードでは :
- 変数はローカル Python オブジェクトです。
forward
関数は依然として計算を定義します。Session.run
呼び出しはforward
への呼び出しに置き換えられます。- パフォーマンス向上のためにオプションで
tf.function
デコレータを追加可能です。 - どのグローバルコレクションも参照せず、正則化は手動で計算されます。
- セッションやプレースホルダーはありません。
W = tf.Variable(tf.ones(shape=(2,2)), name="W")
b = tf.Variable(tf.zeros(shape=(2)), name="b")
@tf.function
def forward(x):
return W * x + b
out_a = forward([1,0])
print(out_a)
tf.Tensor( [[1. 0.] [1. 0.]], shape=(2, 2), dtype=float32)
out_b = forward([0,1])
regularizer = tf.keras.regularizers.l2(0.04)
reg_loss=regularizer(W)
tf.layers
ベースのモデル
v1.layers
モジュールは、変数を定義および再利用するv1.variable_scope
に依存するレイヤー関数を含めるために使用されます。
変換前
def model(x, training, scope='model'):
with v1.variable_scope(scope, reuse=v1.AUTO_REUSE):
x = v1.layers.conv2d(x, 32, 3, activation=v1.nn.relu,
kernel_regularizer=lambda x:0.004*tf.reduce_mean(x**2))
x = v1.layers.max_pooling2d(x, (2, 2), 1)
x = v1.layers.flatten(x)
x = v1.layers.dropout(x, 0.1, training=training)
x = v1.layers.dense(x, 64, activation=v1.nn.relu)
x = v1.layers.batch_normalization(x, training=training)
x = v1.layers.dense(x, 10)
return x
train_data = tf.ones(shape=(1, 28, 28, 1))
test_data = tf.ones(shape=(1, 28, 28, 1))
train_out = model(train_data, training=True)
test_out = model(test_data, training=False)
print(train_out)
print()
print(test_out)
/tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/keras/legacy_tf_layers/convolutional.py:414: UserWarning: `tf.layers.conv2d` is deprecated and will be removed in a future version. Please Use `tf.keras.layers.Conv2D` instead. warnings.warn('`tf.layers.conv2d` is deprecated and ' /tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/keras/engine/base_layer.py:2273: UserWarning: `layer.apply` is deprecated and will be removed in a future version. Please use `layer.__call__` method instead. warnings.warn('`layer.apply` is deprecated and ' tf.Tensor([[0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]], shape=(1, 10), dtype=float32) tf.Tensor( [[-0.07359518 0.03352671 0.26862574 0.16726746 0.08024732 0.04751158 0.21092054 0.5586974 0.26848322 -0.05836517]], shape=(1, 10), dtype=float32) /tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/keras/legacy_tf_layers/pooling.py:310: UserWarning: `tf.layers.max_pooling2d` is deprecated and will be removed in a future version. Please use `tf.keras.layers.MaxPooling2D` instead. warnings.warn('`tf.layers.max_pooling2d` is deprecated and ' /tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/keras/legacy_tf_layers/core.py:329: UserWarning: `tf.layers.flatten` is deprecated and will be removed in a future version. Please use `tf.keras.layers.Flatten` instead. warnings.warn('`tf.layers.flatten` is deprecated and ' /tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/keras/legacy_tf_layers/core.py:268: UserWarning: `tf.layers.dropout` is deprecated and will be removed in a future version. Please use `tf.keras.layers.Dropout` instead. warnings.warn('`tf.layers.dropout` is deprecated and ' /tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/keras/legacy_tf_layers/core.py:171: UserWarning: `tf.layers.dense` is deprecated and will be removed in a future version. Please use `tf.keras.layers.Dense` instead. warnings.warn('`tf.layers.dense` is deprecated and ' /tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/keras/legacy_tf_layers/normalization.py:308: UserWarning: `tf.layers.batch_normalization` is deprecated and will be removed in a future version. Please use `tf.keras.layers.BatchNormalization` instead. In particular, `tf.control_dependencies(tf.GraphKeys.UPDATE_OPS)` should not be used (consult the `tf.keras.layers.BatchNormalization` documentation). '`tf.layers.batch_normalization` is deprecated and '
変換後
- レイヤーの単純なスタックが
tf.keras.Sequential
にぴったり収まります。(より複雑なモデルについてはカスタムレイヤーとモデルおよび Functional API をご覧ください。) - モデルが変数と正則化損失を追跡します。
v1.layers
からtf.keras.layers
への直接的なマッピングがあるため、変換は一対一対応でした。
ほとんどの引数はそのままです。しかし、以下の点は異なります。
training
引数は、それが実行される時点でモデルによって各レイヤーに渡されます。- 元の
model
関数への最初の引数(入力x
)はなくなりました。これはオブジェクトレイヤーがモデルの呼び出しからモデルの構築を分離するためです。
また以下にも注意してください。
tf.contrib
からの初期化子の正則化子を使用している場合は、他よりも多くの引数変更があります。- コードはコレクションに書き込みを行わないため、
v1.losses.get_regularization_loss
などの関数はそれらの値を返さなくなり、トレーニングループが壊れる可能性があります。
model = tf.keras.Sequential([
tf.keras.layers.Conv2D(32, 3, activation='relu',
kernel_regularizer=tf.keras.regularizers.l2(0.04),
input_shape=(28, 28, 1)),
tf.keras.layers.MaxPooling2D(),
tf.keras.layers.Flatten(),
tf.keras.layers.Dropout(0.1),
tf.keras.layers.Dense(64, activation='relu'),
tf.keras.layers.BatchNormalization(),
tf.keras.layers.Dense(10)
])
train_data = tf.ones(shape=(1, 28, 28, 1))
test_data = tf.ones(shape=(1, 28, 28, 1))
train_out = model(train_data, training=True)
print(train_out)
tf.Tensor([[0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]], shape=(1, 10), dtype=float32)
test_out = model(test_data, training=False)
print(test_out)
tf.Tensor( [[-0.43775052 0.32085395 -0.00979301 -0.01953483 0.01984888 -0.02302531 0.02780205 0.09543642 -0.05383288 0.18692899]], shape=(1, 10), dtype=float32)
# Here are all the trainable variables.
len(model.trainable_variables)
8
# Here is the regularization loss.
model.losses
[<tf.Tensor: shape=(), dtype=float32, numpy=0.07525636>]
変数とv1.layers
の混在
既存のコードは低レベルの TensorFlow 1.x 変数と演算子に高レベルのv1.layers
が混ざっていることがよくあります。
変換前
def model(x, training, scope='model'):
with v1.variable_scope(scope, reuse=v1.AUTO_REUSE):
W = v1.get_variable(
"W", dtype=v1.float32,
initializer=v1.ones(shape=x.shape),
regularizer=lambda x:0.004*tf.reduce_mean(x**2),
trainable=True)
if training:
x = x + W
else:
x = x + W * 0.5
x = v1.layers.conv2d(x, 32, 3, activation=tf.nn.relu)
x = v1.layers.max_pooling2d(x, (2, 2), 1)
x = v1.layers.flatten(x)
return x
train_out = model(train_data, training=True)
test_out = model(test_data, training=False)
変換後
このコードを変換するには、前の例で示したレイヤーからレイヤーへのマッピングのパターンに従います。
一般的なパターンは次の通りです。
__init__
でレイヤーパラメータを収集する。build
で変数を構築する。call
で計算を実行し、結果を返す。
v1.variable_scope
は事実上それ自身のレイヤーです。従ってtf.keras.layers.Layer
として書き直します。詳細はガイドをご覧ください。
# Create a custom layer for part of the model
class CustomLayer(tf.keras.layers.Layer):
def __init__(self, *args, **kwargs):
super(CustomLayer, self).__init__(*args, **kwargs)
def build(self, input_shape):
self.w = self.add_weight(
shape=input_shape[1:],
dtype=tf.float32,
initializer=tf.keras.initializers.ones(),
regularizer=tf.keras.regularizers.l2(0.02),
trainable=True)
# Call method will sometimes get used in graph mode,
# training will get turned into a tensor
@tf.function
def call(self, inputs, training=None):
if training:
return inputs + self.w
else:
return inputs + self.w * 0.5
custom_layer = CustomLayer()
print(custom_layer([1]).numpy())
print(custom_layer([1], training=True).numpy())
[1.5] [2.]
train_data = tf.ones(shape=(1, 28, 28, 1))
test_data = tf.ones(shape=(1, 28, 28, 1))
# Build the model including the custom layer
model = tf.keras.Sequential([
CustomLayer(input_shape=(28, 28, 1)),
tf.keras.layers.Conv2D(32, 3, activation='relu'),
tf.keras.layers.MaxPooling2D(),
tf.keras.layers.Flatten(),
])
train_out = model(train_data, training=True)
test_out = model(test_data, training=False)
注意点:
サブクラス化された Keras モデルとレイヤーは v1 グラフ(自動制御依存性なし)と eager モードの両方で実行される必要があります。
call()
をtf.function()
にラップして、AutoGraph と自動制御依存性を得るようにします。
training
引数を受け取ってcall
することを忘れないようにしてください。- それは
tf.Tensor
である場合があります。 - それは Python ブール型である場合があります。
- それは
self.add_weight()
を使用して、コンストラクタまたはModel.build
でモデル変数を作成します。Model.build
では、入力形状にアクセスできるため、適合する形状で重みを作成できます。tf.keras.layers.Layer.add_weight
を使用すると、Keras が変数と正則化損失を追跡できるようになります。
オブジェクトに
tf.Tensors
を保持してはいけません。- それらは
tf.function
または eager コンテキスト内のいずれかで作成される可能性がありますが、それらのテンソルは異なる振る舞いをします。 - 状態には
tf.Variable
を使用してください。これは常に両方のコンテキストから使用可能です。 tf.Tensors
は中間値専用です。
- それらは
Slim & contrib.layers に関する注意
古い TensorFlow 1.x コードの大部分は Slim ライブラリを使用しており、これはtf.contrib.layers
として TensorFlow 1.x でパッケージ化されていました。 contrib
モジュールに関しては、TensorFlow 2.0 ではtf.compat.v1
内でも、あっても利用できなくなりました。Slim を使用したコードの TensorFlow 2.0 への変換は、v1.layers
を使用したレポジトリの変換よりも複雑です。現実的には、まず最初に Slim コードをv1.layers
に変換してから Keras に変換するほうが賢明かもしれません。
arg_scopes
を除去します。すべての引数は明示的である必要があります。- それらを使用する場合、
normalizer_fn
とactivation_fn
をそれら自身のレイヤーに分割します。 - 分離可能な畳み込みレイヤーは 1 つまたはそれ以上の異なる Keras レイヤー(深さ的な、ポイント的な、分離可能な Keras レイヤー)にマップします。
- Slim と
v1.layers
には異なる引数名とデフォルト値があります。 - 一部の引数には異なるスケールがあります。
- Slim 事前トレーニング済みモデルを使用する場合は、
tf.keras.applications
から Keras 事前トレーニング済みモデル、または元の Slim コードからエクスポートされた TensorFlow ハブの TensorFlow 2 SavedModel をお試しください。
一部のtf.contrib
レイヤーはコアの TensorFlow に移動されていない可能性がありますが、代わりに TensorFlow アドオンパッケージに移動されています。
トレーニング
tf.keras
モデルにデータを供給する方法は沢山あります。それらは Python ジェネレータと Numpy 配列を入力として受け取ります。
モデルへのデータ供給方法として推奨するのは、データ操作用の高パフォーマンスクラスのコレクションを含むtf.data
パッケージの使用です。
依然としてtf.queue
を使用している場合、これらは入力パイプラインとしてではなく、データ構造としてのみサポートされます。
データセットを使用する
TensorFlow Dataset パッケージ(tfds
)には、事前定義されたデータセットをtf.data.Dataset
オブジェクトとして読み込むためのユーティリティが含まれています。
この例として、tfds
を使用して MNISTdataset を読み込んでみましょう。
datasets, info = tfds.load(name='mnist', with_info=True, as_supervised=True)
mnist_train, mnist_test = datasets['train'], datasets['test']
次に、トレーニング用のデータを準備します。
- 各画像をリスケールする。
- 例の順序をシャッフルする。
- 画像とラベルのバッチを集める。
BUFFER_SIZE = 10 # Use a much larger value for real code.
BATCH_SIZE = 64
NUM_EPOCHS = 5
def scale(image, label):
image = tf.cast(image, tf.float32)
image /= 255
return image, label
例を短く保つために、データセットをトリミングして 5 バッチのみを返すようにします。
train_data = mnist_train.map(scale).shuffle(BUFFER_SIZE).batch(BATCH_SIZE)
test_data = mnist_test.map(scale).batch(BATCH_SIZE)
STEPS_PER_EPOCH = 5
train_data = train_data.take(STEPS_PER_EPOCH)
test_data = test_data.take(STEPS_PER_EPOCH)
image_batch, label_batch = next(iter(train_data))
Keras トレーニングループを使用する
トレーニングプロセスの低レベル制御が不要な場合は、Keras 組み込みのfit
、evaluate
、predict
メソッドの使用が推奨されます。これらのメソッドは(シーケンシャル、関数型、またはサブクラス化)実装を問わず、モデルをトレーニングするための統一インターフェースを提供します。
これらのメソッドには次のような優位点があります。
- Numpy 配列、Python ジェネレータ、
tf.data.Datasets
を受け取ります。 - 正則化と活性化損失を自動的に適用します。
- マルチデバイストレーニングのために
tf.distribute
をサポートします。 - 任意の callable は損失とメトリクスとしてサポートします。
tf.keras.callbacks.TensorBoard
のようなコールバックとカスタムコールバックをサポートします。- 自動的に TensorFlow グラフを使用し、高性能です。
ここにDataset
を使用したモデルのトレーニング例を示します。(この機能ついての詳細はチュートリアルをご覧ください。)
model = tf.keras.Sequential([
tf.keras.layers.Conv2D(32, 3, activation='relu',
kernel_regularizer=tf.keras.regularizers.l2(0.02),
input_shape=(28, 28, 1)),
tf.keras.layers.MaxPooling2D(),
tf.keras.layers.Flatten(),
tf.keras.layers.Dropout(0.1),
tf.keras.layers.Dense(64, activation='relu'),
tf.keras.layers.BatchNormalization(),
tf.keras.layers.Dense(10)
])
# Model is the full model w/o custom layers
model.compile(optimizer='adam',
loss=tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True),
metrics=['accuracy'])
model.fit(train_data, epochs=NUM_EPOCHS)
loss, acc = model.evaluate(test_data)
print("Loss {}, Accuracy {}".format(loss, acc))
Epoch 1/5 5/5 [==============================] - 1s 7ms/step - loss: 2.0653 - accuracy: 0.3559 Epoch 2/5 5/5 [==============================] - 0s 7ms/step - loss: 0.5214 - accuracy: 0.9221 Epoch 3/5 5/5 [==============================] - 2s 7ms/step - loss: 0.3589 - accuracy: 0.9519 Epoch 4/5 5/5 [==============================] - 0s 6ms/step - loss: 0.2749 - accuracy: 0.9695 Epoch 5/5 5/5 [==============================] - 1s 8ms/step - loss: 0.2215 - accuracy: 0.9875 5/5 [==============================] - 1s 4ms/step - loss: 1.4112 - accuracy: 0.6938 Loss 1.4111566543579102, Accuracy 0.6937500238418579
ループを自分で書く
Keras モデルのトレーニングステップは動作していても、そのステップの外でより制御が必要な場合は、データ イテレーション ループでtf.keras.Model.train_on_batch
メソッドの使用を検討してみてください。
tf.keras.callbacks.Callback
として、多くのものが実装可能であることに留意してください。
このメソッドには前のセクションで言及したメソッドの優位点の多くがありますが、外側のループのユーザ制御も与えます。
tf.keras.Model.test_on_batch
またはtf.keras.Model.evaluate
を使用して、トレーニング中のパフォーマンスをチェックすることも可能です。
注意 : train_on_batch
とtest_on_batch
は、デフォルトで単一バッチの損失とメトリクスを返します。reset_metrics=False
を渡すと累積メトリックを返しますが、必ずメトリックアキュムレータを適切にリセットすることを忘れないようにしてくだい。また、AUC
のような一部のメトリクスは正しく計算するためにreset_metrics=False
が必要なことも覚えておいてください。
上のモデルのトレーニングを続けます。
# Model is the full model w/o custom layers
model.compile(optimizer='adam',
loss=tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True),
metrics=['accuracy'])
for epoch in range(NUM_EPOCHS):
#Reset the metric accumulators
model.reset_metrics()
for image_batch, label_batch in train_data:
result = model.train_on_batch(image_batch, label_batch)
metrics_names = model.metrics_names
print("train: ",
"{}: {:.3f}".format(metrics_names[0], result[0]),
"{}: {:.3f}".format(metrics_names[1], result[1]))
for image_batch, label_batch in test_data:
result = model.test_on_batch(image_batch, label_batch,
# return accumulated metrics
reset_metrics=False)
metrics_names = model.metrics_names
print("\neval: ",
"{}: {:.3f}".format(metrics_names[0], result[0]),
"{}: {:.3f}".format(metrics_names[1], result[1]))
train: loss: 0.180 accuracy: 1.000 train: loss: 0.229 accuracy: 0.969 train: loss: 0.211 accuracy: 0.984 train: loss: 0.288 accuracy: 0.953 train: loss: 0.253 accuracy: 0.938 eval: loss: 1.432 accuracy: 0.734 train: loss: 0.130 accuracy: 1.000 train: loss: 0.122 accuracy: 1.000 train: loss: 0.141 accuracy: 0.984 train: loss: 0.165 accuracy: 0.984 train: loss: 0.157 accuracy: 1.000 eval: loss: 1.407 accuracy: 0.775 train: loss: 0.109 accuracy: 1.000 train: loss: 0.111 accuracy: 1.000 train: loss: 0.098 accuracy: 1.000 train: loss: 0.097 accuracy: 1.000 train: loss: 0.105 accuracy: 1.000 eval: loss: 1.376 accuracy: 0.766 train: loss: 0.085 accuracy: 1.000 train: loss: 0.097 accuracy: 1.000 train: loss: 0.074 accuracy: 1.000 train: loss: 0.084 accuracy: 1.000 train: loss: 0.077 accuracy: 1.000 eval: loss: 1.368 accuracy: 0.788 train: loss: 0.069 accuracy: 1.000 train: loss: 0.073 accuracy: 1.000 train: loss: 0.063 accuracy: 1.000 train: loss: 0.063 accuracy: 1.000 train: loss: 0.063 accuracy: 1.000 eval: loss: 1.362 accuracy: 0.825
トレーニングステップをカスタマイズする
より多くの柔軟性と制御を必要とする場合、独自のトレーニングループを実装することでそれが可能になります。以下の 3 つのステップを踏みます。
- Python ジェネレータか
tf.data.Dataset
をイテレートして例のバッチを作成します。 tf.GradientTape
を使用して勾配を集めます。tf.keras.optimizers
の 1 つを使用して、モデルの変数に重み更新を適用します。
留意点:
- サブクラス化されたレイヤーとモデルの
call
メソッドには、常にtraining
引数を含めます。 training
引数を確実に正しくセットしてモデルを呼び出します。- 使用方法によっては、モデルがデータのバッチ上で実行されるまでモデル変数は存在しないかもしれません。
- モデルの正則化損失などを手動で処理する必要があります。
v1 と比べて簡略化されている点に注意してください :
- 変数初期化子を実行する必要はありません。作成時に変数は初期化されます。
- たとえ
tf.function
演算が eager モードで振る舞う場合でも、手動の制御依存性を追加する必要はありません。
model = tf.keras.Sequential([
tf.keras.layers.Conv2D(32, 3, activation='relu',
kernel_regularizer=tf.keras.regularizers.l2(0.02),
input_shape=(28, 28, 1)),
tf.keras.layers.MaxPooling2D(),
tf.keras.layers.Flatten(),
tf.keras.layers.Dropout(0.1),
tf.keras.layers.Dense(64, activation='relu'),
tf.keras.layers.BatchNormalization(),
tf.keras.layers.Dense(10)
])
optimizer = tf.keras.optimizers.Adam(0.001)
loss_fn = tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True)
@tf.function
def train_step(inputs, labels):
with tf.GradientTape() as tape:
predictions = model(inputs, training=True)
regularization_loss=tf.math.add_n(model.losses)
pred_loss=loss_fn(labels, predictions)
total_loss=pred_loss + regularization_loss
gradients = tape.gradient(total_loss, model.trainable_variables)
optimizer.apply_gradients(zip(gradients, model.trainable_variables))
for epoch in range(NUM_EPOCHS):
for inputs, labels in train_data:
train_step(inputs, labels)
print("Finished epoch", epoch)
Finished epoch 0 Finished epoch 1 Finished epoch 2 Finished epoch 3 Finished epoch 4
新しいスタイルのメトリクスと損失
TensorFlow 2.0 では、メトリクスと損失はオブジェクトです。逐次実行的にtf.function
内で動作します。
損失オブジェクトは呼び出し可能で、(y_true, y_pred) を引数として期待します。
cce = tf.keras.losses.CategoricalCrossentropy(from_logits=True)
cce([[1, 0]], [[-1.0,3.0]]).numpy()
4.01815
メトリックオブジェクトには次のメソッドがあります 。
Metric.update_state()
— 新しい観測を追加するMetric.result()
— 観測値が与えられたとき、メトリックの現在の結果を得るMetric.reset_states()
— すべての観測をクリアする
オブジェクト自体は呼び出し可能です。呼び出しはupdate_state
と同様に新しい観測の状態を更新し、メトリクスの新しい結果を返します。
メトリックの変数を手動で初期化する必要はありません。また、TensorFlow 2.0 は自動制御依存性を持つため、それらについても心配不要です。
次のコードは、メトリックを使用してカスタムトレーニングループ内で観測される平均損失を追跡します。
# Create the metrics
loss_metric = tf.keras.metrics.Mean(name='train_loss')
accuracy_metric = tf.keras.metrics.SparseCategoricalAccuracy(name='train_accuracy')
@tf.function
def train_step(inputs, labels):
with tf.GradientTape() as tape:
predictions = model(inputs, training=True)
regularization_loss=tf.math.add_n(model.losses)
pred_loss=loss_fn(labels, predictions)
total_loss=pred_loss + regularization_loss
gradients = tape.gradient(total_loss, model.trainable_variables)
optimizer.apply_gradients(zip(gradients, model.trainable_variables))
# Update the metrics
loss_metric.update_state(total_loss)
accuracy_metric.update_state(labels, predictions)
for epoch in range(NUM_EPOCHS):
# Reset the metrics
loss_metric.reset_states()
accuracy_metric.reset_states()
for inputs, labels in train_data:
train_step(inputs, labels)
# Get the metric results
mean_loss=loss_metric.result()
mean_accuracy = accuracy_metric.result()
print('Epoch: ', epoch)
print(' loss: {:.3f}'.format(mean_loss))
print(' accuracy: {:.3f}'.format(mean_accuracy))
Epoch: 0 loss: 0.165 accuracy: 0.994 Epoch: 1 loss: 0.138 accuracy: 0.994 Epoch: 2 loss: 0.119 accuracy: 1.000 Epoch: 3 loss: 0.108 accuracy: 1.000 Epoch: 4 loss: 0.095 accuracy: 1.000
Keras メトリック名
TensorFlow 2.0では、Keras モデルはメトリック名の処理に関してより一貫性があります。
メトリックリストで文字列を渡すと、まさにその文字列がメトリックのname
として使用されます。これらの名前はmodel.fit
によって返される履歴オブジェクトと、keras.callbacks
に渡されるログに表示されます。これはメトリックリストで渡した文字列に設定されています。
model.compile(
optimizer = tf.keras.optimizers.Adam(0.001),
loss = tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True),
metrics = ['acc', 'accuracy', tf.keras.metrics.SparseCategoricalAccuracy(name="my_accuracy")])
history = model.fit(train_data)
5/5 [==============================] - 1s 8ms/step - loss: 0.0983 - acc: 0.9957 - accuracy: 0.9957 - my_accuracy: 0.9957
history.history.keys()
dict_keys(['loss', 'acc', 'accuracy', 'my_accuracy'])
これはmetrics=["accuracy"]
を渡すとdict_keys(['loss', 'acc'])
になっていた、以前のバージョンとは異なります。
Keras オプティマイザ
v1.train.AdamOptimizer
やv1.train.GradientDescentOptimizer
などのv1.train
内のオプティマイザは、tf.keras.optimizers
内に同等のものを持ちます。
v1.train
をkeras.optimizers
に変換する
オプティマイザを変換する際の注意事項を次に示します。
- オプティマイザをアップグレードすると、古いチェックポイントとの互換性がなくなる可能性があります。
- epsilon のデフォルトは全て
1e-8
ではなく1e-7
になりました。(これはほとんどのユースケースで無視できます。) v1.train.GradientDescentOptimizer
はtf.keras.optimizers.SGD
で直接置き換えが可能です。v1.train.MomentumOptimizer
はモメンタム引数(tf.keras.optimizers.SGD(..., momentum=...)
)を使用してSGD
オプティマイザで直接置き換えが可能です。v1.train.AdamOptimizer
を変換してtf.keras.optimizers.Adam
を使用することが可能です。beta1
引数とbeta2
引数の名前は、beta_1
とbeta_2
に変更されています。v1.train.RMSPropOptimizer
はtf.keras.optimizers.RMSprop
に変換可能です。decay
引数の名前はrho
に変更されています。v1.train.AdadeltaOptimizer
はtf.keras.optimizers.Adadelta
に直接変換が可能です。tf.train.AdagradOptimizer
はtf.keras.optimizers.Adagrad
に直接変換が可能です。tf.train.FtrlOptimizer
はtf.keras.optimizers.Ftrl
に直接変換が可能です。accum_name
およびlinear_name
引数は削除されています。tf.contrib.AdamaxOptimizer
とtf.contrib.NadamOptimizer
はtf.keras.optimizers.Adamax
とtf.keras.optimizers.Nadam
に直接変換が可能です。beta1
引数とbeta2
引数の名前は、beta_1
とbeta_2
に変更されています。
一部のtf.keras.optimizers
の新しいデフォルト
警告: モデルの収束挙動に変化が見られる場合には、デフォルトの学習率を確認してください。
optimizers.SGD
、optimizers.Adam
、またはoptimizers.RMSprop
に変更はありません。
次のデフォルトの学習率が変更されました。
optimizers.Adagrad
0.01 から 0.001 へoptimizers.Adadelta
1.0 から 0.001 へoptimizers.Adamax
0.002 から 0.001 へoptimizers.Nadam
0.002 から 0.001 へ
TensorBoard
TensorFlow 2 には、TensorBoard で視覚化するための要約データを記述するために使用されるtf.summary
API の大幅な変更が含まれています。新しいtf.summary
の概要については、TensorFlow 2 API を使用した複数のチュートリアルがあります。これには、TensorBoard TensorFlow 2 移行ガイドも含まれています。
保存 & 読み込み
チェックポイントの互換性
TensorFlow 2.0 はオブジェクトベースのチェックポイントを使用します。
古いスタイルの名前ベースのチェックポイントは、注意を払えば依然として読み込むことができます。コード変換プロセスは変数名変更という結果になるかもしれませんが、回避方法はあります。
最も単純なアプローチは、チェックポイント内の名前と新しいモデルの名前を揃えて並べることです。
- 変数にはすべて依然として設定が可能な
name
引数があります。 - Keras モデルはまた
name
引数を取り、それらの変数のためのプレフィックスとして設定されます。 v1.name_scope
関数は、変数名のプレフィックスの設定に使用できます。これはtf.variable_scope
とは大きく異なります。これは名前だけに影響するもので、変数と再利用の追跡はしません。
ご利用のユースケースで動作しない場合は、v1.train.init_from_checkpoint
を試してみてください。これはassignment_map
引数を取り、古い名前から新しい名前へのマッピングを指定します。
注意 : 読み込みを遅延できるオブジェクトベースのチェックポイントとは異なり、名前ベースのチェックポイントは関数が呼び出される時に全ての変数が構築されていることを要求します。一部のモデルは、build
を呼び出すかデータのバッチでモデルを実行するまで変数の構築を遅延します。
TensorFlow Estimatorリポジトリには事前作成された Estimator のチェックポイントを TensorFlow 1.X から 2.0 にアップグレードするための変換ツールが含まれています。これは、同様のユースケースのツールを構築する方法の例として有用な場合があります。
保存されたモデルの互換性
保存されたモデルには、互換性に関する重要な考慮事項はありません。
- TensorFlow 1.x saved_models は TensorFlow 2.x で動作します。
- TensorFlow 2.x saved_models は全ての演算がサポートされていれば TensorFlow 1.x で動作します。
Graph.pb または Graph.pbtxt
未加工のGraph.pb
ファイルを TensorFlow 2.0 にアップグレードする簡単な方法はありません。確実な方法は、ファイルを生成したコードをアップグレードすることです。
ただし、「凍結グラフ」(変数が定数に変換されたtf.Graph
)がある場合、v1.wrap_function
を使用してconcrete_function
への変換が可能です。
def wrap_frozen_graph(graph_def, inputs, outputs):
def _imports_graph_def():
tf.compat.v1.import_graph_def(graph_def, name="")
wrapped_import = tf.compat.v1.wrap_function(_imports_graph_def, [])
import_graph = wrapped_import.graph
return wrapped_import.prune(
tf.nest.map_structure(import_graph.as_graph_element, inputs),
tf.nest.map_structure(import_graph.as_graph_element, outputs))
例えば、次のような凍結された Inception v1 グラフ(2016 年)があります。
path = tf.keras.utils.get_file(
'inception_v1_2016_08_28_frozen.pb',
'http://storage.googleapis.com/download.tensorflow.org/models/inception_v1_2016_08_28_frozen.pb.tar.gz',
untar=True)
Downloading data from http://storage.googleapis.com/download.tensorflow.org/models/inception_v1_2016_08_28_frozen.pb.tar.gz 24698880/24695710 [==============================] - 1s 0us/step
tf.GraphDef
を読み込みます。
graph_def = tf.compat.v1.GraphDef()
loaded = graph_def.ParseFromString(open(path,'rb').read())
これをconcrete_function
にラップします。
inception_func = wrap_frozen_graph(
graph_def, inputs='input:0',
outputs='InceptionV1/InceptionV1/Mixed_3b/Branch_1/Conv2d_0a_1x1/Relu:0')
入力としてテンソルを渡します。
input_img = tf.ones([1,224,224,3], dtype=tf.float32)
inception_func(input_img).shape
TensorShape([1, 28, 28, 96])
Estimator
Estimator でトレーニングする
Estimator は TensorFlow 2.0 でサポートされています。
Estimator を使用する際には、TensorFlow 1.x. からのinput_fn()
、tf.estimator.TrainSpec
、tf.estimator.EvalSpec
を使用できます。
ここに train と evaluate specs を伴う input_fn
を使用する例があります。
input_fn と train/eval specs を作成する
# Define the estimator's input_fn
def input_fn():
datasets, info = tfds.load(name='mnist', with_info=True, as_supervised=True)
mnist_train, mnist_test = datasets['train'], datasets['test']
BUFFER_SIZE = 10000
BATCH_SIZE = 64
def scale(image, label):
image = tf.cast(image, tf.float32)
image /= 255
return image, label[..., tf.newaxis]
train_data = mnist_train.map(scale).shuffle(BUFFER_SIZE).batch(BATCH_SIZE)
return train_data.repeat()
# Define train & eval specs
train_spec = tf.estimator.TrainSpec(input_fn=input_fn,
max_steps=STEPS_PER_EPOCH * NUM_EPOCHS)
eval_spec = tf.estimator.EvalSpec(input_fn=input_fn,
steps=STEPS_PER_EPOCH)
Keras モデル定義を使用する
TensorFlow 2.0 で Estimator を構築する方法には、いくつかの違いがあります。
モデルは Keras を使用して定義することを推奨します。次にtf.keras.estimator.model_to_estimator
ユーティリティを使用して、モデルを Estimator に変更します。次のコードは Estimator を作成してトレーニングする際に、このユーティリティをどのように使用するかを示します。
def make_model():
return tf.keras.Sequential([
tf.keras.layers.Conv2D(32, 3, activation='relu',
kernel_regularizer=tf.keras.regularizers.l2(0.02),
input_shape=(28, 28, 1)),
tf.keras.layers.MaxPooling2D(),
tf.keras.layers.Flatten(),
tf.keras.layers.Dropout(0.1),
tf.keras.layers.Dense(64, activation='relu'),
tf.keras.layers.BatchNormalization(),
tf.keras.layers.Dense(10)
])
model = make_model()
model.compile(optimizer='adam',
loss=tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True),
metrics=['accuracy'])
estimator = tf.keras.estimator.model_to_estimator(
keras_model = model
)
tf.estimator.train_and_evaluate(estimator, train_spec, eval_spec)
INFO:tensorflow:Using default config. INFO:tensorflow:Using default config. WARNING:tensorflow:Using temporary folder as model directory: /tmp/tmp1c_cgfzk WARNING:tensorflow:Using temporary folder as model directory: /tmp/tmp1c_cgfzk INFO:tensorflow:Using the Keras model provided. INFO:tensorflow:Using the Keras model provided. /tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/keras/backend.py:434: UserWarning: `tf.keras.backend.set_learning_phase` is deprecated and will be removed after 2020-10-11. To update it, simply pass a True/False value to the `training` argument of the `__call__` method of your layer or model. warnings.warn('`tf.keras.backend.set_learning_phase` is deprecated and ' INFO:tensorflow:Using config: {'_model_dir': '/tmp/tmp1c_cgfzk', '_tf_random_seed': None, '_save_summary_steps': 100, '_save_checkpoints_steps': None, '_save_checkpoints_secs': 600, '_session_config': allow_soft_placement: true graph_options { rewrite_options { meta_optimizer_iterations: ONE } } , '_keep_checkpoint_max': 5, '_keep_checkpoint_every_n_hours': 10000, '_log_step_count_steps': 100, '_train_distribute': None, '_device_fn': None, '_protocol': None, '_eval_distribute': None, '_experimental_distribute': None, '_experimental_max_worker_delay_secs': None, '_session_creation_timeout_secs': 7200, '_checkpoint_save_graph_def': True, '_service': None, '_cluster_spec': ClusterSpec({}), '_task_type': 'worker', '_task_id': 0, '_global_id_in_cluster': 0, '_master': '', '_evaluation_master': '', '_is_chief': True, '_num_ps_replicas': 0, '_num_worker_replicas': 1} INFO:tensorflow:Using config: {'_model_dir': '/tmp/tmp1c_cgfzk', '_tf_random_seed': None, '_save_summary_steps': 100, '_save_checkpoints_steps': None, '_save_checkpoints_secs': 600, '_session_config': allow_soft_placement: true graph_options { rewrite_options { meta_optimizer_iterations: ONE } } , '_keep_checkpoint_max': 5, '_keep_checkpoint_every_n_hours': 10000, '_log_step_count_steps': 100, '_train_distribute': None, '_device_fn': None, '_protocol': None, '_eval_distribute': None, '_experimental_distribute': None, '_experimental_max_worker_delay_secs': None, '_session_creation_timeout_secs': 7200, '_checkpoint_save_graph_def': True, '_service': None, '_cluster_spec': ClusterSpec({}), '_task_type': 'worker', '_task_id': 0, '_global_id_in_cluster': 0, '_master': '', '_evaluation_master': '', '_is_chief': True, '_num_ps_replicas': 0, '_num_worker_replicas': 1} INFO:tensorflow:Not using Distribute Coordinator. INFO:tensorflow:Not using Distribute Coordinator. INFO:tensorflow:Running training and evaluation locally (non-distributed). INFO:tensorflow:Running training and evaluation locally (non-distributed). INFO:tensorflow:Start train and evaluate loop. The evaluate will happen after every checkpoint. Checkpoint frequency is determined based on RunConfig arguments: save_checkpoints_steps None or save_checkpoints_secs 600. INFO:tensorflow:Start train and evaluate loop. The evaluate will happen after every checkpoint. Checkpoint frequency is determined based on RunConfig arguments: save_checkpoints_steps None or save_checkpoints_secs 600. WARNING:tensorflow:From /tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/training/training_util.py:236: Variable.initialized_value (from tensorflow.python.ops.variables) is deprecated and will be removed in a future version. Instructions for updating: Use Variable.read_value. Variables in 2.X are initialized automatically both in eager and graph (inside tf.defun) contexts. WARNING:tensorflow:From /tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/training/training_util.py:236: Variable.initialized_value (from tensorflow.python.ops.variables) is deprecated and will be removed in a future version. Instructions for updating: Use Variable.read_value. Variables in 2.X are initialized automatically both in eager and graph (inside tf.defun) contexts. INFO:tensorflow:Calling model_fn. INFO:tensorflow:Calling model_fn. INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Warm-starting with WarmStartSettings: WarmStartSettings(ckpt_to_initialize_from='/tmp/tmp1c_cgfzk/keras/keras_model.ckpt', vars_to_warm_start='.*', var_name_to_vocab_info={}, var_name_to_prev_var_name={}) INFO:tensorflow:Warm-starting with WarmStartSettings: WarmStartSettings(ckpt_to_initialize_from='/tmp/tmp1c_cgfzk/keras/keras_model.ckpt', vars_to_warm_start='.*', var_name_to_vocab_info={}, var_name_to_prev_var_name={}) INFO:tensorflow:Warm-starting from: /tmp/tmp1c_cgfzk/keras/keras_model.ckpt INFO:tensorflow:Warm-starting from: /tmp/tmp1c_cgfzk/keras/keras_model.ckpt INFO:tensorflow:Warm-starting variables only in TRAINABLE_VARIABLES. INFO:tensorflow:Warm-starting variables only in TRAINABLE_VARIABLES. INFO:tensorflow:Warm-started 8 variables. INFO:tensorflow:Warm-started 8 variables. INFO:tensorflow:Create CheckpointSaverHook. INFO:tensorflow:Create CheckpointSaverHook. INFO:tensorflow:Graph was finalized. INFO:tensorflow:Graph was finalized. INFO:tensorflow:Running local_init_op. INFO:tensorflow:Running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 0... INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 0... INFO:tensorflow:Saving checkpoints for 0 into /tmp/tmp1c_cgfzk/model.ckpt. INFO:tensorflow:Saving checkpoints for 0 into /tmp/tmp1c_cgfzk/model.ckpt. INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 0... INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 0... INFO:tensorflow:loss = 2.6036682, step = 0 INFO:tensorflow:loss = 2.6036682, step = 0 INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 25... INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 25... INFO:tensorflow:Saving checkpoints for 25 into /tmp/tmp1c_cgfzk/model.ckpt. INFO:tensorflow:Saving checkpoints for 25 into /tmp/tmp1c_cgfzk/model.ckpt. INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 25... INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 25... INFO:tensorflow:Calling model_fn. INFO:tensorflow:Calling model_fn. INFO:tensorflow:Done calling model_fn. /tmpfs/src/tf_docs_env/lib/python3.6/site-packages/tensorflow/python/keras/engine/training.py:2325: UserWarning: `Model.state_updates` will be removed in a future version. This property should not be used in TensorFlow 2.0, as `updates` are applied automatically. warnings.warn('`Model.state_updates` will be removed in a future version. ' INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Starting evaluation at 2021-02-12T21:42:21Z INFO:tensorflow:Starting evaluation at 2021-02-12T21:42:21Z INFO:tensorflow:Graph was finalized. INFO:tensorflow:Graph was finalized. INFO:tensorflow:Restoring parameters from /tmp/tmp1c_cgfzk/model.ckpt-25 INFO:tensorflow:Restoring parameters from /tmp/tmp1c_cgfzk/model.ckpt-25 INFO:tensorflow:Running local_init_op. INFO:tensorflow:Running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Evaluation [1/5] INFO:tensorflow:Evaluation [1/5] INFO:tensorflow:Evaluation [2/5] INFO:tensorflow:Evaluation [2/5] INFO:tensorflow:Evaluation [3/5] INFO:tensorflow:Evaluation [3/5] INFO:tensorflow:Evaluation [4/5] INFO:tensorflow:Evaluation [4/5] INFO:tensorflow:Evaluation [5/5] INFO:tensorflow:Evaluation [5/5] INFO:tensorflow:Inference Time : 1.04609s INFO:tensorflow:Inference Time : 1.04609s INFO:tensorflow:Finished evaluation at 2021-02-12-21:42:22 INFO:tensorflow:Finished evaluation at 2021-02-12-21:42:22 INFO:tensorflow:Saving dict for global step 25: accuracy = 0.53125, global_step = 25, loss = 1.6399828 INFO:tensorflow:Saving dict for global step 25: accuracy = 0.53125, global_step = 25, loss = 1.6399828 INFO:tensorflow:Saving 'checkpoint_path' summary for global step 25: /tmp/tmp1c_cgfzk/model.ckpt-25 INFO:tensorflow:Saving 'checkpoint_path' summary for global step 25: /tmp/tmp1c_cgfzk/model.ckpt-25 INFO:tensorflow:Loss for final step: 0.39722806. INFO:tensorflow:Loss for final step: 0.39722806. ({'accuracy': 0.53125, 'loss': 1.6399828, 'global_step': 25}, [])
注意 : Keras で重み付きメトリクスを作成し、model_to_estimator
を使用してそれらを Estimator API で重み付きメトリクスを変換することはサポートされません。それらのメトリクスは、add_metrics
関数を使用して Estimator 仕様で直接作成する必要があります。
カスタム model_fn
を使用する
保守する必要がある既存のカスタム Estimator model_fn
を持つ場合には、model_fn
を変換して Keras モデルを使用できるようにすることが可能です。
しかしながら、互換性の理由から、カスタムmodel_fn
は依然として1.x スタイルのグラフモードで動作します。これは eager execution はなく自動制御依存性もないことも意味します。
最小限の変更で model_fn をカスタマイズする
TensorFlow 2.0 でカスタムmodel_fn
を動作させるには、既存のコードの変更を最小限に留めたい場合、optimizers
やmetrics
などのtf.compat.v1
シンボルを使用することができます。
カスタムmodel_fn
で Keras モデルを使用することは、それをカスタムトレーニングループで使用することに類似しています。
mode
引数を基に、training
段階を適切に設定します。- モデルの
trainable_variables
をオプティマイザに明示的に渡します。
しかし、カスタムループと比較して、重要な違いがあります。
Model.losses
を使用する代わりにModel.get_losses_for
を使用して損失を抽出します。Model.get_updates_for
を使用してモデルの更新を抽出します。
注意 : 「更新」は各バッチの後にモデルに適用される必要がある変更です。例えば、layers.BatchNormalization
レイヤーの平均と分散の移動平均などです。
次のコードはカスタムmodel_fn
から Estimator を作成し、これらの懸念事項を全て示しています。
def my_model_fn(features, labels, mode):
model = make_model()
optimizer = tf.compat.v1.train.AdamOptimizer()
loss=tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True)
training = (mode == tf.estimator.ModeKeys.TRAIN)
predictions = model(features, training=training)
if mode == tf.estimator.ModeKeys.PREDICT:
return tf.estimator.EstimatorSpec(mode=mode, predictions=predictions)
reg_losses = model.get_losses_for(None) + model.get_losses_for(features)
total_loss=loss_fn(labels, predictions) + tf.math.add_n(reg_losses)
accuracy = tf.compat.v1.metrics.accuracy(labels=labels,
predictions=tf.math.argmax(predictions, axis=1),
name='acc_op')
update_ops = model.get_updates_for(None) + model.get_updates_for(features)
minimize_op = optimizer.minimize(
total_loss,
var_list=model.trainable_variables,
global_step=tf.compat.v1.train.get_or_create_global_step())
train_op = tf.group(minimize_op, update_ops)
return tf.estimator.EstimatorSpec(
mode=mode,
predictions=predictions,
loss=total_loss,
train_op=train_op, eval_metric_ops={'accuracy': accuracy})
# Create the Estimator & Train
estimator = tf.estimator.Estimator(model_fn=my_model_fn)
tf.estimator.train_and_evaluate(estimator, train_spec, eval_spec)
INFO:tensorflow:Using default config. INFO:tensorflow:Using default config. WARNING:tensorflow:Using temporary folder as model directory: /tmp/tmpat5pti2d WARNING:tensorflow:Using temporary folder as model directory: /tmp/tmpat5pti2d INFO:tensorflow:Using config: {'_model_dir': '/tmp/tmpat5pti2d', '_tf_random_seed': None, '_save_summary_steps': 100, '_save_checkpoints_steps': None, '_save_checkpoints_secs': 600, '_session_config': allow_soft_placement: true graph_options { rewrite_options { meta_optimizer_iterations: ONE } } , '_keep_checkpoint_max': 5, '_keep_checkpoint_every_n_hours': 10000, '_log_step_count_steps': 100, '_train_distribute': None, '_device_fn': None, '_protocol': None, '_eval_distribute': None, '_experimental_distribute': None, '_experimental_max_worker_delay_secs': None, '_session_creation_timeout_secs': 7200, '_checkpoint_save_graph_def': True, '_service': None, '_cluster_spec': ClusterSpec({}), '_task_type': 'worker', '_task_id': 0, '_global_id_in_cluster': 0, '_master': '', '_evaluation_master': '', '_is_chief': True, '_num_ps_replicas': 0, '_num_worker_replicas': 1} INFO:tensorflow:Using config: {'_model_dir': '/tmp/tmpat5pti2d', '_tf_random_seed': None, '_save_summary_steps': 100, '_save_checkpoints_steps': None, '_save_checkpoints_secs': 600, '_session_config': allow_soft_placement: true graph_options { rewrite_options { meta_optimizer_iterations: ONE } } , '_keep_checkpoint_max': 5, '_keep_checkpoint_every_n_hours': 10000, '_log_step_count_steps': 100, '_train_distribute': None, '_device_fn': None, '_protocol': None, '_eval_distribute': None, '_experimental_distribute': None, '_experimental_max_worker_delay_secs': None, '_session_creation_timeout_secs': 7200, '_checkpoint_save_graph_def': True, '_service': None, '_cluster_spec': ClusterSpec({}), '_task_type': 'worker', '_task_id': 0, '_global_id_in_cluster': 0, '_master': '', '_evaluation_master': '', '_is_chief': True, '_num_ps_replicas': 0, '_num_worker_replicas': 1} INFO:tensorflow:Not using Distribute Coordinator. INFO:tensorflow:Not using Distribute Coordinator. INFO:tensorflow:Running training and evaluation locally (non-distributed). INFO:tensorflow:Running training and evaluation locally (non-distributed). INFO:tensorflow:Start train and evaluate loop. The evaluate will happen after every checkpoint. Checkpoint frequency is determined based on RunConfig arguments: save_checkpoints_steps None or save_checkpoints_secs 600. INFO:tensorflow:Start train and evaluate loop. The evaluate will happen after every checkpoint. Checkpoint frequency is determined based on RunConfig arguments: save_checkpoints_steps None or save_checkpoints_secs 600. INFO:tensorflow:Calling model_fn. INFO:tensorflow:Calling model_fn. INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Create CheckpointSaverHook. INFO:tensorflow:Create CheckpointSaverHook. INFO:tensorflow:Graph was finalized. INFO:tensorflow:Graph was finalized. INFO:tensorflow:Running local_init_op. INFO:tensorflow:Running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 0... INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 0... INFO:tensorflow:Saving checkpoints for 0 into /tmp/tmpat5pti2d/model.ckpt. INFO:tensorflow:Saving checkpoints for 0 into /tmp/tmpat5pti2d/model.ckpt. INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 0... INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 0... INFO:tensorflow:loss = 2.902596, step = 0 INFO:tensorflow:loss = 2.902596, step = 0 INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 25... INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 25... INFO:tensorflow:Saving checkpoints for 25 into /tmp/tmpat5pti2d/model.ckpt. INFO:tensorflow:Saving checkpoints for 25 into /tmp/tmpat5pti2d/model.ckpt. INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 25... INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 25... INFO:tensorflow:Calling model_fn. INFO:tensorflow:Calling model_fn. INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Starting evaluation at 2021-02-12T21:42:29Z INFO:tensorflow:Starting evaluation at 2021-02-12T21:42:29Z INFO:tensorflow:Graph was finalized. INFO:tensorflow:Graph was finalized. INFO:tensorflow:Restoring parameters from /tmp/tmpat5pti2d/model.ckpt-25 INFO:tensorflow:Restoring parameters from /tmp/tmpat5pti2d/model.ckpt-25 INFO:tensorflow:Running local_init_op. INFO:tensorflow:Running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Evaluation [1/5] INFO:tensorflow:Evaluation [1/5] INFO:tensorflow:Evaluation [2/5] INFO:tensorflow:Evaluation [2/5] INFO:tensorflow:Evaluation [3/5] INFO:tensorflow:Evaluation [3/5] INFO:tensorflow:Evaluation [4/5] INFO:tensorflow:Evaluation [4/5] INFO:tensorflow:Evaluation [5/5] INFO:tensorflow:Evaluation [5/5] INFO:tensorflow:Inference Time : 1.16543s INFO:tensorflow:Inference Time : 1.16543s INFO:tensorflow:Finished evaluation at 2021-02-12-21:42:30 INFO:tensorflow:Finished evaluation at 2021-02-12-21:42:30 INFO:tensorflow:Saving dict for global step 25: accuracy = 0.51875, global_step = 25, loss = 1.6437883 INFO:tensorflow:Saving dict for global step 25: accuracy = 0.51875, global_step = 25, loss = 1.6437883 INFO:tensorflow:Saving 'checkpoint_path' summary for global step 25: /tmp/tmpat5pti2d/model.ckpt-25 INFO:tensorflow:Saving 'checkpoint_path' summary for global step 25: /tmp/tmpat5pti2d/model.ckpt-25 INFO:tensorflow:Loss for final step: 0.38495067. INFO:tensorflow:Loss for final step: 0.38495067. ({'accuracy': 0.51875, 'loss': 1.6437883, 'global_step': 25}, [])
TensorFlow 2.0 シンボルでmodel_fn
をカスタマイズする
TensorFlow 1.x シンボルを全て削除し、カスタムmodel_fn
をネイティブの TensorFlow 2.0 にアップグレードする場合は、オプティマイザとメトリクスをtf.keras.optimizers
とtf.keras.metrics
にアップグレードする必要があります。
カスタムmodel_fn
では、上記の変更に加えて、さらにアップグレードを行う必要があります。
v1.train.Optimizer
の代わりにtf.keras.optimizers
を使用します。- モデルの
trainable_variables
をtf.keras.optimizers
に明示的に渡します。 train_op/minimize_op
を計算するには、- 損失がスカラー損失
Tensor
(呼び出し不可)の場合は、Optimizer.get_updates()
を使用します。返されるリストの最初の要素は目的とするtrain_op/minimize_op
です。 - 損失が呼び出し可能(関数など)な場合は、
Optimizer.minimize()
を使用してtrain_op/minimize_op
を取得します。
- 損失がスカラー損失
- 評価には
tf.compat.v1.metrics
の代わりにtf.keras.metrics
を使用します。
上記のmy_model_fn
の例では、2.0 シンボルの移行されたコードは次のように表示されます。
def my_model_fn(features, labels, mode):
model = make_model()
training = (mode == tf.estimator.ModeKeys.TRAIN)
loss_obj = tf.keras.losses.SparseCategoricalCrossentropy(from_logits=True)
predictions = model(features, training=training)
# Get both the unconditional losses (the None part)
# and the input-conditional losses (the features part).
reg_losses = model.get_losses_for(None) + model.get_losses_for(features)
total_loss=loss_obj(labels, predictions) + tf.math.add_n(reg_losses)
# Upgrade to tf.keras.metrics.
accuracy_obj = tf.keras.metrics.Accuracy(name='acc_obj')
accuracy = accuracy_obj.update_state(
y_true=labels, y_pred=tf.math.argmax(predictions, axis=1))
train_op = None
if training:
# Upgrade to tf.keras.optimizers.
optimizer = tf.keras.optimizers.Adam()
# Manually assign tf.compat.v1.global_step variable to optimizer.iterations
# to make tf.compat.v1.train.global_step increased correctly.
# This assignment is a must for any `tf.train.SessionRunHook` specified in
# estimator, as SessionRunHooks rely on global step.
optimizer.iterations = tf.compat.v1.train.get_or_create_global_step()
# Get both the unconditional updates (the None part)
# and the input-conditional updates (the features part).
update_ops = model.get_updates_for(None) + model.get_updates_for(features)
# Compute the minimize_op.
minimize_op = optimizer.get_updates(
total_loss,
model.trainable_variables)[0]
train_op = tf.group(minimize_op, *update_ops)
return tf.estimator.EstimatorSpec(
mode=mode,
predictions=predictions,
loss=total_loss,
train_op=train_op,
eval_metric_ops={'Accuracy': accuracy_obj})
# Create the Estimator & Train.
estimator = tf.estimator.Estimator(model_fn=my_model_fn)
tf.estimator.train_and_evaluate(estimator, train_spec, eval_spec)
INFO:tensorflow:Using default config. INFO:tensorflow:Using default config. WARNING:tensorflow:Using temporary folder as model directory: /tmp/tmp7eh7nbjo WARNING:tensorflow:Using temporary folder as model directory: /tmp/tmp7eh7nbjo INFO:tensorflow:Using config: {'_model_dir': '/tmp/tmp7eh7nbjo', '_tf_random_seed': None, '_save_summary_steps': 100, '_save_checkpoints_steps': None, '_save_checkpoints_secs': 600, '_session_config': allow_soft_placement: true graph_options { rewrite_options { meta_optimizer_iterations: ONE } } , '_keep_checkpoint_max': 5, '_keep_checkpoint_every_n_hours': 10000, '_log_step_count_steps': 100, '_train_distribute': None, '_device_fn': None, '_protocol': None, '_eval_distribute': None, '_experimental_distribute': None, '_experimental_max_worker_delay_secs': None, '_session_creation_timeout_secs': 7200, '_checkpoint_save_graph_def': True, '_service': None, '_cluster_spec': ClusterSpec({}), '_task_type': 'worker', '_task_id': 0, '_global_id_in_cluster': 0, '_master': '', '_evaluation_master': '', '_is_chief': True, '_num_ps_replicas': 0, '_num_worker_replicas': 1} INFO:tensorflow:Using config: {'_model_dir': '/tmp/tmp7eh7nbjo', '_tf_random_seed': None, '_save_summary_steps': 100, '_save_checkpoints_steps': None, '_save_checkpoints_secs': 600, '_session_config': allow_soft_placement: true graph_options { rewrite_options { meta_optimizer_iterations: ONE } } , '_keep_checkpoint_max': 5, '_keep_checkpoint_every_n_hours': 10000, '_log_step_count_steps': 100, '_train_distribute': None, '_device_fn': None, '_protocol': None, '_eval_distribute': None, '_experimental_distribute': None, '_experimental_max_worker_delay_secs': None, '_session_creation_timeout_secs': 7200, '_checkpoint_save_graph_def': True, '_service': None, '_cluster_spec': ClusterSpec({}), '_task_type': 'worker', '_task_id': 0, '_global_id_in_cluster': 0, '_master': '', '_evaluation_master': '', '_is_chief': True, '_num_ps_replicas': 0, '_num_worker_replicas': 1} INFO:tensorflow:Not using Distribute Coordinator. INFO:tensorflow:Not using Distribute Coordinator. INFO:tensorflow:Running training and evaluation locally (non-distributed). INFO:tensorflow:Running training and evaluation locally (non-distributed). INFO:tensorflow:Start train and evaluate loop. The evaluate will happen after every checkpoint. Checkpoint frequency is determined based on RunConfig arguments: save_checkpoints_steps None or save_checkpoints_secs 600. INFO:tensorflow:Start train and evaluate loop. The evaluate will happen after every checkpoint. Checkpoint frequency is determined based on RunConfig arguments: save_checkpoints_steps None or save_checkpoints_secs 600. INFO:tensorflow:Calling model_fn. INFO:tensorflow:Calling model_fn. INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Create CheckpointSaverHook. INFO:tensorflow:Create CheckpointSaverHook. INFO:tensorflow:Graph was finalized. INFO:tensorflow:Graph was finalized. INFO:tensorflow:Running local_init_op. INFO:tensorflow:Running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 0... INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 0... INFO:tensorflow:Saving checkpoints for 0 into /tmp/tmp7eh7nbjo/model.ckpt. INFO:tensorflow:Saving checkpoints for 0 into /tmp/tmp7eh7nbjo/model.ckpt. INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 0... INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 0... INFO:tensorflow:loss = 2.6965864, step = 0 INFO:tensorflow:loss = 2.6965864, step = 0 INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 25... INFO:tensorflow:Calling checkpoint listeners before saving checkpoint 25... INFO:tensorflow:Saving checkpoints for 25 into /tmp/tmp7eh7nbjo/model.ckpt. INFO:tensorflow:Saving checkpoints for 25 into /tmp/tmp7eh7nbjo/model.ckpt. INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 25... INFO:tensorflow:Calling checkpoint listeners after saving checkpoint 25... INFO:tensorflow:Calling model_fn. INFO:tensorflow:Calling model_fn. INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Done calling model_fn. INFO:tensorflow:Starting evaluation at 2021-02-12T21:42:37Z INFO:tensorflow:Starting evaluation at 2021-02-12T21:42:37Z INFO:tensorflow:Graph was finalized. INFO:tensorflow:Graph was finalized. INFO:tensorflow:Restoring parameters from /tmp/tmp7eh7nbjo/model.ckpt-25 INFO:tensorflow:Restoring parameters from /tmp/tmp7eh7nbjo/model.ckpt-25 INFO:tensorflow:Running local_init_op. INFO:tensorflow:Running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Done running local_init_op. INFO:tensorflow:Evaluation [1/5] INFO:tensorflow:Evaluation [1/5] INFO:tensorflow:Evaluation [2/5] INFO:tensorflow:Evaluation [2/5] INFO:tensorflow:Evaluation [3/5] INFO:tensorflow:Evaluation [3/5] INFO:tensorflow:Evaluation [4/5] INFO:tensorflow:Evaluation [4/5] INFO:tensorflow:Evaluation [5/5] INFO:tensorflow:Evaluation [5/5] INFO:tensorflow:Inference Time : 1.10555s INFO:tensorflow:Inference Time : 1.10555s INFO:tensorflow:Finished evaluation at 2021-02-12-21:42:38 INFO:tensorflow:Finished evaluation at 2021-02-12-21:42:38 INFO:tensorflow:Saving dict for global step 25: Accuracy = 0.546875, global_step = 25, loss = 1.5356407 INFO:tensorflow:Saving dict for global step 25: Accuracy = 0.546875, global_step = 25, loss = 1.5356407 INFO:tensorflow:Saving 'checkpoint_path' summary for global step 25: /tmp/tmp7eh7nbjo/model.ckpt-25 INFO:tensorflow:Saving 'checkpoint_path' summary for global step 25: /tmp/tmp7eh7nbjo/model.ckpt-25 INFO:tensorflow:Loss for final step: 0.4420043. INFO:tensorflow:Loss for final step: 0.4420043. ({'Accuracy': 0.546875, 'loss': 1.5356407, 'global_step': 25}, [])
事前作成された Estimator
tf.estimator.DNN*
、tf.estimator.Linear*
、 tf.estimator.DNNLinearCombined*
のファミリーに含まれる事前作成された Estimator は、依然として TensorFlow 2.0 API でもサポートされていますが、一部の引数が変更されています。
input_layer_partitioner
: 2.0 で削除されました。loss_reduction
:tf.compat.v1.losses.Reduction
の代わりにtf.keras.losses.Reduction
に更新されました。デフォルト値もtf.compat.v1.losses.Reduction.SUM
からtf.keras.losses.Reduction.SUM_OVER_BATCH_SIZE
に変更されています。optimizer
、dnn_optimizer
、linear_optimizer
: これらの引数はtf.compat.v1.train.Optimizer
の代わりにtf.keras.optimizers
に更新されています。
上記の変更を移行するには :
- TF 2.0 では
配布戦略
が自動的に処理するため、input_layer_partitioner
の移行は必要ありません。 loss_reduction
についてはtf.keras.losses.Reduction
でサポートされるオプションを確認してください。optimizer
引数については、optimizer
、dnn_optimizer
、linear_optimizer
引数を渡さない場合、またはoptimizer
引数をコード内の内のstring
として指定する場合は、何も変更する必要はありません。デフォルトでtf.keras.optimizers
を使用します。それ以外の場合は、tf.compat.v1.train.Optimizer
から対応するtf.keras.optimizers
に更新する必要があります。
チェックポイントコンバータ
tf.keras.optimizers
は異なる変数セットを生成してチェックポイントに保存するするため、keras.optimizers
への移行は TensorFlow 1.x を使用して保存されたチェックポイントを壊してしまいます。TensorFlow 2.0 への移行後に古いチェックポイントを再利用できるようにするには、チェックポイントコンバータツールをお試しください。
curl -O https://raw.githubusercontent.com/tensorflow/estimator/master/tensorflow_estimator/python/estimator/tools/checkpoint_converter.py
% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 15165 100 15165 0 0 44342 0 --:--:-- --:--:-- --:--:-- 44342
ツールにはヘルプが組み込まれています。
python checkpoint_converter.py -h
2021-02-12 21:42:39.210758: I tensorflow/stream_executor/platform/default/dso_loader.cc:49] Successfully opened dynamic library libcudart.so.11.0 usage: checkpoint_converter.py [-h] {dnn,linear,combined} source_checkpoint source_graph target_checkpoint positional arguments: {dnn,linear,combined} The type of estimator to be converted. So far, the checkpoint converter only supports Canned Estimator. So the allowed types include linear, dnn and combined. source_checkpoint Path to source checkpoint file to be read in. source_graph Path to source graph file to be read in. target_checkpoint Path to checkpoint file to be written out. optional arguments: -h, --help show this help message and exit
TensorShape
このクラスはtf.compat.v1.Dimension
オブジェクトの代わりにint
を保持することにより単純化されました。従って、.value()
を呼び出してint
を取得する必要はありません。
個々のtf.compat.v1.Dimension
オブジェクトは依然としてtf.TensorShape.dims
からアクセス可能です。
以下に TensorFlow 1.x と TensorFlow 2.0 間の違いを示します。
# Create a shape and choose an index
i = 0
shape = tf.TensorShape([16, None, 256])
shape
TensorShape([16, None, 256])
もし TensorFlow 1.x で次を使っていた場合:
value = shape[i].value
TensorFlow 2.0 では次のようにします:
value = shape[i]
value
16
もし TensorFlow 1.x で次を使っていた場合:
for dim in shape: value = dim.value print(value)
TensorFlow 2.0 では次のようにします:
for value in shape:
print(value)
16 None 256
もし TensorFlow 1.x で次を使っていた場合(あるいは任意の他の次元のメソッドを使用したのであれば):
dim = shape[i] dim.assert_is_compatible_with(other_dim)
TensorFlow 2.0 では次のようにします:
other_dim = 16
Dimension = tf.compat.v1.Dimension
if shape.rank is None:
dim = Dimension(None)
else:
dim = shape.dims[i]
dim.is_compatible_with(other_dim) # or any other dimension method
True
shape = tf.TensorShape(None)
if shape:
dim = shape.dims[i]
dim.is_compatible_with(other_dim) # or any other dimension method
tf.TensorShape
のブール型の値は、階数が既知の場合はTrue
で、そうでない場合はFalse
です。
print(bool(tf.TensorShape([]))) # Scalar
print(bool(tf.TensorShape([0]))) # 0-length vector
print(bool(tf.TensorShape([1]))) # 1-length vector
print(bool(tf.TensorShape([None]))) # Unknown-length vector
print(bool(tf.TensorShape([1, 10, 100]))) # 3D tensor
print(bool(tf.TensorShape([None, None, None]))) # 3D tensor with no known dimensions
print()
print(bool(tf.TensorShape(None))) # A tensor with unknown rank.
True True True True True True False
その他の変更点
tf.colocate_with
を削除する : TensorFlow のデバイス配置アルゴリズムが大幅に改善されたため、これはもう必要ありません。削除したことによってパフォーマンスが低下する場合には、バグを報告してください。v1.ConfigProto
の使用をtf.config
の同等の関数に置き換える。
まとめ
全体のプロセスは次のとおりです。
- アップグレードスクリプトを実行する。
- contrib シンボルを除去する。
- モデルをオブジェクト指向スタイル (Keras) に切り替える。
- 可能なところでは
tf.keras
またはtf.estimator
トレーニングと評価ループを使用する。 - そうでない場合はカスタムループを使用してよいが、セッション&コレクションの回避を確実にする。
コードを慣用的な TensorFlow 2.0 に変換するには少し作業を要しますが、変更するごとに次のような結果が得られます。
- コード行が減少する。
- 明瞭さと簡略性が向上する。
- デバッグが容易になる。