Transform values using this stretch.

Parameters¶

valuesarray-like

The input values, which should already be normalized to the [0:1] range.

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).

invalidNone or float, optional

Value to assign NaN values generated by this class. NaNs in the input values array are not changed. This option is generally used with matplotlib normalization classes, where the invalid value should map to the matplotlib colormap “under” value (i.e., any finite value < 0). If None, then NaN values are not replaced. This keyword has no effect if clip=True.

Returns¶

resultndarray

The transformed values.