matplotlib.colors.Normalize

classmatplotlib.colors.Normalize(vmin=None, vmax=None, clip=False)[source]

Класс, который при вызове отображает значения в интервале [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, vmaxfloat или 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)[source]

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

Параметры:

value

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

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

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

Если None, по умолчанию self.clip (что по умолчанию False).

Примечания

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

autoscale(A)[source]: Устанавливает vmin, vmax в минимальное и максимальное значение A.

autoscale_None(A)[source]: Если vmin или vmax не заданы, используйте min/max A для их установки.

propertyclip

inverse(value)[source]

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

Параметры:

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

staticprocess_value(value)[source]

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

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

Параметры:

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

Возвращает:

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

Примечания

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