/[thuban]/branches/WIP-pyshapelib-bramz/Thuban/Model/classgen.py
ViewVC logotype

Diff of /branches/WIP-pyshapelib-bramz/Thuban/Model/classgen.py

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 886 by jonathan, Fri May 9 16:36:56 2003 UTC revision 1759 by bh, Fri Sep 26 18:36:01 2003 UTC
# Line 5  Line 5 
5  # This program is free software under the GPL (>=v2)  # This program is free software under the GPL (>=v2)
6  # Read the file COPYING coming with Thuban for details.  # Read the file COPYING coming with Thuban for details.
7    
8    """
9    Functions to generate Classifications
10    """
11    
12    __version__ = "$Revision$"
13    # $Source$
14    # $Id$
15    
16  import operator  import operator
17    
18  from color import Color  from color import Color, Transparent
19  from range import Range  from range import Range
20  from classification import Classification, ClassGroupSingleton, \  from classification import Classification, ClassGroupSingleton, \
21      ClassGroupRange, ClassGroupProperties      ClassGroupRange, ClassGroupProperties
22    
23  class ClassGenerator:  def generate_singletons(_list, ramp):
24        """Generate a new classification consisting solely of singletons.
25    
26      def GenSingletonsFromList(self, list, numGroups, ramp):      The resulting classification will consist of one group for each
27          """Generate a new classification consisting solely of singletons.      item in _list whose properties ramp between 'prop1' and 'prop2'.
28    
29          The resulting classification will consist of at most 'numGroups'      _list -- a list of values for each singleton
         groups whose group properties ramp between 'prop1' and 'prop2'. There  
         could be fewer groups if 'list' contains fewer that 'numGroups' items.  
30    
31          list -- any object that implements the iterator interface      ramp -- an object which implements the CustomRamp interface
32        """
33    
34          numGroups -- how many groups to generate. This can not be      clazz = Classification()
                      determined while the classification is being  
                      generated because the stepping values must  
                      be precalculated to ramp between prop1 and prop2.  
35    
36          prop1 -- initial group property values      i = 0
37        maxValue = float(len(_list) - 1)
38        if maxValue < 1: maxValue = 1
39    
40          prop2 -- final group property values      for value in _list:
41          """          prop = ramp.GetProperties(i / maxValue)
42            clazz.AppendGroup(ClassGroupSingleton(value, prop))
43            i += 1
44    
45          clazz = Classification()      return clazz
         if numGroups == 0: return clazz  
46    
47          ramp.SetNumGroups(numGroups)  def generate_uniform_distribution(min, max, numGroups, ramp, intStep = False):
48        """Generate a classification with numGroups range groups
49        each with the same interval.
50    
51          for value, prop in zip(list, ramp):      intStep -- force the calculated stepping to an integer.
52              clazz.AppendGroup(ClassGroupSingleton(value, prop))                 Useful if the values are integers but the
53                   number of groups specified doesn't evenly
54                   divide (max - min).
55        """
56    
57          return clazz      clazz = Classification()
58    
59      def GenSingletons(self, min, max, numGroups, ramp):      cur_min = min
60    
61          clazz = Classification()      end = "["
62        maxValue = float(numGroups - 1)
63        if maxValue < 1: maxValue = 1
64    
65          #step = int((max - min) / float(numGroups))      for i in range(1, numGroups + 1):
66    
67          if numGroups > 0:          prop = ramp.GetProperties(float(i-1) / maxValue)
68    
69              step = int((max - min + 1) / float(numGroups))          if intStep:
70              cur_value = min              cur_max = min + int(round((i * (max - min + 1)) / float(numGroups)))
71            else:
72                cur_max = min + (i * (max - min)) / float(numGroups)
73    
74              ramp.SetNumGroups(numGroups)          if i == numGroups:
75                cur_max = max
76                end = "]"
77    
78              for prop in ramp:          if cur_min == cur_max:
79                  clazz.AppendGroup(ClassGroupSingleton(cur_value), prop)              _range = Range(("[", cur_min, cur_max, "]"))
80                  cur_value += step          else:
81                _range = Range(("[", cur_min, cur_max, end))
82    
83          return clazz          clazz.AppendGroup(ClassGroupRange(_range, prop))
84    
85      def GenUnifromDistribution(self, min, max, numGroups,          cur_min = cur_max
                                ramp, intStep = False):  
         """Generate a classification with numGroups range groups  
         each with the same interval.  
86    
87          intStep -- force the calculated stepping to an integer.      return clazz
                    Useful if the values are integers but the  
                    number of groups specified doesn't evenly  
                    divide (max - min).  
         """  
88    
89          clazz = Classification()  def generate_quantiles(_list, percents, ramp, _range):
90          if numGroups == 0: return clazz      """Generates a Classification which has groups of ranges that
91        represent quantiles of _list at the percentages given in percents.
92        Only the values that fall within _range are considered.
93    
94          ramp.SetNumGroups(numGroups)      Returns a tuple (adjusted, Classification) where adjusted is
95        True if the Classification does not exactly represent the given
96        range, or if the Classification is empty.
97    
98          step = (max - min) / float(numGroups)      _list -- a sort list of values
99    
100          if intStep:      percents -- a sorted list of floats in the range 0.0-1.0 which
101              step = int(step)                  represent the upper bound of each quantile. the
102                    union of all percentiles should be the entire
103                    range from 0.0-1.0
104    
105          cur_min = min      ramp -- an object which implements the CustomRamp interface
         cur_max = cur_min + step  
106    
107          i = 0      _range -- a Range object
         end = "["  
         for prop in ramp:  
108    
109              if i == (numGroups - 1):      Raises a Value Error if 'percents' has fewer than two items, or
110                  cur_max = max      does not cover the entire range.
111                  end = "]"      """
112    
113        clazz = Classification()
114        quantiles = calculate_quantiles(_list, percents, _range)
115        adjusted = True
116    
117              # this check guards against rounding issues      if quantiles is not None:
             if cur_min != cur_max:  
                 range = Range("[" + str(float(cur_min)) + ";" +  
                                     str(float(cur_max)) + end)  
                 clazz.AppendGroup(ClassGroupRange(range, None, prop))  
118    
119              cur_min = cur_max          numGroups = len(quantiles[3])
             cur_max += step  
             i += 1  
120    
121          return clazz          if numGroups != 0:
122    
123                adjusted = quantiles[0]
124    
125      def GenQuantiles(self, list, percents, ramp, _range):              start, min, endMax, right = _range.GetRange()
         clazz = Classification()  
         quantiles = self.CalculateQuantiles(list, percents, _range)  
         numGroups = len(quantiles[1])  
         if numGroups == 0: return clazz  
126    
127          ramp.SetNumGroups(numGroups)              oldp = 0
128                i = 1
129                end = "]"
130    
131          left, min, max, right = _range.GetRange()              maxValue = float(numGroups - 1)
132                if maxValue < 1: maxValue = 1
133                for (q, p) in quantiles[3]:
134    
135          start = "["                  prop = ramp.GetProperties(float(i-1) / maxValue)
         oldp = 0  
         for (q, p), prop in zip(quantiles[1], ramp):  
             max = list[q]  
             group = ClassGroupRange(Range(start + str(min) + ";" +  
                                                   str(max) + "]"),  
                                     None, prop)  
136    
137              group.SetLabel("%s%% - %s%%" % (round(oldp*100, 2),                  if i == numGroups:
138                                              round(p*100, 2)))                      max = endMax
139              oldp = p                      end = right
140              start = "]"                  else:
141              min = max                      max = _list[q]
             clazz.AppendGroup(group)  
142    
143          return (quantiles[0], clazz)                  group = ClassGroupRange(Range((start, min, max, end)), prop)
144        
145                    group.SetLabel("%s%% - %s%%" % (round(oldp*100, 2),
146                                                    round(p*100, 2)))
147                    oldp = p
148                    start = "]"
149                    min = max
150                    clazz.AppendGroup(group)
151                    i += 1
152    
153      def CalculateQuantiles(self, list, percents, _range):      return (adjusted, clazz)
         """Calculate quantiles for the given list of percents from the  
         sorted list of values that are in range.  
                                                                                   
         percents is a sorted list of floats in the range 0.0-1.0  
154    
         This may not actually generate numGroups quantiles if  
         many of the values that fall on quantile borders are the same.  
155    
156          Returns a tuple of the form: (adjusted, [quantile_list])  def calculate_quantiles(_list, percents, _range):
157        """Calculate quantiles for the given _list of percents from the
158        sorted list of values that are in range.
159                                                                                
160        This may not actually generate len(percents) quantiles if
161        many of the values that fall on quantile borders are the same.
162    
163          where adjusted is true if the the quantile percentages differ from      Returns a tuple of the form:
164          those supplied, and quantile_list is a list of tuples of the form:          (adjusted, minIndex, maxIndex, [quantile_list])
             (list_index, quantile_percentage)  
         """  
       
         quantiles = []  
                                                                                   
         adjusted = False  
         if len(percents) != 0:  
                                                                                 
             #print "list:", list  
             #print "percents:", percents  
             #print "numGroups:", numGroups  
       
             #  
             # find what part of the list range covers  
             #  
             minIndex = -1  
             maxIndex = -2  
             for i in xrange(0, len(list), 1):  
                 if operator.contains(_range, list[i]):  
                     minIndex = i  
                     break  
   
             for i in xrange(len(list)-1, -1, -1):  
                 if operator.contains(_range, list[i]):  
                     maxIndex = i  
                     break;  
   
             numValues = maxIndex - minIndex + 1  
             #print "minIndex:", minIndex, "maxIndex:", maxIndex  
             if minIndex <= maxIndex:  
   
                 #  
                 # build a list of unique indices into list of where each  
                 # quantile should be  
                 #  
                 quantiles = {}  
                 for p in percents:  
                     index = min(minIndex + int(p*numValues)-1, maxIndex)  
   
                     adjusted = adjusted \  
                         or quantiles.has_key(index) \  
                         or ((index+1) / float(numValues)) != p  
165    
166                      quantiles[index] = 0      where adjusted is True if the the quantile percentages differ from
167        those supplied, minIndex is the index into _list where the
168        minimum value used is located, maxIndex is the index into _list
169        where the maximum value used is located, and quantile_list is a
170        list of tuples of the form: (list_index, quantile_percentage)
171    
172                  quantiles = quantiles.keys()      Returns None, if no quantiles could be generated based on the
173                  quantiles.sort()      given range or input list.
174    
175                  #print "quantiles:", quantiles      _list -- a sort list of values
       
                 #  
                 # the current quantile index must be strictly greater than  
                 # the lowerBound  
                 #  
                 lowerBound = minIndex - 1  
       
                 for qindex in range(len(quantiles)):  
                     if lowerBound >= maxIndex:  
                         # discard higher quantiles  
                         quantiles = quantiles[:qindex]  
                         break  
       
                     # lowerBound + 1 is always a valid index  
       
       
                     #  
                     # bump up the current quantile index to be a usable index  
                     # if it currently falls below the lowerBound  
                     #  
                     if quantiles[qindex] <= lowerBound:  
                         quantiles[qindex] = min(lowerBound + 1, maxIndex)  
           
                     listIndex = quantiles[qindex]  
                     value = list[quantiles[qindex]]  
       
                     #print "-----------------------------------"  
                     #print "listIndex:", listIndex  
                     #print "value:", value  
       
                     #  
                     # look for similar values around the quantile index  
                     #  
                   
                     #print "lowerBound:", lowerBound  
                     lindex = listIndex - 1  
                     lcount = 0  
                     while lindex > lowerBound:  
                         if value != list[lindex]: break  
                         lcount += 1  
                         lindex -= 1  
       
                     rindex = listIndex + 1  
                     rcount = 0  
                     while rindex < maxIndex + 1:  
                         if value != list[rindex]: break  
                         rcount += 1  
                         rindex += 1  
       
                     #print lcount, "(lcount)", rcount, "(rcount)"  
                     #print lindex, "(lindex)", rindex, "(rindex)"  
       
                     #  
                     # adjust the current quantile index based on how many  
                     # numbers in the list are the same as the current value  
                     #  
                     newIndex = listIndex  
                     if lcount == rcount:  
                         if lcount != 0:  
                             #  
                             # there are an equal number of numbers to the left  
                             # and right, try going to the left first unless  
                             # doing so creates an empty quantile.  
                             #  
                             if lindex != lowerBound:  
                                 newIndex = lindex  
                                 #quantiles[qindex] = lindex  
                             else:  
                                 newIndex = rindex - 1  
                                 #quantiles[qindex] = rindex - 1  
       
                     elif lcount < rcount:  
                         # there are fewer items to the left, so  
                         # try going to the left first unless  
                         # doing so creates an empty quantile.  
                         if lindex != lowerBound:  
                             newIndex = lindex  
                             #quantiles[qindex] = lindex  
                         else:  
                             newIndex = rindex - 1  
                             #quantiles[qindex] = rindex - 1  
       
                     elif rcount < lcount:  
                         # there are fewer items to the right, so go to the right  
                         #quantiles[qindex] = rindex - 1  
                         newIndex = rindex - 1  
       
                     quantiles[qindex] = newIndex  
                     lowerBound = quantiles[qindex]  
       
                     #print "quantiles:", quantiles  
                     #print "lowerBound:", lowerBound  
           
                 #print "================================="  
                 #print "quantiles:", quantiles  
                 #print "qindex:", qindex  
       
         return (adjusted, [(q, (q+1) / float(numValues)) for q in quantiles])  
176    
177  CLR  = 0      percents -- a sorted list of floats in the range 0.0-1.0 which
178  STEP = 1                  represent the upper bound of each quantile. the
179  class CustomRamp:                  union of all percentiles should be the entire
180                    range from 0.0-1.0
181    
182      def __init__(self, prop1, prop2):      _range -- a Range object
         self.prop1 = prop1  
         self.prop2 = prop2  
183    
184          self.count = 0      Raises a Value Error if 'percents' has fewer than two items, or
185        does not cover the entire range.
186        """
187    
188      def __iter__(self):      quantiles = []
189          return self      adjusted = False
190    
191      def GetRamp(self):      if len(percents) <= 1:
192          return self          raise ValueError("percents parameter must have more than one item")
193    
194      def SetNumGroups(self, num):      if percents[-1] != 1.0:
195            raise ValueError("percents does not cover the entire range")
196    
197          if num <= 0:      #
198              return False      # find what part of the _list range covers
199        #
200        minIndex = -1
201        maxIndex = -2
202        for i in xrange(0, len(_list), 1):
203            if operator.contains(_range, _list[i]):
204                minIndex = i
205                break
206    
207          self.count = int(num)      for i in xrange(len(_list)-1, -1, -1):
208          num = float(num)          if operator.contains(_range, _list[i]):
209                maxIndex = i
210                break
211    
212          prop1 = self.prop1      numValues = maxIndex - minIndex + 1
         prop2 = self.prop2  
213    
214          clr = prop1.GetLineColor()      if numValues > 0:
         lineColor2 = prop2.GetLineColor()  
           
         self.noLine = clr is not Color.Transparent \  
                         and lineColor2 is not Color.Transparent  
215    
216            #
217            # build a list of unique indices into list of where each
218            # quantile *should* be. set adjusted if the resulting
219            # indices are different
220            #
221            quantiles = {}
222            for p in percents:
223                index = min(minIndex + int(p*numValues)-1, maxIndex)
224    
225          self.lineInfo = self.__GetColorInfo(prop1.GetLineColor(),              adjusted = adjusted \
226                                              prop2.GetLineColor(),                  or quantiles.has_key(index) \
227                                              num)                  or ((index - minIndex + 1) / float(numValues)) != p
228    
229          self.fillInfo = self.__GetColorInfo(prop1.GetFill(),              quantiles[index] = 0
                                             prop2.GetFill(),  
                                             num)  
230    
231          self.lineWidth = prop1.GetLineWidth()          quantiles = quantiles.keys()
232          self.lineWidthStep = (prop2.GetLineWidth() - self.lineWidth) / num          quantiles.sort()
233    
234          return True          #
235            # the current quantile index must be strictly greater than
236            # the lowerBound
237            #
238            lowerBound = minIndex - 1
239    
240      def next(self):          for qindex in xrange(len(quantiles)):
241          if self.count == 0:              if lowerBound >= maxIndex:
242              raise StopIteration                  # discard higher quantiles
243                    quantiles = quantiles[:qindex]
244                    break
245    
246          prop = ClassGroupProperties()              # lowerBound + 1 is always a valid index
247    
248          if self.lineInfo is None:              #
249              prop.SetLineColor(Color.Transparent)              # bump up the current quantile index to be a usable index
250          else:              # if it currently falls below the lowerBound
251              prop.SetLineColor(Color(self.lineInfo[CLR][0] / 255,              #
252                                      self.lineInfo[CLR][1] / 255,              if quantiles[qindex] <= lowerBound:
253                                      self.lineInfo[CLR][2] / 255))                  quantiles[qindex] = lowerBound + 1
   
             self.lineInfo[CLR][0] += self.lineInfo[STEP][0]  
             self.lineInfo[CLR][1] += self.lineInfo[STEP][1]  
             self.lineInfo[CLR][2] += self.lineInfo[STEP][2]  
254    
255          if self.fillInfo is None:              listIndex = quantiles[qindex]
256              prop.SetFill(Color.Transparent)              value = _list[listIndex]
         else:  
             prop.SetFill(Color(self.fillInfo[CLR][0] / 255,  
                             self.fillInfo[CLR][1] / 255,  
                             self.fillInfo[CLR][2] / 255))  
257    
258              self.fillInfo[CLR][0] += self.fillInfo[STEP][0]              #
259              self.fillInfo[CLR][1] += self.fillInfo[STEP][1]              # look for similar values around the quantile index
260              self.fillInfo[CLR][2] += self.fillInfo[STEP][2]              #
261                lindex = listIndex - 1
262                while lindex > lowerBound and value == _list[lindex]:
263                    lindex -= 1
264                lcount = (listIndex - 1) - lindex
265    
266                rindex = listIndex + 1
267                while rindex < maxIndex + 1 and value == _list[rindex]:
268                    rindex += 1
269                rcount = (listIndex + 1) - rindex
270    
271                #
272                # adjust the current quantile index based on how many
273                # numbers in the _list are the same as the current value
274                #
275                newIndex = listIndex
276                if lcount == rcount:
277                    if lcount != 0:
278                        #
279                        # there are an equal number of numbers to the left
280                        # and right, try going to the left first unless
281                        # doing so creates an empty quantile.
282                        #
283                        if lindex != lowerBound:
284                            newIndex = lindex
285                        else:
286                            newIndex = rindex - 1
287    
288          prop.SetLineWidth(int(self.lineWidth))              elif lcount < rcount:
289          self.lineWidth        += self.lineWidthStep                  # there are fewer items to the left, so
290                    # try going to the left first unless
291                    # doing so creates an empty quantile.
292                    if lindex != lowerBound:
293                        newIndex = lindex
294                    else:
295                        newIndex = rindex - 1
296    
297                elif rcount < lcount:
298                    # there are fewer items to the right, so go to the right
299                    newIndex = rindex - 1
300    
301                adjusted = adjusted or newIndex != listIndex
302    
303                quantiles[qindex] = newIndex
304                lowerBound = quantiles[qindex]
305    
306        if len(quantiles) == 0:
307            return None
308        else:
309            return (adjusted, minIndex, maxIndex,
310                    [(q, (q - minIndex+1) / float(numValues)) \
311                     for q in quantiles])
312    
313          self.count -= 1  class CustomRamp:
314    
315          return prop      def __init__(self, prop1, prop2):
316            """Create a ramp between prop1 and prop2."""
317            self.prop1 = prop1
318            self.prop2 = prop2
319    
320      def __GetColorInfo(self, color1, color2, numGroups):      def GetRamp(self):
321            """Return this ramp."""
322            return self
323    
324          if color1 is Color.Transparent and color2 is Color.Transparent:      def GetProperties(self, index):
325              #          """Return a ClassGroupProperties object whose properties
326              # returning early          represent a point at 'index' between prop1 and prop2 in
327              #          the constructor.
             return None  
         elif color1 is not Color.Transparent and color2 is Color.Transparent:  
             color = [color1.red   * 255,  
                      color1.green * 255,  
                      color1.blue  * 255]  
             step = (0, 0, 0)  
         elif color1 is Color.Transparent and color2 is not Color.Transparent:  
             color = [color2.red   * 255,  
                      color2.green * 255,  
                      color2.blue  * 255]  
             step = (0, 0, 0)  
         else:  
             color = [color1.red   * 255,  
                      color1.green * 255,  
                      color1.blue  * 255]  
             step = ((color2.red   * 255 - color1.red   * 255)   / numGroups,  
                     (color2.green * 255 - color1.green * 255) / numGroups,  
                     (color2.blue  * 255 - color1.blue  * 255)  / numGroups)  
328    
329            index -- a value such that 0 <= index <= 1
330            """
331    
332            if not (0 <= index <= 1):
333                raise ValueError(_("invalid index"))
334    
335          return (color, step)          newProps = ClassGroupProperties()
336    
337            self.__SetProperty(self.prop1.GetLineColor(),
338                               self.prop2.GetLineColor(),
339                               index, newProps.SetLineColor)
340            self.__SetProperty(self.prop1.GetFill(), self.prop2.GetFill(),
341                               index, newProps.SetFill)
342    
343            w = (self.prop2.GetLineWidth() - self.prop1.GetLineWidth()) \
344                * index \
345                + self.prop1.GetLineWidth()
346            newProps.SetLineWidth(int(round(w)))
347    
348            return newProps
349    
350        def __SetProperty(self, color1, color2, index, setf):
351            """Use setf to set the appropriate property for the point
352            index percent between color1 and color2. setf is a function
353            to call that accepts a Color object or Transparent.
354            """
355    
356            if color1 is Transparent and color2 is Transparent:
357                setf(Transparent)
358            elif color1 is Transparent:
359                setf(Color(
360                     color2.red   * index,
361                     color2.green * index,
362                     color2.blue  * index))
363            elif color2 is Transparent:
364                setf(Color(
365                     color1.red   * index,
366                     color1.green * index,
367                     color1.blue  * index))
368            else:
369                setf(Color(
370                    (color2.red   - color1.red)   * index + color1.red,
371                    (color2.green - color1.green) * index + color1.green,
372                    (color2.blue  - color1.blue)  * index + color1.blue))
373    
374  class MonochromaticRamp(CustomRamp):  class MonochromaticRamp(CustomRamp):
375        """Helper class to make ramps between two colors."""
376    
377      def __init__(self, start, end):      def __init__(self, start, end):
378            """Create a Monochromatic Ramp.
379    
380            start -- starting Color
381    
382            end -- ending Color
383            """
384          sp = ClassGroupProperties()          sp = ClassGroupProperties()
385          sp.SetLineColor(start)          sp.SetLineColor(start)
386          sp.SetFill(start)          sp.SetFill(start)
# Line 419  class MonochromaticRamp(CustomRamp): Line 391  class MonochromaticRamp(CustomRamp):
391    
392          CustomRamp.__init__(self, sp, ep)          CustomRamp.__init__(self, sp, ep)
393    
394  class GreyRamp(MonochromaticRamp):  grey_ramp         = MonochromaticRamp(Color(1, 1, 1),  Color(0, 0, 0))
395      def __init__(self):  red_ramp          = MonochromaticRamp(Color(1, 1, 1),  Color(.8, 0, 0))
396          MonochromaticRamp.__init__(self, Color(1, 1, 1), Color(0, 0, 0))  green_ramp        = MonochromaticRamp(Color(1, 1, 1),  Color(0, .8, 0))
397    blue_ramp         = MonochromaticRamp(Color(1, 1, 1),  Color(0, 0, .8))
398  class RedRamp(MonochromaticRamp):  green_to_red_ramp = MonochromaticRamp(Color(0, .8, 0), Color(1, 0, 0))
     def __init__(self):  
         MonochromaticRamp.__init__(self, Color(1, 1, 1), Color(.8, 0, 0))  
   
 class GreenRamp(MonochromaticRamp):  
     def __init__(self):  
         MonochromaticRamp.__init__(self, Color(1, 1, 1), Color(0, .8, 0))  
   
 class BlueRamp(MonochromaticRamp):  
     def __init__(self):  
         MonochromaticRamp.__init__(self, Color(1, 1, 1), Color(0, 0, .8))  
   
 class GreenToRedRamp(MonochromaticRamp):  
     def __init__(self):  
         MonochromaticRamp.__init__(self, Color(0, .8, 0), Color(1, 0, 0))  
399    
400  class HotToColdRamp:  class HotToColdRamp:
401        """A ramp that generates properties with colors ranging from
402        'hot' colors (e.g. red, orange) to 'cold' colors (e.g. green, blue)
403        """
404    
     def __iter__(self):  
         return self  
           
405      def GetRamp(self):      def GetRamp(self):
406            """Return this ramp."""
407          return self          return self
408    
409      def SetNumGroups(self, num):      def GetProperties(self, index):
410          if num < 0:          """Return a ClassGroupProperties object whose properties
411              return False          represent a point at 'index' between "hot" and "cold".
412    
413          self.num = float(num)          index -- a value such that 0 <= index <= 1
414          self.index = 0          """
   
         return True  
   
     def next(self):  
         if self.index == self.num:  
             raise StopIteration  
415    
416          clr = [1.0, 1.0, 1.0]          clr = [1.0, 1.0, 1.0]
417    
418          if self.index < (.25 * self.num):          if index < .25:
419              clr[0] = 0              clr[0] = 0
420              clr[1] = 4 * self.index / self.num              clr[1] = 4 * index
421          elif self.index < (.5 * self.num):          elif index < .5:
422              clr[0] = 0              clr[0] = 0
423              clr[2] = 1 + 4 * (.25 * self.num - self.index) / self.num              clr[2] = 1 + 4 * (.25 - index)
424          elif self.index < (.75 * self.num):          elif index < .75:
425              clr[0] = 4 * (self.index - .5 * self.num) / self.num              clr[0] = 4 * (index - .5)
426              clr[2] = 0              clr[2] = 0
427          else:          else:
428              clr[1] = 1 + 4 * (.75 * self.num - self.index) / self.num              clr[1] = 1 + 4 * (.75 - index)
429              clr[2] = 0              clr[2] = 0
430    
         self.index += 1  
   
431          prop = ClassGroupProperties()          prop = ClassGroupProperties()
432          prop.SetLineColor(Color(clr[0], clr[1], clr[2]))          prop.SetLineColor(Color(clr[0], clr[1], clr[2]))
433          prop.SetFill(Color(clr[0], clr[1], clr[2]))          prop.SetFill(Color(clr[0], clr[1], clr[2]))
434    
435          return prop          return prop
436    
437  #class Colors16Ramp:  class FixedRamp:
438  #      """FixedRamp allows particular properties of a ramp to be
439      #def __iter__(self):      held constant over the ramp.
440          #return self      """
441  #  
442      #def GetRamp(self):      def __init__(self, ramp, fixes):
443          #return self          """
444  #          ramp -- a source ramp to get the default properties
445      #def SetNumGroups(self, num):  
446          #if num < 0:          fixes -- a tuple (lineColor, lineWidth, fillColor) such that
447              #return False               if any item is not None, the appropriate property will
448  #               be fixed to that item value.
449          #self.index = 0          """
450  #  
451          #return True          self.fixes = fixes
452            self.ramp = ramp
453    
454        def GetRamp(self):
455            """Return this ramp."""
456            return self
457    
458        def GetProperties(self, index):
459            """Return a ClassGroupProperties object whose properties
460            represent a point at 'index' between the properties in
461            the ramp that initialized this FixedRamp.
462    
463            index -- a value such that 0 <= index <= 1
464            """
465    
466            props = self.ramp.GetProperties(index)
467            if self.fixes[0] is not None: props.SetLineColor(self.fixes[0])
468            if self.fixes[1] is not None: props.SetLineWidth(self.fixes[1])
469            if self.fixes[2] is not None: props.SetFill(self.fixes[2])
470    
471            return props

Legend:
Removed from v.886  
changed lines
  Added in v.1759

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26