bce3dc4faada74771c938ce9303dcaad901c3e9b
[jacinto-ai/caffe-jacinto.git] / src / caffe / pyutil / drawnet.py
1 """Functions to draw a caffe NetParameter protobuffer.
2 """
4 import pydot
6 # Internal layer and blob styles.
7 LAYER_STYLE = {'shape': 'record', 'fillcolor': '#6495ED',
8          'style': 'filled,bold'}
9 NEURON_LAYER_STYLE = {'shape': 'record', 'fillcolor': '#90EE90',
10          'style': 'filled,bold'}
11 BLOB_STYLE = {'shape': 'octagon', 'fillcolor': '#F0E68C',
12         'style': 'filled'}
14 def get_pydot_graph(caffe_net):
15   pydot_graph = pydot.Dot(caffe_net.name, graph_type='digraph')
16   pydot_nodes = {}
17   pydot_edges = []
18   for layer in caffe_net.layers:
19     name = layer.layer.name
20     layertype = layer.layer.type
21     if (len(layer.bottom) == 1 and len(layer.top) == 1 and
22         layer.bottom[0] == layer.top[0]):
23       # We have an in-place neuron layer.
24       pydot_nodes[name + '_' + layertype] = pydot.Node(
25           '%s (%s)' % (name, layertype), **NEURON_LAYER_STYLE)
26     else:
27       pydot_nodes[name + '_' + layertype] = pydot.Node(
28           '%s (%s)' % (name, layertype), **LAYER_STYLE)
29     for bottom_blob in layer.bottom:
30       pydot_nodes[bottom_blob + '_blob'] = pydot.Node(
31         '%s' % (bottom_blob), **BLOB_STYLE)
32       pydot_edges.append((bottom_blob + '_blob', name + '_' + layertype))
33     for top_blob in layer.top:
34       pydot_nodes[top_blob + '_blob'] = pydot.Node(
35         '%s' % (top_blob))
36       pydot_edges.append((name + '_' + layertype, top_blob + '_blob'))
37   # Now, add the nodes and edges to the graph.
38   for node in pydot_nodes.values():
39     pydot_graph.add_node(node)
40   for edge in pydot_edges:
41     pydot_graph.add_edge(
42         pydot.Edge(pydot_nodes[edge[0]], pydot_nodes[edge[1]]))
43   return pydot_graph
45 def draw_net(caffe_net, ext='png'):
46   """Draws a caffe net and returns the image string encoded using the given
47   extension.
49   Input:
50     caffe_net: a caffe.proto.caffe_pb2.NetParameter protocol buffer.
51     ext: the image extension. Default 'png'.
52   """
53   return get_pydot_graph(caffe_net).create(format=ext)
55 def draw_net_to_file(caffe_net, filename):
56   """Draws a caffe net, and saves it to file using the format given as the
57   file extension. Use '.raw' to output raw text that you can manually feed
58   to graphviz to draw graphs.
59   """
60   ext = filename[filename.rfind('.')+1:]
61   with open(filename, 'w') as fid:
62     fid.write(draw_net(caffe_net, ext))