#
# Copyright (C) 2000-2005 by Yasushi Saito (yasushi.saito@gmail.com)
# 
# Jockey is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by the
# Free Software Foundation; either version 2, or (at your option) any
# later version.
#
# Jockey 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 General Public License
# for more details.
#
import canvas
import fill_style
import line_style
import pychart_util
import chart_object
import legend
import font
import color
from pychart_types import *

class T(chart_object.T):
    """Plots sector diagram which can be superimposed on one another.
    Sector diagrams are also known as wind roses"""
    keys = {
        "start_angle" : (NumberType, 90, ""), # top of chart (north)
	"center" : (CoordType, None, ""),
	"base_radius" : (NumberType, None, ""),
	"line_style" : (line_style.T, line_style.T(color=color.black, width=0.3), ""),
        "fill_styles" : (list, fill_style.standards.list()[:],
                         """The fill style of each item. The length of the
                         list should be equal to the length of the data.
                         """),
	"sector_centred":(int, 1,
			  """Bool indicating whether the sectors should be centred on each sector_width(e.g. on 0)"""),
	"dir_offset":  (UnitType, None,
			"""The distance between the directions and the outermost circle. Defaults fine for most cases"""),
        "data" : (AnyType, None, pychart_util.data_desc),
        "label_col" : (int, 0,
                       """The column, within "data", from which the labels of items are retrieved."""),
        "data_col": (int, 1,
                     """ The column, within "data", from which the data values are retrieved."""),
        "dir_line_style": (line_style.T, None, ""),
        "dir_fill_style": (fill_style.T, fill_style.default, ""),
	"shadow": (ShadowType, None, pychart_util.shadow_desc),
	"sector_width": (int, None, ""), # automatically generated
        }

    def __init__(self, colour=True, **args):
        chart_object.T.init(self, args)
	if colour:
  	    # the theme.color flag does not seem to affect the fill_style.standards,
	    #besides, I want the first two colors to resemble those of gnuplot's postscript terminal
  	    self.fill_styles = [fill_style.Plain(bgcolor=color.red),
				fill_style.Plain(bgcolor=color.green),
				fill_style.Plain(bgcolor=color.blue),
				fill_style.Plain(bgcolor=color.magenta)]

    def check_integrity(self):
        nSectors = len(self.data[0][self.data_col])
        if (360%nSectors != 0):
            raise Exception('Length of dataset ' + str(nSectors) + ' not a divisor of 360 degrees!')
        for dataset in self.data:
            length = len(dataset[self.data_col])
            if length != nSectors:
                raise Exception('Lengths of datasets given is different!')
            for val in dataset[self.data_col]:
                if (val < 0) | (val > 1):
                    raise Exception('Data value ' + str(val) + ' not between 0 and 1!')
        self.sector_width = 360/nSectors
        chart_object.T.check_integrity(self)

    def get_data_range(self, which):
        return (0, 1)

    def get_legend_entry(self):
        legends = []
        i = 0
        for dataset in self.data:
            fill = self.fill_styles[i]
            i = (i + 1) % len(self.fill_styles)
            legends.append(legend.Entry(line_style=self.line_style,
                                    fill_style=fill,
                                    label=dataset[self.label_col]))
        return legends

    def draw(self, ar, can):
        center = self.center
        if not center:
            center = (ar.loc[0] + ar.size[0]/2.0,
                            ar.loc[1] + ar.size[1]/2.0)
        base_radius = self.base_radius # the maximum radius of a wedge
        if not base_radius:
            base_radius = min(ar.size[0]/2.0, ar.size[1]/2.0) #* 0.8

        sector_decrement = 1./(len(self.data)*2) * self.sector_width # each following sector diagram will have its sector width decremented by half this amount (in degrees)
        i = 0
        for dataset in self.data:
            cur_angle = self.start_angle
            if self.sector_centred:
                cur_angle -= self.sector_width/2.
            fill = self.fill_styles[i]
            x_center = center[0]
            y_center = center[1]

            if not i: # draw directions around sector diagram once off
                dir_offset = base_radius + (self.dir_offset or base_radius * 0.04)
                directions = ['N', 'E', 'S', 'W']
                angle = self.start_angle

                can.ellipsis(line_style.T(color=color.black, width=0.3, dash=line_style.dash1), None,
                             x_center, y_center, base_radius, 1,
                             0, 360) #

                for d in directions:
                    x_label, y_label = pychart_util.rotate(dir_offset, 0, angle) # coords for bottom left corner of box
                    tw = font.text_width(d)
                    half = 1/3. # normal arithmetic does not seem to apply to these text_box objects...
                    if (angle == 0): # east
                        y_label -= font.text_height(d)[0]*half # move down half
                    elif (angle == -180): # west
                        y_label -= font.text_height(d)[0]*half # move down half
                        x_label -= font.text_width(d) # move left full
                    elif (angle == 90): # north
                        x_label -= font.text_height(d)[0]*half # move left half
                    elif (angle == -90): # south
                        y_label -= font.text_height(d)[0]*.8 # move down (couldn't figure out how to set this dynamically so I fudged...)
                        x_label -= font.text_height(d)[0]*half # move left half
                    canvas.show(x_label + x_center, y_label + y_center, d)
                    angle -= 360/len(directions)

            for val in dataset[self.data_col]: # now draw the sectors
                radius = base_radius*val # scale the radius
                start = cur_angle-self.sector_width+i*sector_decrement
                stop = cur_angle-i*sector_decrement # these may seem confusing, but remember that we need to go counterclockwise

                can.ellipsis(self.line_style, fill,
                             x_center, y_center, radius, 1, start, stop, self.shadow) 
                cur_angle = (cur_angle - self.sector_width) % 360 # we want to go in anticlockwise direction (North, West, South, etc. as in meteorology)
            i = (i + 1) % len(self.fill_styles)