PercentileInterval#

class astropy.visualization.PercentileInterval(percentile, n_samples=None)[source]#

Bases: AsymmetricPercentileInterval

Interval based on a keeping a specified fraction of pixels.

Parameters:
percentilefloat

The fraction of pixels to keep. The same fraction of pixels is eliminated from both ends.

n_samplesint, optional

Maximum number of values to use. If this is specified, and there are more values in the dataset as this, then values are randomly sampled from the array (with replacement).

Methods Summary

__call__(values[, clip, out])

Transform values using this interval.

get_limits(values)

Return the minimum and maximum value in the interval based on the values provided.

Methods Documentation

__call__(values, clip=True, out=None)#

Transform values using this interval.

The vmin and vmax values are determined by the get_limits method.

The following transformation is then applied to the values:

\[{\rm result} = \frac{{\rm values} - v_{\rm min}} {v_{\rm max} - v_{\rm min}}\]

If clip is True (default), the result is then clipped to the [0:1] range.

Parameters:
valuesarray_like

The input values.

clipbool, optional

If True (default), values outside the [0:1] range are clipped to the [0:1] range.

outndarray, optional

If specified, the output values will be placed in this array (typically used for in-place calculations).

Returns:
resultndarray

The transformed values.

get_limits(values)#

Return the minimum and maximum value in the interval based on the values provided.

Parameters:
valuesndarray

The image values.

Returns:
vmin, vmaxfloat

The mininium and maximum image value in the interval.