matplotlib.pyplot.colorbar
- matplotlib.pyplot.colorbar(mappable=None, cax=None, ax=None, **kwargs)[source]
-
Добавить цветковую шкалу к графику.
- Параметры:
-
- mappable
-
matplotlib.cm.ScalarMappable(например,AxesImage,ContourSetи т.д.) описываемая этой цветковой шкалой. Этот аргумент обязателен для методаFigure.colorbar, но необязателен для функцииpyplot.colorbar, которая устанавливает значение по умолчанию для текущего изображения.Обратите внимание, что можно создать
ScalarMappable"на лету", чтобы создать цветковую шкалу, не привязанную к ранее нарисованному объекту, например:fig.colorbar(cm.ScalarMappable(norm=norm, cmap=cmap), ax=ax)
-
cax
Axes, необязательно -
Оси, на которые будет нарисована цветковая шкала.
-
ax
Axes, список осей, необязательно -
Одна или несколько родительских осей, из которых будет взято место для новой оси цветковой шкалы, если cax равно None. Это не имеет эффекта, если cax задано.
- use_gridspecbool, необязательно
-
Если cax равно
None, новая cax создается как экземпляр Axes. Если ax является экземпляром Subplot и use_gridspec равноTrue, cax создается как экземпляр Subplot с использованием модуляgridspec.
- Возвращаемое значение:
-
-
colorbar
Colorbar
-
colorbar
- Другие параметры:
-
- locationNone или {'left', 'right', 'top', 'bottom'}
-
Расположение относительно родительских осей, где создается ось цветковой шкалы. Также определяет ориентацию цветковой шкалы (цветковые шкалы слева и справа вертикальные, цветковые шкалы сверху и снизу горизонтальные). Если None, расположение будет взято из orientation, если оно установлено (вертикальные цветковые шкалы справа, горизонтальные снизу), или по умолчанию будет равно 'right', если orientation не установлено.
- orientationNone или {'vertical', 'horizontal'}
-
Ориентация цветковой шкалы. Предпочтительнее установить location цветковой шкалы, так как это также определяет orientation; передача несовместимых значений для location и orientation вызывает исключение.
- fractionfloat, по умолчанию: 0.15
-
Доля исходных осей, используемых для цветковой шкалы.
- shrinkfloat, по умолчанию: 1.0
-
Доля, на которую нужно умножить размер цветковой шкалы.
- aspectfloat, по умолчанию: 20
-
Соотношение длинных и коротких размеров.
- padfloat, по умолчанию: 0.05, если вертикально, 0.15, если горизонтально
-
Доля исходных осей между цветковой шкалой и новыми осями изображения.
- anchor(float, float), необязательно
-
Точка привязки оси цветковой шкалы. По умолчанию (0.0, 0.5), если вертикально; (0.5, 1.0), если горизонтально.
- panchor(float, float) или False, необязательно
-
Точка привязки родительских осей цветковой шкалы. Если False, точка привязки родительских осей останется без изменений. По умолчанию (1.0, 0.5), если вертикально; (0.5, 0.0), если горизонтально.
- extend{'neither', 'both', 'min', 'max'}
-
Добавить указанные концы для значений, выходящих за пределы диапазона (если не 'neither'). Эти значения устанавливаются для данной цветовой карты с использованием методов colormap set_under и set_over.
- extendfrac{None, 'auto', длина, длины}
-
(перевод аналогичный)
- extendrectbool
-
(перевод аналогичный)
- spacing{'uniform', 'proportional'}
-
(перевод аналогичный)
- ticksNone или список делений или Locator
-
(перевод аналогичный)
- formatNone или str или Formatter
-
(перевод аналогичный)
- drawedgesbool
-
(перевод аналогичный)
- labelstr
-
(перевод аналогичный)
- boundaries, valuesNone или последовательность
-
(перевод аналогичный)
Примечания
(перевод аналогичный)
Примеры использования matplotlib.pyplot.colorbar
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.6.0/api/_as_gen/matplotlib.pyplot.colorbar.html