Visualization of Computational Graph¶
As neural networks get larger and complicated, it gets much harder to confirm if their architectures are constructed properly.
Chainer supports visualization of computational graphs.
Users can generate computational graphs by invoking build_computational_graph()
. Generated computational graphs are dumped to specified format (Currently Dot Language is supported).
Basic usage is as follows:
import chainer.computational_graph as c
...
g = c.build_computational_graph(vs)
with open('path/to/output/file', 'w') as o:
o.write(g.dump())
where vs
is list of Variable
instances and g
is an instance of ComputationalGraph
.
This code generates the computational graph that are backward-reachable (i.e. reachable by repetition of steps backward) from at least one of vs
.
Here is an example of (a part of) the generated graph (inception(3a) in GoogLeNet). This example is from example/imagenet
.
-
chainer.computational_graph.
build_computational_graph
(outputs, remove_split=True, variable_style={'shape': 'octagon', 'style': 'filled', 'fillcolor': '#E0E0E0'}, function_style={'shape': 'record', 'style': 'filled', 'fillcolor': '#6495ED'}, rankdir='TB', remove_variable=False, show_name=True)[source]¶ Builds a graph of functions and variables backward-reachable from outputs.
Parameters: - outputs (list) – nodes from which the graph is constructed.
Each element of outputs must be either
Variable
object orFunction
object. - remove_split (bool) – It must be
True
. This argument is left for backward compatibility. - variable_style (dict) – Dot node style for variable. Possible keys are ‘shape’, ‘color’, ‘fillcolor’, ‘style’, and etc.
- function_style (dict) – Dot node style for function.
- rankdir (str) – Direction of the graph that must be TB (top to bottom), BT (bottom to top), LR (left to right) or RL (right to left).
- remove_variable (bool) – If True, :class:`~chainer.Variable`s are removed from the resulting computational graph. Only :class:`~chainer.Function`s are shown in the output.
- show_name (bool) – If True, the name attribute of each node is added to the label of the node. Default is True.
Returns: A graph consisting of nodes and edges that are backward-reachable from at least one of
outputs
.If
unchain_backward
was called in some variable in the computational graph before this function, backward step is stopped at this variable.For example, suppose that computational graph is as follows:
|--> f ---> y x --+ |--> g ---> z
Let
outputs = [y, z]
. Then the full graph is emitted.Next, let
outputs = [y]
. Note thatz
andg
are not backward-reachable fromy
. The resulting graph would be following:x ---> f ---> y
See
TestGraphBuilder
for details.Return type: Note
The default behavior of
ComputationalGraph
has been changed from v1.23.0, so that it ouputs the richest representation of a graph as default, namely, styles are set and names of functions and variables are shown. To reproduce the same result as previous versions (<= v1.22.0), please specify variable_style=None, function_style=None, and show_name=False explicitly.- outputs (list) – nodes from which the graph is constructed.
Each element of outputs must be either
-
class
chainer.computational_graph.
ComputationalGraph
(nodes, edges, variable_style={'shape': 'octagon', 'style': 'filled', 'fillcolor': '#E0E0E0'}, function_style={'shape': 'record', 'style': 'filled', 'fillcolor': '#6495ED'}, rankdir='TB', remove_variable=False, show_name=True)[source]¶ Class that represents computational graph.
Note
We assume that the computational graph is directed and acyclic.
Parameters: - nodes (list) – List of nodes. Each node is either
Variable
object orFunction
object. - edges (list) – List of edges. Each edge consists of pair of nodes.
- variable_style (dict) – Dot node style for variable.
- function_style (dict) – Dot node style for function.
- rankdir (str) – Direction of the graph that must be TB (top to bottom), BT (bottom to top), LR (left to right) or RL (right to left).
- remove_variable (bool) – If True, :class:`~chainer.Variable`s are removed from the resulting computational graph. Only :class:`~chainer.Function`s are shown in the output.
- show_name (bool) – If True, the name attribute of each node is added to the label of the node. Default is True.
Note
The default behavior of
ComputationalGraph
has been changed from v1.23.0, so that it ouputs the richest representation of a graph as default, namely, styles are set and names of functions and variables are shown. To reproduce the same result as previous versions (<= v1.22.0), please specify variable_style=None, function_style=None, and show_name=False explicitly.- nodes (list) – List of nodes. Each node is either