barchart.py revision 2117 
1# Copyright (c) 2005-2006 The Regents of The University of Michigan
2# All rights reserved.
3#
4# Redistribution and use in source and binary forms, with or without
5# modification, are permitted provided that the following conditions are
6# met: redistributions of source code must retain the above copyright
7# notice, this list of conditions and the following disclaimer;
8# redistributions in binary form must reproduce the above copyright
9# notice, this list of conditions and the following disclaimer in the
10# documentation and/or other materials provided with the distribution;
11# neither the name of the copyright holders nor the names of its
12# contributors may be used to endorse or promote products derived from
13# this software without specific prior written permission.
14#
15# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
18# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
19# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
21# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
25# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26#
27# Authors: Nathan Binkert
28#          Lisa Hsu
29
30import matplotlib, pylab
31from matplotlib.font_manager import FontProperties
32from matplotlib.numerix import array, arange, reshape, shape, transpose, zeros
33from matplotlib.numerix import Float
34
35matplotlib.interactive(False)
36
37from chart import ChartOptions
38
39class BarChart(ChartOptions):
40    def __init__(self, default=None, **kwargs):
41        super(BarChart, self).__init__(default, **kwargs)
42        self.inputdata = None
43        self.chartdata = None
44
45    def gen_colors(self, count):
46        cmap = matplotlib.cm.get_cmap(self.colormap)
47        if count == 1:
48            return cmap([ 0.5 ])
49        else:
50            return cmap(arange(count) / float(count - 1))
51
52    # The input data format does not match the data format that the
53    # graph function takes because it is intuitive.  The conversion
54    # from input data format to chart data format depends on the
55    # dimensionality of the input data.  Check here for the
56    # dimensionality and correctness of the input data
57    def set_data(self, data):
58        if data is None:
59            self.inputdata = None
60            self.chartdata = None
61            return
62
63        data = array(data)
64        dim = len(shape(data))
65        if dim not in (1, 2, 3):
66            raise AttributeError, "Input data must be a 1, 2, or 3d matrix"
67        self.inputdata = data
68
69        # If the input data is a 1d matrix, then it describes a
70        # standard bar chart.
71        if dim == 1:
72            self.chartdata = array([[data]])
73
74        # If the input data is a 2d matrix, then it describes a bar
75        # chart with groups. The matrix being an array of groups of
76        # bars.
77        if dim == 2:
78            self.chartdata = transpose([data], axes=(2,0,1))
79            print shape(self.chartdata)
80
81        # If the input data is a 3d matrix, then it describes an array
82        # of groups of bars with each bar being an array of stacked
83        # values.
84        if dim == 3:
85            self.chartdata = transpose(data, axes=(1,2,0))
86            print shape(self.chartdata)
87
88    def get_data(self):
89        return self.inputdata
90
91    data = property(get_data, set_data)
92
93    # Graph the chart data.
94    # Input is a 3d matrix that describes a plot that has multiple
95    # groups, multiple bars in each group, and multiple values stacked
96    # in each bar.  The underlying bar() function expects a sequence of
97    # bars in the same stack location and same group location, so the
98    # organization of the matrix is that the inner most sequence
99    # represents one of these bar groups, then those are grouped
100    # together to make one full stack of bars in each group, and then
101    # the outer most layer describes the groups.  Here is an example
102    # data set and how it gets plotted as a result.
103    #
104    # e.g. data = [[[10,11,12], [13,14,15],  [16,17,18], [19,20,21]],
105    #              [[22,23,24], [25,26,27],  [28,29,30], [31,32,33]]]
106    #
107    # will plot like this:
108    #
109    #    19 31    20 32    21 33
110    #    16 28    17 29    18 30
111    #    13 25    14 26    15 27
112    #    10 22    11 23    12 24
113    #
114    # Because this arrangement is rather conterintuitive, the rearrange
115    # function takes various matricies and arranges them to fit this
116    # profile.
117    #
118    # This code deals with one of the dimensions in the matrix being
119    # one wide.
120    #
121    def graph(self):
122        if self.chartdata is None:
123            raise AttributeError, "Data not set for bar chart!"
124
125        need_subticks = True
126
127        dim = len(shape(self.inputdata))
128        cshape = shape(self.chartdata)
129        print cshape
130        if dim == 1:
131            colors = self.gen_colors(cshape[2])
132            colors = [ [ colors ] * cshape[1] ] * cshape[0]
133            need_subticks = False
134
135        if dim == 2:
136            colors = self.gen_colors(cshape[0])
137            colors = [ [ [ c ] * cshape[2] ] * cshape[1] for c in colors ]
138
139        if dim == 3:
140            colors = self.gen_colors(cshape[1])
141            colors = [ [ [ c ] * cshape[2] for c in colors ] ] * cshape[0]
142
143        colors = array(colors)
144
145        self.figure = pylab.figure(figsize=self.chart_size)
146
147        outer_axes = None
148        inner_axes = None
149        if need_subticks:
150            self.metaaxes = self.figure.add_axes(self.figure_size)
151            self.metaaxes.set_yticklabels([])
152            self.metaaxes.set_yticks([])
153            size = [0] * 4
154            size[0] = self.figure_size[0]
155            size[1] = self.figure_size[1] + .075
156            size[2] = self.figure_size[2]
157            size[3] = self.figure_size[3] - .075
158            self.axes = self.figure.add_axes(size)
159            outer_axes = self.metaaxes
160            inner_axes = self.axes
161        else:
162            self.axes = self.figure.add_axes(self.figure_size)
163            outer_axes = self.axes
164            inner_axes = self.axes
165
166        bars_in_group = len(self.chartdata)
167        if bars_in_group < 5:
168            width = 1.0 / ( bars_in_group + 1)
169            center = width / 2
170        else:
171            width = .8 / bars_in_group
172            center = .1
173
174        bars = []
175        for i,stackdata in enumerate(self.chartdata):
176            bottom = array([0.0] * len(stackdata[0]), Float)
177            stack = []
178            for j,bardata in enumerate(stackdata):
179                bardata = array(bardata)
180                ind = arange(len(bardata)) + i * width + center
181                bar = self.axes.bar(ind, bardata, width, bottom=bottom,
182                                    color=colors[i][j])
183                if dim != 1:
184                    self.metaaxes.bar(ind, [0] * len(bardata), width)
185                stack.append(bar)
186                bottom += bardata
187            bars.append(stack)
188
189        if self.xlabel is not None:
190            outer_axes.set_xlabel(self.xlabel)
191
192        if self.ylabel is not None:
193            inner_axes.set_ylabel(self.ylabel)
194
195        if self.yticks is not None:
196            ymin, ymax = self.axes.get_ylim()
197            nticks = float(len(self.yticks))
198            ticks = arange(nticks) / (nticks - 1) * (ymax - ymin)  + ymin
199            inner_axes.set_yticks(ticks)
200            inner_axes.set_yticklabels(self.yticks)
201        elif self.ylim is not None:
202            self.inner_axes.set_ylim(self.ylim)
203
204        if self.xticks is not None:
205            outer_axes.set_xticks(arange(cshape[2]) + .5)
206            outer_axes.set_xticklabels(self.xticks)
207        if self.xsubticks is not None:
208            inner_axes.set_xticks(arange((cshape[0] + 1)*cshape[2])*width + 2*center)
209            self.xsubticks.append('')
210            inner_axes.set_xticklabels(self.xsubticks * cshape[0], fontsize=8)
211        if self.legend is not None:
212            if dim == 1:
213                lbars = bars[0][0]
214            if dim == 2:
215                lbars = [ bars[i][0][0] for i in xrange(len(bars))]
216            if dim == 3:
217                number = len(bars[0])
218                lbars = [ bars[0][number - j - 1][0] for j in xrange(number)]
219
220            self.figure.legend(lbars, self.legend, self.legend_loc,
221                               prop=FontProperties(size=self.legend_size))
222
223        if self.title is not None:
224            self.axes.set_title(self.title)
225
226    def savefig(self, name):
227        self.figure.savefig(name)
228
229    def savecsv(self, name):
230        f = file(name, 'w')
231        data = array(self.inputdata)
232        dim = len(data.shape)
233
234        if dim == 1:
235            #if self.xlabel:
236            #    f.write(', '.join(list(self.xlabel)) + '\n')
237            f.write(', '.join([ '%f' % val for val in data]) + '\n')
238        if dim == 2:
239            #if self.xlabel:
240            #    f.write(', '.join([''] + list(self.xlabel)) + '\n')
241            for i,row in enumerate(data):
242                ylabel = []
243                #if self.ylabel:
244                #    ylabel = [ self.ylabel[i] ]
245                f.write(', '.join(ylabel + [ '%f' % val for val in row]) + '\n')
246        if dim == 3:
247            f.write("don't do 3D csv files\n")
248            pass
249
250        f.close()
251
252if __name__ == '__main__':
253    from random import randrange
254    import random, sys
255
256    dim = 3
257    number = 5
258
259    args = sys.argv[1:]
260    if len(args) > 3:
261        sys.exit("invalid number of arguments")
262    elif len(args) > 0:
263        myshape = [ int(x) for x in args ]
264    else:
265        myshape = [ 3, 4, 8 ]
266
267    # generate a data matrix of the given shape
268    size = reduce(lambda x,y: x*y, myshape)
269    #data = [ random.randrange(size - i) + 10 for i in xrange(size) ]
270    data = [ float(i)/100.0 for i in xrange(size) ]
271    data = reshape(data, myshape)
272
273    # setup some test bar charts
274    if True:
275        chart1 = BarChart()
276        chart1.data = data
277
278        chart1.xlabel = 'Benchmark'
279        chart1.ylabel = 'Bandwidth (GBps)'
280        chart1.legend = [ 'x%d' % x for x in xrange(myshape[-1]) ]
281        chart1.xticks = [ 'xtick%d' % x for x in xrange(myshape[0]) ]
282        chart1.title = 'this is the title'
283        chart1.figure_size = [0.1, 0.2, 0.7, 0.85 ]
284        if len(myshape) > 1:
285            chart1.xsubticks = [ '%d' % x for x in xrange(myshape[1]) ]
286        chart1.graph()
287        chart1.savefig('/tmp/test1.png')
288        chart1.savefig('/tmp/test1.ps')
289        chart1.savefig('/tmp/test1.eps')
290        chart1.savecsv('/tmp/test1.csv')
291
292    if False:
293        chart2 = BarChart()
294        chart2.data = data
295        chart2.colormap = 'gray'
296        chart2.graph()
297        chart2.savefig('/tmp/test2.png')
298        chart2.savefig('/tmp/test2.ps')
299
300    pylab.myshow()
301