Subversion Repositories nocmodel

#!/usr/bin/env python
# -*- coding: utf-8 -*-
 
#
# Support for graphical representation of NoC objects
#
# Author:  Oscar Diaz
# Version: 0.1
# Date:    03-03-2011
 
#
# This code is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This code is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the
# Free Software  Foundation, Inc., 59 Temple Place, Suite 330,
# Boston, MA  02111-1307  USA
#
 
#
# Changelog:
#
# 03-03-2011 : (OD) initial release
#
 
"""
================
NoCmodel Graphic utilities
================
 
This module declares functions to draw graphical representations of 
NoCmodel objects.
 
"""
try:
    import matplotlib.pyplot as plt
    has_matplotlib = True
except:
    print("Matplotlib package not found. Drawing functions will not work.")
    has_matplotlib = False
 
import networkx as nx
import warnings
 
from noc_base import *
 
def draw_noc(noc, rectangular=True, nodepos=None):
    """
    Draw a representation of a NoC
 
    Arguments:
    * noc: Model to draw
    * rectangular: If True assumes rectangular layout, with routers 
      having coord_x and coord_y attributes. If false, expect router's 
      positions in nodepos argument
    * nodepos: Optional dictionary where keys are router's indexes and values 
      are tuples with x and y positions.
    """
    if not has_matplotlib:
        warnings.warn("Function not available")
        return None
 
    # node positions
    if rectangular:
        if nodepos == None:
            nodepos = {}
            for i in noc.router_list():
                nodepos[i.index] = (i.coord_x, i.coord_y)
    else:
        if nodepos == None:
            raise ValueError("For non-rectangular layouts this function needs argument 'nodepos'")
 
    # some parameters
    ip_relpos = (-0.3, 0.3) # relative to router
    # node labels
    nodelabels = {}
    for i in nodepos.iterkeys():
        nodelabels[i] = noc.node[i]["router_ref"].name
 
    # channel positions
    chpos = {}
    for i in noc.channel_list():
        ep = i.endpoints
        ep_1x = nodepos[ep[0].index][0]
        ep_1y = nodepos[ep[0].index][1]
        ep_2x = nodepos[ep[1].index][0]
        ep_2y = nodepos[ep[1].index][1]
        thepos = (ep_2x + ((ep_1x - ep_2x)/2.0), ep_2y + ((ep_1y - ep_2y)/2.0))
        chpos[i.index] = {"pos": thepos, "text": i.name}
 
    # start drawing
    nx.draw_networkx_nodes(noc, pos=nodepos, node_size=1000, node_color="blue", alpha=0.5)
    nx.draw_networkx_edges(noc, pos=nodepos, edge_color="black", alpha=1.0, width=3.0)
    nx.draw_networkx_labels(noc, pos=nodepos, labels=nodelabels, font_color="red")
 
    ax=plt.gca()
    # channel labels
    for i in chpos.itervalues():
        ax.text(i["pos"][0], i["pos"][1], i["text"], horizontalalignment="center", verticalalignment="top", bbox=dict(facecolor='red', alpha=0.2))
 
    # ipcore with channels and labels
    for i in noc.ipcore_list():
        thepos = nodepos[i.router_ref.index]
        # channel
        ax.arrow(thepos[0], thepos[1], ip_relpos[0], ip_relpos[1])
        # ip channel label
        ax.text(thepos[0]+(ip_relpos[0]/2), thepos[1]+(ip_relpos[1]/2), i.channel_ref.name, horizontalalignment="center", bbox=dict(facecolor='red', alpha=0.2))
        # box with ipcore labels
        ax.text(thepos[0]+ip_relpos[0], thepos[1]+ip_relpos[1], i.name, horizontalalignment="center", bbox=dict(facecolor='green', alpha=0.2))
 
    # adjust axis TODO!
    plt.show()