ó ›ßÈ[c @ s]dZddlmZmZddlZddlmZddlmZm Z m Z m Z m Z ddl mZmZmZmZmZmZyKddlZddlmZeeeƒsØd eefd „ƒYZnWn'ek rd efd „ƒYZnXd d gZidgd6Zd efd„ƒYZdddddddded„ Z dS(sK Normalization class for Matplotlib that can be used to produce colorbars. iÿÿÿÿ(tdivisiontprint_functionN(tmai(tPercentileIntervaltAsymmetricPercentileIntervaltManualIntervaltMinMaxIntervalt BaseInterval(t LinearStretcht SqrtStretcht PowerStretcht LogStretcht AsinhStretcht BaseStretch(t NormalizeRcB seZRS((t__name__t __module__(((sBlib/python2.7/site-packages/astropy/visualization/mpl_normalize.pyRscB seZd„ZRS(cO stdƒ‚dS(Ns2matplotlib is required in order to use this class.(t ImportError(tselftargstkwargs((sBlib/python2.7/site-packages/astropy/visualization/mpl_normalize.pyt__init__s(RRR(((sBlib/python2.7/site-packages/astropy/visualization/mpl_normalize.pyRstImageNormalizet simple_normt matplotlibt*cB sAeZdZddddeƒed„Zdd„Zd„ZRS(s÷ Normalization class to be used with Matplotlib. Parameters ---------- data : `~numpy.ndarray`, optional The image array. This input is used only if ``interval`` is also input. ``data`` and ``interval`` are used to compute the vmin and/or vmax values only if ``vmin`` or ``vmax`` are not input. interval : `~astropy.visualization.BaseInterval` subclass instance, optional The interval object to apply to the input ``data`` to determine the ``vmin`` and ``vmax`` values. This input is used only if ``data`` is also input. ``data`` and ``interval`` are used to compute the vmin and/or vmax values only if ``vmin`` or ``vmax`` are not input. vmin, vmax : float The minimum and maximum levels to show for the data. The ``vmin`` and ``vmax`` inputs override any calculated values from the ``interval`` and ``data`` inputs. stretch : `~astropy.visualization.BaseStretch` subclass instance, optional The stretch object to apply to the data. The default is `~astropy.visualization.LinearStretch`. clip : bool, optional If `True` (default), data values outside the [0:1] range are clipped to the [0:1] range. c C stt|ƒjd|d|d|ƒ||_||_|dk r|dk r|j|ƒ\}}|jdkr||_n|jdkr||_qn|dk rÈt|tƒ rÈt dƒ‚n||_ |dk rüt|t ƒ rüt dƒ‚n||_ |j |_||_dS(Ntvmintvmaxtclips5stretch must be an instance of a BaseStretch subclasss7interval must be an instance of a BaseInterval subclass(tsuperRRRRtNonet get_limitst isinstanceR t TypeErrortstretchRtintervaltinversetinverse_stretchR( RtdataR#RRR"Rt_vmint_vmax((sBlib/python2.7/site-packages/astropy/visualization/mpl_normalize.pyRAs"%      cC s=|dkr|j}nt|tjƒrW|r9t}n |j}|j|jƒ}nt}t j |ƒr‡t j |gdt ƒ}nt j |dt dt ƒ}|j|ƒt j||jd|ƒt j||j|jd|ƒ|jrt j|ddd|ƒ}n|j|d|dtƒ}tj |d|ƒS(Ntdtypetcopytoutggð?Rtmask(RRR Rt MaskedArraytFalseR,tfilledRtnptisscalartarraytfloattTruetautoscale_NonetsubtractRt true_divideR"(RtvaluesRR,((sBlib/python2.7/site-packages/astropy/visualization/mpl_normalize.pyt__call__\s$       cC s.|j|dtƒ}||j|j|jS(NR(R%R.RR(RR8t values_norm((sBlib/python2.7/site-packages/astropy/visualization/mpl_normalize.pyR$sN( RRt__doc__RRR.RR9R$(((sBlib/python2.7/site-packages/astropy/visualization/mpl_normalize.pyR$s   %tlineargð?gš™™™™™¹?c C sK|d k rt|ƒ} ni|d k s3|d k rQt|p?d|pHdƒ} n3|d k si|d k r{t||ƒ} n tƒ} |dkrœtƒ}n{|dkr´tƒ}nc|dkrÏt|ƒ}nH|dkrçtƒ}n0|dkrt |ƒ}nt dj |ƒƒ‚| j |ƒ\} } t d | d | d |d | ƒS(s? Return a Normalization class that can be used for displaying images with Matplotlib. This function enables only a subset of image stretching functions available in `~astropy.visualization.mpl_normalize.ImageNormalize`. This function is used by the ``astropy.visualization.scripts.fits2bitmap`` script. Parameters ---------- data : `~numpy.ndarray` The image array. stretch : {'linear', 'sqrt', 'power', log', 'asinh'}, optional The stretch function to apply to the image. The default is 'linear'. power : float, optional The power index for ``stretch='power'``. The default is 1.0. asinh_a : float, optional For ``stretch='asinh'``, the value where the asinh curve transitions from linear to logarithmic behavior, expressed as a fraction of the normalized image. Must be in the range between 0 and 1. The default is 0.1. min_cut : float, optional The pixel value of the minimum cut level. Data values less than ``min_cut`` will set to ``min_cut`` before stretching the image. The default is the image minimum. ``min_cut`` overrides ``min_percent``. max_cut : float, optional The pixel value of the maximum cut level. Data values greater than ``min_cut`` will set to ``min_cut`` before stretching the image. The default is the image maximum. ``max_cut`` overrides ``max_percent``. min_percent : float, optional The percentile value used to determine the pixel value of minimum cut level. The default is 0.0. ``min_percent`` overrides ``percent``. max_percent : float, optional The percentile value used to determine the pixel value of maximum cut level. The default is 100.0. ``max_percent`` overrides ``percent``. percent : float, optional The percentage of the image values used to determine the pixel values of the minimum and maximum cut levels. The lower cut level will set at the ``(100 - percent) / 2`` percentile, while the upper cut level will be set at the ``(100 + percent) / 2`` percentile. The default is 100.0. ``percent`` is ignored if either ``min_percent`` or ``max_percent`` is input. clip : bool, optional If `True` (default), data values outside the [0:1] range are clipped to the [0:1] range. Returns ------- result : `ImageNormalize` instance An `ImageNormalize` instance that can be used for displaying images with Matplotlib. ggY@R<tsqrttpowertlogtasinhsUnknown stretch: {0}.RRR"RN(RRRRRRR R R R t ValueErrortformatRR( R&R"R>tasinh_atmin_cuttmax_cutt min_percentt max_percenttpercentRR#RR((sBlib/python2.7/site-packages/astropy/visualization/mpl_normalize.pyR‰s*H           (!R;t __future__RRtnumpyR0RR#RRRRRR"RR R R R R Rtmatplotlib.colorsRR ttypetobjectRt__all__t__doctest_requires__RRR4R(((sBlib/python2.7/site-packages/astropy/visualization/mpl_normalize.pyts$ (.    e