matplotlib.legend_handler

Стандартные обработчики легенд.

Сильно рекомендуется ознакомиться с руководством по легендам перед изучением данной документации.

Обработчики легенд должны быть вызываемым объектом со следующей сигнатурой.

legend_handler(legend, orig_handle, fontsize, handlebox)

Где legend — сама легенда, orig_handle — исходный график, fontsize — размер шрифта в пикселях, а handlebox — экземпляр OffsetBox. Внутри вызова необходимо создать соответствующие элементы (используя соответствующие свойства из legend и/или orig_handle) и добавить их в handlebox. Элементы должны быть масштабированы в соответствии с размером шрифта (обратите внимание, что размер указан в пикселях, то есть это значение, масштабированное с учётом dpi).

Этот модуль включает определения нескольких классов обработчиков легенд, производных от базового класса (HandlerBase) со следующим методом:

def legend_artist(self, legend, orig_handle, fontsize, handlebox)

class matplotlib.legend_handler.HandlerBase(xpad=0.0, ypad=0.0, update_func=None) [source]

Базовый класс для стандартных обработчиков легенд.

Производные классы должны переопределять метод create_artists, у которого следующая сигнатура:

def create_artists(self, legend, orig_handle,
                   xdescent, ydescent, width, height, fontsize,
                   trans):

Переопределённый метод должен создать элементы графики с заданным преобразованием, которые помещаются в заданные размеры (xdescent, ydescent, width, height), которые масштабируются, если необходимо, по размеру шрифта.

adjust_drawing_area(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize) [source]

create_artists(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize, trans) [source]

legend_artist(self, legend, orig_handle, fontsize, handlebox) [source]

Возвращает элемент графики, который генерирует этот HandlerBase для данного исходного элемента/указателя.

Параметры:

legendLegend Легенда, для которой создаются эти элементы легенды. orig_handlematplotlib.artist.Artist or similar Объект, для которого создаются эти элементы легенды. fontsizeint Размер шрифта в пикселях. Создаваемые элементы должны быть масштабированы в соответствии с заданным размером шрифта. handleboxmatplotlib.offsetbox.OffsetBox Прямоугольник, созданный для размещения элементов этой записи легенды. Элементы, созданные в методе legend_artist, должны быть добавлены в этот handlebox внутри этого метода.

update_prop(self, legend_handle, orig_handle, legend) [source]

class matplotlib.legend_handler.HandlerCircleCollection(yoffsets=None, sizes=None, **kw) [source]

Обработчик для CircleCollection.

Параметры:	numpointsint Количество точек, отображаемых в записи легенды. yoffsetsarray of floats Список из numpoints значений смещений по оси y для каждой точки в записи легенды.

Примечания

Любые другие ключевые аргументы передаются в HandlerNpoints.

create_collection(self, orig_handle, sizes, offsets, transOffset) [source]

class matplotlib.legend_handler.HandlerErrorbar(xerr_size=0.5, yerr_size=None, marker_pad=0.3, numpoints=None, **kw) [source]

Обработчик для Errorbars.

Параметры:	marker_padfloat Отступ между точками в записи легенды. numpointsint Количество точек, отображаемых в записи легенды.

Примечания

Любые другие ключевые аргументы передаются в HandlerNpoints.

create_artists(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize, trans) [source]

get_err_size(self, legend, xdescent, ydescent, width, height, fontsize) [source]

class matplotlib.legend_handler.HandlerLine2D(marker_pad=0.3, numpoints=None, **kw) [source]

Обработчик для Line2D экземпляров.

Параметры:	marker_padfloat Отступ между точками в записи легенды. numpointsint Количество точек, отображаемых в записи легенды.

Примечания

Любые другие ключевые аргументы передаются в HandlerNpoints.

create_artists(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize, trans) [source]

class matplotlib.legend_handler.HandlerLineCollection(marker_pad=0.3, numpoints=None, **kw) [source]

Обработчик для LineCollection экземпляров.

Параметры:	marker_padfloat Отступ между точками в записи легенды. numpointsint Количество точек, отображаемых в записи легенды.

Примечания

Любые другие ключевые аргументы передаются в HandlerNpoints.

create_artists(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize, trans) [source]

get_numpoints(self, legend) [source]

class matplotlib.legend_handler.HandlerNpoints(marker_pad=0.3, numpoints=None, **kw) [source]

Обработчик легенды, отображающий numpoints точек в записи легенды.

Параметры:	marker_padfloat Отступ между точками в записи легенды. numpointsint Количество точек для отображения в записи легенды.

Примечания

Любые другие ключевые аргументы передаются в HandlerBase.

get_numpoints(self, legend) [source]

get_xdata(self, legend, xdescent, ydescent, width, height, fontsize) [source]

class matplotlib.legend_handler.HandlerNpointsYoffsets(numpoints=None, yoffsets=None, **kw) [source]

Обработчик легенды, отображающий numpoints в легенде, позволяющий индивидуально смещать их в направлении оси Y.

Параметры:	numpointsint Количество точек для отображения в записи легенды. yoffsetsarray of floats Список из numpoints значений смещений по оси Y для каждой точки в записи легенды.

Примечания

Любые другие ключевые аргументы передаются в HandlerNpoints.

get_ydata(self, legend, xdescent, ydescent, width, height, fontsize) [source]

class matplotlib.legend_handler.HandlerPatch(patch_func=None, **kw) [source]

Обработчик для экземпляров Patch.

Параметры:	patch_funccallable, optional Функция, создающая элемент легенды. patch_func должна иметь следующий сигнатуру: def patch_func(legend=legend, orig_handle=orig_handle, xdescent=xdescent, ydescent=ydescent, width=width, height=height, fontsize=fontsize) После этого созданный элемент будет иметь вызываемый метод update_prop , и к нему будет применено соответствующее преобразование.

Примечания

Любые другие ключевые аргументы передаются в HandlerBase.

create_artists(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize, trans) [source]

class matplotlib.legend_handler.HandlerPathCollection(yoffsets=None, sizes=None, **kw) [source]

Обработчик для PathCollection, используемых в scatter.

Параметры:	numpointsint Количество точек для отображения в записи легенды. yoffsetsarray of floats Список из numpoints значений смещений по оси Y для каждой точки в записи легенды.

Примечания

Любые другие ключевые аргументы передаются в HandlerNpoints.

create_collection(self, orig_handle, sizes, offsets, transOffset) [source]

class matplotlib.legend_handler.HandlerPolyCollection(xpad=0.0, ypad=0.0, update_func=None) [source]

Обработчик для PolyCollection, используемых в fill_between и stackplot.

create_artists(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize, trans) [source]

class matplotlib.legend_handler.HandlerRegularPolyCollection(yoffsets=None, sizes=None, **kw) [source]

Обработчик для RegularPolyCollection.

Параметры:	numpointsint Количество точек для отображения в записи легенды. yoffsetsarray of floats Список из numpoints значений смещений по оси Y для каждой точки в записи легенды.

Примечания

Любые другие ключевые аргументы передаются в HandlerNpoints.

create_artists(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize, trans) [source]

create_collection(self, orig_handle, sizes, offsets, transOffset) [source]

get_numpoints(self, legend) [source]

get_sizes(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize) [source]

update_prop(self, legend_handle, orig_handle, legend) [source]

class matplotlib.legend_handler.HandlerStem(marker_pad=0.3, numpoints=None, bottom=None, yoffsets=None, **kw) [source]

Обработчик для графиков, созданных с помощью stem.

Параметры:	marker_padfloat, default: 0.3 Отступ между точками в элементе легенды. numpointsint, optional Количество точек для отображения в элементе легенды. bottomfloat, optional yoffsetsarray of floats, optional Список смещений по оси y для каждой точки в элементе легенды длиной numpoints.

Примечания

Любые другие ключевые аргументы передаются в HandlerNpointsYoffsets.

create_artists(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize, trans) [source]

get_ydata(self, legend, xdescent, ydescent, width, height, fontsize) [source]

class matplotlib.legend_handler.HandlerTuple(ndivide=1, pad=None, **kwargs) [source]

Обработчик для кортежей.

Дополнительные ключевые аргументы передаются в HandlerBase.

Параметры:	ndivideint, default: 1 Количество секций для разделения области легенды. Если None, используется длина входного кортежа. padfloat, default: rcParams["legend.borderpad"] (default: 0.4) Отступ в единицах размера шрифта.

create_artists(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize, trans) [source]

matplotlib.legend_handler.update_from_first_child(tgt, src) [source]