From 94f8a9d5d519e6e943e05dc3bae67ab217171183 Mon Sep 17 00:00:00 2001 From: Ir1d Date: Wed, 4 Mar 2020 14:02:41 +0800 Subject: [PATCH 1/5] docs: add examples for random_uniform, random_normal and random_binomial in tf.keras.backend closes #31277 --- tensorflow/python/keras/backend.py | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/tensorflow/python/keras/backend.py b/tensorflow/python/keras/backend.py index f83ed74c2f8..54b1df156c1 100644 --- a/tensorflow/python/keras/backend.py +++ b/tensorflow/python/keras/backend.py @@ -5653,6 +5653,13 @@ def random_normal(shape, mean=0.0, stddev=1.0, dtype=None, seed=None): Returns: A tensor with normal distribution of values. + + Example: + + >>> kvar = tf.keras.backend.random_normal((2,3), 0, 1) + >>> kvar + """ if dtype is None: dtype = floatx() @@ -5677,6 +5684,13 @@ def random_uniform(shape, minval=0.0, maxval=1.0, dtype=None, seed=None): Returns: A tensor. + + Example: + + >>> kvar = tf.keras.backend.random_uniform((2,3), 0, 1) + >>> kvar + """ if dtype is None: dtype = floatx() @@ -5702,6 +5716,13 @@ def random_binomial(shape, p=0.0, dtype=None, seed=None): Returns: A tensor. + + Example: + + >>> kvar = tf.keras.backend.random_binomial((2,3), 0.5) + >>> kvar + """ if dtype is None: dtype = floatx() From 0aa22bd95adc4ed318e029ac5b495db7a42bc150 Mon Sep 17 00:00:00 2001 From: Ir1d Date: Thu, 5 Mar 2020 19:56:13 +0800 Subject: [PATCH 2/5] update as per review comment --- tensorflow/python/keras/backend.py | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/tensorflow/python/keras/backend.py b/tensorflow/python/keras/backend.py index 54b1df156c1..86687d4f71f 100644 --- a/tensorflow/python/keras/backend.py +++ b/tensorflow/python/keras/backend.py @@ -1479,7 +1479,7 @@ def random_uniform_variable(shape, low, high, dtype=None, name=None, seed=None): Example: - >>> kvar = tf.keras.backend.random_uniform_variable((2,3), 0, 1) + >>> kvar = tf.keras.backend.random_uniform_variable(shape=(2,3), low=0.0, high=1.0) >>> kvar @@ -1513,7 +1513,7 @@ def random_normal_variable(shape, mean, scale, dtype=None, name=None, Example: - >>> kvar = tf.keras.backend.random_normal_variable((2,3), 0, 1) + >>> kvar = tf.keras.backend.random_normal_variable(shape=(2,3), mean=0.0, scale=1.0) >>> kvar @@ -5656,8 +5656,8 @@ def random_normal(shape, mean=0.0, stddev=1.0, dtype=None, seed=None): Example: - >>> kvar = tf.keras.backend.random_normal((2,3), 0, 1) - >>> kvar + >>> random_normal_tensor = tf.keras.backend.random_normal(shape=(2,3), mean=0.0, stddev=1.0) + >>> random_normal_tensor """ @@ -5687,8 +5687,8 @@ def random_uniform(shape, minval=0.0, maxval=1.0, dtype=None, seed=None): Example: - >>> kvar = tf.keras.backend.random_uniform((2,3), 0, 1) - >>> kvar + >>> random_uniform_tensor = tf.keras.backend.random_uniform(shape=(2,3), minval=0.0, maxval=1.0) + >>> random_uniform_tensor """ @@ -5719,8 +5719,8 @@ def random_binomial(shape, p=0.0, dtype=None, seed=None): Example: - >>> kvar = tf.keras.backend.random_binomial((2,3), 0.5) - >>> kvar + >>> random_binomial_tensor = tf.keras.backend.random_binomial(shape=(2,3), p=0.5) + >>> random_binomial_tensor """ From b30f9cf90463a2087660206a45f872fff666491a Mon Sep 17 00:00:00 2001 From: Ir1d Date: Fri, 6 Mar 2020 15:47:32 +0800 Subject: [PATCH 3/5] fix pylint --- tensorflow/python/keras/backend.py | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/tensorflow/python/keras/backend.py b/tensorflow/python/keras/backend.py index 86687d4f71f..45102fa2cfb 100644 --- a/tensorflow/python/keras/backend.py +++ b/tensorflow/python/keras/backend.py @@ -1479,7 +1479,8 @@ def random_uniform_variable(shape, low, high, dtype=None, name=None, seed=None): Example: - >>> kvar = tf.keras.backend.random_uniform_variable(shape=(2,3), low=0.0, high=1.0) + >>> kvar = tf.keras.backend.random_uniform_variable(shape=(2,3), + low=0.0, high=1.0) >>> kvar @@ -1513,7 +1514,8 @@ def random_normal_variable(shape, mean, scale, dtype=None, name=None, Example: - >>> kvar = tf.keras.backend.random_normal_variable(shape=(2,3), mean=0.0, scale=1.0) + >>> kvar = tf.keras.backend.random_normal_variable(shape=(2,3), + mean=0.0, scale=1.0) >>> kvar @@ -5656,7 +5658,8 @@ def random_normal(shape, mean=0.0, stddev=1.0, dtype=None, seed=None): Example: - >>> random_normal_tensor = tf.keras.backend.random_normal(shape=(2,3), mean=0.0, stddev=1.0) + >>> random_normal_tensor = tf.keras.backend.random_normal(shape=(2,3), + mean=0.0, stddev=1.0) >>> random_normal_tensor @@ -5687,7 +5690,8 @@ def random_uniform(shape, minval=0.0, maxval=1.0, dtype=None, seed=None): Example: - >>> random_uniform_tensor = tf.keras.backend.random_uniform(shape=(2,3), minval=0.0, maxval=1.0) + >>> random_uniform_tensor = tf.keras.backend.random_uniform(shape=(2,3), + minval=0.0, maxval=1.0) >>> random_uniform_tensor @@ -5719,7 +5723,8 @@ def random_binomial(shape, p=0.0, dtype=None, seed=None): Example: - >>> random_binomial_tensor = tf.keras.backend.random_binomial(shape=(2,3), p=0.5) + >>> random_binomial_tensor = tf.keras.backend.random_binomial(shape=(2,3), + p=0.5) >>> random_binomial_tensor From c826dad7f49869eef62777c4ca386ee3f988fe70 Mon Sep 17 00:00:00 2001 From: Ir1d Date: Fri, 20 Mar 2020 09:26:19 +0800 Subject: [PATCH 4/5] use correct indent for multiline doctest --- tensorflow/python/keras/backend.py | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/tensorflow/python/keras/backend.py b/tensorflow/python/keras/backend.py index 45102fa2cfb..428f1ff7acf 100644 --- a/tensorflow/python/keras/backend.py +++ b/tensorflow/python/keras/backend.py @@ -1480,7 +1480,7 @@ def random_uniform_variable(shape, low, high, dtype=None, name=None, seed=None): Example: >>> kvar = tf.keras.backend.random_uniform_variable(shape=(2,3), - low=0.0, high=1.0) + ... low=0.0, high=1.0) >>> kvar @@ -1515,7 +1515,7 @@ def random_normal_variable(shape, mean, scale, dtype=None, name=None, Example: >>> kvar = tf.keras.backend.random_normal_variable(shape=(2,3), - mean=0.0, scale=1.0) + ... mean=0.0, scale=1.0) >>> kvar @@ -5691,7 +5691,7 @@ def random_uniform(shape, minval=0.0, maxval=1.0, dtype=None, seed=None): Example: >>> random_uniform_tensor = tf.keras.backend.random_uniform(shape=(2,3), - minval=0.0, maxval=1.0) + ... minval=0.0, maxval=1.0) >>> random_uniform_tensor @@ -5724,7 +5724,7 @@ def random_binomial(shape, p=0.0, dtype=None, seed=None): Example: >>> random_binomial_tensor = tf.keras.backend.random_binomial(shape=(2,3), - p=0.5) + ... p=0.5) >>> random_binomial_tensor From b28cbd90877456ea3f3407a475d40301ce1a9251 Mon Sep 17 00:00:00 2001 From: Ir1d Date: Fri, 20 Mar 2020 09:27:36 +0800 Subject: [PATCH 5/5] use correct indent for multiline doctest --- tensorflow/python/keras/backend.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tensorflow/python/keras/backend.py b/tensorflow/python/keras/backend.py index 428f1ff7acf..9859cc66184 100644 --- a/tensorflow/python/keras/backend.py +++ b/tensorflow/python/keras/backend.py @@ -5659,7 +5659,7 @@ def random_normal(shape, mean=0.0, stddev=1.0, dtype=None, seed=None): Example: >>> random_normal_tensor = tf.keras.backend.random_normal(shape=(2,3), - mean=0.0, stddev=1.0) + ... mean=0.0, stddev=1.0) >>> random_normal_tensor