}+zJc @ s d Z d d k i Z d d k l Z d d k Z d d k Z d e f d YZ
d e f d YZ d e
f d YZ d
e
f d YZ
d d d
YZ h Z d Z d d k l Z e e Z d Z d Z d Z d Z e d j o e e n d S( s
The axes_divider module provide helper classes to adjust the positions of
multiple axes at the drawing time.
Divider: this is the class that is used calculates the axes
position. It divides the given renctangular area into several sub
rectangles. You intialize the divider by setting the horizontal
and vertical list of sizes that the division will be based on. You
then use the new_locator method, whose return value is a callable
object that can be used to set the axes_locator of the axes.
iN( t SubplotBaset Dividerc B s e Z d Z d d d Z e d Z e d Z d Z d Z d Z
d Z d Z d
Z
d Z d Z e d
Z d Z d d d d Z d d d Z RS( s
This is the class that is used calculates the axes position. It
divides the given renctangular area into several
sub-rectangles. You intialize the divider by setting the
horizontal and vertical lists of sizes
(:mod:`mpl_toolkits.axes_grid.axes_size`) that the division will
be based on. You then use the new_locator method to create a
callable object that can be used to as the axes_locator of the
axes.
t Cc C sL | | _ | | _ | | _ | | _ | | _ | | _ d | _ d | _ d S( s
:param fig: matplotlib figure
:param pos: position (tuple of 4 floats) of the rectangle that
will be divided.
:param horizontal: list of sizes
(:mod:`~mpl_toolkits.axes_grid.axes_size`)
for horizontal division
:param vertical: list of sizes
(:mod:`~mpl_toolkits.axes_grid.axes_size`)
for vertical division
:param aspect: if True, the overall rectalngular area is reduced
so that the relative part of the horizontal and
vertical scales have same scale.
:param anchor: Detrmine how the reduced rectangle is placed
when aspect is True,
i N( t _figt _post _horizontalt _verticalt _anchort _aspectt
_xrefindext
_yrefindex( t selft figt post
horizontalt verticalt aspectt anchor( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt __init__$ s c C sn d \ } } x7 | D]/ } | i | \ } } | | 7} | | 7} q W| d j o | | | } | Sd Sd S( Ng ( g g ( t get_size( t lt
total_sizet renderert rs_sumt as_sumt st _rst _ast k( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt _calc_k@ s
c C sP d g } x@ | D]8 } | i | \ } } | i | d | | | q W| S( Ng i( R t append( R R R t offsetsR R R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt
_calc_offsetsQ s !c C s
| | _ d S( s
set the position of the rectangle.
:param pos: position (tuple of 4 floats) of the rectangle that
will be divided.
N( R ( R R
( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt set_position] s c C s | i S( s% return the position of the rectangle.( R ( R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt get_positionf s c C sb | t i i i j p t | d j o
| | _ n& t d d i t i i i d S( s
:param anchor: anchor position
===== ============
value description
===== ============
'C' Center
'SW' bottom left
'S' bottom
'SE' bottom right
'E' right
'NE' top right
'N' top
'NW' top left
'W' left
===== ============
i s argument must be among %ss , N( t mtransformst Bboxt coefst keyst lenR t
ValueErrort joint BBox( R R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt
set_anchorj s ,
c C s | i S( s return the anchor( R ( R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt
get_anchor s c C s
| | _ d S( s
:param horizontal: list of sizes
(:mod:`~mpl_toolkits.axes_grid.axes_size`)
for horizontal division
N( R ( R t h( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt set_horizontal s c C s | i S( s return horizontal sizes( R ( R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt get_horizontal s c C s
| | _ d S( s
:param horizontal: list of sizes
(:mod:`~mpl_toolkits.axes_grid.axes_size`)
for horizontal division
N( R ( R t v( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt set_vertical s c C s | i S( s return vertical sizes( R ( R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt get_vertical s c C s
| | _ d S( s.
:param anchor: True or False
N( R ( R R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt
set_aspect s c C s | i S( s
return aspect( R ( R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt
get_aspect s c C s | i i \ } } | i \ } } }
} | i | i | |
| } | i | i | | | }
| i o t | |
} | i | i | | } | i | i | | } | d | d | } | d | d | } t i
i | | |
| } t i
i | | | | } | i | i
| } | i | i } } n> | i | i | | } | i | i |
| } | | } } | d j o | d } n | d j o | d } n | | | | | | | | | } } | | | | | | | | | } } t i
i | | | | S( sT
:param nx, nx1: Integers specifying the column-position of the
cell. When nx1 is None, a single nx-th column is
specified. Otherwise location of columns spanning between nx
to nx1 (but excluding nx1-th column) is specified.
:param ny, ny1: same as nx and nx1, but for row positions.
ii i N( R t get_size_inchesR" R R R R4 t minR R# R$ t from_boundst anchoredR, t x0t y0t None( R t nxt nyt nx1t ny1R t figWt figHt xt yt wR- t k_ht k_vR t oxt oyt wwt hht pbt pb1t pb1_anchoredR9 R: t x1t w1t y1t h1( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt locate s0
))c C s t | | | | | S( s
returns a new locator
(:class:`mpl_toolkits.axes_grid.axes_divider.AxesLocator`) for
specified cell.
:param nx, nx1: Integers specifying the column-position of the
cell. When nx1 is None, a single nx-th column is
specified. Otherwise location of columns spanning between nx
to nx1 (but excluding nx1-th column) is specified.
:param ny, ny1: same as nx and nx1, but for row positions.
( t AxesLocator( R R< R= R> R? ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt new_locator s
N( t __name__t
__module__t __doc__R; R t staticmethodR R R! R" R+ R, R. R/ R1 R2 t FalseR3 R4 RR RT ( ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR s
/RS c B s& e Z d Z d d d Z d Z RS( s}
A simple callable object, initiallized with AxesDivider class,
returns the position and size of the given cell.
c C s | | _ | i } | i } | | | | | _ | _ | d j o | d } n | d j o | d } n | | | _ | | | _ d S( s
:param axes_divider: An instance of AxesDivider class.
:param nx, nx1: Integers specifying the column-position of the
cell. When nx1 is None, a single nx-th column is
specified. Otherwise location of columns spanning between nx
to nx1 (but excluding nx1-th column) is is specified.
:param ny, ny1: same as nx and nx1, but for row positions.
i N( t
_axes_dividerR R
t _nxt _nyR; t _nx1t _ny1( R t axes_dividerR< R= R> R? R R
( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR s
c C sP | i i } | i i } | i i | i | | i | | i | | i | | S( N( RZ R R
RR R[ R\ R] R^ ( R t axesR R R
( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt __call__ s
N( RU RV RW R; R Ra ( ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyRS s t SubplotDividerc B s) e Z d Z d Z d Z d Z RS( sT
The Divider class whose rectangle area is specified as a subplot grometry.
c
O s | | _ t | d j oO t | d } t | d j o t d n t t | \ } } } n3 t | d j o | \ } } } n
t d | | } | d 8} | | j o t d n | | _ | | _ | | _ | i | i
i } | i d g }
| i d g } | i d d
} | i d
d }
| o t d n t i | | | |
| d | d
|
d
S( s
*fig* is a :class:`matplotlib.figure.Figure` instance.
*args* is the tuple (*numRows*, *numCols*, *plotNum*), where
the array of subplots in the figure has dimensions *numRows*,
*numCols*, and where *plotNum* is the number of the subplot
being created. *plotNum* starts at 1 in the upper left
corner and increases to the right.
If *numRows* <= *numCols* <= *plotNum* < 10, *args* can be the
decimal integer *numRows* * 100 + *numCols* * 10 + *plotNum*.
i i i s+ Argument to subplot must be a 3 digits longs Illegal argument to subplots% Subplot number exceeds total subplotsR R R R R t N( t figureR' t strR( t mapt intt _rowst _colst _numt
update_paramst figboxt boundst popR; t ExceptionR R ( R R t argst kwargsR t rowst colst numt totalR
R R R R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR s4
c C s | i | i i S( s$ return the bounds of the subplot box( Rk Rl Rm ( R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR" R s
c C s | i } | i } | i } | i i } | i } | i } | i } | i } | i } | i
}
| | } | | } | | |
| d }
|
|
} | | | | d } | | } t | | \ } } | | d |
| | } | | | | } t i
i | | | |
| _ d S( s0 update the subplot position from fig.subplotparsi N( Rh Ri Rj Rd t subplotparst leftt rightt bottomt topt wspacet hspacet divmodR# R$ R7 Rl ( R Rr Rs Rt t parsRw Rx Ry Rz R{ R| t totWidtht totHeightRA t sepHR@ t sepWt rowNumt colNumt figBottomt figLeft( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyRk X s*
( RU RV RW R R" Rk ( ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyRb s 3 t AxesDividerc B sY e Z d Z d Z d Z d e d Z d e d Z d Z d Z
d Z RS( s1
Divider based on the pre-existing axes.
c C st | | _ t i | | _ t i | | _ t i | d | i d d d | i g d | i g d d d d d S( s#
:param axes: axes
R R
R R R R R N(
t _axest Sizet AxesXt _xreft AxesYt _yrefR R t
get_figureR; ( R R` ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR } s c K s} | i } | i d d } | d j o- t | t o
| i } qU t | } n | | i | i d t | } | S( Nt
axes_classt original(
R Rn R; t
isinstanceR t _axes_classt typeR R" t True( R Rq R` R t ax( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt
_get_new_axes s
c K se | op t | t i p t i | d | i } n | o& | i i d | | i d 7_ qw | i i | n t | t i p t i | d | i } n | o> | i i d | | i d 7_ | i d d d d } n6 | i i | | i d t
| i d d d } | i | } | i d t
| i d d d } | i | | S( s
Add a new axes on the right (or left) side of the main axes.
:param size: A width of the axes. A :mod:`~mpl_toolkits.axes_grid.axes_size`
instance or if float or string is given, *from_any*
fucntion is used to create one, with *ref_size* set to AxesX instance
of the current axes.
:param pad: pad between the axes. It takes same argument as *size*.
:param pack_start: If False, the new axes is appended at the end
of the list, i.e., it became the right-most axes. If True, it is
inseted at the start of the list, and becomes the left-most axes.
All extra keywords argument is passed to when creating a axes.
if *axes_class* is given, the new axes will be created as an
instance of the given class. Otherwise, the same class of the
main axes will be used. if Not provided
t fraction_refi i R< R= (
R R t _Baset from_anyR R t insertR R RT R' R t set_axes_locator( R t sizet padt
pack_startRq t locatorR ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt new_horizontal s* %%
c K s@ | op t | t i p t i | d | i } n | o& | i i d | | i d 7_ qw | i i | n t | t i p t i | d | i } n | o> | i i d | | i d 7_ | i d d d d } n6 | i i | | i d d d t
| i d } | i | } | i | | S( s
Add a new axes on the top (or bottom) side of the main axes.
:param size: A height of the axes. A :mod:`~mpl_toolkits.axes_grid.axes_size`
instance or if float or string is given, *from_any*
fucntion is used to create one, with *ref_size* set to AxesX instance
of the current axes.
:param pad: pad between the axes. It takes same argument as *size*.
:param pack_start: If False, the new axes is appended at the end
of the list, i.e., it became the top-most axes. If True, it is
inseted at the start of the list, and becomes the bottom-most axes.
All extra keywords argument is passed to when creating a axes.
if *axes_class* is given, the new axes will be created as an
instance of the given class. Otherwise, the same class of the
main axes will be used. if Not provided
R i i R< R= (
R R R R R R R R
R RT R' R R ( R R R R Rq R R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt new_vertical s( %
c C sD | i d j o) | i i } | d j o t St Sn | i Sd S( Nt auto( R R; R R4 RY R ( R R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR4 s
c C s8 | i d j o | i i d t } | i S| i Sd S( NR ( R R; R R" R Rm ( R t bbox( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR" s c C s) | i d j o | i i S| i Sd S( N( R R; R R, ( R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR,
s N( RU RV RW R R R; RY R R R4 R" R, ( ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR x s 00
t LocatableAxesBasec B s> e Z d Z d Z d Z d d Z d e d Z RS( c O s, | i i | | | d | _ d | _ d S( N( R R R; t _locatort _locator_renderer( R t klt kw( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR s c C s
| | _ d S( N( R ( R R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR s c C s | i S( N( R ( R ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyt get_axes_locator s c C s\ | i d j o | i i | | n/ | i | | i } | i i | d | d S( Nt position( R R; R t apply_aspectR ( R R R
( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR s c C s# | | _ | i i | | | d S( N( R R t draw( R R t inframe( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR ) s N( RU RV R R R R; R RY R ( ( ( sI /usr/lib64/python2.6/site-packages/mpl_toolkits/axes_grid/axes_divider.pyR s
c C sW t i | } | d j o7 t i d | i t | f h | d 6 } | t | s( -_ X