Jc @ s# d Z d d k l Z d d k Z d d k Z d d k Z d d k l 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 d k i Z d d k l Z d f d YZ d e i e f d YZ! d S(
sQ
These are classes to support contour plotting and
labelling for the axes class
i( t divisionN( t ma( t BlockingContourLabelert ContourLabelerc B s e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d d
d Z
d Z d
d Z d Z RS( s3 Mixin to provide labelling capability to ContourSetc O s | i d d } | i d d } | i d d } | i d d | _ | i d d } | i d t | _ | i d
t | _ t | d j o" | i } t t | i } n t | d j o t
| d } g g } } xH t | i D]7 \ }
} | | j o | i |
| i | q q Wt | t | j o= d t
| } | d
7} | t
| i 7} t | qn
t d | | _ | | _ t i | _ | d j o t | i i }
no t | t t t
g j o t d nC t | t
j o t | i i }
n | i i | | }
|
g t | | _ | d j o( | | _ t i | i | i | _ nX t i! | d t | i } t t | i | _ t" i# d | d t i$ | _ g | _% | i o7 d GHd GH| p d GHn t& | } | | | n | i' | | | i( | _) | i% | _* | i+ | _, t- i. d | i( | _/ | i/ S( sF
call signature::
clabel(cs, **kwargs)
adds labels to line contours in *cs*, where *cs* is a
:class:`~matplotlib.contour.ContourSet` object returned by
contour.
::
clabel(cs, v, **kwargs)
only labels contours listed in *v*.
Optional keyword arguments:
*fontsize*:
See http://matplotlib.sf.net/fonts.html
*colors*:
- if *None*, the color of each label matches the color of
the corresponding contour
- if one string color, e.g. *colors* = 'r' or *colors* =
'red', all labels will be plotted in this color
- if a tuple of matplotlib color args (string, float, rgb, etc),
different labels will be plotted in different colors in the order
specified
*inline*:
controls whether the underlying contour is removed or
not. Default is *True*.
*inline_spacing*:
space in pixels to leave on each side of label when
placing inline. Defaults to 5. This spacing will be
exact for labels at locations where the contour is
straight, less so for labels on curved contours.
*fmt*:
a format string for the label. Default is '%1.3f'
Alternatively, this can be a dictionary matching contour
levels with arbitrary strings to use for each contour level
(i.e., fmt[level]=string)
*manual*:
if *True*, contour labels will be placed manually using
mouse clicks. Click the first button near a contour to
add a label, click the second button (or potentially both
mouse buttons at once) to finish adding labels. The third
button can be used to remove the last label added, but
only if labels are not inline. Alternatively, the keyboard
can be used to select label locations (enter to end label
placement, delete or backspace act like the third mouse button,
and any other key will select a label location).
*rightside_up*:
if *True* (default), label rotations will always be plus
or minus 90 degrees from level.
.. plot:: mpl_examples/pylab_examples/contour_demo.py
t fontsizet inlinei t inline_spacingi t fmts %1.3ft colorst manualt rightside_upi s Specified levels s
don't match available levels s- Illegal arguments to clabel, see help(clabel)s$ Font size must be an integer number.t Nt cmapt norms9 Select label locations manually using first mouse button.s. End manual selection with second mouse button.s1 Remove last label by clicking third mouse button.s text.TextN(0 t gett Nonet labelFmtt Falset labelManualt TrueR
t lent levelst ranget listt enumeratet appendt strt
ValueErrort TypeErrort labelLevelListt labelIndiceListt font_managert FontPropertiest labelFontPropst intt get_size_in_pointst typet floatt set_sizet labelFontSizeListt
labelMappablet npt taket cvaluest labelCValueListR t ListedColormapt cmt ScalarMappablet NoNormt labelXYsR t labelst
labelTextst clt cl_xyt labelCValuest
cl_cvaluest cbookt silent_listt labelTextsList( t selft argst kwargsR R R t _colorsR t indicest levlabst it levt msgt font_sizeR t blocking_contour_labeler( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt clabel# sr O
c C s t | } | d | j o d St i | d d d f } t i | d d d f } t i | d d d f } t i | d d d f } | } | | d | j p | | d | j o d Sd Sd S( s- if contours are too short, don't plot a labeli
i Ni g333333?( R R) t amaxt amin( R; t linecontourt
labelwidtht lcsizet xmaxt xmint ymaxt ymint lw( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt print_label s *c C s | i g j ox g } | i D]2 } | t i | | d d | | d d q ~ } x0 | D] } | d | j o d Sd Sq` Wn d Sd S( s6 if there's a label already nearby, find a better placei i i g333333?N( R1 R) t sqrt( R; t xt yRP t _[1]t loct distt d( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt too_close s B c C s t | d } t i | } xU | D]M } | | | | | | } }
| i | |
| o q& q& | |
| f Sq& W| d } | | | | | | } }
| |
| f S( sB labels are ploted at a location with the smallest
dispersion of the contour from a straight line
unless there's another label nearby, in which case
the second best place on the contour is picked up
if there's no good place a label isplotted at the
beginning of the contour
i i ( R" R) t argsortRY ( R; t distancest XXt YYt ysizeRP t hysizet adistt indRS RT ( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt get_label_coords s
c C sD t i | o t | | } n t | i | | | } | S( s$ get the width of the label in points( R8 t is_string_likeR t get_text( R; RB R t fsizeRP ( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt get_label_width s c C s t i t i | i i i d d d d } t i | d | d } | i | | i | | d | i
d | i i i i
} t i | i d d d d f d } | S( s
This computes actual onscreen label width.
This uses some black magic to determine onscreen extent of non-drawn
label. This magic may not be very robust.
i t axisi i t kt rendererN( R) t meant asarrayt axRg t reshapet textt Textt set_label_propsRd t get_window_extentt figuret canvasRi t difft corners( R; RB R Re t xxt tt bboxRP ( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt get_real_label_width s 3 ,c C sA | i | | i | | i | i | i | i i d S( s0 set the label properties - color, fontsize, textN( t set_textt set_colort set_fontpropertiesR! t set_clip_boxRl Rx ( R; t labelRn t color( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyRp s
c C s: t i | o | St | t o | | S| | Sd S( s get the text of the labelN( R8 Rc t
isinstancet dict( R; RB R ( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyRd s
c C s1 t | } | d j o t t i | | } n d } | d j o
| } n | } t i | d d d f | | f } t i | d d d f | | f } | d d d f i | d } | d d d f i | d } | d d d f i | d }
| d d d f i | d } | | | |
|
| | | } t i | |
d | | d i }
t i i g } t
| D] } | t | | |
| q~ d } | i | | | | | \ } } } g } | D] } | t
| q~ } | i | | f } | | | f S( s find a good place to plot a label (relatively flat
part of the contour) and the angle of rotation for the
text object
i Ni ii ( R R" R) t ceilt resizeRm RR t ravelt addt reduceR t absRb t tuplet index( R; RI RJ t nsizet xsizeR^ R\ R] t yfirstt ylastt xfirstt xlastt st LRU RA RW RS RT Ra t _[2]t lt lct dind( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt locate_label( s(
((""""")H$'i c C s | d j o
g } n | d } t i | } | o_ t i | | d !| | d f } t | o& t i | | d !| | d f } n d } n t i | } | | | } t i | | g } | o t i | d d g }
n t i | }
t i | | |
| d t
} t i | d d i } t i
| d j o
d }
n& t i | d | d d t i }
| i o: |
d j o |
d }
n |
d
j o d |
}
qn g } t | o|
| t i | | g } t i | t i t | | d t } t i | d o; t | d | d j o t i | | | d g } n t i | d o; t | d | d j o t i | | | d g } n t i | d t i | d g } | oR t i
t i | o4 | i t i | | | d | d d !| f qqt i | d p* | i t i | | d d | f n t i | d p& | i t i | | | d f qn |
| f S( s
This function calculates the appropriate label rotation given
the linecontour coordinates in screen units, the index of the
label location and the label width.
It will also break contour and calculate inlining if *lc* is
not empty (lc defaults to the empty list if None). *spacing*
is the space around the label in pixels to leave empty.
Do both of these tasks at once to avoid calling mlab.path_length
multiple times, which is relatively costly.
The method used here involves calculating the path length
along the contour in pixel coordinates and then looking
approximately label width / 2 away from central point to
determine rotation and then to break contour if desired.
g @ii i t extrapRg g g f@iZ iN( R t mlabt is_closed_polygonR) t r_R t path_lengtht arrayt
zeros_liket less_simple_linear_interpolationR Rt R t allt arctan2t piR
t arangeR t isnanR" t floorR R ( R; t slcRa RP R t spacingt hlwt closedt plt xit dpt llt ddt rotationt nlct It xy1t xy2( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt calc_label_rot_and_inlineM s\
"
&
%
$00&8**c C s | i i i i | | f \ } } t i | | d | d d d d } | i i | d | i } | i | | i
}
| i | |
| | i i
| | i i
| | i i
| | f | i i | d S( NR t horizontalalignmentt centert verticalalignmentt alpha( Rl t transDatat invertedt transform_pointRn Ro R( t to_rgbaR Rd R Rp R3 R R6 R1 t
add_artist( R; RS RT R RB t cvaluet dxt dyRw R t _text( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt add_label s ' ic C s0 | i i | | i i | } | i d S( s> Defaults to removing last label, but any index can be suppliedN( R6 t popR3 t remove( R; R Rw ( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt pop_label s c C s | i i } xt | i | i | i | i D]\ } } } } | i | } | i | | i | } g }
| i
} xNt | D]@\ } }
|
i } | i
| } t i | o- t i | | d d d d f f } n | } | i | | o | i | | \ } } } | o
| } n d } | i | | | | | \ } } | i | | | | | | oB x? | D]3 } t | d j o |
i t i | qxqxWqq |
i |
q W| o | 2| i |
q. q. Wd S( Ni i ( Rl R t zipR R R' R, t collectionsRf R t get_pathsR t verticest transformR R R) R RQ R R R R R R t patht Patht extend( R; R R t transt iconRB Re R t conRP t additionst pathst segNumt linepathR t slc0R RS RT Ra t lcargR t newt n( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyR2 sD
-
&N( t __name__t
__module__t __doc__RF RQ RY Rb Rf Ry Rp Rd R R R R R R2 ( ( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyR s
%j t
ContourSetc B s e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d
Z d Z
d Z d e d
Z RS( s
Create and store a set of contour lines or filled regions.
User-callable method: clabel
Useful attributes:
ax:
the axes object in which the contours are drawn
collections:
a silent_list of LineCollections or PolyCollections
levels:
contour levels
layers:
same as levels for line contours; half-way between
levels for filled contours. See _process_colors method.
c O sj | | _ | i d d" | _ | i d t | _ | i d d" | _ | i d d" | _ | i d d | _ | i d d" | _ | i d d" | _
| i d d" } | i d
d" | _ | i d d" } | i d d
| _ | i d t
| _ | i d d | _ | i d d" | _ t | t i p t | i t i oJ t
| _ | d" j o t i } n | i d
j o t d qn
t | _ | i d" j o n | i
d" j o n | d" j o n | i d" j o | d" j o t d n | i d j o t i d | _ n | i | \ } } } | i d" j o% t i | i d t | i } n | i o t i d | _ n t i d | _ g | _ g | _! h | d 6} | d" j o | | d ii gGz?N(
R R R R R t MaxNLocatort create_dummy_axist zmaxt zmint
set_boundsR t _autoR ( R; R
R R# R$ RB t zmargin( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt _autolev s(
c C s | i d j o t d n | i \ } } | i d j o | i d j o# t i t i | t i | S| i \ } } } } t i | | | } t i | | | } t i | | Sn | i d j o" d | d | f \ } } } } n | i \ } } } } t
| | | }
t
| | | } | t i | d |
} | t i | d | } | i d j o | d d d } n t i | | S( s
Return X, Y arrays such that contour(Z) will match imshow(Z)
if origin is not None.
The center of pixel Z[i,j] depends on origin:
if origin is None, x = j, y = i;
if origin is 'lower', x = j + 0.5, y = i + 0.5;
if origin is 'upper', x = j + 0.5, y = Nrows - i - 0.5
If extent is not None, x and y will be scaled to match,
as in imshow.
If origin is None and extent is not None, then extent
will give the minimum and maximum values of x and y.
i s Input must be a 2D array.i g ?t upperNi( t ndimR t shapeR R R R) t meshgridR t linspaceR% ( R; R
t Nyt NxR R R R RS RT R R ( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt _initialize_x_y s(
#"c C sv | i i | d } | i i | d } t i | d t i } t i | d t i } t i | d d t i } | i d j o t d n | i \ } } | i | i j o! | i | i j o | | | f S| i d j p | i d j o t d n | i \ } | i \ } | | j p
| | j o t d d n t i
| | \ } } | | | f S( s
For functions like contour, check that the dimensions
of the input arrays match; if x and y are 1D, convert
them to 2D using meshgrid.
Possible change: I think we should make and use an ArgumentError
Exception class (here and elsewhere).
i i t dtypei s Input z must be a 2D array.s Inputs x and y must be 1D or 2D.s, Length of x must be number of columns in z,
s' and length of y must be number of rows.( Rl t convert_xunitst convert_yunitsR) Rk t float64R R* R R+ R, ( R; R< RS RT R
R. R/ t nxt ny( ( s8 /usr/lib64/python2.6/site-packages/matplotlib/contour.pyt
_check_xyz s&
& c
G s | i o
d } n d } t | } | d j o5 t i | d d t i } | i | \ } } nD | d j o | i | d \ } } } n t d | | f t i | d t
} t i | | _ t i
| | _ | i oH | i d j o8 t i | d j | } t i d
| i | _ n t
| _ | i d j o | d j p
| d j o | i | d } ns | d
} yH t | t j o | i | | } n t i | i t i } Wn t d | | f n X| i o# t | d j o t d n | | _ n t | i | _ | i d j o. | i i d t | i d | i d n | i d j o+ | i i t! | i d
| i d n t i | i | _ t i" | i | _# t i$ | i | _% | i d j o# d | i d | i d | _# n | i d j o# d | i d
| i d | _% n | i | _& | i o d | i d
| i d | _& | i d j o# d | i# | i d | i& d | i } t | i } | d j og d g | } | i oL t i d } x< t | i D]' \ } } | d j o | | | s&