File: //opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyo
�
�)�Uc @ sp d Z d d l m Z d d l Z d d l Z d d l Z d d l m Z d d l j
Z
d d l j Z
d d l j Z d d l j Z d d l j Z d d l j Z d d l j Z d d l j Z d d l j Z d d l j Z d d l j Z d d l j! Z! d d l" m# Z# d e j$ f d � � YZ% d f d � � YZ& d
e j' e& f d � � YZ( d 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
ClabelTextc B s e Z d Z d � Z RS( s�
Unlike the ordinary text, the get_rotation returns an updated
angle in the pixel coordinate assuming that the input rotation is
an angle in data coordinate (or whatever transform set).
c C sh t j j | � } | j � } | j � \ } } | j t j | g � t j | | g g � � } | d S( Ni ( t textt Textt get_rotationt
get_transformt get_positiont transform_anglest npt array( t selft anglet transt xt yt
new_angles( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR ( s ( t __name__t
__module__t __doc__R ( ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR " s t 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
� Z d � Z d � Z d � Z d d � Z d � Z RS( s3 Mixin to provide labelling capability to ContourSetc O s� | j d d � } | j d d � } | j d d � } | j d d � | _ | j d d � } | j d t � | _ | j d
t � | _ | j d t � | _ t | � d k r� | j } t
t | � � } n� t | � d k r�t | d � } g g } } xF t | j � D]5 \ }
} | | k r | j
|
� | j
| � q q Wt | � t | � k r�d
t | � } | d 7} | t | j � 7} t | � � q�n t d � � | | _ | | _ t j � | _ | d k r�t | j j � � }
nj t | � t t t g k rt d � � n@ t | � t k r@t | j j � � }
n | j j | � | }
|
g t | � | _ | d k r�| | _ t j | j | j � | _ nW t! j" | d t | j � �} t
t | j � � | _ t# j$ d | d t! j% � � | _ g | _& | j r<d GHd GH| s d GHn t' | � } | | | � n | j( | | � | j) | _* | j& | _+ | j, | _- t. j/ d | j) � | _0 | j0 S( s}
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.
*use_clabeltext*:
if *True* (default is False), ClabelText class (instead of
matplotlib.Text) is used to create labels. ClabelText
recalculates rotation angles of texts during the drawing time,
therefore this can be used if aspect of the axes changes.
.. plot:: mpl_examples/pylab_examples/contour_demo.py
t fontsizet inlinei t inline_spacingi t fmts %1.3ft colorst use_clabeltextt 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(1 t gett Nonet labelFmtt Falset _use_clabeltextt 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
labelMappableR
t taket cvaluest labelCValueListR t ListedColormapt cmt ScalarMappablet NoNormt labelXYsR t labelst
labelTextst clt cl_xyt labelCValuest
cl_cvaluest cbookt silent_listt labelTextsList( R t argst kwargsR R R t _colorsR) t indicest levlabst it levt msgt font_sizeR t blocking_contour_labeler( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt clabel4 sr U
c C s� t | � } | d | k r d St j | d d � d f � } t j | d d � d f � } t j | d d � d f � } t j | d d � d f � } | } | | d | k s� | | d | k r� 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( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt print_label� s (c C s� | j g k r| g | j D]1 } t j | | d d | | d d � ^ q } x- | D] } | d | k rq d Sd SqW Wn d Sd S( s6 if there's a label already nearby, find a better placei i i g333333�?N( RD R
t sqrt( R R R Rb t loct distt d( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt too_close� s >
c C s� t | d � } t j | � } xS | D]K } | | | | | | } }
| j | |
| � rd 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 ( R6 R
t argsortRh ( R t distancest XXt YYt ysizeRb t hysizet adistt indR R ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt get_label_coords� s
c C s� t j | � s$ | j | | � } n t j j | � \ } } | d k r� t | d � si t j � | _ n | j j
| | � \ } } } np | r� t | d � s� t j d � | _
n | j
j | d d d | j �\ } } | j � } n t | � | } | S( s$ get the width of the label in pointst TeXt _TeX_managert _mathtext_parsert bitmapt dpiiH t prop( RK t is_string_liket get_textR R t is_math_textt hasattrt
texmanagert
TexManagerRs t get_text_width_height_descentt mathtextt MathTextParserRt t parseR5 t get_widthR( ( R RT R t fsizet ismathRb t _t img( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt get_label_width s !'c C s� t j t j | j j � � j d d � d d �} t j | d | d � } | j | | j | | � d � | j
d | j j j j
� } t j | j � 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 axR� t reshapeR R t set_label_propsRy t get_window_extentt figuret canvasR� t difft corners( R RT R R� t xxt tt bboxRb ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt get_real_label_width# s 3 ,c C sA | j | � | j | � | j | j � | j | j j � d S( s0 set the label properties - color, fontsize, textN( t set_textt set_colort set_fontpropertiesR5 t set_clip_boxR� R� ( R t labelR t color( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR� ; s
c C s6 t j | � r | St | t � r* | | S| | Sd S( s get the text of the labelN( RK Rx t
isinstancet dict( R RT R ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyRy B s
c C s# t | � } | d k r4 t t j | | � � } n d } | d k rO | } n t | � } t j | d d � d f | | f � } t j | d d � d f | | f � } | d d � d f j | d � } | d d � d f j | d � } | d d � d f j | d � }
| d d � d f j | d � } | | | |
|
| | | } t j | |
d | | d � j � }
t j j g t
| � D] } t | � | |
| ^ q�d � } | j | | | | | � \ } } } g | D] } t
| � ^ q�} | j | | 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 i����i ( R( R6 R
t ceilt resizeR� Rd t ravelt addt reduceR* t absRq t tuplet index( R R[ R\ t nsizet xsizeRm Rk Rl t yfirstt ylastt xfirstt xlastt st LRS Rf R R Rp t lt lct dind( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt locate_labelL s( ((""""")@$ i c C s� | d k r g } n | d } t j | � } | r� t j | | d !| | d f } t | � r� t j | | d !| | d f } n d } n t j | � } | | | } t j | | g � } | r� t j | d d g � }
n t j | � }
t j | | |
| d t
�} t j | d d �j � } t j
| d k � rLd }
n% t j | d | d � d t j }
| j r�|
d k r�|
d }
n |
d
k r�d |
}
q�n g } t | � r�|
| t j | | g � } t j | t j t | � � | d t �} t j | d � rVt | d � | d k rVt j | | | d g � } n t j | d � r�t | d � | d k r�t j | | | d g � } n t j | d � t j | d � g } | r t j
t j | � � r�| j t j | | | d | d d !| f � q�q�t j | d � sZ| j t j | | d d | f � n t j | d � s�| j t j | | | d f � q�n |
| 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 @i����i i t extrapR� g g �f@iZ i����N( R" t mlabt is_closed_polygonR
t r_R( t path_lengthR t
zeros_liket less_simple_linear_interpolationR' R� R� t allt arctan2t piR t arangeR$ t isnanR6 t floorR� R- ( R t slcRp Rb R� t spacingt hlwt closedt plt xit dpt llt ddt rotationt nlct It xy1t xy2( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt calc_label_rot_and_inlineq s\
" % %
$..&6)(c C sO | j j j � j | | f � \ } } t j | | d | d d d d �} | S( NR� t horizontalalignmentt centert verticalalignment( R� t transDatat invertedt transform_pointR R ( R R R R� t dxt dyR� ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt _get_label_text� s
' c C s� | j j j � } | j | | f � \ } } | j t j | g � t j | | g g � � } t | | d | d d d d d �} | S( NR� i R� R� R� ( R� R� R� R� R R
R R ( R R R R� t transDataInvR� R� t drotationR� ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt _get_label_clabeltext� s c C s� | j j | d | j �} | j | | j � } | j | | | � | j j | � | j j | � | j j | | f � | j
j | � d S( Nt alpha( R< t to_rgbaR� Ry R# R� RF R- RI RD R� t
add_artist( R R� R R RT t cvalueR� t _text( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt
_add_label� s c C s2 | j | | | � } | j | | | | | � d S( s6
Addd contour label using Text class.
N( R� R� ( R R R R� RT R� R� ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt add_label� s c C s2 | j | | | � } | j | | | | | � d S( s<
Addd contour label using ClabelText class.
N( R� R� ( R R R R� RT R� R� ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt add_label_clabeltext s i����c C s0 | j j | � | j j | � } | j � d S( s> Defaults to removing last label, but any index can be suppliedN( RI t popRF t remove( R R� R� ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt pop_label s c C s� | j r | j } n | j } x�t | j | j | j | j � D]�\ } } } } | j | } | j � } | j
| | j | � }
g } | j � } xAt
| � D]3\ }
} | j } | j | � } t j | � rt j | | d d � d d � f f } n | } | j | |
� r�| j | |
� \ } } } | rC| } n d } | j | | |
| | � \ } } | | | | | | � | r�x< | D]1 } t | � d k r�| j t j | � � q�q�Wq�q� | j | � q� W| r@ | 2| j | � q@ q@ Wd S( Ni i ( R% R� R� t zipR2 R1 R; R? t collectionsR R� R# t get_pathsR, t verticest transformR� R� R
R� Rc R� R" R� R( R- t mpatht Patht extend( R R R R� t iconRT R� R� t conR Rb t additionst pathst segNumt linepathR� t slc0R� R R Rp t lcargR� t newt n( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyRE sD
,
#N( R R R RX Rc Rh Rq R� R� R� Ry R� R" R� R� R� R� R� R� R� RE ( ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR 1 s$ �
%i 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
� Z d � Z d e d � Z RS( s�
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 s� | | _ | j d d! � | _ | j d t � | _ | j d d! � | _ | j d d! � | _ | j d d! � | _ | j d d! � | _ | j d d! � | _
| j d d! � } | j d d! � | _ | j d
d! � } | j d d � | _ | j d
t
� | _ | j d d � | _ | j d d! � | _ t | t j � sPt | j t j � r�t
| _ | d! k rtt j � } n | j d k r�t d � � q�n t | _ | j d! k r�n | j
d! k r�n | d! k r�n | j d! k r�| d! k r�t d � � n | j d k r t j d | _ n | j | | � | j � | j d! k r�t | j � } | j rk| d 8} n t j | j d | �} n | j r�t j d � | _ n t j d � | _ g | _ g | _! i | d 6} | d! k r�| | d
<n t" j# j$ | | � | j% � | j& � \ | _' | _( | j r1| j d! k rKt) j* d � n | j+ � \ } } | j( d! k r�d! g t | j' � | _( n xet, | | | j' | j( � D]� \ }
} } }
| j- | |
� } | j d d � } t j. | d | j f d d d | j d | �} | j j/ | � | j j0 | � q�Wn� | j1 � } | | _2 | j3 � } x� t, | j | | | j' � D]~ \ }
} } } | j d d � } t j4 | d | d | d | j d | �} | j5 d � | j j/ | t � | j j0 | � qnW| j6 � d! S(" s
Draw contour lines or filled regions, depending on
whether keyword arg 'filled' is False (default) or True.
The first three arguments must be:
*ax*: axes object.
*levels*: [level0, level1, ..., leveln]
A list of floating point numbers indicating the contour
levels.
*allsegs*: [level0segs, level1segs, ...]
List of all the polygon segments for all the *levels*.
For contour lines len(allsegs) == len(levels), and for
filled contour regions len(allsegs) = len(levels)-1.
level0segs = [polygon0, polygon1, ...]
polygon0 = array_like [[x0,y0], [x1,y1], ...]
*allkinds*: None or [level0kinds, level1kinds, ...]
Optional list of all the polygon vertex kinds (code types), as
described and used in Path. This is used to allow multiply-
connected paths such as holes within filled polygons.
If not None, len(allkinds) == len(allsegs).
level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]
If allkinds is not None, usually all polygons for a particular
contour level are grouped together so that
level0segs = [polygon0] and level0kinds = [polygon0kinds].
Keyword arguments are as described in
:class:`~matplotlib.contour.QuadContourSet` object.
**Examples:**
.. plot:: mpl_examples/misc/contour_manual.py
R) t filledt
linewidthst
linestylesR� t origint extentR R R R� t neithert antialiasedt nchunki t locators- extend kwarg does not work yet with log scales" Either colors or cmap must be Nonet images image.origini R s collections.PathCollections collections.LineCollections! linewidths is ignored by contourft zordert antialiasedst
edgecolorst nonei t linestylet
_nolegend_N(7 R� R! R" R) R$ R� R� R� R� R� R� R R� R' R R R R� t LogNormt tickert
LogLocatort logscaleR/ t mplt rcParamst
_process_argst _process_levelsR( R@ RK RL R� RF RI RA RB t __init__t _process_colorst _get_allsegs_and_allkindst allsegst allkindst warningst warnt _get_lowers_and_uppersR� t _make_pathst PathCollectiont add_collectionR- t _process_linewidthst tlinewidthst _process_linestylest LineCollectiont set_labelt changed( R R� RN RO R R t ncolorst kwt lowerst upperst levelt level_uppert segst kindsR� R t colR t tlinestylest widtht lstyle( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR ` s� ,
+ +
c
O s� | d | _ | d | _ t | � d k r6 | d p9 d | _ t j | j � | _ t j | j � | _ t
| _ | j r� t | j � t | j � d k r� t
d � � q� n- t | j � t | j � k r� t
d � � n | j d k rt | j � t | j � k rt
d � � n t
} x� | j D]� } x� | D]� } t j | � } | r�t j | | j d d � � } t j | | j d d � � } q5| j d d � } | j d d � } t } q5Wq(W| r�| j j | | g � | j j d t � n d S(
s�
Process args and kwargs; override in derived classes.
Must set self.levels, self.zmin and self.zmax, and update axes
limits.
i i i s- must be one less number of segments as levelss) must be same number of segments as levelss( allkinds has different length to allsegsR� t tightN( R) R R( R" R R
RY t zmaxRZ t zminR$ t _autoR� R/ R� t minimumt mint maximumt maxR' R� t update_datalimt autoscale_view( R RN RO t
havelimitsR* t segR5 R7 ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR � s4
% " -
!c C s | j | j f S( sv
Override in derived classes to create and return allsegs and allkinds.
allkinds can be None.
( R R ( R ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR s c C ss | j d } | j | d k r\ | j � } | j rI d | j | d <q\ | d c d 8<n | j d } | | f S( s=
Return (lowers,uppers) for filled contours.
i����i g�G�z��?i ( t _levelsR2 t copyR ( R R& R' ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR s
c C se | d k rA g t | | � D]! \ } } t j | d | �^ q Sg | D] } t j | � ^ qH Sd S( Nt codes( R" R� R� R� ( R R* R+ R; t kind( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR / s 5c C s� g | j | j d | j �D] } t | � f ^ q } | | _ xF t | | j � D]2 \ } } | j rx | j | � qS | j | � qS WxL t | j
| j � D]5 \ } } | j | j � | j | j
j | � � q� Wt j j | � d S( NR� ( R� R> R� R� t tcolorsR� R� R� t
set_facecolorR� RF RI t set_alphaR< RA RB R# ( R t rgbaR@ R� t
collectionR� t cv( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR# 5 s 4 " c C s� | j d k rC | j r* t j � | _ qC t j | d � | _ n | j j � | j } | j } | j j | | � | j � } t
| _ | j r� | S| | | k | | k @S( s�
Select contour levels to span the data.
We need two more levels for filled contours than for
line contours, because for the latter we need to specify
the lower and upper boundary of each range. For example,
a single contour boundary, say at z = 0, requires only
one contour line, but two filled regions, and therefore
three levels to provide boundaries for both regions.
i N(
R R" R R R
t MaxNLocatort create_dummy_axisR1 R2 t
set_boundsR' R3 R� ( R t zR R1 R2 RT ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt _autolevD s
c C s | j r d } n d } t | _ | j d k r� t | � d k rW | j | d � } np | d } yF t | � t k r� | j | | � } n t j
| � j t j � } Wn t
d | | f � � n X| j r� t | � d k r� t d � � n | | _ n d S( sH
Determine the contour levels and store in self.levels.
t contourft contouri i s* Last %s arg must give levels; see help(%s)i s* Filled contours require at least 2 levels.N( R� R$ R3 R) R" R( RJ R8 R6 R
R� t astypet float64R0 R/ ( R RI RN t fnRT t level_arg( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt _contour_level_args_ s$
c C s� t | j � | _ | j d
k rN | j j d t | j d | j � d � n | j d k r� | j j t | j d | j � d � n t
j | j � | _ t
j | j � | _
t
j | j � | _ | j d k r� d | j d | j d | _
n | j d
k r(d | j d | j d | _ n | j r�d | j d | j d | _ | j d k r�d | j
| j d | j d <n | j d k r�d | j | j d | j d <q�n | j | _ d S( Nt bothR5 i i R7 i����i i����g �?( RR s min( RR s max( RR s min( RR s max( RR s min( RR s max( R+ R) R< R� t insertR5 R2 R- R7 R1 R
R� RZ t vminRY t vmaxR� t layers( R ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR w s& -*"" "%c C s | j j | _ | j d k r� d t | j � } } | j rJ | d 8} n | j d k rb d } n | j d k r~ | d 7} n t | | � | _ | j
t j � � n | j | _ | j
j � s� | j | j | j � n | j d
k r� t | j
_ n | j | j � d S( s�
Color argument processing for contouring.
Note that we base the color mapping on the contour levels,
not on the actual range of the Z values. This means we
don't have to worry about bad values in Z, and we always have
the full dynamic range available for the selected levels.
The color is based on the midpoint of the layer, except for
an extended end layers.
i i RR R5 i����R7 N( s boths min( s boths max( s boths maxs min( R t
monochromeR R" R( R) R� R� R* R> t set_normRC RV R t scaledt set_climRT RU R$ t clipt set_array( R t i0t i1( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR � s"
c C s� | j } t | j � } | d k r> t j d f g | } n� t j | � s] | g | } ni t | � } t | � | k r� t t
j | t | � � � } | | } n t | � | k r� | | } n g | D] } | f ^ q� } | S( Ns lines.linewidth( R� R( R) R" R R RK t iterableR+ R6 R
R� ( R R� t NlevR t nrepst w( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR � s
c C sE | j } t | j � } | d k r� d g | } | j rAt j d } | j | j d } x9 t | j � D]% \ } } | | k rl | | | <ql ql WqAn� t
j | � r� | g | } n� t
j | � r5t
| � } t | � | k rt t j | t | � � � } | | } n t | � | k rA| | } qAn t d � � | S( Nt solids contour.negative_linestylegV瞯�<s& Unrecognized type for linestyles kwarg( R� R( R) R" RW R R R1 R2 R, RK Rx R_ R+ R6 R
R� R/ ( R R� R` R- t neg_lst epsRS RT Ra ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR � s*
c C s | j S( s5 returns alpha to be applied to all ContourSet artists( R� ( R ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt get_alpha� s c C s | | _ | j � d S( s% sets alpha for all ContourSet artistsN( R� R# ( R R� ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyRB � s c C so | d k r$ t t | j � � } n d } d } d } d } d } x| D] }
| j |
} | j � } | j � }
x� t |
� D]� \ } } | j } | r� | j | � } n | d d � d f | d | d d � d f | d } t
| � } | | k r� | } |
} | } t j j
| | k � d } | | d f } | | d f } q� q� WqI W| | | | | | f S( sQ
Finds contour that is closest to a point. Defaults to
measuring distance in pixels (screen space - useful for manual
contour labeling), but this can be controlled via a keyword
argument.
Returns a tuple containing the contour, segment, index of
segment, x & y of segment point and distance to minimum point.
Call signature::
conmin,segmin,imin,xmin,ymin,dmin = find_nearest_contour(
self, x, y, indices=None, pixel=True )
Optional keyword arguments::
*indices*:
Indexes of contour levels to consider when looking for
nearest point. Defaults to using all levels.
*pixel*:
If *True*, measure distance in pixel space, if not, measure
distance in axes space. Defaults to *True*.
g _�BNi i i ( R" R* R( R) R� R R� R, R� R� R5 R R� t find( R R R RQ t pixelt dmint conmint segminR_ Ra R� R� R R� R� R� R� t dsRg t imin( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt find_nearest_contour� s2 #
: N( R R R R R R R R R# RJ RQ R R R R Rf RB R" R' Rn ( ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR� O s � * t QuadContourSetc B sJ e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z 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 s t j | | | | � d S( sF
Calculate and draw contour lines or filled regions, depending
on whether keyword arg 'filled' is False (default) or True.
The first argument of the initializer must be an axes
object. The remaining arguments and keyword arguments
are described in QuadContourSet.contour_doc.
N( R� R ( R R� RN RO ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR 7 s c O sC t | d t � re | d j } | j d k rB | d j | _ n | d j | _ | d j | _ n� | j | | � \ } } } t j | � } t j
| � } t j | � } t j
| � }
| j j | | f | |
f g � | j j
d t � t j | � } | t j k rd } n t j | | | j � | � } | | _ d S( s*
Process args and kwargs.
i R0 N( R� Ro t CntrR) R" R2 R1 t
_contour_argsR R4 R6 R� R8 R9 R' t getmaskt nomaskt _cntrR� ( R RN RO t CR R RI t x0t x1t y0t y1t _mask( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR B s$
" c C s g } | j r� | j � \ } } g } x� t | | � D]h \ } } | j j | | d | j �} t | � d } | | } | | }
| j | � | j |
� q7 WnS d } xJ | j D]? } | j j | � } t | � d } | | } | j | � q� W| | f S( sV
Create and return allsegs and allkinds by calling underlying C code.
R i N(
R� R R� Rp t traceR R( R- R" R) ( R R R& R' R R( R) t nlistt nsegR* R+ ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR [ s$
c C sa | j r d } n d } t | � } | d k rn t j | d d t j �} | j | � \ } } | d } nN | d k r� | j | d | � \ } } } | d } n t d | | f � � t j | d
t
�} t j | � | _ t j
| � | _ | j rD| j d k rDt j | d k | � } t j d � | j � | _ n | j | | � | | | f S( NRK RL i i t dtypei i i s& Too many arguments to %s; see help(%s)R= s, Log scale: values of z <= 0 have been masked( R� R( R R� R
RN t _initialize_x_yt
_check_xyzR0 t masked_invalidR$ R6 R1 R4 R2 R t masked_whereR R R5 RQ ( R RN RO RO t NargsRI R R ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyRq s s*
c
C s� | d \ } } | j j d | d | d | � | j j | � } | j j | � } t j | d t j �} t j | d t j �} t j | d d t j �} | j d k r� t d � � n | j
\ } } | j
| j
k r� | j
| j
k r� | | | f S| j d k s| j d k r*t d � � n | j
\ } | j
\ } | | k sZ| | k rmt d d
� � n t j | | � \ } } | | | 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 t xdatat ydataRO R~ s Input z must be a 2D array.i 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.( R� t _process_unit_infot convert_xunitst convert_yunitsR
R� RN R t ndimR0 t shapet meshgrid(
R RN RO R R RI t Nyt Nxt nxt ny( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR� � s* $
c C s� | j d k r t d � � n | j \ } } | j d k r� | j d k rm t j t j | � t j | � � S| j \ } } } } t j | | | � } t j | | | � } t j | | � Sn | j d k r� d | d | f \ } } } } n | j \ } } } } t
| | � | }
t
| | � | } | t j | � d |
} | t j | � d | } | j d k r�| d d d � } n t j | | � 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����( R� R0 R� R� R" R� R
R� R� t linspaceR9 ( R RI R� R� Rv Rw Rx Ry R R R� R� ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyR � s(
"!s�
:func:`~matplotlib.pyplot.contour` and
:func:`~matplotlib.pyplot.contourf` draw contour lines and
filled contours, respectively. Except as noted, function
signatures and return values are the same for both versions.
:func:`~matplotlib.pyplot.contourf` differs from the MATLAB
version in that it does not draw the polygon edges.
To draw edges, add line contours with
calls to :func:`~matplotlib.pyplot.contour`.
call signatures::
contour(Z)
make a contour plot of an array *Z*. The level values are chosen
automatically.
::
contour(X,Y,Z)
*X*, *Y* specify the (*x*, *y*) coordinates of the surface
::
contour(Z,N)
contour(X,Y,Z,N)
contour *N* automatically-chosen levels.
::
contour(Z,V)
contour(X,Y,Z,V)
draw contour lines at the values specified in sequence *V*
::
contourf(..., V)
fill the (len(*V*)-1) regions between the values in *V*
::
contour(Z, **kwargs)
Use keyword args to control colors, linewidth, origin, cmap ... see
below for more details.
*X*, *Y*, and *Z* must be arrays with the same dimensions.
*Z* may be a masked array, but filled contouring may not
handle internal masked regions correctly.
``C = contour(...)`` returns a
:class:`~matplotlib.contour.QuadContourSet` object.
Optional keyword arguments:
*colors*: [ None | string | (mpl_colors) ]
If *None*, the colormap specified by cmap will be used.
If a string, like 'r' or 'red', all levels will be plotted in this
color.
If a tuple of matplotlib color args (string, float, rgb, etc),
different levels will be plotted in different colors in the order
specified.
*alpha*: float
The alpha blending value
*cmap*: [ None | Colormap ]
A cm :class:`~matplotlib.cm.Colormap` instance or
*None*. If *cmap* is *None* and *colors* is *None*, a
default Colormap is used.
*norm*: [ None | Normalize ]
A :class:`matplotlib.colors.Normalize` instance for
scaling data values to colors. If *norm* is *None* and
*colors* is *None*, the default linear scaling is used.
*levels* [level0, level1, ..., leveln]
A list of floating point numbers indicating the level
curves to draw; eg to draw just the zero contour pass
``levels=[0]``
*origin*: [ None | 'upper' | 'lower' | 'image' ]
If *None*, the first value of *Z* will correspond to the
lower left corner, location (0,0). If 'image', the rc
value for ``image.origin`` will be used.
This keyword is not active if *X* and *Y* are specified in
the call to contour.
*extent*: [ None | (x0,x1,y0,y1) ]
If *origin* is not *None*, then *extent* is interpreted as
in :func:`matplotlib.pyplot.imshow`: it gives the outer
pixel boundaries. In this case, the position of Z[0,0]
is the center of the pixel, not a corner. If *origin* is
*None*, then (*x0*, *y0*) is the position of Z[0,0], and
(*x1*, *y1*) is the position of Z[-1,-1].
This keyword is not active if *X* and *Y* are specified in
the call to contour.
*locator*: [ None | ticker.Locator subclass ]
If *locator* is None, the default
:class:`~matplotlib.ticker.MaxNLocator` is used. The
locator is used to determine the contour levels if they
are not given explicitly via the *V* argument.
*extend*: [ 'neither' | 'both' | 'min' | 'max' ]
Unless this is 'neither', contour levels are automatically
added to one or both ends of the range so that all data
are included. These added ranges are then mapped to the
special colormap values which default to the ends of the
colormap range, but can be set via
:meth:`matplotlib.colors.Colormap.set_under` and
:meth:`matplotlib.colors.Colormap.set_over` methods.
*xunits*, *yunits*: [ None | registered units ]
Override axis units by specifying an instance of a
:class:`matplotlib.units.ConversionInterface`.
contour-only keyword arguments:
*linewidths*: [ None | number | tuple of numbers ]
If *linewidths* is *None*, the default width in
``lines.linewidth`` in ``matplotlibrc`` is used.
If a number, all levels will be plotted with this linewidth.
If a tuple, different levels will be plotted with different
linewidths in the order specified
*linestyles*: [None | 'solid' | 'dashed' | 'dashdot' | 'dotted' ]
If *linestyles* is *None*, the 'solid' is used.
*linestyles* can also be an iterable of the above strings
specifying a set of linestyles to be used. If this
iterable is shorter than the number of contour levels
it will be repeated as necessary.
If contour is using a monochrome colormap and the contour
level is less than 0, then the linestyle specified
in ``contour.negative_linestyle`` in ``matplotlibrc``
will be used.
contourf-only keyword arguments:
*antialiased*: [ True | False ]
enable antialiasing
*nchunk*: [ 0 | integer ]
If 0, no subdivision of the domain. Specify a positive integer to
divide the domain into subdomains of roughly *nchunk* by *nchunk*
points. This may never actually be advantageous, so this option may
be removed. Chunking introduces artifacts at the chunk boundaries
unless *antialiased* is *False*.
Note: contourf fills intervals that are closed at the top; that
is, for boundaries *z1* and *z2*, the filled region is::
z1 < z <= z2
There is one exception: if the lowest boundary coincides with
the minimum value of the *z* array, then that minimum value
will be included in the lowest interval.
**Examples:**
.. plot:: mpl_examples/pylab_examples/contour_demo.py
.. plot:: mpl_examples/pylab_examples/contourf_demo.py
(
R R R R R R Rq R� R t contour_doc( ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyRo & s �(* R t
__future__R R t
matplotlibR t numpyR
R t matplotlib._cntrRt t matplotlib.patht pathR� t matplotlib.tickerR t
matplotlib.cmRA t matplotlib.colorsR t matplotlib.collectionsR� t matplotlib.font_managerR3 t matplotlib.textR t matplotlib.cbookRK t matplotlib.mlabR� t matplotlib.mathtextR t matplotlib.texmanagerR| t matplotlib.blocking_inputR R R R RB R� Ro ( ( ( sE /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/contour.pyt <module> s2
� � � �