matplotlib.colors.PowerNorm

classmatplotlib.colors.PowerNorm(gamma, vmin=None, vmax=None, clip=False)[исходный код]

Базовый класс: Normalize

Линейно отображает заданное значение в диапазон 0–1, а затем применяет к этому диапазону степенную нормализацию.

Параметры:

gammafloat

Показатель степени.

vmin, vmaxfloat or None

Если vmin и/или vmax не заданы, им присваиваются соответственно минимальное и максимальное значения первого обработанного входного набора данных; то есть вызовы __call__(A) вызывают autoscale_None(A).

clipbool, default: False

Определяет поведение при отображении значений за пределами диапазона [vmin, vmax].

Если отсечение отключено, значения выше vmax преобразуются степенной функцией, в результате чего получаются значения больше 1, а значения ниже vmin преобразуются линейно, в результате чего получаются значения меньше 0. Обычно это желательное поведение, поскольку цветовые карты могут обозначать такие значения ниже диапазона и выше диапазона специальными цветами.

Если отсечение включено, значения ниже vmin отображаются в 0, а значения выше vmax — в 1. Такие значения становятся неотличимы от обычных граничных значений, что может привести к неверной интерпретации данных.

Примечания

Формула нормализации:

\[\left ( \frac{x - v_{min}}{v_{max} - v_{min}} \right )^{\gamma}\]

Для входных значений ниже vmin gamma равна единице.

Параметры:

vmin, vmaxfloat or None

Значения входных данных в диапазоне [vmin, vmax] будут линейно отображены в [0, 1]. Если vmin или vmax не заданы, им присваиваются соответственно минимальное и максимальное значения входных данных.

clipbool, default: False

Определяет поведение при отображении значений за пределами диапазона [vmin, vmax].

Если отсечение отключено, значения за пределами диапазона [vmin, vmax] также преобразуются, в результате чего получаются значения за пределами [0, 1]. Обычно это желательное поведение, поскольку цветовые карты могут обозначать такие значения ниже диапазона и выше диапазона специальными цветами.