diff options
author | A. Unique TensorFlower <gardener@tensorflow.org> | 2017-02-08 04:36:05 -0800 |
---|---|---|
committer | TensorFlower Gardener <gardener@tensorflow.org> | 2017-02-08 04:51:44 -0800 |
commit | 15ff7b702788c0cf75bb8d5ce090f06490098cf7 (patch) | |
tree | 1e3f2c9de91603769965abfab927aae9334d1614 /tensorflow/g3doc | |
parent | aabc7972b94af5a678550427534d4fba7fda327c (diff) |
Update generated Python Op docs.
Change: 146896735
Diffstat (limited to 'tensorflow/g3doc')
5 files changed, 82 insertions, 6 deletions
diff --git a/tensorflow/g3doc/api_docs/python/functions_and_classes/shard0/tf_debug.watch_graph_with_blacklists.md b/tensorflow/g3doc/api_docs/python/functions_and_classes/shard0/tf_debug.watch_graph_with_blacklists.md index 64e084af3d..72af627344 100644 --- a/tensorflow/g3doc/api_docs/python/functions_and_classes/shard0/tf_debug.watch_graph_with_blacklists.md +++ b/tensorflow/g3doc/api_docs/python/functions_and_classes/shard0/tf_debug.watch_graph_with_blacklists.md @@ -1,4 +1,4 @@ -### `tf_debug.watch_graph_with_blacklists(run_options, graph, debug_ops='DebugIdentity', debug_urls=None, node_name_regex_blacklist=None, op_type_regex_blacklist=None)` {#watch_graph_with_blacklists} +### `tf_debug.watch_graph_with_blacklists(run_options, graph, debug_ops='DebugIdentity', debug_urls=None, node_name_regex_blacklist=None, op_type_regex_blacklist=None, global_step=-1)` {#watch_graph_with_blacklists} Add debug tensor watches, blacklisting nodes and op types. @@ -26,4 +26,6 @@ N.B.: Under certain circumstances, not all specified `Tensor`s will be relation. In other words, a node will be excluded if it hits either of the two blacklists; a node will be included if and only if it hits neither of the blacklists. +* <b>`global_step`</b>: (`int`) Optional global_step count for this debug tensor + watch. diff --git a/tensorflow/g3doc/api_docs/python/functions_and_classes/shard3/tf_debug.add_debug_tensor_watch.md b/tensorflow/g3doc/api_docs/python/functions_and_classes/shard3/tf_debug.add_debug_tensor_watch.md index 91ce5083e5..1c79b12669 100644 --- a/tensorflow/g3doc/api_docs/python/functions_and_classes/shard3/tf_debug.add_debug_tensor_watch.md +++ b/tensorflow/g3doc/api_docs/python/functions_and_classes/shard3/tf_debug.add_debug_tensor_watch.md @@ -1,4 +1,4 @@ -### `tf_debug.add_debug_tensor_watch(run_options, node_name, output_slot=0, debug_ops='DebugIdentity', debug_urls=None)` {#add_debug_tensor_watch} +### `tf_debug.add_debug_tensor_watch(run_options, node_name, output_slot=0, debug_ops='DebugIdentity', debug_urls=None, global_step=-1)` {#add_debug_tensor_watch} Add watch on a `Tensor` to `RunOptions`. @@ -16,4 +16,6 @@ N.B.: Under certain circumstances, the `Tensor` may not be actually watched `list` of `str` with only one element. * <b>`debug_urls`</b>: (`str` or `list` of `str`) URL(s) to send debug values to, e.g., `file:///tmp/tfdbg_dump_1`, `grpc://localhost:12345`. +* <b>`global_step`</b>: (`int`) Optional global_step count for this debug tensor + watch. diff --git a/tensorflow/g3doc/api_docs/python/functions_and_classes/shard4/tf_debug.DebugDumpDir.md b/tensorflow/g3doc/api_docs/python/functions_and_classes/shard4/tf_debug.DebugDumpDir.md index 6a7a6088c9..4b60562c32 100644 --- a/tensorflow/g3doc/api_docs/python/functions_and_classes/shard4/tf_debug.DebugDumpDir.md +++ b/tensorflow/g3doc/api_docs/python/functions_and_classes/shard4/tf_debug.DebugDumpDir.md @@ -25,6 +25,38 @@ in a tfdbg dump root directory. - - - +#### `tf_debug.DebugDumpDir.core_metadata` {#DebugDumpDir.core_metadata} + +Metadata about the `Session.run()` call from the core runtime. + +Of the three counters available in the return value, `global_step` is +supplied by the caller of the debugged `Session.run()`, while +`session_run_count` and `executor_step_count` are determined by the state +of the core runtime, automatically. For the same fetch list, feed keys and +debug tensor watch options, the same executor will be used and +`executor_step_count` should increase by one at a time. However, runs with +different fetch lists, feed keys and debug_tensor watch options that all +share the same `Session` object can lead to gaps in `session_run_count`. + +##### Returns: + + If core metadata are loaded, a `namedtuple` with the fields: + `global_step`: A global step count supplied by the caller of + `Session.run()`. It is optional to the caller. If the caller did not + supply this parameter, its value will be -1. + `session_run_count`: A counter for Run() calls to the underlying + TensorFlow `Session` object. + `executor_step_count`: A counter for invocations of a given runtime + executor. The same executor is re-used for the same fetched tensors, + target nodes, input feed keys and debug tensor watch options. + `input_names`: Names of the input (feed) Tensors. + `output_names`: Names of the output (fetched) Tensors. + `target_nodes`: Names of the target nodes. + If the core metadata have not been loaded, `None`. + + +- - - + #### `tf_debug.DebugDumpDir.debug_watch_keys(node_name)` {#DebugDumpDir.debug_watch_keys} Get all tensor watch keys of given node according to partition graphs. diff --git a/tensorflow/g3doc/api_docs/python/functions_and_classes/shard6/tf_debug.watch_graph.md b/tensorflow/g3doc/api_docs/python/functions_and_classes/shard6/tf_debug.watch_graph.md index 94f3489f06..5f206435bd 100644 --- a/tensorflow/g3doc/api_docs/python/functions_and_classes/shard6/tf_debug.watch_graph.md +++ b/tensorflow/g3doc/api_docs/python/functions_and_classes/shard6/tf_debug.watch_graph.md @@ -1,4 +1,4 @@ -### `tf_debug.watch_graph(run_options, graph, debug_ops='DebugIdentity', debug_urls=None, node_name_regex_whitelist=None, op_type_regex_whitelist=None)` {#watch_graph} +### `tf_debug.watch_graph(run_options, graph, debug_ops='DebugIdentity', debug_urls=None, node_name_regex_whitelist=None, op_type_regex_whitelist=None, global_step=-1)` {#watch_graph} Add debug watches to `RunOptions` for a TensorFlow graph. @@ -27,4 +27,6 @@ N.B.: Under certain circumstances, not all specified `Tensor`s will be are set, the two filtering operations will occur in a logical `AND` relation. In other words, a node will be included if and only if it hits both whitelists. +* <b>`global_step`</b>: (`int`) Optional global_step count for this debug tensor + watch. diff --git a/tensorflow/g3doc/api_docs/python/tf_debug.md b/tensorflow/g3doc/api_docs/python/tf_debug.md index fb5e10fb7d..3e0cc273bf 100644 --- a/tensorflow/g3doc/api_docs/python/tf_debug.md +++ b/tensorflow/g3doc/api_docs/python/tf_debug.md @@ -12,7 +12,7 @@ be watched when the TensorFlow graph is executed at runtime. - - - -### `tf_debug.add_debug_tensor_watch(run_options, node_name, output_slot=0, debug_ops='DebugIdentity', debug_urls=None)` {#add_debug_tensor_watch} +### `tf_debug.add_debug_tensor_watch(run_options, node_name, output_slot=0, debug_ops='DebugIdentity', debug_urls=None, global_step=-1)` {#add_debug_tensor_watch} Add watch on a `Tensor` to `RunOptions`. @@ -30,11 +30,13 @@ N.B.: Under certain circumstances, the `Tensor` may not be actually watched `list` of `str` with only one element. * <b>`debug_urls`</b>: (`str` or `list` of `str`) URL(s) to send debug values to, e.g., `file:///tmp/tfdbg_dump_1`, `grpc://localhost:12345`. +* <b>`global_step`</b>: (`int`) Optional global_step count for this debug tensor + watch. - - - -### `tf_debug.watch_graph(run_options, graph, debug_ops='DebugIdentity', debug_urls=None, node_name_regex_whitelist=None, op_type_regex_whitelist=None)` {#watch_graph} +### `tf_debug.watch_graph(run_options, graph, debug_ops='DebugIdentity', debug_urls=None, node_name_regex_whitelist=None, op_type_regex_whitelist=None, global_step=-1)` {#watch_graph} Add debug watches to `RunOptions` for a TensorFlow graph. @@ -63,11 +65,13 @@ N.B.: Under certain circumstances, not all specified `Tensor`s will be are set, the two filtering operations will occur in a logical `AND` relation. In other words, a node will be included if and only if it hits both whitelists. +* <b>`global_step`</b>: (`int`) Optional global_step count for this debug tensor + watch. - - - -### `tf_debug.watch_graph_with_blacklists(run_options, graph, debug_ops='DebugIdentity', debug_urls=None, node_name_regex_blacklist=None, op_type_regex_blacklist=None)` {#watch_graph_with_blacklists} +### `tf_debug.watch_graph_with_blacklists(run_options, graph, debug_ops='DebugIdentity', debug_urls=None, node_name_regex_blacklist=None, op_type_regex_blacklist=None, global_step=-1)` {#watch_graph_with_blacklists} Add debug tensor watches, blacklisting nodes and op types. @@ -95,6 +99,8 @@ N.B.: Under certain circumstances, not all specified `Tensor`s will be relation. In other words, a node will be excluded if it hits either of the two blacklists; a node will be included if and only if it hits neither of the blacklists. +* <b>`global_step`</b>: (`int`) Optional global_step count for this debug tensor + watch. @@ -286,6 +292,38 @@ in a tfdbg dump root directory. - - - +#### `tf_debug.DebugDumpDir.core_metadata` {#DebugDumpDir.core_metadata} + +Metadata about the `Session.run()` call from the core runtime. + +Of the three counters available in the return value, `global_step` is +supplied by the caller of the debugged `Session.run()`, while +`session_run_count` and `executor_step_count` are determined by the state +of the core runtime, automatically. For the same fetch list, feed keys and +debug tensor watch options, the same executor will be used and +`executor_step_count` should increase by one at a time. However, runs with +different fetch lists, feed keys and debug_tensor watch options that all +share the same `Session` object can lead to gaps in `session_run_count`. + +##### Returns: + + If core metadata are loaded, a `namedtuple` with the fields: + `global_step`: A global step count supplied by the caller of + `Session.run()`. It is optional to the caller. If the caller did not + supply this parameter, its value will be -1. + `session_run_count`: A counter for Run() calls to the underlying + TensorFlow `Session` object. + `executor_step_count`: A counter for invocations of a given runtime + executor. The same executor is re-used for the same fetched tensors, + target nodes, input feed keys and debug tensor watch options. + `input_names`: Names of the input (feed) Tensors. + `output_names`: Names of the output (fetched) Tensors. + `target_nodes`: Names of the target nodes. + If the core metadata have not been loaded, `None`. + + +- - - + #### `tf_debug.DebugDumpDir.debug_watch_keys(node_name)` {#DebugDumpDir.debug_watch_keys} Get all tensor watch keys of given node according to partition graphs. |