File: //opt/alt/python27/lib64/python2.7/site-packages/matplotlib/units.pyc
�
�)�Uc @ sw d Z d d l Z d d l m Z m Z m Z d d
d � � YZ d d d � � YZ d e f d � � YZ
e
� Z d S( sQ
The classes here provide support for using custom classes with
matplotlib, eg those that do not expose the array interface but know
how to converter themselves to arrays. It also supoprts classes with
units and units conversion. Use cases include converters for custom
objects, eg a list of datetime objects, as well as for objects that
are unit aware. We don't assume any particular units implementation,
rather a units implementation must provide a ConversionInterface, and
the register with the Registry converter dictionary. For example,
here is a complete implementation which supports plotting with native
datetime objects::
import matplotlib.units as units
import matplotlib.dates as dates
import matplotlib.ticker as ticker
import datetime
class DateConverter(units.ConversionInterface):
@staticmethod
def convert(value, unit, axis):
'convert value to a scalar or array'
return dates.date2num(value)
@staticmethod
def axisinfo(unit, axis):
'return major and minor tick locators and formatters'
if unit!='date': return None
majloc = dates.AutoDateLocator()
majfmt = dates.AutoDateFormatter(majloc)
return AxisInfo(majloc=majloc,
majfmt=majfmt,
label='date')
@staticmethod
def default_units(x, axis):
'return the default unit for x or None'
return 'date'
# finally we register our object type with a converter
units.registry[datetime.date] = DateConverter()
i����N( t iterablet
is_numliket is_string_liket AxisInfoc B s) e Z d Z d d d d d d d � Z RS( sR information to support default axis labeling and tick labeling, and default limitsc C s: | | _ | | _ | | _ | | _ | | _ | | _ d S( sW
majloc and minloc: TickLocators for the major and minor ticks
majfmt and minfmt: TickFormatters for the major and minor ticks
label: the default axis label
default_limits: the default min, max of the axis if no data is present
If any of the above are None, the axis will simply use the default
N( t majloct minloct majfmtt minfmtt labelt default_limits( t selfR R R R R R ( ( sC /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/units.pyt __init__2 s
N( t __name__t
__module__t __doc__t NoneR ( ( ( sC /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/units.pyR 0 s t ConversionInterfacec B sJ e Z d Z e d � � Z e d � � Z e d � � Z e d � � Z RS( s�
The minimal interface for a converter to take custom instances (or
sequences) and convert them to values mpl can use
c C s d S( sC return an units.AxisInfo instance for axis with the specified unitsN( R ( t unitt axis( ( sC /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/units.pyt axisinfoI s c C s d S( s8 return the default unit for x or None for the given axisN( R ( t xR ( ( sC /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/units.pyt
default_unitsN s c C s | S( s�
convert obj using unit for the specified axis. If obj is a sequence,
return the converted sequence. The ouput must be a sequence of scalars
that can be used by the numpy array layer
( ( t objR R ( ( sC /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/units.pyt convertS s c C s5 t | � r'