Logo Search packages:      
Sourcecode: matplotlib version File versions  Download package

mpltraits.py

# External imports
import enthought.traits.api as T

# Matplotlib-specific imports
import cutils

# For the fontconfig pattern parser
from matplotlib.fontconfig_pattern import parse_fontconfig_pattern

# stolen from cbook
def is_string_like(obj):
    if hasattr(obj, 'shape'): return 0 # this is a workaround
                                       # for a bug in numeric<23.1
    try: obj + ''
    except (TypeError, ValueError): return 0
    return 1


##############################################################################
# Handlers and other support functions and data structures
##############################################################################


00024 class BackendHandler(T.TraitHandler):
    """
    """
    backends = {'agg': 'Agg',
                'cairo': 'Cairo',
                'cocoaagg': 'CocoaAgg',
                'fltkagg': 'FltkAgg',
                'gtk': 'GTK',
                'gtkagg': 'GTKAgg',
                'gtkcairo': 'GTKCairo',
                'pdf': 'Pdf',
                'ps': 'PS',
                'qt4agg': 'Qt4Agg',
                'qtagg': 'QtAgg',
                'svg': 'SVG',
                'template': 'Template',
                'tkagg': 'TkAgg',
                'wx': 'WX',
                'wxagg': 'WXAgg'}

    def validate(self, object, name, value):
        try:
            return self.backends[value.lower()]
        except:
            return self.error(object, name, value)

    def info(self):
        be = self.backends.keys()
        be.sort
        return "one of: %s"% ' | '.join(['%s'%i for i in be])


00056 class BoolHandler(T.TraitHandler):
    """
    """

    bools = {'true': True,
             'yes': True,
             'y' : True,
             'on': True,
             1: True,
             True: True,
             'false': False,
             'no': False,
             'n': False,
             'off': False,
             0: False,
             False: False}
       
    def validate(self, object, name, value):
        try:
            return self.bools[value]
        except:
            return self.error(object, name, value)

    def info(self):
        return "one of: %s"% ' | '.join(['%s'%i for i in self.bools.keys()])

flexible_true = T.Trait(True, BoolHandler())
flexible_false = T.Trait(False, BoolHandler())

00085 class ColorHandler(T.TraitHandler):
    """
    """
       
    def validate(self, object, name, value):
        s=value
        if s.lower() == 'none': return 'None'
        if len(s)==1 and s.isalpha(): return s
        if s.find(',')>=0: # looks like an rgb
            # get rid of grouping symbols
            s = ''.join([ c for c in s if c.isdigit() or c=='.' or c==','])
            vals = s.split(',')
            if len(vals)!=3:
                raise ValueError('Color tuples must be length 3')

            try: return [float(val) for val in vals]
            except ValueError:
                raise ValueError('Could not convert all entries "%s" to floats'%s)

        if s.replace('.', '').isdigit(): # looks like scalar (grayscale)
            return s

        if len(s)==6 and s.isalnum(): # looks like hex
            return '#' + s
    
        if len(s)==7 and s.startswith('#') and s[1:].isalnum():
            return s

        if s.isalpha():
            #assuming a color name, hold on
            return s

        raise ValueError('%s does not look like color arg'%s)

    def info(self):
        return """\
any valid matplotlib color, eg an abbreviation like 'r' for red, a full
name like 'orange', a hex color like '#efefef', a grayscale intensity
like '0.5', or an RGBA tuple (1,0,0,1)"""


class IsWritableDir(T.TraitHandler):
    def validate(self, object, name, value):
        if cutils.is_writable_dir(value):
            return value
        else:
            raise OSError('%s is not a writable directory'%value)


colormaps = ['Accent', 'Accent_r', 'Blues', 'Blues_r', 'BrBG', 'BrBG_r', 'BuGn',
             'BuGn_r', 'BuPu', 'BuPu_r', 'Dark2', 'Dark2_r', 'GnBu', 'GnBu_r', 
             'Greens', 'Greens_r', 'Greys', 'Greys_r', 'OrRd', 
             'OrRd_r', 'Oranges', 'Oranges_r', 'PRGn', 'PRGn_r', 'Paired', 
             'Paired_r', 'Pastel1', 'Pastel1_r', 'Pastel2', 'Pastel2_r', 'PiYG',
             'PiYG_r', 'PuBu', 'PuBuGn', 'PuBuGn_r', 'PuBu_r', 'PuOr', 'PuOr_r',
             'PuRd', 'PuRd_r', 'Purples', 'Purples_r', 'RdBu', 'RdBu_r', 'RdGy',
             'RdGy_r', 'RdPu', 'RdPu_r', 'RdYlBu', 'RdYlBu_r', 'RdYlGn', 
             'RdYlGn_r', 'Reds', 'Reds_r', 'Set1', 'Set1_r', 'Set2', 'Set2_r', 
             'Set3', 'Set3_r', 'Spectral', 'Spectral_r', 'YlGn', 'YlGnBu', 
             'YlGnBu_r', 'YlGn_r', 'YlOrBr', 'YlOrBr_r', 'YlOrRd', 'YlOrRd_r', 
             'autumn', 'autumn_r', 'binary', 'binary_r', 'bone', 'bone_r', 
             'cool', 'cool_r', 'copper', 'copper_r', 'flag', 
             'flag_r', 'gist_earth', 'gist_earth_r', 'gist_gray', 'gist_gray_r',
             'gist_heat', 'gist_heat_r', 'gist_ncar', 'gist_ncar_r', 
             'gist_rainbow', 'gist_rainbow_r', 'gist_stern', 'gist_stern_r', 
             'gist_yarg', 'gist_yarg_r', 'gray', 'gray_r', 'hot', 'hot_r', 
             'hsv', 'hsv_r', 'jet', 'jet_r', 'pink', 'pink_r', 
             'prism', 'prism_r', 'spectral', 'spectral_r', 'spring', 
             'spring_r', 'summer', 'summer_r', 'winter', 'winter_r']

00155 class FontconfigPatternHandler(T.TraitHandler):
    """This validates a fontconfig pattern by using the FontconfigPatternParser.
    The results are not actually used here, since we can't instantiate a
    FontProperties object at config-parse time."""
    def validate(self, object, name, value):
        # This will throw a ValueError if value does not parse correctly
        parse_fontconfig_pattern(value)
        return value

    def info(self):
        return """A fontconfig pattern.  See the fontconfig user manual for more information."""

Generated by  Doxygen 1.6.0   Back to index