CRc@ sLdZddlmZmZddlZddlZddlmZddlj Z ej j dZ e ee d \ZZedkoedkZidd 6d d 6d d 6dd6dd6dd6dd6dd6dd6dd6dd6dd6d d!6d"d#6d$d%6d&d'6d(d)6d*d+6d,d-6d.d/6d d06d1d26d3d46d5d66d7d86d9d:6d;d<6d=d>6d?d@6dAdB6dCdD6dEdF6dGdH6dIdJ6dKdL6dMdN6dOdP6dQdR6dSdT6dUdV6dWdX6dYdZ6d[d\6d]d^6d_d`6dadb6dcdd6dedf6dgdh6didj6dkdl6dmdn6dodp6dqdr6dsdt6dudv6dwdx6dydz6d{d|6d}d~6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dad6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd6dd 6d d 6d d 6dd6dd6dd6dd6dd6dd6dd6dd6ZxNejD]@\ZZejdldkr}ejdldZeeed<d=e(Z+d?Z,d@Z-dAefdBYZ.dCdDZ/dS(Es A module for converting numbers or color arguments to *RGB* or *RGBA* *RGB* and *RGBA* are sequences of, respectively, 3 or 4 floats in the range 0-1. This module includes functions and classes for color specification conversions, and for mapping numbers to colors in a 1-D array of colors called a colormap. Colormapping typically involves two steps: a data array is first mapped onto the range 0-1 using an instance of :class:`Normalize` or of a subclass; then this number in the 0-1 range is mapped to a color using an instance of a subclass of :class:`Colormap`. Two are provided here: :class:`LinearSegmentedColormap`, which is used to generate all the built-in colormap instances, but is also useful for making custom colormaps, and :class:`ListedColormap`, which is used for generating a custom colormap from a list of color specifications. The module also provides a single instance, *colorConverter*, of the :class:`ColorConverter` class providing methods for converting single color specifications or sequences of them to *RGB* or *RGBA*. Commands which take color arguments can use several formats to specify the colors. For the basic built-in colors, you can use a single letter - b: blue - g: green - r: red - c: cyan - m: magenta - y: yellow - k: black - w: white Gray shades can be given as a string encoding a float in the 0-1 range, e.g.:: color = '0.75' For a greater range of colors, you have two options. You can specify the color using an html hex string, as in:: color = '#eeefff' or you can pass an *R* , *G* , *B* tuple, where each of *R* , *G* , *B* are in the range [0,1]. Finally, legal html names for colors, like 'red', 'burlywood' and 'chartreuse' are supported. i(tprint_functiontdivisionN(tmat.iis#F0F8FFt aliceblues#FAEBD7t antiquewhites#00FFFFtaquas#7FFFD4t aquamarines#F0FFFFtazures#F5F5DCtbeiges#FFE4C4tbisques#000000tblacks#FFEBCDtblanchedalmonds#0000FFtblues#8A2BE2t blueviolets#A52A2Atbrowns#DEB887t burlywoods#5F9EA0t cadetblues#7FFF00t chartreuses#D2691Et chocolates#FF7F50tcorals#6495EDtcornflowerblues#FFF8DCtcornsilks#DC143Ctcrimsontcyans#00008Btdarkblues#008B8Btdarkcyans#B8860Bt darkgoldenrods#A9A9A9tdarkgrays#006400t darkgreens#BDB76Bt darkkhakis#8B008Bt darkmagentas#556B2Ftdarkolivegreens#FF8C00t darkoranges#9932CCt darkorchids#8B0000tdarkreds#E9967At darksalmons#8FBC8Ft darkseagreens#483D8Bt darkslateblues#2F4F4Ft darkslategrays#00CED1t darkturquoises#9400D3t darkviolets#FF1493tdeeppinks#00BFFFt deepskyblues#696969tdimgrays#1E90FFt dodgerblues#B22222t firebricks#FFFAF0t floralwhites#228B22t forestgreens#FF00FFtfuchsias#DCDCDCt gainsboros#F8F8FFt ghostwhites#FFD700tgolds#DAA520t goldenrods#808080tgrays#008000tgreens#ADFF2Ft greenyellows#F0FFF0thoneydews#FF69B4thotpinks#CD5C5Ct indianreds#4B0082tindigos#FFFFF0tivorys#F0E68Ctkhakis#E6E6FAtlavenders#FFF0F5t lavenderblushs#7CFC00t lawngreens#FFFACDt lemonchiffons#ADD8E6t lightblues#F08080t lightcorals#E0FFFFt lightcyans#FAFAD2tlightgoldenrodyellows#90EE90t lightgreens#D3D3D3t lightgrays#FFB6C1t lightpinks#FFA07At lightsalmons#20B2AAt lightseagreens#87CEFAt lightskyblues#778899tlightslategrays#B0C4DEtlightsteelblues#FFFFE0t lightyellows#00FF00tlimes#32CD32t limegreens#FAF0E6tlinentmagentas#800000tmaroons#66CDAAtmediumaquamarines#0000CDt mediumblues#BA55D3t mediumorchids#9370DBt mediumpurples#3CB371tmediumseagreens#7B68EEtmediumslateblues#00FA9Atmediumspringgreens#48D1CCtmediumturquoises#C71585tmediumvioletreds#191970t midnightblues#F5FFFAt mintcreams#FFE4E1t mistyroses#FFE4B5tmoccasins#FFDEADt navajowhites#000080tnavys#FDF5E6toldlaces#808000tolives#6B8E23t olivedrabs#FFA500toranges#FF4500t orangereds#DA70D6torchids#EEE8AAt palegoldenrods#98FB98t palegreens#AFEEEEt paleturquoises#DB7093t palevioletreds#FFEFD5t papayawhips#FFDAB9t peachpuffs#CD853Ftperus#FFC0CBtpinks#DDA0DDtplums#B0E0E6t powderblues#800080tpurples#FF0000treds#BC8F8Ft rosybrowns#4169E1t royalblues#8B4513t saddlebrowns#FA8072tsalmons#FAA460t sandybrowns#2E8B57tseagreens#FFF5EEtseashells#A0522Dtsiennas#C0C0C0tsilvers#87CEEBtskyblues#6A5ACDt slateblues#708090t slategrays#FFFAFAtsnows#00FF7Ft springgreens#4682B4t steelblues#D2B48Cttans#008080tteals#D8BFD8tthistles#FF6347ttomatos#40E0D0t turquoises#EE82EEtviolets#F5DEB3twheats#FFFFFFtwhites#F5F5F5t whitesmokes#FFFF00tyellows#9ACD32t yellowgreenitgreycC s.ytj|tSWntk r)tSXdS(s.Return *True* if *c* can be converted to *RGB*N(tcolorConvertertto_rgbtTruet ValueErrortFalse(tc((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyt is_color_likes   cC s2dtg|d D]}tj|d^qS(sBGiven an rgb or rgba sequence of 0-1 floats, return the hex strings #%02x%02x%02xii(ttupletnptround(trgbtval((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pytrgb2hexss\A#[a-fA-F0-9]{6}\ZcC st|tstdntj|d krFtd|ntg|dd!|dd!|dd!fD]}t|dd^qnS( s| Take a hex string *s* and return the corresponding rgb 3-tuple Example: #efefef -> (0.93725, 0.93725, 0.93725) s$hex2color requires a string argumentsinvalid hex color string "%s"iiiiigo@N( t isinstancet basestringt TypeErrorthexColorPatterntmatchtNoneRRtint(tstn((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyt hex2colors tColorConvertercB sseZdZidd6dd6dd6dd6dd 6dd 6dd 6dd 6ZiZdZddZddZRS(s Provides methods for converting color specifications to *RGB* or *RGBA* Caching is used for more efficient conversion upon repeated calls with the same argument. Ordinarily only the single instance instantiated in this module, *colorConverter*, is needed. gg?tbg?tgtrg?RitmtytktwcC sDy|j|SWnytk r"nitk rt|}y|j|SWqtk r]qtk rtdt|fqXnXyztj|rF|j}|j j |d }|d krt j ||}|j drt|}qCt|}|dks|dkr-tdnt|gd}qntj|rt|dksyt|dkrtdt|nt|d }g|D]*}t|dks|dkr|^qrtd qn td ||j| than that given). The list must start with x=0, end with x=1, and all values of x must be in increasing order. Values between the given mapping points are determined by simple linear interpolation. Alternatively, data can be a function mapping values between 0 - 1 to 0 - 1. The function returns an array "result" where ``result[x*(N-1)]`` gives the closest value for values of x between 0 and 1. iiRs$data must be convertable to an arrayiisdata must be nx3 formatNgig?s9data mapping points must start with x=0. and end with x=1s3data mapping points must have x in increasing order(tcallableRtlinspacetclipRRRRRRtsometruetsortRt searchsorted( tNtdatatgammatxindtluttadataRRty0ty1tind((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pytmakeMappingArrays< - "   !**tColormapcB sqeZdZddZd edZdd dZdd dZdd dZ dZ d Z d Z RS( s Baseclass for all scalar to RGBA mappings. Typically Colormap instances are used to convert data values (floats) from the interval ``[0, 1]`` to the RGBA color that the respective Colormap represents. For scaling of data into the ``[0, 1]`` interval see :class:`matplotlib.colors.Normalize`. It is worth noting that :class:`matplotlib.cm.ScalarMappable` subclasses make heavy use of this ``data->normalize->map-to-color`` processing chain. icC sf||_||_d|_d|_d|_||_|d|_|d|_t |_ t |_ dS(s Parameters ---------- name : str The name of the colormap. N : int The number of rgb quantization levels. giiN(gggg( tnameRt _rgba_badRt _rgba_undert _rgba_overt_i_undert_i_overt_i_badRt_isinittcolorbar_extend(RRR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyt__init__s         c C s%|js|jnd }tj|sFd}tj|g}n3d}tj|dt}|j }|j }~|j j s|j j}n|j jdkrgtjddgd|j }tj|} tj||dk| ||j9}tr$tj|d |jd |ntj|d |j}tj||d kd |jt}ntj|||jdk|jtj||dk|j|d k r|j|jkrtj|||jq|r|j|jqn|r|jd jtj} n|jj} |d k rt|d}t |d }|rmt|d }n| d dkj!r|| d d d f len(colors) the list will be extended by repetition. iN(RRR$RRRRRRtlistRRRR(RRRRR6((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR s*        cC s[tj|j}tj|jddftj|_||jd*t|_ |j dS(Niii( RRRRRRRR RRR(RR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR>s %  N(RRRRRR(((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR1s1t NormalizecB s_eZdZddedZedZddZdZ dZ dZ dZ RS( s_ A class which, when called, can normalize data into the ``[0.0, 1.0]`` interval. cC s||_||_||_dS(s If *vmin* or *vmax* is not given, they are taken from the input's minimum and maximum value respectively. If *clip* is *True* and the given value falls outside the range, the returned value will be 0 or 1, whichever is closer. Returns 0 if:: vmin==vmax Works with scalars or arrays, including masked arrays. If *clip* is *True*, masked values are set to 1; otherwise they remain masked. Clipping silently defeats the purpose of setting the over, under, and masked colors in the colormap, so it is likely to lead to surprises; therefore the default is *clip* = *False*. N(tvmintvmaxR(RR4R5R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyRLs  cC stj|rt}tj|}|jjdkrZt|tj r|j }qq|jj dkr|j tj }q|j tj}n$t}tj|gj tj }||fS(sY Homogenize the input *value* for easy and efficient normalization. *value* can be a scalar or sequence. Returns *result*, *is_scalar*, where *result* is a masked array matching *value*. Float dtypes are preserved; integer types with two bytes or smaller are converted to np.float32, and larger types are converted to np.float. Preserving float32 when possible, and using in-place operations, can greatly improve speed for large arrays. Experimental; we may want to add an option to force the use of float32. Ri(RRRRRRRRRRRtitemsizeR Rtfloat32RR(tvaluet is_scalarR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyt process_value`sc C s:|dkr|j}n|j|\}}|j||j|j}}||kri|jdn||krtdnt|}t|}|rt j |}t j t j|j |||d|}n|j}||8}|||}t j j |d|jdt}|r6|d}n|S(Nis/minvalue must be less than or equal to maxvalueRR(RRR:tautoscale_NoneR4R5R RRRtgetmaskRRRRRR( RR8RRR9R4R5Rtresdat((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyRs,       $   ! cC s{|jstdnt|j}t|j}tj|rgtj|}||||S||||SdS(NsNot invertible until scaled( tscaledRRR4R5RRRR(RR8R4R5R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pytinverses cC s(tj||_tj||_dS(s8 Set *vmin*, *vmax* to min, max of *A*. N(RR R4RR5(RtA((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyt autoscalescC sv|jdkr9tj|dkr9tj||_n|jdkrrtj|dkrrtj||_ndS(s( autoscale only None-valued vmin or vmaxiN(R4RRtsizeRR R5R(RR@((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR;s$$cC s|jdk o|jdk S(s return true if vmin and vmax setN(R4RR5(R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR>sN( RRRRRRR0R:RR?RAR;R>(((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR3Fs   tLogNormcB s5eZdZddZdZdZdZRS(sA Normalize a given value to the 0-1 range on a log scale c C s|dkr|j}n|j|\}}tj|ddt}|j||j|j}}||krt dn3|dkrt dn||kr|j dn|rtj |}tj t j|j|||d|}n|j}|j}|t jjkr/|dk}n||dkO}tj||dt j|||t j|8}|t j|t j|}t jj |d|dt}|r|d}n|S(NiRs/minvalue must be less than or equal to maxvaluesvalues must all be positiveRi(RRR:Rtmasked_less_equalRR;R4R5RR R<RRRRRtnomaskRRtlog( RR8RRR9R4R5RR=((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyRs:      $     cC s}|jstdn|j|j}}tj|rdtj|}|tj|||S|t |||SdS(NsNot invertible until scaled( R>RR4R5RRRRtpowertpow(RR8R4R5R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR?s cC s@tj|ddt}tj||_tj||_dS(s8 Set *vmin*, *vmax* to min, max of *A*. iRN(RRDRR R4RR5(RR@((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyRAscC s|jdk r"|jdk r"dStj|ddt}|jdkr^tj||_n|jdkrtj||_ndS(s( autoscale only None-valued vmin or vmaxNiR(R4RR5RRDRR R(RR@((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR;sN(RRRRRR?RAR;(((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyRCs  % t SymLogNormcB seeZdZdd d edZd dZdZdZdZ dZ dZ d Z RS( sh The symmetrical logarithmic scale is logarithmic in both the positive and negative directions from the origin. Since the values close to zero tend toward infinity, there is a need to have a range around zero that is linear. The parameter *linthresh* allows the user to specify the size of this range (-*linthresh*, *linthresh*). g?cC s;tj||||||_|dtjd|_dS(sY *linthresh*: The range within which the plot is linear (to avoid having the plot go to infinity around zero). *linscale*: This allows the linear range (-*linthresh* to *linthresh*) to be stretched relative to the logarithmic range. Its value is the number of decades to use for each half of the linear range. For example, when *linscale* == 1.0 (the default), the space used for the positive and negative halves of the linear range will be equal to one decade in the logarithmic range. Defaults to 1. g?iN(R3Rt linthreshRtet _linscale_adj(RRJtlinscaleR4R5R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR s c C s|dkr|j}n|j|\}}|j||j|j}}||krhtdn||kr|jdnx|rtj |}tj t j|j |||d|}n|j |j}||j8}||j|j}|r|d}n|S(Ns/minvalue must be less than or equal to maxvalueiR(RRR:R;R4R5RR RR<RRRt _transformRt_lowert_upper( RR8RRR9R4R5RR=((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR s&     $   cC stj||jk}tj||}|jtjtj|||j}|||j9}|||<||c|j9<|S(s) Inplace transformation. (RtabsRJtsignRLRF(RR.tmaskedRRRF((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyRN:s* cC stj||j|jk}tj||}tj||||j|j}|||j9}|||<||c|j<|S(s1 Inverse inplace Transformation. (RRQRJRLRRtexp(RR.RSRRRT((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyt_inv_transformFs% cC sG|j|j}}tj||g}|j|\|_|_dS(sE Calculates vmin and vmax in the transformed system. N(R4R5RRRNRPRO(RR4R5tarr((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyt_transform_vmin_vmaxRscC sR|jstdntj|}||j|j|j}|j|S(NsNot invertible until scaled(R>RRRRPRORU(RR8R((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR?Zs  cC s2tj||_tj||_|jdS(s8 Set *vmin*, *vmax* to min, max of *A*. N(RR R4RR5RW(RR@((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyRAascC sw|jdk r!|jdk r!n|jdkrEtj||_n|jdkritj||_n|jdS(s) autoscale only None-valued vmin or vmax N(R4RR5RR RRW(RR@((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR;isN( RRRRRRRRNRURWR?RAR;(((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyRIs     t BoundaryNormcB s/eZdZedZddZdZRS(s Generate a colormap index based on discrete intervals. Unlike :class:`Normalize` or :class:`LogNorm`, :class:`BoundaryNorm` maps values to integers instead of to the interval 0-1. Mapping to the 0-1 interval could have been done via piece-wise linear interpolation, but using integers seems simpler, and reduces the number of conversions back and forth between integer and floating point. cC s||_|d|_|d|_tj||_t|j|_||_|jd|jkrrt |_ n t |_ dS(s *boundaries* a monotonically increasing sequence *ncolors* number of colors in the colormap to be used If:: b[i] <= v < b[i+1] then v is mapped to color j; as i varies from 0 to len(boundaries)-2, j goes from 0 to ncolors-1. Out-of-range values are mapped to -1 if low and ncolors if high; these are converted to valid indices by :meth:`Colormap.__call__` . iiiN( RR4R5RRt boundariesRRtNcmapRt_interpR(RRYtncolorsR((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyRs     c C s`|dkr|j}ntj|}tj|}|j|jd}|rntj||j|jntj |j dtj }x-t |j D]\}}||||keZdZdddddddZdZddZRS( s9 Create a light source coming from the specified azimuth and elevation. Angles are in degrees, with the azimuth measured clockwise from north and elevation up from the zero plane of the surface. The :meth:`shade` is used to produce rgb values for a shaded relief image given a data array. i;i-iicC s:||_||_||_||_||_||_dS(s Specify the azimuth (measured clockwise from south) and altitude (measured up from the plane of the surface) of the light source in degrees. The color of the resulting image will be darkened by moving the (s,v) values (in hsv colorspace) toward (hsv_min_sat, hsv_min_val) in the shaded regions, or lightened by sliding (s,v) toward (hsv_max_sat hsv_max_val) in regions that are illuminated. The default extremes are chose so that completely shaded points are nearly black (s = 1, v = 0) and completely illuminated points are nearly white (s = 0, v = 1). N(tazdegtaltdegt hsv_min_valt hsv_max_valt hsv_min_satt hsv_max_sat(RRxRyRzR{R|R}((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyR-s      cC sh|||j|j|j}|j|d|}||ddddddf<|S(sE Take the input data array, convert to HSV values in the given colormap, then adjust those color values to given the impression of a shaded relief map with a specified light source. RGBA values are returned, which can then be used to plot the shaded image with imshow. t elevationNii(R Rt shade_rgb(RRtcmaptrgb0trgb1((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pytshadeFs *%g?c C so|jtjd}|jtjd}tj|\}}dtjtjtj||}tj||} tj|tj|tj |tj |tj | | dtj} | | j | j | j } d| d|} t |ddddddf} tj tjtj| dddddfd k| dkd| | dddddf| |j| dddddf| dddddf               (0Rt __future__RRtretnumpyRRtmatplotlib.cbookRt __version__tsplittpartstmapRtNP_MAJORtNP_MINORRRtitemsRRrtfindtreplaceRRtcompileRRtobjectRRRRR#R1R3RCRIRXRct deprecatedReRgRnRvRwR(((sK/opt/xtal/ccp4-6.5-linux32/lib/python2.7/site-packages/matplotlib/colors.pyt0sd       =q@uGrD   =g