1 |
# Copyright (c) 2001, 2003 by Intevation GmbH |
# Copyright (c) 2001, 2003, 2005 by Intevation GmbH |
2 |
# Authors: |
# Authors: |
3 |
# Jonathan Coles <[email protected]> |
# Jonathan Coles <[email protected]> |
4 |
|
# Jan-Oliver Wagner <[email protected]> (2005) |
5 |
# |
# |
6 |
# This program is free software under the GPL (>=v2) |
# This program is free software under the GPL (>=v2) |
7 |
# Read the file COPYING coming with Thuban for details. |
# Read the file COPYING coming with Thuban for details. |
21 |
on the mapping algorithm. |
on the mapping algorithm. |
22 |
""" |
""" |
23 |
|
|
24 |
# fix for people using python2.1 |
import copy, operator, types |
|
from __future__ import nested_scopes |
|
|
|
|
|
import copy |
|
25 |
|
|
26 |
from Thuban import _ |
from Thuban import _ |
27 |
|
|
|
from types import * |
|
|
|
|
28 |
from messages import \ |
from messages import \ |
29 |
LAYER_PROJECTION_CHANGED, \ |
LAYER_PROJECTION_CHANGED, \ |
30 |
LAYER_LEGEND_CHANGED, \ |
LAYER_LEGEND_CHANGED, \ |
31 |
LAYER_VISIBILITY_CHANGED |
LAYER_VISIBILITY_CHANGED,\ |
32 |
|
CLASS_CHANGED |
33 |
|
|
34 |
from Thuban.Model.color import Color |
from Thuban.Model.color import Color, Transparent, Black |
35 |
|
from Thuban.Model.range import Range |
36 |
|
|
37 |
import Thuban.Model.layer |
import Thuban.Model.layer |
38 |
|
|
39 |
class Classification: |
from Thuban.Lib.connector import Publisher |
40 |
|
|
41 |
|
class Classification(Publisher): |
42 |
"""Encapsulates the classification of layer. |
"""Encapsulates the classification of layer. |
43 |
|
|
44 |
The Classification divides some kind of data into Groups which |
The Classification divides some kind of data into Groups which |
46 |
retrieved by matching data values to the appropriate group. |
retrieved by matching data values to the appropriate group. |
47 |
""" |
""" |
48 |
|
|
49 |
def __init__(self, layer = None, field = None): |
def __init__(self): |
50 |
"""Initialize a classification. |
"""Initialize a classification.""" |
|
|
|
|
layer -- the Layer object who owns this classification |
|
|
|
|
|
field -- the name of the data table field that |
|
|
is to be used to classify layer properties |
|
|
""" |
|
51 |
|
|
|
self.layer = None |
|
|
self.field = None |
|
|
self.fieldType = None |
|
52 |
self.__groups = [] |
self.__groups = [] |
53 |
|
|
|
self.__setLayerLock = False |
|
|
|
|
54 |
self.SetDefaultGroup(ClassGroupDefault()) |
self.SetDefaultGroup(ClassGroupDefault()) |
55 |
|
|
|
self.SetLayer(layer) |
|
|
self.SetField(field) |
|
|
|
|
56 |
def __iter__(self): |
def __iter__(self): |
57 |
return ClassIterator(self.__groups) |
return ClassIterator(self.__groups) |
58 |
|
|
59 |
def __deepcopy__(self, memo): |
def __deepcopy__(self, memo): |
60 |
clazz = Classification() |
clazz = Classification() |
61 |
|
|
|
# note: the only thing that isn't copied is the layer reference |
|
|
clazz.field = self.field |
|
|
clazz.fieldType = self.fieldType |
|
62 |
clazz.__groups[0] = copy.deepcopy(self.__groups[0]) |
clazz.__groups[0] = copy.deepcopy(self.__groups[0]) |
63 |
|
|
64 |
for i in range(1, len(self.__groups)): |
for i in range(1, len(self.__groups)): |
68 |
|
|
69 |
def __SendNotification(self): |
def __SendNotification(self): |
70 |
"""Notify the layer that this class has changed.""" |
"""Notify the layer that this class has changed.""" |
71 |
if self.layer is not None: |
self.issue(CLASS_CHANGED) |
|
self.layer.ClassChanged() |
|
|
|
|
|
def SetField(self, field): |
|
|
"""Set the name of the data table field to use. |
|
|
|
|
|
If there is no layer then the field type is set to None, |
|
|
otherwise the layer is queried to find the type of the |
|
|
field data |
|
|
|
|
|
field -- if None then all values map to the default data |
|
|
""" |
|
|
|
|
|
if field == "": |
|
|
field = None |
|
|
|
|
|
|
|
|
if field is None: |
|
|
if self.layer is not None: |
|
|
self.fieldType = None |
|
|
else: |
|
|
if self.layer is not None: |
|
|
fieldType = self.layer.GetFieldType(field) |
|
|
if fieldType is None: |
|
|
raise ValueError("'%s' was not found in the layer's table." |
|
|
% self.field) |
|
|
|
|
|
# |
|
|
# unfortunately we cannot call SetFieldType() because it |
|
|
# requires the layer to be None |
|
|
# |
|
|
self.fieldType = fieldType |
|
|
#self.SetFieldType(fieldType) |
|
|
|
|
|
self.field = field |
|
|
|
|
|
self.__SendNotification() |
|
|
|
|
|
def GetField(self): |
|
|
"""Return the name of the field.""" |
|
|
return self.field |
|
|
|
|
|
def GetFieldType(self): |
|
|
"""Return the field type.""" |
|
|
return self.fieldType |
|
|
|
|
|
def SetFieldType(self, type): |
|
|
"""Set the type of the field used by this classification. |
|
72 |
|
|
73 |
A ValueError is raised if the owning layer is not None and |
def __getattr__(self, attr): |
74 |
'type' is different from the current field type. |
"""Generate the compiled classification on demand""" |
75 |
""" |
if attr == "_compiled_classification": |
76 |
|
self._compile_classification() |
77 |
if type != self.fieldType: |
return self._compiled_classification |
78 |
if self.layer is not None: |
raise AttributeError(attr) |
79 |
raise ValueError() |
|
80 |
else: |
def _compile_classification(self): |
81 |
self.fieldType = type |
"""Generate the compiled classification |
82 |
self.__SendNotification() |
|
83 |
|
The compiled classification is a more compact representation of |
84 |
def SetLayer(self, layer): |
the classification groups that is also more efficient for |
85 |
"""Set the owning Layer of this classification. |
performing the classification. |
86 |
|
|
87 |
A ValueError exception will be thrown either the field or |
The compiled classification is a list of tuples. The first |
88 |
field type mismatch the information in the layer's table. |
element of the tuple is a string which describes the rest of the |
89 |
""" |
tuple. There are two kinds of tuples: |
90 |
|
|
91 |
# prevent infinite recursion when calling SetClassification() |
'singletons' |
92 |
if self.__setLayerLock: return |
|
93 |
|
The second element of the tuple is a dictionary which |
94 |
self.__setLayerLock = True |
combines several consecutive ClassGroupSingleton instances. |
95 |
|
The dictionary maps the values of the singletons (as |
96 |
if layer is None: |
returned by the GetValue() method) to the corresponding |
97 |
if self.layer is not None: |
group. |
98 |
l = self.layer |
|
99 |
self.layer = None |
'range' |
100 |
l.SetClassification(None) |
|
101 |
else: |
The tuple describes a ClassGroupRange instance. The tuples |
102 |
assert isinstance(layer, Thuban.Model.layer.Layer) |
second element is a tuple fo the form (lfunc, min, max, |
103 |
|
rfunc, group) where group is the original group object, |
104 |
old_layer = self.layer |
lfunc and rfuct are comparison functions and min and max are |
105 |
|
lower and upper bounds of the range. Given a value and such |
106 |
self.layer = layer |
a tuple the group matches if and only if |
107 |
|
|
108 |
try: |
lfunc(min, value) and rfunc(max, value) |
109 |
self.SetField(self.GetField()) # this sync's the fieldType |
|
110 |
except ValueError: |
is true. |
111 |
self.layer = old_layer |
|
112 |
self.__setLayerLock = False |
The compiled classification is bound to |
113 |
raise ValueError |
self._compile_classification. |
114 |
|
""" |
115 |
|
compiled = [] |
116 |
|
for group in self.__groups[1:]: |
117 |
|
if isinstance(group, ClassGroupSingleton): |
118 |
|
if not compiled or compiled[-1][0] != "singletons": |
119 |
|
compiled.append(("singletons", {})) |
120 |
|
compiled[-1][1].setdefault(group.GetValue(), group) |
121 |
|
elif isinstance(group, ClassGroupRange): |
122 |
|
left, min, max, right = group.GetRangeTuple() |
123 |
|
if left == "[": |
124 |
|
lfunc = operator.le |
125 |
|
elif left == "]": |
126 |
|
lfunc = operator.lt |
127 |
|
if right == "[": |
128 |
|
rfunc = operator.gt |
129 |
|
elif right == "]": |
130 |
|
rfunc = operator.ge |
131 |
|
compiled.append(("range", (lfunc, min, max, rfunc, group))) |
132 |
else: |
else: |
133 |
self.layer.SetClassification(self) |
raise TypeError("Unknown group type %s", group) |
134 |
|
self._compiled_classification = compiled |
135 |
|
|
136 |
self.__setLayerLock = False |
def _clear_compiled_classification(self): |
137 |
|
"""Reset the compiled classification. |
138 |
|
|
139 |
def GetLayer(self): |
If will be created on demand when self._compiled_classification |
140 |
"""Return the parent layer.""" |
is accessed again. |
|
return self.layer |
|
141 |
|
|
142 |
|
Call this method whenever self.__groups is modified. |
143 |
|
""" |
144 |
|
try: |
145 |
|
del self._compiled_classification |
146 |
|
except: |
147 |
|
pass |
148 |
|
|
149 |
# |
# |
150 |
# these SetDefault* methods are really only provided for |
# these SetDefault* methods are really only provided for |
157 |
|
|
158 |
fill -- a Color object. |
fill -- a Color object. |
159 |
""" |
""" |
|
assert isinstance(fill, Color) |
|
160 |
self.GetDefaultGroup().GetProperties().SetFill(fill) |
self.GetDefaultGroup().GetProperties().SetFill(fill) |
161 |
self.__SendNotification() |
self.__SendNotification() |
162 |
|
|
169 |
|
|
170 |
color -- a Color object. |
color -- a Color object. |
171 |
""" |
""" |
|
assert isinstance(color, Color) |
|
172 |
self.GetDefaultGroup().GetProperties().SetLineColor(color) |
self.GetDefaultGroup().GetProperties().SetLineColor(color) |
173 |
self.__SendNotification() |
self.__SendNotification() |
174 |
|
|
181 |
|
|
182 |
lineWidth -- an integer > 0. |
lineWidth -- an integer > 0. |
183 |
""" |
""" |
184 |
assert isinstance(lineWidth, IntType) |
assert isinstance(lineWidth, types.IntType) |
185 |
self.GetDefaultGroup().GetProperties().SetLineWidth(lineWidth) |
self.GetDefaultGroup().GetProperties().SetLineWidth(lineWidth) |
186 |
self.__SendNotification() |
self.__SendNotification() |
187 |
|
|
203 |
|
|
204 |
group -- group that the value maps to. |
group -- group that the value maps to. |
205 |
""" |
""" |
|
|
|
206 |
assert isinstance(group, ClassGroupDefault) |
assert isinstance(group, ClassGroupDefault) |
207 |
if len(self.__groups) > 0: |
if len(self.__groups) > 0: |
208 |
self.__groups[0] = group |
self.__groups[0] = group |
209 |
else: |
else: |
210 |
self.__groups.append(group) |
self.__groups.append(group) |
211 |
|
self.__SendNotification() |
212 |
|
|
213 |
def GetDefaultGroup(self): |
def GetDefaultGroup(self): |
214 |
"""Return the default group.""" |
"""Return the default group.""" |
223 |
self.InsertGroup(self.GetNumGroups(), item) |
self.InsertGroup(self.GetNumGroups(), item) |
224 |
|
|
225 |
def InsertGroup(self, index, group): |
def InsertGroup(self, index, group): |
|
|
|
226 |
assert isinstance(group, ClassGroup) |
assert isinstance(group, ClassGroup) |
|
|
|
227 |
self.__groups.insert(index + 1, group) |
self.__groups.insert(index + 1, group) |
228 |
|
self._clear_compiled_classification() |
229 |
self.__SendNotification() |
self.__SendNotification() |
230 |
|
|
231 |
def RemoveGroup(self, index): |
def RemoveGroup(self, index): |
232 |
return self.__groups.pop(index + 1) |
"""Remove the classification group with the given index""" |
233 |
|
self.__groups.pop(index + 1) |
234 |
|
self._clear_compiled_classification() |
235 |
|
self.__SendNotification() |
236 |
|
|
237 |
def ReplaceGroup(self, index, group): |
def ReplaceGroup(self, index, group): |
238 |
assert isinstance(group, ClassGroup) |
assert isinstance(group, ClassGroup) |
|
|
|
239 |
self.__groups[index + 1] = group |
self.__groups[index + 1] = group |
240 |
|
self._clear_compiled_classification() |
241 |
self.__SendNotification() |
self.__SendNotification() |
242 |
|
|
243 |
def GetGroup(self, index): |
def GetGroup(self, index): |
247 |
"""Return the number of non-default groups in the classification.""" |
"""Return the number of non-default groups in the classification.""" |
248 |
return len(self.__groups) - 1 |
return len(self.__groups) - 1 |
249 |
|
|
|
|
|
250 |
def FindGroup(self, value): |
def FindGroup(self, value): |
251 |
"""Return the associated group, or the default group. |
"""Return the group that matches the value. |
252 |
|
|
253 |
Groups are checked in the order the were added to the |
Groups are effectively checked in the order the were added to |
254 |
Classification. |
the Classification. |
255 |
|
|
256 |
value -- the value to classify. If there is no mapping, |
value -- the value to classify. If there is no mapping or value |
257 |
the field is None or value is None, |
is None, return the default properties |
|
return the default properties |
|
258 |
""" |
""" |
259 |
|
|
260 |
if self.GetField() is not None and value is not None: |
if value is not None: |
261 |
|
for typ, params in self._compiled_classification: |
262 |
for i in range(1, len(self.__groups)): |
if typ == "singletons": |
263 |
group = self.__groups[i] |
group = params.get(value) |
264 |
if group.Matches(value): |
if group is not None: |
265 |
return group |
return group |
266 |
|
elif typ == "range": |
267 |
|
lfunc, min, max, rfunc, g = params |
268 |
|
if lfunc(min, value) and rfunc(max, value): |
269 |
|
return g |
270 |
|
|
271 |
return self.GetDefaultGroup() |
return self.GetDefaultGroup() |
272 |
|
|
288 |
items = [] |
items = [] |
289 |
|
|
290 |
def build_color_item(text, color): |
def build_color_item(text, color): |
291 |
if color is Color.Transparent: |
if color is Transparent: |
292 |
return ("%s: %s" % (text, _("None")), None) |
return ("%s: %s" % (text, _("None")), None) |
293 |
|
|
294 |
return ("%s: (%.3f, %.3f, %.3f)" % |
return ("%s: (%.3f, %.3f, %.3f)" % |
308 |
i.append(build_color_item(_("Line Color"), v)) |
i.append(build_color_item(_("Line Color"), v)) |
309 |
v = props.GetLineWidth() |
v = props.GetLineWidth() |
310 |
i.append(_("Line Width: %s") % v) |
i.append(_("Line Width: %s") % v) |
311 |
|
|
312 |
|
# Note: Size is owned by all properties, so |
313 |
|
# a size will also appear where it does not |
314 |
|
# make sense like for lines and polygons. |
315 |
|
v = props.GetSize() |
316 |
|
i.append(_("Size: %s") % v) |
317 |
|
|
318 |
v = props.GetFill() |
v = props.GetFill() |
319 |
i.append(build_color_item(_("Fill"), v)) |
i.append(build_color_item(_("Fill"), v)) |
320 |
return (label, i) |
return (label, i) |
322 |
for p in self: |
for p in self: |
323 |
items.append(build_item(p, p.GetDisplayText())) |
items.append(build_item(p, p.GetDisplayText())) |
324 |
|
|
|
# if isinstance(p, ClassGroupDefault): |
|
|
# items.append(build_item(self.GetDefaultGroup(), _("'DEFAULT'"))) |
|
|
# elif isinstance(p, ClassGroupSingleton): |
|
|
# items.append(build_item(p, str(p.GetValue()))) |
|
|
# elif isinstance(p, ClassGroupRange): |
|
|
# items.append(build_item(p, "%s - %s" % |
|
|
# (p.GetMin(), p.GetMax()))) |
|
|
|
|
325 |
return (_("Classification"), items) |
return (_("Classification"), items) |
326 |
|
|
327 |
class ClassIterator: |
class ClassIterator: |
328 |
"""Allows the Groups in a Classifcation to be interated over. |
"""Allows the Groups in a Classifcation to be interated over. |
329 |
|
|
335 |
"""Constructor. |
"""Constructor. |
336 |
|
|
337 |
default -- the default group |
default -- the default group |
338 |
|
|
339 |
points -- a list of singleton groups |
points -- a list of singleton groups |
340 |
|
|
341 |
ranges -- a list of range groups |
ranges -- a list of range groups |
342 |
|
|
343 |
maps -- a list of map groups |
maps -- a list of map groups |
344 |
""" |
""" |
345 |
|
|
346 |
self.data = data #[default, points, ranges, maps] |
self.data = data |
347 |
self.data_index = 0 |
self.data_index = 0 |
|
#self.data_iter = iter(self.data) |
|
|
#self.iter = None |
|
348 |
|
|
349 |
def __iter__(self): |
def __iter__(self): |
350 |
return self |
return self |
358 |
d = self.data[self.data_index] |
d = self.data[self.data_index] |
359 |
self.data_index += 1 |
self.data_index += 1 |
360 |
return d |
return d |
361 |
|
|
|
# if self.iter is None: |
|
|
# try: |
|
|
# self.data_item = self.data_iter.next() |
|
|
# self.iter = iter(self.data_item) |
|
|
# except TypeError: |
|
|
# return self.data_item |
|
|
|
|
|
# try: |
|
|
# return self.iter.next() |
|
|
# except StopIteration: |
|
|
# self.iter = None |
|
|
# return self.next() |
|
|
|
|
362 |
class ClassGroupProperties: |
class ClassGroupProperties: |
363 |
"""Represents the properties of a single Classification Group. |
"""Represents the properties of a single Classification Group. |
364 |
|
|
365 |
These are used when rendering a layer.""" |
These are used when rendering a layer.""" |
366 |
|
|
367 |
|
# TODO: Actually, size is only relevant for point objects. |
368 |
|
# Eventually it should be spearated, e.g. when introducing symbols. |
369 |
|
|
370 |
def __init__(self, props = None): |
def __init__(self, props = None): |
371 |
"""Constructor. |
"""Constructor. |
372 |
|
|
373 |
props -- a ClassGroupProperties object. The class is copied if |
props -- a ClassGroupProperties object. The class is copied if |
374 |
prop is not None. Otherwise, a default set of properties |
prop is not None. Otherwise, a default set of properties |
375 |
is created such that: line color = Color.Black, line width = 1, |
is created such that: line color = Black, line width = 1, |
376 |
and fill color = Color.Transparent |
size = 5 and fill color = Transparent |
377 |
""" |
""" |
378 |
|
|
|
#self.stroke = None |
|
|
#self.strokeWidth = 0 |
|
|
#self.fill = None |
|
|
|
|
379 |
if props is not None: |
if props is not None: |
380 |
self.SetProperties(props) |
self.SetProperties(props) |
381 |
else: |
else: |
382 |
self.SetLineColor(Color.Black) |
self.SetLineColor(Black) |
383 |
self.SetLineWidth(1) |
self.SetLineWidth(1) |
384 |
self.SetFill(Color.Transparent) |
self.SetSize(5) |
385 |
|
self.SetFill(Transparent) |
386 |
|
|
387 |
def SetProperties(self, props): |
def SetProperties(self, props): |
388 |
"""Set this class's properties to those in class props.""" |
"""Set this class's properties to those in class props.""" |
390 |
assert isinstance(props, ClassGroupProperties) |
assert isinstance(props, ClassGroupProperties) |
391 |
self.SetLineColor(props.GetLineColor()) |
self.SetLineColor(props.GetLineColor()) |
392 |
self.SetLineWidth(props.GetLineWidth()) |
self.SetLineWidth(props.GetLineWidth()) |
393 |
|
self.SetSize(props.GetSize()) |
394 |
self.SetFill(props.GetFill()) |
self.SetFill(props.GetFill()) |
395 |
|
|
396 |
def GetLineColor(self): |
def GetLineColor(self): |
397 |
"""Return the line color as a Color object.""" |
"""Return the line color as a Color object.""" |
398 |
return self.stroke |
return self.__stroke |
399 |
|
|
400 |
def SetLineColor(self, color): |
def SetLineColor(self, color): |
401 |
"""Set the line color. |
"""Set the line color. |
403 |
color -- the color of the line. This must be a Color object. |
color -- the color of the line. This must be a Color object. |
404 |
""" |
""" |
405 |
|
|
406 |
assert isinstance(color, Color) |
self.__stroke = color |
|
self.stroke = color |
|
407 |
|
|
408 |
def GetLineWidth(self): |
def GetLineWidth(self): |
409 |
"""Return the line width.""" |
"""Return the line width.""" |
410 |
return self.strokeWidth |
return self.__strokeWidth |
411 |
|
|
412 |
def SetLineWidth(self, lineWidth): |
def SetLineWidth(self, lineWidth): |
413 |
"""Set the line width. |
"""Set the line width. |
414 |
|
|
415 |
lineWidth -- the new line width. This must be > 0. |
lineWidth -- the new line width. This must be > 0. |
416 |
""" |
""" |
417 |
assert isinstance(lineWidth, IntType) |
assert isinstance(lineWidth, types.IntType) |
418 |
if (lineWidth < 1): |
if (lineWidth < 1): |
419 |
raise ValueError(_("lineWidth < 1")) |
raise ValueError(_("lineWidth < 1")) |
420 |
|
|
421 |
self.strokeWidth = lineWidth |
self.__strokeWidth = lineWidth |
422 |
|
|
423 |
|
def GetSize(self): |
424 |
|
"""Return the size.""" |
425 |
|
return self.__size |
426 |
|
|
427 |
|
def SetSize(self, size): |
428 |
|
"""Set the size. |
429 |
|
|
430 |
|
size -- the new size. This must be > 0. |
431 |
|
""" |
432 |
|
assert isinstance(size, types.IntType) |
433 |
|
if (size < 1): |
434 |
|
raise ValueError(_("size < 1")) |
435 |
|
|
436 |
|
self.__size = size |
437 |
|
|
438 |
def GetFill(self): |
def GetFill(self): |
439 |
"""Return the fill color as a Color object.""" |
"""Return the fill color as a Color object.""" |
440 |
return self.fill |
return self.__fill |
441 |
|
|
442 |
def SetFill(self, fill): |
def SetFill(self, fill): |
443 |
"""Set the fill color. |
"""Set the fill color. |
444 |
|
|
445 |
fill -- the color of the fill. This must be a Color object. |
fill -- the color of the fill. This must be a Color object. |
446 |
""" |
""" |
447 |
|
|
448 |
assert isinstance(fill, Color) |
self.__fill = fill |
|
self.fill = fill |
|
449 |
|
|
450 |
def __eq__(self, other): |
def __eq__(self, other): |
451 |
"""Return true if 'props' has the same attributes as this class""" |
"""Return true if 'props' has the same attributes as this class""" |
452 |
|
|
453 |
|
# |
454 |
|
# using 'is' over '==' results in a huge performance gain |
455 |
|
# in the renderer |
456 |
|
# |
457 |
return isinstance(other, ClassGroupProperties) \ |
return isinstance(other, ClassGroupProperties) \ |
458 |
and self.stroke == other.GetLineColor() \ |
and (self.__stroke is other.__stroke or \ |
459 |
and self.strokeWidth == other.GetLineWidth() \ |
self.__stroke == other.__stroke) \ |
460 |
and self.fill == other.GetFill() |
and (self.__fill is other.__fill or \ |
461 |
|
self.__fill == other.__fill) \ |
462 |
|
and self.__strokeWidth == other.__strokeWidth\ |
463 |
|
and self.__size == other.__size |
464 |
|
|
465 |
def __ne__(self, other): |
def __ne__(self, other): |
466 |
return not self.__eq__(other) |
return not self.__eq__(other) |
471 |
def __deepcopy__(self): |
def __deepcopy__(self): |
472 |
return ClassGroupProperties(self) |
return ClassGroupProperties(self) |
473 |
|
|
474 |
|
def __repr__(self): |
475 |
|
return repr((self.__stroke, self.__strokeWidth, self.__size, |
476 |
|
self.__fill)) |
477 |
|
|
478 |
class ClassGroup: |
class ClassGroup: |
479 |
"""A base class for all Groups within a Classification""" |
"""A base class for all Groups within a Classification""" |
480 |
|
|
496 |
def GetLabel(self): |
def GetLabel(self): |
497 |
"""Return the Group's label.""" |
"""Return the Group's label.""" |
498 |
return self.label |
return self.label |
499 |
|
|
500 |
def SetLabel(self, label): |
def SetLabel(self, label): |
501 |
"""Set the Group's label. |
"""Set the Group's label. |
502 |
|
|
503 |
label -- a string representing the Group's label. This must |
label -- a string representing the Group's label. This must |
504 |
not be None. |
not be None. |
505 |
""" |
""" |
506 |
assert isinstance(label, StringType) |
assert isinstance(label, types.StringTypes) |
507 |
self.label = label |
self.label = label |
508 |
|
|
509 |
def GetDisplayText(self): |
def GetDisplayText(self): |
542 |
|
|
543 |
def __eq__(self, other): |
def __eq__(self, other): |
544 |
return isinstance(other, ClassGroup) \ |
return isinstance(other, ClassGroup) \ |
545 |
|
and self.label == other.label \ |
546 |
and self.GetProperties() == other.GetProperties() |
and self.GetProperties() == other.GetProperties() |
547 |
|
|
548 |
def __ne__(self, other): |
def __ne__(self, other): |
549 |
return not self.__eq__(other) |
return not self.__eq__(other) |
550 |
|
|
551 |
|
def __repr__(self): |
552 |
|
return repr(self.label) + ", " + repr(self.GetProperties()) |
553 |
|
|
554 |
class ClassGroupSingleton(ClassGroup): |
class ClassGroupSingleton(ClassGroup): |
555 |
"""A Group that is associated with a single value.""" |
"""A Group that is associated with a single value.""" |
578 |
|
|
579 |
def GetValue(self): |
def GetValue(self): |
580 |
"""Return the associated value.""" |
"""Return the associated value.""" |
581 |
return self.value |
return self.__value |
582 |
|
|
583 |
def SetValue(self, value): |
def SetValue(self, value): |
584 |
"""Associate this Group with the given value.""" |
"""Associate this Group with the given value.""" |
585 |
self.value = value |
self.__value = value |
586 |
|
|
587 |
def Matches(self, value): |
def Matches(self, value): |
588 |
"""Determine if the given value matches the associated Group value.""" |
"""Determine if the given value matches the associated Group value.""" |
589 |
|
|
590 |
"""Returns True if the value matches, False otherwise.""" |
"""Returns True if the value matches, False otherwise.""" |
591 |
|
|
592 |
return self.value == value |
return self.__value == value |
593 |
|
|
594 |
def GetDisplayText(self): |
def GetDisplayText(self): |
595 |
label = self.GetLabel() |
label = self.GetLabel() |
601 |
def __eq__(self, other): |
def __eq__(self, other): |
602 |
return ClassGroup.__eq__(self, other) \ |
return ClassGroup.__eq__(self, other) \ |
603 |
and isinstance(other, ClassGroupSingleton) \ |
and isinstance(other, ClassGroupSingleton) \ |
604 |
and self.GetValue() == other.GetValue() |
and self.__value == other.__value |
605 |
|
|
606 |
|
def __repr__(self): |
607 |
|
return "(" + repr(self.__value) + ", " + ClassGroup.__repr__(self) + ")" |
608 |
|
|
609 |
class ClassGroupDefault(ClassGroup): |
class ClassGroupDefault(ClassGroup): |
610 |
"""The default Group. When values do not match any other |
"""The default Group. When values do not match any other |
643 |
and isinstance(other, ClassGroupDefault) \ |
and isinstance(other, ClassGroupDefault) \ |
644 |
and self.GetProperties() == other.GetProperties() |
and self.GetProperties() == other.GetProperties() |
645 |
|
|
646 |
|
def __repr__(self): |
647 |
|
return "(" + ClassGroup.__repr__(self) + ")" |
648 |
|
|
649 |
class ClassGroupRange(ClassGroup): |
class ClassGroupRange(ClassGroup): |
650 |
"""A Group that represents a range of values that map to the same |
"""A Group that represents a range of values that map to the same |
651 |
set of properties.""" |
set of properties.""" |
652 |
|
|
653 |
def __init__(self, min = 0, max = 1, props = None, label = "", group=None): |
def __init__(self, _range = (0,1), props = None, label = "", group=None): |
654 |
"""Constructor. |
"""Constructor. |
655 |
|
|
656 |
The minumum value must be strictly less than the maximum. |
The minumum value must be strictly less than the maximum. |
657 |
|
|
658 |
min -- the minimum range value |
_range -- either a tuple (min, max) where min < max or |
659 |
|
a Range object |
|
max -- the maximum range value |
|
660 |
|
|
661 |
prop -- a ClassGroupProperites object. If prop is None a default |
prop -- a ClassGroupProperites object. If prop is None a default |
662 |
set of properties is created. |
set of properties is created. |
664 |
label -- a label for this group. |
label -- a label for this group. |
665 |
""" |
""" |
666 |
|
|
667 |
ClassGroup.__init__(self, label, props, None) |
ClassGroup.__init__(self, label, props, group) |
668 |
|
self.SetRange(_range) |
|
self.min = self.max = 0 |
|
|
|
|
|
self.SetRange(min, max) |
|
669 |
|
|
670 |
def __copy__(self): |
def __copy__(self): |
671 |
return ClassGroupRange(self.GetMin(), |
return ClassGroupRange(self.__range, |
672 |
self.GetMax(), |
props = self.GetProperties(), |
673 |
self.GetProperties(), |
label = self.GetLabel()) |
|
self.GetLabel()) |
|
674 |
|
|
675 |
def __deepcopy__(self, memo): |
def __deepcopy__(self, memo): |
676 |
return ClassGroupRange(copy.copy(self.GetMin()), |
return ClassGroupRange(copy.copy(self.__range), |
|
copy.copy(self.GetMax()), |
|
677 |
group = self) |
group = self) |
678 |
|
|
679 |
def GetMin(self): |
def GetMin(self): |
680 |
"""Return the range's minimum value.""" |
"""Return the range's minimum value.""" |
681 |
return self.min |
return self.__range.GetRange()[1] |
682 |
|
|
683 |
def SetMin(self, min): |
def SetMin(self, min): |
684 |
"""Set the range's minimum value. |
"""Set the range's minimum value. |
687 |
maximum value. Use SetRange() to change both min and max values. |
maximum value. Use SetRange() to change both min and max values. |
688 |
""" |
""" |
689 |
|
|
690 |
self.SetRange(min, self.max) |
self.SetRange((min, self.__range.GetRange()[2])) |
691 |
|
|
692 |
def GetMax(self): |
def GetMax(self): |
693 |
"""Return the range's maximum value.""" |
"""Return the range's maximum value.""" |
694 |
return self.max |
return self.__range.GetRange()[2] |
695 |
|
|
696 |
def SetMax(self, max): |
def SetMax(self, max): |
697 |
"""Set the range's maximum value. |
"""Set the range's maximum value. |
699 |
max -- the new maximum. Note that this must be greater than the current |
max -- the new maximum. Note that this must be greater than the current |
700 |
minimum value. Use SetRange() to change both min and max values. |
minimum value. Use SetRange() to change both min and max values. |
701 |
""" |
""" |
702 |
self.SetRange(self.min, max) |
self.SetRange((self.__range.GetRange()[1], max)) |
703 |
|
|
704 |
def SetRange(self, min, max): |
def SetRange(self, _range): |
705 |
"""Set a new range. |
"""Set a new range. |
706 |
|
|
707 |
Note that min must be strictly less than max. |
_range -- Either a tuple (min, max) where min < max or |
708 |
|
a Range object. |
709 |
|
|
710 |
min -- the new minimum value |
Raises ValueError on error. |
|
min -- the new maximum value |
|
711 |
""" |
""" |
712 |
|
|
713 |
if min >= max: |
if isinstance(_range, Range): |
714 |
raise ValueError(_("ClassGroupRange: %i(min) >= %i(max)!") % |
self.__range = _range |
715 |
(min, max)) |
elif isinstance(_range, types.TupleType) and len(_range) == 2: |
716 |
self.min = min |
self.__range = Range(("[", _range[0], _range[1], "[")) |
717 |
self.max = max |
else: |
718 |
|
raise ValueError() |
719 |
|
|
720 |
def GetRange(self): |
def GetRange(self): |
721 |
"""Return the range as a tuple (min, max)""" |
"""Return the range as a string""" |
722 |
return (self.min, self.max) |
return self.__range.string(self.__range.GetRange()) |
723 |
|
|
724 |
|
def GetRangeTuple(self): |
725 |
|
return self.__range.GetRange() |
726 |
|
|
727 |
def Matches(self, value): |
def Matches(self, value): |
728 |
"""Determine if the given value lies with the current range. |
"""Determine if the given value lies with the current range. |
730 |
The following check is used: min <= value < max. |
The following check is used: min <= value < max. |
731 |
""" |
""" |
732 |
|
|
733 |
return self.min <= value < self.max |
return operator.contains(self.__range, value) |
734 |
|
|
735 |
def GetDisplayText(self): |
def GetDisplayText(self): |
736 |
label = self.GetLabel() |
label = self.GetLabel() |
737 |
|
|
738 |
if label != "": return label |
if label != "": return label |
739 |
|
|
740 |
return _("%s - %s") % (self.GetMin(), self.GetMax()) |
return self.__range.string(self.__range.GetRange()) |
741 |
|
|
742 |
def __eq__(self, other): |
def __eq__(self, other): |
743 |
return ClassGroup.__eq__(self, other) \ |
return ClassGroup.__eq__(self, other) \ |
744 |
and isinstance(other, ClassGroupRange) \ |
and isinstance(other, ClassGroupRange) \ |
745 |
and self.GetRange() == other.GetRange() |
and self.__range == other.__range |
746 |
|
|
747 |
|
def __repr__(self): |
748 |
|
return "(" + str(self.__range) + ClassGroup.__repr__(self) + ")" |
749 |
|
|
750 |
class ClassGroupMap(ClassGroup): |
class ClassGroupMap(ClassGroup): |
751 |
"""Currently, this class is not used.""" |
"""Currently, this class is not used.""" |