/usr/lib64/python2.6/site-packages/matplotlib
Edit: /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyc (25497B)
Jc @ s
d Z d d k Z d d k Z d d k i Z d d k i Z d d k i
Z
d d k i Z d d k
i Z d d k i Z d d k i Z d d k i Z d d k i Z d Z d Z d e e f Z d e i f d YZ d e f d YZ d
Z d e e _ d S( s
Colorbar toolkit with two classes and a function:
:class:`ColorbarBase`
the base class with full colorbar drawing functionality.
It can be used as-is to make a colorbar for a given colormap;
a mappable object (e.g., image) is not needed.
:class:`Colorbar`
the derived class for use with images or contour plots.
:func:`make_axes`
a function for resizing an axes and adding a second axes
suitable for a colorbar
The :meth:`~matplotlib.figure.Figure.colorbar` method uses :func:`make_axes`
and :class:`Colorbar`; the :func:`~matplotlib.pyplot.colorbar` function
is a thin wrapper over :meth:`~matplotlib.figure.Figure.colorbar`.
iNse
============= ====================================================
Property Description
============= ====================================================
*orientation* vertical or horizontal
*fraction* 0.15; fraction of original axes to use for colorbar
*pad* 0.05 if vertical, 0.15 if horizontal; fraction
of original axes between colorbar and new image axes
*shrink* 1.0; fraction by which to shrink the colorbar
*aspect* 20; ratio of long to short dimensions
============= ====================================================
sH
=========== ====================================================
Property Description
=========== ====================================================
*extend* [ 'neither' | 'both' | 'min' | 'max' ]
If not 'neither', make pointed end(s) for out-of-
range values. These are set for a given colormap
using the colormap set_under and set_over methods.
*spacing* [ 'uniform' | 'proportional' ]
Uniform spacing gives each discrete color the same
space; proportional makes the space proportional to
the data interval.
*ticks* [ None | list of ticks | Locator object ]
If None, ticks are determined automatically from the
input.
*format* [ None | format string | Formatter object ]
If None, the
:class:`~matplotlib.ticker.ScalarFormatter` is used.
If a format string is given, e.g. '%.3f', that is
used. An alternative
:class:`~matplotlib.ticker.Formatter` object may be
given instead.
*drawedges* [ False | True ] If true, draw lines at color
boundaries.
=========== ====================================================
The following will probably be useful only in the context of
indexed colors (that is, when the mappable has norm=NoNorm()),
or other unusual circumstances.
============ ===================================================
Property Description
============ ===================================================
*boundaries* None or a sequence
*values* None or a sequence which must be of length 1 less
than the sequence of *boundaries*. For each region
delimited by adjacent entries in *boundaries*, the
color mapped to the corresponding value in values
will be used.
============ ===================================================
s>
Add a colorbar to a plot.
Function signatures for the :mod:`~matplotlib.pyplot` interface; all
but the first are also method signatures for the
:meth:`~matplotlib.figure.Figure.colorbar` method::
colorbar(**kwargs)
colorbar(mappable, **kwargs)
colorbar(mappable, cax=cax, **kwargs)
colorbar(mappable, ax=ax, **kwargs)
arguments:
*mappable*
the :class:`~matplotlib.image.Image`,
:class:`~matplotlib.contour.ContourSet`, etc. to
which the colorbar applies; this argument is mandatory for the
:meth:`~matplotlib.figure.Figure.colorbar` method but optional for the
:func:`~matplotlib.pyplot.colorbar` function, which sets the
default to the current image.
keyword arguments:
*cax*
None | axes object into which the colorbar will be drawn
*ax*
None | parent axes object from which space for a new
colorbar axes will be stolen
Additional keyword arguments are of two kinds:
axes properties:
%s
colorbar properties:
%s
If *mappable* is a :class:`~matplotlib.contours.ContourSet`, its *extend*
kwarg is included automatically.
Note that the *shrink* kwarg provides a simple way to keep a vertical
colorbar, for example, from being taller than the axes of the mappable
to which the colorbar is attached; but it is a manual method requiring
some trial and error. If the colorbar is too tall (or a horizontal
colorbar is too wide) use a smaller value of *shrink*.
For more precise control, you can manually specify the positions of
the axes objects in which the mappable and the colorbar are drawn. In
this case, do not use any of the axes properties kwargs.
returns:
:class:`~matplotlib.colorbar.Colorbar` instance; see also its base class,
:class:`~matplotlib.colorbar.ColorbarBase`. Call the
:meth:`~matplotlib.colorbar.ColorbarBase.set_label` method
to label the colorbar.
t ColorbarBasec
B s& e Z d Z h e d d d 6e d d d 6e d d d 6e d d d 6Z d d d d d d
d d d d e e d Z d
Z d Z
d Z d Z d Z
d Z d Z d Z d Z d d Z d Z d Z d Z d Z d Z d Z d Z d Z RS( s
Draw a colorbar in an existing axes.
This is a base class for the :class:`Colorbar` class, which is the
basis for the :func:`~matplotlib.pyplot.colorbar` method and pylab
function.
It is also useful by itself for showing a colormap. If the *cmap*
kwarg is given but *boundaries* and *values* are left as None,
then the colormap will be displayed on a 0-1 scale. To show the
under- and over-value colors, specify the *norm* as::
colors.Normalize(clip=False)
To show the colors versus index instead of on the 0-1 scale,
use::
norm=colors.NoNorm.
Useful attributes:
:attr:`ax`
the Axes instance in which the colorbar is drawn
:attr:`lines`
a LineCollection if lines were drawn, otherwise None
:attr:`dividers`
a LineCollection if *drawedges* is True, otherwise None
Useful public methods are :meth:`set_label` and :meth:`add_lines`.
i i@B t neitheri it botht mint maxg ?t verticalt uniformc C s | | _ | d j o t i } n | d j o t i } n | | _ t i i | d | d | | | _ | | _
| | _ | i | | _
| | _ | | _ | | _ |
| _ d | _ d | _ d | _ | i d t i |
o" t i |
d t |
| _ n
|
| _ | d j o< t | i t i o t i | _ qt i! | _ n0 t i" | o t i# | | _ n
| | _ | i$ d S( Nt cmapt normt t nbins(% t axt Nonet cmt get_cmapt colorst Normalizet alphat ScalarMappablet __init__t valuest
boundariest extendt _slice_dictt _insidet spacingt orientationt drawedgest filledt solidst linest dividerst set_labelt cbookt iterablet tickert FixedLocatort lent locatort
isinstanceR t LogNormt LogFormattert formattert ScalarFormattert is_string_liket FormatStrFormattert draw_all( t selfR R R R R R R R R t tickst formatR R ( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyR s<
"
c C s | i | i | i \ } } | i d d t i f } | i | | | i o | i | | | n | i d S( ss
Calculate any free parameters based on the current cmap and norm,
and do all the drawing.
N(
t _process_valuest _find_ranget _mesht _valuest npt newaxist _config_axesR t _add_solidst
_set_label( R/ t Xt Yt C( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyR. s
c
C s | i } | i t | i t | i | | } | i | | i | i i | i | i i
t i | d d d f | d d d f d t
i d d t
i d | _ | i | i | i i d | i i d t
i d } t i | d | d
| d d d d
| _ | i | i | i \ } } } | i d j oa | i g | i i d | i i d | i | | i | | i i i | nN | i g | i! i d | i | | i" | | i! i i | d S( s1
Make an axes patch and outline.
Ni i t colors axes.edgecolort linewidths axes.linewidths axes.facecolort edgecolort facecolorg{Gz?t zorderiR t rightt bottom(# R t set_frame_ont Falset set_navigatet _outlinet update_datalimt set_xlimt dataLimt intervalxt set_ylimt intervalyR t Line2Dt mplt rcParamst outlinet
add_artistt set_clip_boxR t
set_clip_patht patchest Polygont patcht _tickerR t
set_xtickst yaxist set_label_positiont set_ticks_positiont
set_ytickst set_yticklabelst get_major_formattert set_offset_stringt xaxist set_xticklabels( R/ R; R< R t xyt cR0 t
ticklabelst
offset_string( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyR8 s>
<
c C sJ | i d j o | i i | i | i n | i i | i | i d S( NR ( R R t
set_ylabelt _labelt _labelkwt
set_xlabel( R/ ( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyR: $ s c K s | | _ | | _ | i d S( s5
Label the long axis of the colorbar
N( Ri Rj R: ( R/ t labelt kw( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyR * s c C s | i d } d d | d | d d | d d | d | d | d g } t i t i t i | | } t i t i t i | | } | i t | d f } | i t | d f } | i d j o t i | | f St i | | f S( so
Return *x*, *y* arrays of colorbar bounding polygon,
taking orientation into account.
i i i t
horizontal( t shapeR6 t taket ravelt transposet reshapeR% R t hstack( R/ R; R< t Nt iit xt y( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyRH 3 s
=$$c C s | i d } | i d j o> g } t d | d D] } | t | | | | q5 ~ Sg } t d | d D] } | t | | | | qs ~ Sd S( sM
Return the separator line segments; helper for _add_solids.
i R i N( Ro R t ranget zip( R/ R; R< Ru t _[1]t it _[2]( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyt _edgesB s
>c C s, | i d j o | | | f } n+ t i | t i | t i | f } h | i d 6| i d 6d d 6| i d 6} | i i } | i i t | i i
| | } | i i | | | _ | i oY t
i | i | | d t i d f d d
t i d f | _ | i i | i n d S(
sp
Draw the colors using :meth:`~matplotlib.axes.Axes.pcolor`;
optionally add separators.
R R R t flatt shadingR R s axes.edgecolort
linewidthsg ?s axes.linewidthN( R R6 Rr R R R R t isholdt holdt Truet pcolorR R t collectionst LineCollectionR~ RP RQ R t add_collection( R/ R; R< R= t argsRm t _holdt col( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyR9 N s *
c C s4 t | } | i | \ } } t | | j o t d n t i d d g } t i | | \ } } | i d j o< g }
t | D] } |
t | | | | q ~
} n9 g }
t | D] } |
t | | | | q ~
} t i
| d | } | | _ | i | | i
i | d S( s-
Draw lines on the colorbar.
s! levels are outside colorbar rangeg g ?R R N( R% t _locatet
ValueErrorR6 t arrayt meshgridR Ry Rz R R R t set_colorR R ( R/ t levelsR R Ru t dummyRx Rw R; R< R{ R| Rd R} R ( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyt add_linesj s <8
c
C s/ | i } | i } | d j o | i d j o t | i t i o? t | i } d t
| d } t i d | d d } qt | i t i
o% | i i } t i | d d } qt | i t i o t i } qt i } q | i | i } t i | d d } n t | i t i o | i d | i d f } n | i | i f } | i | i | i | | i | | i | | i | t i | } | i | \ } } | i | g } t | D] \ } }
| | |
| q~ } | i } | | | f S( si
Return two sequences: ticks (colorbar data locations)
and ticklabels (strings).
i i
t baset offseti R
iN( R& R* R R R' R R t NoNormR% R5 t intR# t IndexLocatort BoundaryNormR$ R( t
LogLocatort MaxNLocatort _boundariesR t vmint vmaxt create_dummy_axist set_view_intervalt set_data_intervalR6 R R t set_locst enumeratet
get_offset(
R/ R& R* t nvR t bt intvR0 R{ R| t tRf Rg ( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyRY ~ s>
6 c C s[ | d j o
| i } n | d j o t i | d t | _ | i d j oZ d | i d | i d | _ t | i t
i o | i d i t i
| _ n d St i | i | _ d S| i d j o t i | i | _ | i d j o t i t | i d d } d | i d | i d | d d +d | d | d | d
Nt dg @i i iiR R R ( R s min( R s max( R s min( R s max( R s min( R s max( R s min( R s max( R R R6 t asarrayt floatR R R5 R' R R R t astypet int16R t zerosR% t
_uniform_yR Ru t arangeR R R t listt scaledR R t inverseR2 ( R/ R t vt bi( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyR2 sx
# '%% " %c C s. | i | i } | d | _ | d | _ d S( s
Set :attr:`vmin` and :attr:`vmax` attributes to the first and
last boundary excluding extended end boundaries.
i iN( R R R R ( R/ R ( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyR3 s
c C sO t | i } | i d j o | d 8} n | i d j o | d 8} n | S( s1 number of boundaries **before** extension of endsR i R R i ( s mins max( R% R R ( R/ t nb( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyt
_central_N s c C sP | i i d } | i d j o | d 7} n | i d j o | d 7} n | S( se
Based on the colormap and extend variable, return the
number of boundaries.
i R i R R ( s mins max( R Ru R ( R/ Ru ( ( s9 /usr/lib64/python2.6/site-packages/matplotlib/colorbar.pyt _extended_N s c C s | i d j o t i d d | } n | i d j o. t i | d d } d | d s& ,< L +