matplotlib.colors.BivarColormap
- classmatplotlib.colors.BivarColormap(N=256, M=256, shape='square', origin=(0, 0), name='bivariate colormap')[исходный код]
-
Базовые классы:
objectБазовый класс для всех преобразований из двух переменных в RGBA.
Предназначен для использования в качестве прямой замены Colormap при работе с двумерной таблицей поиска. Используется с
ScalarMappable.- Параметры:
-
- Nint, default: 256
-
Количество уровней квантования RGB вдоль первой оси.
- Mint, default: 256
-
Количество уровней квантования RGB вдоль второй оси.
- shape{'square', 'circle', 'ignore', 'circleignore'}
-
- 'square' каждое значение независимо ограничивается интервалом [0,1]
- 'circle' значения ограничиваются радиально относительно центра цветовой карты, а при отображении цветовой карты применяется круглая маска
- 'ignore' значения не ограничиваются, а вместо этого им присваивается цвет 'outside'
- 'circleignore' применяется круглая маска, но данные не ограничиваются, а вместо этого им присваивается цвет 'outside'
- origin(float, float), default: (0,0)
-
Относительное начало координат цветовой карты. Обычно (0, 0) для цветовых карт, линейных по обеим осям, и (.5, .5) для круглых цветовых карт. Используется при получении одномерных цветовых карт из двумерных.
- namestr, optional
-
Имя цветовой карты.
- __call__(X, alpha=None, bytes=False)[исходный код]
-
- Параметры:
-
- Xtuple (X0, X1), X0 and X1: float or int or array-like
-
Значение или значения данных для преобразования в RGBA.
- Для чисел с плавающей точкой X должно находиться в интервале
[0.0, 1.0], чтобы вернуть значения RGBA на уровнеX*100цветовой карты. - Для целых чисел X должно находиться в интервале
[0, Colormap.N), чтобы вернуть значения RGBA, индексированные по цветовой карте с индексомX.
- Для чисел с плавающей точкой X должно находиться в интервале
- alphafloat or array-like or None, default: None
-
Alpha должен быть скаляром от 0 до 1, последовательностью таких чисел с плавающей точкой, форма которой соответствует X0, или None.
- bytesbool, default: False
-
Если False (по умолчанию), возвращаемые значения RGBA будут числами с плавающей точкой в интервале
[0, 1], в противном случае это будут значенияnumpy.uint8в интервале[0, 255].
- Возвращает:
-
- Кортеж значений RGBA, если X — скаляр; в противном случае массив
- значений RGBA формы
X.shape + (4, ).
- copy()[исходный код]
-
Возвращает копию цветовой карты.
- get_bad()[исходный код]
-
Возвращает цвет для маскированных значений.
- get_outside()[исходный код]
-
Возвращает цвет для значений вне диапазона.
- propertylut
-
Предназначено для внешнего доступа к lut, например, для отображения cmap. Для круглых цветовых карт возвращает lut с круглой маской.
Во внутренних функциях (например, to_rgb()) следует использовать _lut, в которой хранится lut без круглой маски. lut без круглой маски нужна в to_rgb(), поскольку при преобразовании чисел с плавающей точкой в целые некоторые запросы пикселей попадают сразу за пределы круглой маски.
- propertyorigin
- resampled(lutshape, transposed=False)[исходный код]
-
Возвращает новую цветовую карту с lutshape элементами.
Обратите внимание, что эта функция не перемещает начало координат.
- Параметры:
-
- lutshapetuple of ints or None
-
Кортеж должен иметь длину 2, каждый элемент — целое число или None.
- Если элемент — целое число, соответствующая ось пересчитывается.
- Если элемент отрицательный, соответствующая ось пересчитывается в обратном порядке.
- Если элемент равен -1, ось инвертируется.
- Если элемент равен 1 или None, соответствующая ось не пересчитывается.
- transposedbool, default: False
-
Если True, после пересчёта оси меняются местами.
- Возвращает:
-
- BivarColormap
- reversed(axis_0=True, axis_1=True)[исходный код]
-
Инвертирует обе оси или одну из них.
- propertyshape
- transposed()[исходный код]
-
Транспонирует цветовую карту, меняя порядок осей местами.
- with_extremes(*, bad=None, outside=None, shape=None, origin=None)[исходный код]
-
Возвращает копию
BivarColormapс изменёнными атрибутами.Обратите внимание, что цвет outside имеет значение, только если
shape= 'ignore' или 'circleignore'.- Параметры:
-
- badNone or цвет
-
Если задан цвет Matplotlib, значение bad соответствующим образом устанавливается в копии.
- outsideNone or цвет
-
Если задан цвет Matplotlib, а shape равен 'ignore' или 'circleignore', значения outside цветовой карты соответствующим образом окрашиваются в копии.
- shape{'square', 'circle', 'ignore', 'circleignore'}
-
- Если 'square', каждое значение независимо ограничивается интервалом [0,1].
- Если 'circle', значения ограничиваются радиально относительно центра цветовой карты, а при отображении цветовой карты применяется круглая маска.
- Если 'ignore', значения не ограничиваются, а вместо этого им присваивается цвет outside.
- Если 'circleignore', применяется круглая маска, но данные не ограничиваются, а вместо этого им присваивается цвет outside.
- origin(float, float)
-
Относительное начало координат цветовой карты. Обычно (0, 0) для цветовых карт, линейных по обеим осям, и (.5, .5) для круглых цветовых карт. Используется при получении одномерных цветовых карт из двумерных.
- Возвращает:
-
- BivarColormap
-
копию self с заданными атрибутами
© 2012–2026 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/matplotlib.colors.BivarColormap.html