/[thuban]/branches/WIP-pyshapelib-bramz/Thuban/Model/classification.py

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

Parent Directory | Revision Log | View Patch Patch

-revision 374 by jan,
Mon Jan 27 14:20:02 2003 UTC
+revision 1909 by bh,
Fri Oct 31 18:16:34 2003 UTC
 Line 1
- # Copyright (c) 2001 by Intevation GmbH
+ # Copyright (c) 2001, 2003 by Intevation GmbH
  # Authors:
  # Jonathan Coles <[email protected]>
  #
 Line 13 
 to data. This mapping can be specified i
  First, specific values can be associated with data.
  Second, ranges can be associated with data such that if
  an input value falls with a range that data is returned.
- If no mapping can be found then a NullData data will
+ If no mapping can be found then default data will
  be returned. Input values must be hashable objects
- See the description of getProperties() for more information
+ See the description of FindGroup() for more information
  on the mapping algorithm.
  """
+ import copy, operator, types
  from Thuban import _
- # constants
+ from messages import \
- RANGE_MIN  = 0
+     LAYER_PROJECTION_CHANGED, \
- RANGE_MAX  = 1
+     LAYER_LEGEND_CHANGED, \
- RANGE_DATA = 2
+     LAYER_VISIBILITY_CHANGED,\
+     CLASS_CHANGED
+ from Thuban.Model.color import Color, Transparent, Black
+ from Thuban.Model.range import Range
+ import Thuban.Model.layer
+ from Thuban.Lib.connector import Publisher
+ class Classification(Publisher):
+     """Encapsulates the classification of layer.
+     The Classification divides some kind of data into Groups which
+     are associated with properties. Later the properties can be
+     retrieved by matching data values to the appropriate group.
+     """
+     def __init__(self):
+         """Initialize a classification."""
+         self.__groups = []
+         self.SetDefaultGroup(ClassGroupDefault())
+     def __iter__(self):
+         return ClassIterator(self.__groups)
+     def __deepcopy__(self, memo):
+         clazz = Classification()
+         clazz.__groups[0] = copy.deepcopy(self.__groups[0])
+         for i in range(1, len(self.__groups)):
+             clazz.__groups.append(copy.deepcopy(self.__groups[i]))
+         return clazz
+     def __SendNotification(self):
+         """Notify the layer that this class has changed."""
+         self.issue(CLASS_CHANGED)
+     #
+     # these SetDefault* methods are really only provided for
+     # some backward compatibility. they should be considered
+     # for removal once all the classification code is finished.
+     #
+     def SetDefaultFill(self, fill):
+         """Set the default fill color.
+         fill -- a Color object.
+         """
+         self.GetDefaultGroup().GetProperties().SetFill(fill)
+         self.__SendNotification()
+     def GetDefaultFill(self):
+         """Return the default fill color."""
+         return self.GetDefaultGroup().GetProperties().GetFill()
+     def SetDefaultLineColor(self, color):
+         """Set the default line color.
+         color -- a Color object.
+         """
+         self.GetDefaultGroup().GetProperties().SetLineColor(color)
+         self.__SendNotification()
+     def GetDefaultLineColor(self):
+         """Return the default line color."""
+         return self.GetDefaultGroup().GetProperties().GetLineColor()
+     def SetDefaultLineWidth(self, lineWidth):
+         """Set the default line width.
+         lineWidth -- an integer > 0.
+         """
+         assert isinstance(lineWidth, types.IntType)
+         self.GetDefaultGroup().GetProperties().SetLineWidth(lineWidth)
+         self.__SendNotification()
+     def GetDefaultLineWidth(self):
+         """Return the default line width."""
+         return self.GetDefaultGroup().GetProperties().GetLineWidth()
+     #
+     # The methods that manipulate self.__groups have to be kept in
+     # sync. We store the default group in index 0 to make it
+     # convienent to iterate over the classification's groups, but
+     # from the user's perspective the first (non-default) group is
+     # at index 0 and the DefaultGroup is a special entity.
+     #
- class Classification:
+     def SetDefaultGroup(self, group):
+         """Set the group to be used when a value can't be classified.
+         group -- group that the value maps to.
+         """
+         assert isinstance(group, ClassGroupDefault)
+         if len(self.__groups) > 0:
+             self.__groups[0] = group
+         else:
+             self.__groups.append(group)
+         self.__SendNotification()
+     def GetDefaultGroup(self):
+         """Return the default group."""
+         return self.__groups[0]
-     def __init__(self, field = None):
+     def AppendGroup(self, item):
-         """Initialize a classification.
+         """Append a new ClassGroup item to the classification.
-            field -- the name of the data table field that
+         item -- this must be a valid ClassGroup object
-                     is to be used to classify layer properties
          """
+         self.InsertGroup(self.GetNumGroups(), item)
+     def InsertGroup(self, index, group):
+         assert isinstance(group, ClassGroup)
+         self.__groups.insert(index + 1, group)
+         self.__SendNotification()
+     def RemoveGroup(self, index):
+         """Remove the classification group with the given index"""
+         self.__groups.pop(index + 1)
+         self.__SendNotification()
+     def ReplaceGroup(self, index, group):
+         assert isinstance(group, ClassGroup)
+         self.__groups[index + 1] = group
+         self.__SendNotification()
+     def GetGroup(self, index):
+         return self.__groups[index + 1]
+     def GetNumGroups(self):
+         """Return the number of non-default groups in the classification."""
+         return len(self.__groups) - 1
+     def FindGroup(self, value):
+         """Return the associated group, or the default group.
+         Groups are checked in the order the were added to the
+         Classification.
+         value -- the value to classify. If there is no mapping,
+                  the field is None or value is None,
+                  return the default properties
+         """
+         if value is not None:
+             for i in range(1, len(self.__groups)):
+                 group = self.__groups[i]
+                 if group.Matches(value):
+                     return group
+         return self.GetDefaultGroup()
+     def GetProperties(self, value):
+         """Return the properties associated with the given value.
+         Use this function rather than Classification.FindGroup().GetProperties()
+         since the returned group may be a ClassGroupMap which doesn't support
+         a call to GetProperties().
+         """
+         group = self.FindGroup(value)
+         if isinstance(group, ClassGroupMap):
+             return group.GetPropertiesFromValue(value)
+         else:
+             return group.GetProperties()
+     def TreeInfo(self):
+         items = []
+         def build_color_item(text, color):
+             if color is Transparent:
+                 return ("%s: %s" % (text, _("None")), None)
+             return ("%s: (%.3f, %.3f, %.3f)" %
+                     (text, color.red, color.green, color.blue),
+                     color)
+         def build_item(group, string):
+             label = group.GetLabel()
+             if label == "":
+                 label = string
+             else:
+                 label += " (%s)" % string
+             props = group.GetProperties()
+             i = []
+             v = props.GetLineColor()
+             i.append(build_color_item(_("Line Color"), v))
+             v = props.GetLineWidth()
+             i.append(_("Line Width: %s") % v)
+             v = props.GetFill()
+             i.append(build_color_item(_("Fill"), v))
+             return (label, i)
+         for p in self:
+             items.append(build_item(p, p.GetDisplayText()))
+         return (_("Classification"), items)
-         self.__points = {}
+ class ClassIterator:
-         self.__ranges = []
+     """Allows the Groups in a Classifcation to be interated over.
-         self.setField(field)
-         self.setNull(None)
+     The items are returned in the following order:
+         default data, singletons, ranges, maps
+     """
+     def __init__(self, data): #default, points, ranges, maps):
+         """Constructor.
+         default -- the default group
+         points -- a list of singleton groups
+         ranges -- a list of range groups
+         maps -- a list of map groups
+         """
+         self.data = data
+         self.data_index = 0
+     def __iter__(self):
+         return self
+     def next(self):
+         """Return the next item."""
+         if self.data_index >= len(self.data):
+             raise StopIteration
+         else:
+             d = self.data[self.data_index]
+             self.data_index += 1
+             return d
-     def setField(self, field):
+ class ClassGroupProperties:
-         """Set the name of the data table field to use.
+     """Represents the properties of a single Classification Group.
-            field -- if None then all values map to NullData
+     These are used when rendering a layer."""
+     def __init__(self, props = None):
+         """Constructor.
+         props -- a ClassGroupProperties object. The class is copied if
+                  prop is not None. Otherwise, a default set of properties
+                  is created such that: line color = Black, line width = 1,
+                  and fill color = Transparent
          """
-         self.field = field
+         if props is not None:
+             self.SetProperties(props)
+         else:
+             self.SetLineColor(Black)
+             self.SetLineWidth(1)
+             self.SetFill(Transparent)
+     def SetProperties(self, props):
+         """Set this class's properties to those in class props."""
+         assert isinstance(props, ClassGroupProperties)
+         self.SetLineColor(props.GetLineColor())
+         self.SetLineWidth(props.GetLineWidth())
+         self.SetFill(props.GetFill())
+     def GetLineColor(self):
+         """Return the line color as a Color object."""
+         return self.__stroke
-     def setNull(self, data):
+     def SetLineColor(self, color):
-         """Set the data to be used when a value can't be classified.
+         """Set the line color.
-            data -- data that the value maps to. See class description.
+         color -- the color of the line. This must be a Color object.
          """
-         self.NullData = data
+         self.__stroke = color
-     def addRange(self, min, max, data):
+     def GetLineWidth(self):
-         """Add a new range to the classification.
+         """Return the line width."""
+         return self.__strokeWidth
-            A range allows a value to be classified if it falls between
+     def SetLineWidth(self, lineWidth):
-            min and max. Specifically, min <= value < max
+         """Set the line width.
-            min -- the lower bound.
-            max -- the upper bound.
+         lineWidth -- the new line width. This must be > 0.
+         """
+         assert isinstance(lineWidth, types.IntType)
+         if (lineWidth < 1):
+             raise ValueError(_("lineWidth < 1"))
+         self.__strokeWidth = lineWidth
+     def GetFill(self):
+         """Return the fill color as a Color object."""
+         return self.__fill
+     def SetFill(self, fill):
+         """Set the fill color.
-            data -- data that the value maps to. See class description.
+         fill -- the color of the fill. This must be a Color object.
          """
-         if min >= max:
+         self.__fill = fill
-             raise ValueError(_("Range minimum >= maximum!"))
-         self.__ranges.append([min, max, data])
+     def __eq__(self, other):
+         """Return true if 'props' has the same attributes as this class"""
-     def addPoint(self, value, data):
+         #
-         """Associate a single value with data.
+         # using 'is' over '==' results in a huge performance gain
+         # in the renderer
+         #
+         return isinstance(other, ClassGroupProperties)   \
+             and (self.__stroke is other.__stroke or      \
+                  self.__stroke == other.__stroke)        \
+             and (self.__fill is other.__fill or          \
+                  self.__fill == other.__fill)            \
+             and self.__strokeWidth == other.__strokeWidth
-            When this value is to be classified data will be returned.
+     def __ne__(self, other):
+         return not self.__eq__(other)
-            value -- classification value.
+     def __copy__(self):
+         return ClassGroupProperties(self)
-            data  -- data that the value maps to. See class description.
+     def __deepcopy__(self):
+         return ClassGroupProperties(self)
+     def __repr__(self):
+         return repr((self.__stroke, self.__strokeWidth, self.__fill))
+ class ClassGroup:
+     """A base class for all Groups within a Classification"""
+     def __init__(self, label = "", props = None, group = None):
+         """Constructor.
+         label -- A string representing the Group's label
+         """
+         if group is not None:
+             self.SetLabel(copy.copy(group.GetLabel()))
+             self.SetProperties(copy.copy(group.GetProperties()))
+             self.SetVisible(group.IsVisible())
+         else:
+             self.SetLabel(label)
+             self.SetProperties(props)
+             self.SetVisible(True)
+     def GetLabel(self):
+         """Return the Group's label."""
+         return self.label
+     def SetLabel(self, label):
+         """Set the Group's label.
+         label -- a string representing the Group's label. This must
+                  not be None.
          """
+         assert isinstance(label, types.StringTypes)
+         self.label = label
-         self.__points[value] = data
+     def GetDisplayText(self):
+         assert False, "GetDisplay must be overridden by subclass!"
+         return ""
-     def getProperties(self, value):
+     def Matches(self, value):
-         """Return the associated data, or the NullData.
+         """Determines if this Group is associated with the given value.
-            The following search technique is used:
+         Returns False. This needs to be overridden by all subclasses.
-                (1) if the field is None, return NullData
+         """
-                (2) check if the value exists as a single value
+         assert False, "GetMatches must be overridden by subclass!"
-                (3) check if the value falls within a range. Ranges
+         return False
-                    are checked in the order they were added to
-                    the classification.
+     def GetProperties(self):
+         """Return the properties associated with the given value."""
+         return self.prop
+     def SetProperties(self, prop):
+         """Set the properties associated with this Group.
-            value -- the value to classify. If there is no mapping
+         prop -- a ClassGroupProperties object. if prop is None,
-                     return the NullData (which may be None)
+                 a default set of properties is created.
          """
-         if self.field is not None:
+         if prop is None: prop = ClassGroupProperties()
-             #
+         assert isinstance(prop, ClassGroupProperties)
-             # first check the discrete values
+         self.prop = prop
-             #
-             if self.__points.has_key(value):
+     def IsVisible(self):
-                 return self.__points[value]
+         return self.visible
+     def SetVisible(self, visible):
+         self.visible = visible
+     def __eq__(self, other):
+         return isinstance(other, ClassGroup) \
+             and self.label == other.label \
+             and self.GetProperties() == other.GetProperties()
+     def __ne__(self, other):
+         return not self.__eq__(other)
+     def __repr__(self):
+         return repr(self.label) + ", " + repr(self.GetProperties())
+ class ClassGroupSingleton(ClassGroup):
+     """A Group that is associated with a single value."""
+     def __init__(self, value = 0, props = None, label = "", group = None):
+         """Constructor.
+         value -- the associated value.
+         prop -- a ClassGroupProperites object. If prop is None a default
+                  set of properties is created.
+         label -- a label for this group.
+         """
+         ClassGroup.__init__(self, label, props, group)
+         self.SetValue(value)
+     def __copy__(self):
+         return ClassGroupSingleton(self.GetValue(),
+                                    self.GetProperties(),
+                                    self.GetLabel())
+     def __deepcopy__(self, memo):
+         return ClassGroupSingleton(self.GetValue(), group = self)
+     def GetValue(self):
+         """Return the associated value."""
+         return self.__value
+     def SetValue(self, value):
+         """Associate this Group with the given value."""
+         self.__value = value
+     def Matches(self, value):
+         """Determine if the given value matches the associated Group value."""
+         """Returns True if the value matches, False otherwise."""
+         return self.__value == value
+     def GetDisplayText(self):
+         label = self.GetLabel()
+         if label != "": return label
+         return str(self.GetValue())
+     def __eq__(self, other):
+         return ClassGroup.__eq__(self, other) \
+             and isinstance(other, ClassGroupSingleton) \
+             and self.__value == other.__value
+     def __repr__(self):
+         return "(" + repr(self.__value) + ", " + ClassGroup.__repr__(self) + ")"
+ class ClassGroupDefault(ClassGroup):
+     """The default Group. When values do not match any other
+        Group within a Classification, the properties from this
+        class are used."""
+     def __init__(self, props = None, label = "", group = None):
+         """Constructor.
+         prop -- a ClassGroupProperites object. If prop is None a default
+                  set of properties is created.
+         label -- a label for this group.
+         """
+         ClassGroup.__init__(self, label, props, group)
+     def __copy__(self):
+         return ClassGroupDefault(self.GetProperties(), self.GetLabel())
+     def __deepcopy__(self, memo):
+         return ClassGroupDefault(label = self.GetLabel(), group = self)
+     def Matches(self, value):
+         return True
+     def GetDisplayText(self):
+         label = self.GetLabel()
+         if label != "": return label
+         return _("DEFAULT")
+     def __eq__(self, other):
+         return ClassGroup.__eq__(self, other) \
+             and isinstance(other, ClassGroupDefault) \
+             and self.GetProperties() == other.GetProperties()
+     def __repr__(self):
+         return "(" + ClassGroup.__repr__(self) + ")"
+ class ClassGroupRange(ClassGroup):
+     """A Group that represents a range of values that map to the same
+        set of properties."""
+     def __init__(self, _range = (0,1), props = None, label = "", group=None):
+         """Constructor.
+         The minumum value must be strictly less than the maximum.
+         _range -- either a tuple (min, max) where min < max or
+                   a Range object
+         prop -- a ClassGroupProperites object. If prop is None a default
+                  set of properties is created.
+         label -- a label for this group.
+         """
+         ClassGroup.__init__(self, label, props, group)
+         self.SetRange(_range)
+     def __copy__(self):
+         return ClassGroupRange(self.__range,
+                                props = self.GetProperties(),
+                                label = self.GetLabel())
+     def __deepcopy__(self, memo):
+         return ClassGroupRange(copy.copy(self.__range),
+                                group = self)
+     def GetMin(self):
+         """Return the range's minimum value."""
+         return self.__range.GetRange()[1]
+     def SetMin(self, min):
+         """Set the range's minimum value.
+         min -- the new minimum. Note that this must be less than the current
+                maximum value. Use SetRange() to change both min and max values.
+         """
+         self.SetRange((min, self.__range.GetRange()[2]))
+     def GetMax(self):
+         """Return the range's maximum value."""
+         return self.__range.GetRange()[2]
+     def SetMax(self, max):
+         """Set the range's maximum value.
+         max -- the new maximum. Note that this must be greater than the current
+                minimum value. Use SetRange() to change both min and max values.
+         """
+         self.SetRange((self.__range.GetRange()[1], max))
+     def SetRange(self, _range):
+         """Set a new range.
+         _range -- Either a tuple (min, max) where min < max or
+                   a Range object.
+         Raises ValueError on error.
+         """
+         if isinstance(_range, Range):
+             self.__range = _range
+         elif isinstance(_range, types.TupleType) and len(_range) == 2:
+             self.__range = Range(("[", _range[0], _range[1], "["))
+         else:
+             raise ValueError()
+     def GetRange(self):
+         """Return the range as a string"""
+         return self.__range.string(self.__range.GetRange())
+     def Matches(self, value):
+         """Determine if the given value lies with the current range.
+         The following check is used: min <= value < max.
+         """
+         return operator.contains(self.__range, value)
+     def GetDisplayText(self):
+         label = self.GetLabel()
+         if label != "": return label
+         return self.__range.string(self.__range.GetRange())
+     def __eq__(self, other):
+         return ClassGroup.__eq__(self, other) \
+             and isinstance(other, ClassGroupRange) \
+             and self.__range == other.__range
+     def __repr__(self):
+         return "(" + str(self.__range) + ClassGroup.__repr__(self) + ")"
+ class ClassGroupMap(ClassGroup):
+     """Currently, this class is not used."""
+     FUNC_ID = "id"
+     def __init__(self, map_type = FUNC_ID, func = None, prop = None, label=""):
+         ClassGroup.__init__(self, label)
+         self.map_type = map_type
+         self.func = func
+         if self.func is None:
+             self.func = func_id
+     def Map(self, value):
+         return self.func(value)
+     def GetProperties(self):
+         return None
-             #
+     def GetPropertiesFromValue(self, value):
-             # now check the ranges
+         pass
-             #
-             for p in self.__ranges:
-                 if (p[RANGE_MIN] <= value) and (value < p[RANGE_MAX]):
-                     return p[RANGE_DATA]
+     def GetDisplayText(self):
+         return "Map: " + self.map_type
-         return self.NullData
+     #
+     # built-in mappings
+     #
+     def func_id(value):
+         return value

 Legend:



Removed from v.374
 


changed lines


 
Added in v.1909
 Legend:



Removed from v.374
 


changed lines


 
Added in v.1909
-Removed from v.374
+Added in v.1909

[email protected]	ViewVC Help
Powered by ViewVC 1.1.26