matplotlib.colors.Normalize

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

Базовые классы: object

Класс, который при вызове линейно отображает значения из интервала [vmin, vmax] в интервал [0.0, 1.0]. Отображение значений вне [vmin, vmax] зависит от параметра clip.

См. также

Нормализация цветовой карты

Примеры

x = [-2, -1, 0, 1, 2]

norm = mpl.colors.Normalize(vmin=-1, vmax=1, clip=False)
norm(x)  # [-0.5, 0., 0.5, 1., 1.5]
norm = mpl.colors.Normalize(vmin=-1, vmax=1, clip=True)
norm(x)  # [0., 0., 0.5, 1., 1.]

Параметры:

vmin, vmaxчисло с плавающей точкой или None

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

clipbool, по умолчанию: False

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

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

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

Примечания

Если vmin == vmax, входные данные будут отображены в 0.

__call__(value, clip=None)[исходный код]

Нормализует данные и возвращает нормализованные данные.

Параметры:

value

Данные для нормализации.

clipbool, необязательный

См. описание параметра clip в Normalize.

Если None, по умолчанию используется self.clip (значение по умолчанию для которого — False).

Примечания

Если они ещё не инициализированы, self.vmin и self.vmax инициализируются с использованием self.autoscale_None(value).

autoscale(A)[исходный код]: Задаёт vmin и vmax равными минимуму и максимуму A.

autoscale_None(A)[исходный код]: Если vmin или vmax не заданы, использует минимум/максимум A, чтобы задать их.

propertyclip

inverse(value)[исходный код]

Преобразует нормализованное значение (то есть индекс в цветовой карте) обратно в значение данных изображения.

Параметры:

value: Нормализованное значение.

staticprocess_value(value)[исходный код]

Приводит входное значение value к единообразному виду для удобной и эффективной нормализации.

value может быть скаляром или последовательностью.

Параметры:

value: Данные для нормализации.

Возвращает:

resultмассив с маской: Массив с маской той же формы, что и value.
is_scalarbool: Является ли value скаляром.

Примечания

Типы данных с плавающей точкой сохраняются; целочисленные типы размером не более двух байт преобразуются в np.float32, а более крупные типы — в np.float64. Сохранение float32, когда это возможно, и использование операций на месте значительно повышают скорость обработки больших массивов.