diff options
Diffstat (limited to 'tensorflow/g3doc/how_tos/graph_viz/index.md')
| -rw-r--r-- | tensorflow/g3doc/how_tos/graph_viz/index.md | 26 |
1 files changed, 16 insertions, 10 deletions
diff --git a/tensorflow/g3doc/how_tos/graph_viz/index.md b/tensorflow/g3doc/how_tos/graph_viz/index.md index 81c4a9f247..ece21ed342 100644 --- a/tensorflow/g3doc/how_tos/graph_viz/index.md +++ b/tensorflow/g3doc/how_tos/graph_viz/index.md @@ -9,7 +9,13 @@ To see your own graph, run TensorBoard pointing it to the log directory of the j ## Name scoping and nodes <a class="md-anchor" id="AUTOGENERATED-name-scoping-and-nodes"></a> -Typical TensorFlow graphs can have many thousands of nodes--far too many to see easily all at once, or even to lay out using standard graph tools. To simplify, variable's name can be scoped and the visualization uses this information to define a hierarchy structure on the nodes in the graph, and by default only shows the top of this hierarchy. Here is an example that defines three operations under the `hidden` name scope using [`tf.name_scope()`](https://tensorflow.org/api_docs/python/framework.html?cl=head#name_scope): +Typical TensorFlow graphs can have many thousands of nodes--far too many to see +easily all at once, or even to lay out using standard graph tools. To simplify, +variable names can be scoped and the visualization uses this information to +define a hierarchy on the nodes in the graph. By default, only the top of this +hierarchy is shown. Here is an example that defines three operations under the +`hidden` name scope using +[`tf.name_scope`](../../api_docs/python/framework.md#name_scope): ```python import tensorflow as tf @@ -26,10 +32,10 @@ This results in the following three op names: * *hidden*/weights * *hidden*/biases -The visualization will, by default, collapse all three into a node labeled `hidden`. +By default, the visualization will collapse all three into a node labeled `hidden`. The extra detail isn't lost. You can double-click, or click on the orange `+` sign in the top right to expand the node, and then you'll see -three subnodes, for `alpha`, `weights` and `biases`. +three subnodes for `alpha`, `weights` and `biases`. Here's a real-life example of a more complicated node in its initial and expanded states. @@ -72,8 +78,8 @@ between the `init` node and its dependencies would create a very cluttered view. To reduce clutter, the visualization separates out all high-degree nodes to an -"auxiliary" area on the right and doesn't draw lines to represent their edges. -Instead of lines, we draw small "node icons" to indicate the connections. +*auxiliary* area on the right and doesn't draw lines to represent their edges. +Instead of lines, we draw small *node icons* to indicate the connections. Separating out the auxiliary nodes typically doesn't remove critical information since these nodes are usually related to bookkeeping functions. @@ -96,9 +102,9 @@ information since these nodes are usually related to bookkeeping functions. </tr> </table> -One last structural simplification is "series collapsing". Sequential +One last structural simplification is *series collapsing*. Sequential motifs--that is, nodes whose names differ by a number at the end and have -isomorphic structures--are collapsed into a single "stack" of nodes, as shown +isomorphic structures--are collapsed into a single *stack* of nodes, as shown below. For networks with long sequences, this greatly simplifies the view. As with hierarchical nodes, double-clicking expands the series. @@ -126,7 +132,7 @@ for constants and summary nodes. To summarize, here's a table of node symbols: Symbol | Meaning --- | --- - | "High-level" node representing a name scope. Double-click to expand a high-level node. + | *High-level* node representing a name scope. Double-click to expand a high-level node.  | Sequence of numbered nodes that are not connected to each other.  | Sequence of numbered nodes that are connected to each other.  | An individual operation node. @@ -169,7 +175,7 @@ right corner of the visualization. </table> Selection can also be helpful in understanding high-degree nodes. Select any -high-degree node, and the corresponding "node icons" for its other connections +high-degree node, and the corresponding node icons for its other connections will be selected as well. This makes it easy, for example, to see which nodes are being saved--and which aren't. @@ -177,7 +183,7 @@ Clicking on a node name in the info card will select it. If necessary, the viewpoint will automatically pan so that the node is visible. Finally, you can choose two color schemes for your graph, using the color menu -above the legend. The default "Structure View" shows structure: when two +above the legend. The default *Structure View* shows structure: when two high-level nodes have the same structure, they appear in the same color of the rainbow. Uniquely structured nodes are gray. There's a second view, which shows what device the different operations run on. Name scopes are colored |