matplotlib.patches.Patch

class matplotlib.patches.Patch(edgecolor=None, facecolor=None, color=None, linewidth=None, linestyle=None, antialiased=None, hatch=None, fill=True, capstyle=None, joinstyle=None, **kwargs) [source]

Заплатка — это 2D-художник с цветом заливки и цветом границы.

Если любой из edgecolor, facecolor, linewidth или antialiased равен None, они по умолчанию принимают значения из настроек rc параметров.

Поддерживаются следующие свойства kwarg:

Свойство	Описание
agg_filter	функция-фильтр, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha	float или None
animated	bool
antialiased или aa	bool или None
capstyle	['butt' | 'round' | 'projecting']
clip_box	экземпляр Bbox
clip_on	bool
clip_path	[(Path, Transform) | Patch | None]
color	спецификация цвета matplotlib
contains	функция-обработчик
edgecolor или ec	спецификация цвета mpl, None, 'none' или 'auto'
facecolor или fc	спецификация цвета mpl или None для значения по умолчанию или 'none' для отсутствия цвета
figure	экземпляр Figure
fill	bool
gid	строка идентификатора
hatch	['/' | '\' | '|' | '-' | '+' | 'x' | 'o' | 'O' | '.' | '*']
joinstyle	['miter' | 'round' | 'bevel']
label	объект
linestyle или ls	['solid' | 'dashed', 'dashdot', 'dotted' | (смещение, последовательность вкл/выкл штрихов) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	числовое значение или None для значения по умолчанию
path_effects	AbstractPathEffect
picker	[None | bool | float | вызываемый объект]
rasterized	bool или None
sketch_params	(масштаб: float, длина: float, случайность: float)
snap	bool или None
transform	Transform
url	строка URL
visible	bool
zorder	float

contains(mouseevent, radius=None) [source]

Проверяет, произошла ли активность мыши в пределах заплатки.

Возвращает Истина/Ложь, {}

contains_point(point, radius=None) [source]

Возвращает True , если заданная точка находится внутри пути (преобразованного с помощью атрибута transform).

radius позволяет сделать путь немного больше или меньше.

contains_points(points, radius=None) [source]

Возвращает массив bool, который равен True если соответствующая точка находится внутри (замкнутого) пути. (преобразованного с помощью атрибута transform).

points должен быть массивом Nx2. radius позволяет сделать путь немного больше или меньше.

draw(renderer) [source]

Отрисуйте Patch на заданном renderer.

fill

возвращает, установлена ли заливка

get_aa()

Возвращает True, если Patch должна быть нарисована с антиалиасингом.

get_antialiased() [source]

Возвращает True, если Patch должна быть нарисована с антиалиасингом.

get_capstyle() [source]

Возвращает текущий стиль окончания линии

get_data_transform() [source]

Возвращает экземпляр Transform, который преобразует координаты данных в физические координаты.

get_ec()

Возвращает цвет обводки Patch.

get_edgecolor() [source]

Возвращает цвет обводки Patch.

get_extents() [source]

Возвращает объект Bbox, определяющий прямоугольные границы Patch.

get_facecolor() [source]

Возвращает цвет заливки Patch.

get_fc()

Возвращает цвет заливки Patch.

get_fill() [source]

возвращает, установлена ли заливка

get_hatch() [source]

Возвращает текущий шаблон штриховки

get_joinstyle() [source]

Возвращает текущий стиль соединения

get_linestyle() [source]

Возвращает стиль линии. Будет одним из ['сплошная' | 'штриховая' | 'штрихпунктирная' | 'пунктирная']

get_linewidth() [source]

Возвращает ширину линии в пунктах.

get_ls()

Возвращает стиль линии. Будет одним из ['сплошная' | 'штриховая' | 'штрихпунктирная' | 'пунктирная']

get_lw()

Возвращает ширину линии в пунктах.

get_patch_transform() [source]

Возвращает экземпляр Transform, который преобразует координаты области в координаты данных.

Например, можно определить область круга, представляющую радиус 5, предоставив координаты для единичного круга, а преобразование, которое масштабирует координаты (координаты области) на 5.

get_path() [source]

Возвращает путь этого фрагмента

get_transform() [source]

Возвращает Transform, применяемое к Patch.

get_verts() [source]

Возвращает копию вершин, используемых в этом фрагменте

Если фрагмент содержит кривые Безье, кривые будут интерполированы отрезками прямых. Чтобы получить доступ к кривым как кривым, используйте get_path().

get_window_extent(renderer=None) [source]

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

Будьте осторожны при использовании этой функции, результаты не обновятся, если изменится прямоугольник окна элемента управления. Размер может измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или используемого холста (как это делается при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но сохранятся неправильно.

set_aa(aa) [source]

Псевдоним для set_antialiased

set_alpha(alpha) [source]

Устанавливает прозрачность заливки области.

ПРИНИМАЕТ: float или None

set_antialiased(aa) [source]

Устанавливает, следует ли использовать антиалиасинг.

Параметры:	b : bool or None

set_capstyle(s) [source]

Устанавливает стиль окончания линии

ПРИНИМАЕТ: ['butt' | 'round' | 'projecting']

set_color(c) [source]

Устанавливает цвет обводки и заливки.

ПРИНИМАЕТ: цветовое описание matplotlib

См. также

set_facecolor(), set_edgecolor()

Для отдельной установки цвета обводки или заливки.

set_ec(color) [source]

Псевдоним для set_edgecolor

set_edgecolor(color) [source]

Устанавливает цвет обводки области

ПРИНИМАЕТ: цветовое описание mpl, None, 'none' или 'auto'

set_facecolor(color) [source]

Устанавливает цвет заливки области

ПРИНИМАЕТ: цветовое описание mpl или None для значения по умолчанию или 'none' для отсутствия цвета

set_fc(color) [source]

Псевдоним для set_facecolor

set_fill(b) [source]

Устанавливает, следует ли заполнять область.

Параметры:	b : bool

set_hatch(hatch) [source]

Установить узор штриховки

hatch может быть одним из:

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Буквы могут быть объединены, в этом случае все указанные штриховки выполняются. Если одна и та же буква повторяется, это увеличивает плотность штриховки данного узора.

Штриховка поддерживается только в PostScript, PDF, SVG и Agg backends.

ПРИНИМАЕТ: ['/' | '\' | '|' | '-' | '+' | 'x' | 'o' | 'O' | '.' | '*']

set_joinstyle(s) [source]

Установить стиль соединения фигуры

ПРИНИМАЕТ: ['miter' | 'round' | 'bevel']

set_linestyle(ls) [source]

Установить стиль линии фигуры

linestyle	описание
'-' или 'solid'	сплошная линия
'--' или 'dashed'	пунктирная линия
'-.' или 'dashdot'	штрихпунктирная линия
':' или 'dotted'	штриховая линия

В качестве альтернативы можно указать кортеж с черточками следующего формата:

(offset, onoffseq),

где onoffseq это кортеж чётной длины с отступами и значениями черточек в точках.

ПРИНИМАЕТ: ['solid' | 'dashed', 'dashdot', 'dotted' |

(offset, on-off-dash-seq) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : { '-', '--', '-.', ':'} and more see description Стиль линии.

set_linewidth(w) [source]

Устанавливает ширину линии фигуры в пунктах

ПРИНИМАЕТ: число или None для значения по умолчанию

set_ls(ls) [source]

псевдоним для set_linestyle

set_lw(lw) [source]

псевдоним для set_linewidth

update_from(other) [source]

Обновляет текущий объект Patch по свойствам other.

validCap = ('butt', 'round', 'projecting')

validJoin = ('miter', 'round', 'bevel')

zorder = 1

Примеры использования matplotlib.patches.Patch

Создание настраиваемых легенд

Руководство по легендам