patches

matplotlib.patches

class matplotlib.patches.Arc(xy, width, height, angle=0.0, theta1=0.0, theta2=360.0, **kwargs)

Bases: matplotlib.patches.Ellipse

Эллиптическая дуга. Из-за различных оптимизаций, она не может быть заполнена.

Дуга должна использоваться в экземпляре Axes — её нельзя добавить напрямую к Figure — потому что она оптимизирована для рендеринга только тех сегментов, которые находятся внутри области осей с высоким разрешением.

Поддерживаются следующие аргументы:

xy

центр эллипса

width

длина горизонтальной оси

height

длина вертикальной оси

angle

угол поворота в градусах (против часовой стрелки)

theta1

начальный угол дуги в градусах

theta2

конечный угол дуги в градусах

Если theta1 и theta2 не указаны, дуга будет представлять собой полный эллипс.

Допустимые ключевые аргументы:

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

draw(artist, renderer, *args, **kwargs)

Эллипсы обычно рисуются с использованием приближения, которое использует восемь кубических сплайнов Безье. По данным неподтверждённого источника, погрешность этого приближения составляет 1.89818e-6:

Lancaster, Don. Приближение окружности или эллипса с помощью четырёх кубических сплайнов Безье.

http://www.tinaja.com/glib/ellipse4.pdf

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

В этом случае рисуются только видимые части эллипса, причём каждая видимая дуга использует фиксированное число сегментов сплайна (8). Алгоритм работает следующим образом:

1. Находятся точки пересечения эллипса с областью осей. (Это делается путём выполнения обратного преобразования на область осей, таким образом, что она относительна к единичной окружности — это делает вычисление пересечения намного проще, чем непосредственное вычисление пересечения повернутого эллипса).

   Используется алгоритм «линия, пересекающая окружность» из:

   Vince, John. Геометрия для компьютерной графики: формулы, примеры и доказательства. Лондон: Springer-Verlag, 2005.

2. Вычисляются углы каждой из точек пересечения.
3. Проводя против часовой стрелки, начиная с положительного направления оси x, каждая видимая дуга между парами вершин рисуется с использованием техники приближения дуги Безье, реализованной в matplotlib.path.Path.arc().

class matplotlib.patches.Arrow(x, y, dx, dy, width=1.0, **kwargs)

Bases: matplotlib.patches.Patch

Стрелка.

Рисует стрелку, начиная с (x, y), направление и длину задаются (dx, dy), ширина стрелки масштабируется по width.

Допустимые значения kwargs:

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

get_patch_transform()

get_path()

class matplotlib.patches.ArrowStyle

Bases: matplotlib.patches._Style

ArrowStyle — это контейнерный класс, определяющий несколько классов стилей стрелок, используемых для создания пути стрелки вдоль заданного пути. Они в основном используются с FancyArrowPatch.

Объект стиля стрелки может быть создан следующим образом:

ArrowStyle.Fancy(head_length=.4, head_width=.4, tail_width=.4)

или:

ArrowStyle("Fancy", head_length=.4, head_width=.4, tail_width=.4)

или:

ArrowStyle("Fancy, head_length=.4, head_width=.4, tail_width=.4")

Определены следующие классы:

Класс	Имя	Атрибуты
Кривая	-	None
КриваяB	->	head_length=0.4,head_width=0.2
СкобаB	-[	widthB=1.0,lengthB=0.2,angleB=None
Заполненная криваяB	-|>	head_length=0.4,head_width=0.2
КриваяA	<-	head_length=0.4,head_width=0.2
КриваяAB	<->	head_length=0.4,head_width=0.2
Заполненная криваяA	<|-	head_length=0.4,head_width=0.2
Заполненная криваяAB	<|-|>	head_length=0.4,head_width=0.2
СкобаA	]-	widthA=1.0,lengthA=0.2,angleA=None
СкобаAB	]-[	widthA=1.0,lengthA=0.2,angleA=None,widthB=1.0,lengthB=0.2,angleB=None
Изящная	fancy	head_length=0.4,head_width=0.4,tail_width=0.4
Простая	simple	head_length=0.5,head_width=0.5,tail_width=0.2
Клинообразная	wedge	tail_width=0.3,shrink_factor=0.5
СтойкаAB	|-|	widthA=1.0,angleA=None,widthB=1.0,angleB=None

Экземпляр любого класса стиля стрелки — это вызываемый объект, сигнатура вызова которого:

__call__(self, path, mutation_size, linewidth, aspect_ratio=1.)

и он возвращает кортеж объекта Path и логическое значение. path — это объект Path, по которому будет нарисована стрелка. mutation_size и aspect_ratio имеют тот же смысл, что и в BoxStyle. linewidth — это ширина линии, которая будет нарисована. Это предназначено для корректировки расположения головки, чтобы она не выходила за пределы целевой точки, но не все классы её поддерживают.

(Исходный код, png, hires.png, pdf)

возвращает экземпляр подкласса с заданным именем стиля.

class BarAB(widthA=1.0, angleA=None, widthB=1.0, angleB=None)

Bases: matplotlib.patches._Bracket

Стрелка с риской (|) на обоих концах.

widthA

ширина скобы

lengthA

длина скобы

angleA

угол между скобой и линией

widthB

ширина скобы

lengthB

длина скобы

angleB

угол между скобой и линией

class ArrowStyle.BracketA(widthA=1.0, lengthA=0.2, angleA=None)

Bases: matplotlib.patches._Bracket

Стрелка со скобой(]) на конце.

widthA

ширина скобы

lengthA

длина скобы

angleA

угол между скобой и линией

class ArrowStyle.BracketAB(widthA=1.0, lengthA=0.2, angleA=None, widthB=1.0, lengthB=0.2, angleB=None)

Bases: matplotlib.patches._Bracket

Стрелка со скобой(]) на обоих концах.

widthA

ширина скобы

lengthA

длина скобы

angleA

угол между скобой и линией

widthB

ширина скобы

lengthB

длина скобы

angleB

угол между скобой и линией

class ArrowStyle.BracketB(widthB=1.0, lengthB=0.2, angleB=None)

Bases: matplotlib.patches._Bracket

Стрелка со скобой([) на конце.

widthB

ширина скобы

lengthB

длина скобы

angleB

угол между скобой и линией

class ArrowStyle.Curve

Bases: matplotlib.patches._Curve

Простая кривая без наконечника.

class ArrowStyle.CurveA(head_length=0.4, head_width=0.2)

Bases: matplotlib.patches._Curve

Стрелка с наконечником в начале.

head_length

длина наконечника

head_width

ширина наконечника

class ArrowStyle.CurveAB(head_length=0.4, head_width=0.2)

Bases: matplotlib.patches._Curve

Стрелка с наконечниками в начале и в конце.

head_length

длина наконечника

head_width

ширина наконечника

class ArrowStyle.CurveB(head_length=0.4, head_width=0.2)

Bases: matplotlib.patches._Curve

Стрелка с наконечником в конце.

head_length

длина наконечника

head_width

ширина наконечника

class ArrowStyle.CurveFilledA(head_length=0.4, head_width=0.2)

Bases: matplotlib.patches._Curve

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

head_length

длина наконечника

head_width

ширина наконечника

class ArrowStyle.CurveFilledAB(head_length=0.4, head_width=0.2)

Bases: matplotlib.patches._Curve

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

head_length

длина наконечника

head_width

ширина наконечника

class ArrowStyle.CurveFilledB(head_length=0.4, head_width=0.2)

Bases: matplotlib.patches._Curve

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

head_length

длина наконечника

head_width

ширина наконечника

class ArrowStyle.Fancy(head_length=0.4, head_width=0.4, tail_width=0.4)

Bases: matplotlib.patches._Base

Изящная стрелка. Работает только с квадратичной кривой Безье.

head_length

длина наконечника

head_with

ширина наконечника

tail_width

ширина хвоста

transmute(path, mutation_size, linewidth)

class ArrowStyle.Simple(head_length=0.5, head_width=0.5, tail_width=0.2)

Bases: matplotlib.patches._Base

Простая стрелка. Работает только с квадратичной кривой Безье.

head_length

длина наконечника

head_with

ширина наконечника

tail_width

ширина хвоста

transmute(path, mutation_size, linewidth)

class ArrowStyle.Wedge(tail_width=0.3, shrink_factor=0.5)

Bases: matplotlib.patches._Base

Клинообразная форма. Работает только с квадратичной кривой Безье. Начальная точка имеет ширину хвоста, а конечная — ширину 0. В середине ширина равна shrink_factor*tail_width.

tail_width

ширина хвоста

shrink_factor

доля ширины стрелки в средней точке

transmute(path, mutation_size, linewidth)

class matplotlib.patches.BoxStyle

Базовые классы: matplotlib.patches._Style

BoxStyle — это контейнерный класс, который определяет несколько классов boxstyle, используемых для FancyBboxPatch.

Объект стиля можно создать следующим образом:

BoxStyle.Round(pad=0.2)

или:

BoxStyle("Round", pad=0.2)

или:

BoxStyle("Round, pad=0.2")

Ниже определены следующие классы boxstyle.

Класс	Имя	Атрибуты
Circle	circle	pad=0.3
DArrow	darrow	pad=0.3
LArrow	larrow	pad=0.3
RArrow	rarrow	pad=0.3
Round	round	pad=0.3,rounding_size=None
Round4	round4	pad=0.3,rounding_size=None
Roundtooth	roundtooth	pad=0.3,tooth_size=None
Sawtooth	sawtooth	pad=0.3,tooth_size=None
Square	square	pad=0.3

Экземпляр любого класса boxstyle — это вызываемый объект, сигнатура вызова которого:

__call__(self, x0, y0, width, height, mutation_size, aspect_ratio=1.)

и возвращает экземпляр Path. x0, y0, width и height задают расположение и размер рисуемой области. mutation_scale определяет общий размер мутации (т.е. преобразования прямоугольника в произвольную фигуру). mutation_aspect определяет соотношение сторон мутации.

(Исходный код, png, hires.png, pdf)

возвращает экземпляр подкласса с заданным именем стиля.

class Circle(pad=0.3)

Базовые классы: matplotlib.patches._Base

Простая круговая область.

Параметры:	pad : float Величина отступа вокруг исходной области.

transmute(x0, y0, width, height, mutation_size)

class BoxStyle.DArrow(pad=0.3)

Базовые классы: matplotlib.patches._Base

(Двойная) стрелка

transmute(x0, y0, width, height, mutation_size)

class BoxStyle.LArrow(pad=0.3)

Базовые классы: matplotlib.patches._Base

(Левая) стрелка

transmute(x0, y0, width, height, mutation_size)

class BoxStyle.RArrow(pad=0.3)

Базовые классы: matplotlib.patches.LArrow

(Правая) стрелка

transmute(x0, y0, width, height, mutation_size)

class BoxStyle.Round(pad=0.3, rounding_size=None)

Базовые классы: matplotlib.patches._Base

Прямоугольник с закруглёнными углами.

pad

величина отступа

rounding_size

радиус закругления углов. pad если None

transmute(x0, y0, width, height, mutation_size)

class BoxStyle.Round4(pad=0.3, rounding_size=None)

Базовые классы: matplotlib.patches._Base

Другой прямоугольник с закруглёнными краями.

pad

величина отступа

rounding_size

размер закругления краев. pad если None

transmute(x0, y0, width, height, mutation_size)

class BoxStyle.Roundtooth(pad=0.3, tooth_size=None)

Базовые классы: matplotlib.patches.Sawtooth

Прямоугольник с закруглёнными зубцами.

pad

величина отступа

tooth_size

размер зубцов. pad если None

transmute(x0, y0, width, height, mutation_size)

class BoxStyle.Sawtooth(pad=0.3, tooth_size=None)

Базовые классы: matplotlib.patches._Base

Прямоугольник с зубцами.

pad

величина отступа

tooth_size

размер зубцов. pad если None

transmute(x0, y0, width, height, mutation_size)

class BoxStyle.Square(pad=0.3)

Базовые классы: matplotlib.patches._Base

Простой прямоугольник.

pad

величина отступа

transmute(x0, y0, width, height, mutation_size)

class matplotlib.patches.Circle(xy, radius=5, **kwargs)

Bases: matplotlib.patches.Ellipse

Объект круга.

Создаёт истинный круг в центре xy = (x, y) с заданным радиусом. В отличие от CirclePolygon, который является полигональным приближением, этот объект использует сплайны Безье и гораздо ближе к безмасштабному кругу.

Допустимые значения kwargs:

Свойство	Описание
agg_filter	неизвестно
alpha	float или None
animated	[True | False]
antialiased или aa	[True | False] или None для значения по умолчанию
axes	объект Axes
capstyle	[‘butt’ | ‘round’ | ‘projecting’]
clip_box	объект matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
color	спецификация цвета matplotlib
contains	функция-обработчик
edgecolor или ec	спецификация цвета mpl, или None для значения по умолчанию, или ‘none’ для отсутствия цвета
facecolor или fc	спецификация цвета mpl, или None для значения по умолчанию, или ‘none’ для отсутствия цвета
figure	объект matplotlib.figure.Figure
fill	[True | False]
gid	строка-идентификатор
hatch	[‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
label	строка или любой печатаемый объект с преобразованием ‘%s’
linestyle или ls	[‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (offset, on-off-dash-seq) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	число с плавающей точкой или None для значения по умолчанию
path_effects	неизвестно
picker	[None|число с плавающей точкой|булево значение|функция]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	объект Transform
url	строка url
visible	[True | False]
zorder	любое число

get_radius()

возвращает радиус круга

radius

возвращает радиус круга

set_radius(radius)

Устанавливает радиус круга

ПРИНИМАЕТ: float

class matplotlib.patches.CirclePolygon(xy, radius=5, resolution=20, **kwargs)

Bases: matplotlib.patches.RegularPolygon

Приближение круга многоугольником.

Создаёт окружность в точке xy = (x, y) с заданным радиусом. Эта окружность аппроксимируется правильным многоугольником с resolution сторонами. Для более плавного круга, нарисованного с помощью сплайнов, см. Circle.

Допустимые параметры:

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

class matplotlib.patches.ConnectionPatch(xyA, xyB, coordsA, coordsB=None, axesA=None, axesB=None, arrowstyle='-', arrow_transmuter=None, connectionstyle='arc3', connector=None, patchA=None, patchB=None, shrinkA=0.0, shrinkB=0.0, mutation_scale=10.0, mutation_aspect=None, clip_on=False, dpi_cor=1.0, **kwargs)

Основы: matplotlib.patches.FancyArrowPatch

Класс ConnectionPatch предназначен для создания соединительных линий между двумя точками (возможно, в разных осях).

Соединяет точку xyA в coordsA с точкой xyB в coordsB

Допустимые ключи:

Ключ	Описание
arrowstyle	стиль стрелки
connectionstyle	стиль соединения
relpos	по умолчанию (0.5, 0.5)
patchA	по умолчанию — граница текста
patchB	по умолчанию — None
shrinkA	по умолчанию — 2 точки
shrinkB	по умолчанию — 2 точки
mutation_scale	по умолчанию — размер текста (в пунктах)
mutation_aspect	по умолчанию — 1.
?	любой ключ для matplotlib.patches.PathPatch

coordsA и coordsB — строки, указывающие координаты xyA и xyB.

Свойство	Описание
‘figure points’	точки от нижнего левого угла фигуры
‘figure pixels’	пиксели от нижнего левого угла фигуры
‘figure fraction’	0,0 — нижний левый угол фигуры, 1,1 — верхний правый
‘axes points’	точки от нижнего левого угла осей
‘axes pixels’	пиксели от нижнего левого угла осей
‘axes fraction’	0,0 — нижний левый угол осей, 1,1 — верхний правый
‘data’	используйте систему координат анотируемого объекта (по умолчанию)
‘offset points’	Укажите смещение (в пунктах) от значения xy
‘polar’	вы можете указать theta, r для аннотации, даже в декартовых графиках. Обратите внимание, что если вы используете полярные оси, вам не нужно указывать polar для системы координат, так как это родная система координат «данные».

draw(renderer)

Рисование.

get_annotation_clip()

Возвращает атрибут annotation_clip. См. set_annotation_clip() для значения возвращаемых данных.

get_path_in_displaycoord()

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

set_annotation_clip(b)

Устанавливает атрибут annotation_clip.

• True: аннотация будет отображаться только тогда, когда self.xy находится внутри

  осей.

• False: аннотация всегда будет отображаться независимо от ее

  положения.

• None: self.xy будет проверяться только если xycoords — «data»

class matplotlib.patches.ConnectionStyle

Основы: matplotlib.patches._Style

Класс ConnectionStyle — это контейнерный класс, который определяет несколько классов стилей соединения, используемых для создания пути между двумя точками. В основном используются с FancyArrowPatch.

Объект connectionstyle может быть создан как:

ConnectionStyle.Arc3(rad=0.2)

или:

ConnectionStyle("Arc3", rad=0.2)

или:

ConnectionStyle("Arc3, rad=0.2")

Определены следующие классы:

Класс	Имя	Атрибуты
Angle	angle	angleA=90,angleB=0,rad=0.0
Angle3	angle3	angleA=90,angleB=0
Arc	arc	angleA=0,angleB=0,armA=None,armB=None,rad=0.0
Arc3	arc3	rad=0.0
Bar	bar	armA=0.0,armB=0.0,fraction=0.3,angle=None

Экземпляр любого класса стиля соединения — это вызываемый объект, сигнатура вызова которого:

__call__(self, posA, posB,
         patchA=None, patchB=None,
         shrinkA=2., shrinkB=2.)

и он возвращает экземпляр Path. posA и posB — кортежи с координатами x,y двух соединяемых точек. Если заданы patchA (или patchB), возвращаемый путь обрезается так, чтобы он начинался (или заканчивался) с границы области. Путь дополнительно уменьшается на shrinkA (или shrinkB), указанные в пунктах.

Возвращает экземпляр подкласса с заданным именем стиля.

class Angle(angleA=90, angleB=0, rad=0.0)

Основы: matplotlib.patches._Base

Создаёт кусково-непрерывный путь с квадратичными Bézier-кривыми между двумя точками. Путь имеет одну проходящую точку, расположенную в точке пересечения двух прямых, проходящих через начальную (или конечную) точку и имеющих угол angleA (или angleB). Соединяющие участки скруглены с помощью rad.

angleA

начальный угол пути

angleB

конечный угол пути

rad

радиус скругления

connect(posA, posB)

class ConnectionStyle.Angle3(angleA=90, angleB=0)

Основы: matplotlib.patches._Base

Создаёт простую квадратичную Bézier-кривую между двумя точками. Средняя контрольная точка расположена в точке пересечения двух прямых, проходящих через начальную (или конечную) точку и имеющих угол angleA (или angleB).

angleA

начальный угол пути

angleB

конечный угол пути

connect(posA, posB)

class ConnectionStyle.Arc(angleA=0, angleB=0, armA=None, armB=None, rad=0.0)

Основы: matplotlib.patches._Base

Создаёт кусково-непрерывный путь с квадратичными Bézier-кривыми между двумя точками. Путь может иметь две проходящие точки: одна на расстоянии armA и с углом angleA от точки A, другая — относительно точки B. Кромки скруглены с помощью rad.

angleA :

начальный угол пути

angleB :

конечный угол пути

armA :

длина начального плеча

armB :

длина конечного плеча

rad :

радиус скругления кромки

connect(posA, posB)

class ConnectionStyle.Arc3(rad=0.0)

Основы: matplotlib.patches._Base

Создаёт простую квадратичную Bézier-кривую между двумя точками. Кривая создаётся так, что средняя контрольная точка (C1) находится на одинаковом расстоянии от начальной (C0) и конечной точек (C2), а расстояние от C1 до линии, соединяющей C0-C2, равно rad умноженному на расстояние C0-C2.

rad

кривизна кривой.

connect(posA, posB)

class ConnectionStyle.Bar(armA=0.0, armB=0.0, fraction=0.3, angle=None)

Основы: matplotlib.patches._Base

Прямая линия с углом angle между A и B с armA и armB. Одно из плеч удлиняется, чтобы они соединялись под прямым углом. Длина плеча A определяется как (armA + fraction x расстояние AB). То же для armB.

Параметры:	armA : float минимальная длина плеча A armB : float минимальная длина плеча B fraction : float доля расстояния между двумя точками, которая будет добавлена к armA и armB. angle : float или None угол соединительной линии (если None, параллельно A и B)

connect(posA, posB)

class matplotlib.patches.Ellipse(xy, width, height, angle=0.0, **kwargs)

Bases: matplotlib.patches.Patch

Эллипс без масштабирования.

xy

центр эллипса

width

общая длина (диаметр) горизонтальной оси

height

общая длина (диаметр) вертикальной оси

angle

угол поворота в градусах (против часовой стрелки)

Допустимые аргументы kwargs:

Свойство	Описание
agg_filter	неизвестно
alpha	вещественное число или None
animated	[True | False]
antialiased or aa	[True | False] или None по умолчанию
axes	экземпляр Axes
capstyle	[‘butt’ | ‘round’ | ‘projecting’]
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
color	спецификация цвета matplotlib
contains	вызываемая функция
edgecolor or ec	спецификация цвета mpl, или None по умолчанию, или ‘none’ для отсутствия цвета
facecolor or fc	спецификация цвета mpl, или None по умолчанию, или ‘none’ для отсутствия цвета
figure	экземпляр matplotlib.figure.Figure
fill	[True | False]
gid	строка идентификатора
hatch	[‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
label	строка или любой вывод с преобразованием ‘%s’
linestyle or ls	[‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (offset, on-off-dash-seq) | '-' | '-.' | ':' | 'None' | ' ' | '']
linewidth or lw	вещественное число или None по умолчанию
path_effects	неизвестно
picker	[None|вещественное число|логическое значение|вызываемая функция]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка url
visible	[True | False]
zorder	любое число

get_patch_transform()

get_path()

Возвращает вершины прямоугольника

class matplotlib.patches.FancyArrow(x, y, dx, dy, width=0.001, length_includes_head=False, head_width=None, head_length=None, shape='full', overhang=0, head_starts_at_zero=False, **kwargs)

Основы: matplotlib.patches.Polygon

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

Аргументы конструктора

width: float (по умолчанию: 0.001)

ширина всего хвоста стрелки

length_includes_head: [True | False] (по умолчанию: False)

True, если наконечник учитывается при расчете длины.

head_width: float или None (по умолчанию: 3*width)

общая ширина всего наконечника стрелки

head_length: float или None (по умолчанию: 1.5 * head_width)

длина наконечника стрелки

shape: [‘full’, ‘left’, ‘right’] (по умолчанию: ‘full’)

рисовать левую половину, правую половину или полную стрелку

overhang: float (по умолчанию: 0)

дробь, на которую стрелка отходит назад (0 overhang означает треугольную форму). Может быть отрицательным или больше единицы.

head_starts_at_zero: [True | False] (по умолчанию: False)

если True, наконечник рисуется с координаты 0 вместо конца в координате 0.

Другие допустимые ключевые слова-аргументы (унаследованные от Patch):

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

class matplotlib.patches.FancyArrowPatch(posA=None, posB=None, path=None, arrowstyle='simple', arrow_transmuter=None, connectionstyle='arc3', connector=None, patchA=None, patchB=None, shrinkA=2.0, shrinkB=2.0, mutation_scale=1.0, mutation_aspect=None, dpi_cor=1.0, **kwargs)

Bases: matplotlib.patches.Patch

Фигурная стрелка. Рисует стрелку с использованием :class:ArrowStyle.

Если заданы posA и posB, создаётся путь, соединяющий две точки, согласно параметру connectionstyle. Путь будет обрезан по patchA и patchB, а затем уменьшен на shrinkA и shrinkB. Стрелка рисуется вдоль полученного пути с использованием параметра arrowstyle. Если задан параметр path, стрелка рисуется вдоль этого пути, и параметры patchA, patchB, shrinkA и shrinkB игнорируются.

Параметр connectionstyle описывает способ соединения точек posA и posB. Он может быть экземпляром класса ConnectionStyle (matplotlib.patches.ConnectionStlye) или строкой имени стиля соединения с необязательными параметрами, разделёнными запятыми. Доступны следующие стили соединения.

Класс	Имя	Атрибуты
Angle	angle	angleA=90,angleB=0,rad=0.0
Angle3	angle3	angleA=90,angleB=0
Arc	arc	angleA=0,angleB=0,armA=None,armB=None,rad=0.0
Arc3	arc3	rad=0.0
Bar	bar	armA=0.0,armB=0.0,fraction=0.3,angle=None

Параметр arrowstyle описывает, как будет нарисована стрелка. Он может быть строкой имени стиля стрелки с необязательными параметрами, разделёнными запятыми, или экземпляром ArrowStyle. Необязательные атрибуты предназначены для масштабирования с помощью параметра mutation_scale. Доступны следующие стили стрелок.

Класс	Имя	Атрибуты
Curve	-	None
CurveB	->	head_length=0.4,head_width=0.2
BracketB	-[	widthB=1.0,lengthB=0.2,angleB=None
CurveFilledB	-|>	head_length=0.4,head_width=0.2
CurveA	<-	head_length=0.4,head_width=0.2
CurveAB	<->	head_length=0.4,head_width=0.2
CurveFilledA	<|-	head_length=0.4,head_width=0.2
CurveFilledAB	<|-|>	head_length=0.4,head_width=0.2
BracketA	]-	widthA=1.0,lengthA=0.2,angleA=None
BracketAB	]-[	widthA=1.0,lengthA=0.2,angleA=None,widthB=1.0,lengthB=0.2,angleB=None
Fancy	fancy	head_length=0.4,head_width=0.4,tail_width=0.4
Simple	simple	head_length=0.5,head_width=0.5,tail_width=0.2
Wedge	wedge	tail_width=0.3,shrink_factor=0.5
BarAB	|-|	widthA=1.0,angleA=None,widthB=1.0,angleB=None

mutation_scale

: Значение, с помощью которого будут масштабироваться атрибуты arrowstyle

(например, head_length). По умолчанию = 1.

mutation_aspect

: Высота прямоугольника будет

сжата на это значение перед мутацией, а изменённый прямоугольник будет растянут в обратной пропорции. По умолчанию = None.

Допустимые аргументы kwargs:

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

draw(renderer)

get_arrowstyle()

Возвращает объект arrowstyle

get_connectionstyle()

Возвращает экземпляр ConnectionStyle

get_dpi_cor()

dpi_cor используется в настоящее время для параметров linewidth и коэффициента уменьшения. Масштаб мутации на это не влияет.

get_mutation_aspect()

Возвращает коэффициент масштабирования мутации рамки.

get_mutation_scale()

Возвращает масштаб мутации.

get_path()

возвращает путь стрелки в координатах данных. Используйте метод get_path_in_displaycoord(), чтобы получить путь стрелки в координатах отображения.

get_path_in_displaycoord()

Возвращает измененный путь стрелки в координатах отображения

set_arrowstyle(arrowstyle=None, **kw)

Устанавливает стиль стрелки.

arrowstyle может быть строкой с именем стиля стрелки с необязательными

запятыми-разделяемыми атрибутами. В качестве альтернативы, атрибуты можно передавать как ключевые слова.

set_arrowstyle(“Fancy,head_length=0.2”) set_arrowstyle(“fancy”, head_length=0.2)

Старые атрибуты просто игнорируются.

Без аргумента (или с arrowstyle=None), возвращает доступные стили стрелок в виде списка строк.

set_connectionstyle(connectionstyle, **kw)

Устанавливает стиль соединения.

connectionstyle может быть строкой с именем стиля соединения с

необязательными запятыми-разделяемыми атрибутами. В качестве альтернативы, атрибуты можно передавать как ключевые слова.

set_connectionstyle(“arc,angleA=0,armA=30,rad=10”) set_connectionstyle(“arc”, angleA=0,armA=30,rad=10)

Старые атрибуты просто игнорируются.

Без аргумента (или с connectionstyle=None), возвращает доступные стили в виде списка строк.

set_dpi_cor(dpi_cor)

dpi_cor используется в настоящее время для параметров linewidth и коэффициента уменьшения. Масштаб мутации на это не влияет.

set_mutation_aspect(aspect)

Устанавливает коэффициент масштабирования мутации рамки.

ПРИНИМАЕТ: число с плавающей точкой

set_mutation_scale(scale)

Устанавливает масштаб мутации.

ПРИНИМАЕТ: число с плавающей точкой

set_patchA(patchA)

Устанавливает начальный фрагмент.

set_patchB(patchB)

установить начальный участок

set_positions(posA, posB)

установить начальные и конечные позиции соединяющего пути. Используйте текущее значение, если None.

class matplotlib.patches.FancyBboxPatch(xy, width, height, boxstyle='round', bbox_transmuter=None, mutation_scale=1.0, mutation_aspect=None, **kwargs)

Bases: matplotlib.patches.Patch

Отобразить красивую рамку вокруг прямоугольника с левым нижним углом в xy*=(*x, y) заданной шириной и высотой.

FancyBboxPatch класс похож на класс Rectangle, но он рисует красивую рамку вокруг прямоугольника. Преобразование прямоугольной рамки в красивую рамку делегируется классу BoxTransmuterBase и его производным классам.

xy = левая нижняя вершина

width, height

boxstyle определяет вид красивой рамки. Он может быть строкой имени стиля с атрибутом, разделенным запятыми, или экземпляром BoxStyle. Доступны следующие стили рамок.

Класс	Имя	Атрибуты
Circle	circle	pad=0.3
DArrow	darrow	pad=0.3
LArrow	larrow	pad=0.3
RArrow	rarrow	pad=0.3
Round	round	pad=0.3,rounding_size=None
Round4	round4	pad=0.3,rounding_size=None
Roundtooth	roundtooth	pad=0.3,tooth_size=None
Sawtooth	sawtooth	pad=0.3,tooth_size=None
Square	square	pad=0.3

mutation_scale : значение, с которым будут масштабироваться атрибуты boxstyle (например, pad). По умолчанию=1.

mutation_aspect : высота прямоугольника будет сжата на это значение перед мутацией, а изменённая рамка будет растянута в обратной пропорции. По умолчанию=None.

Допустимые kwargs:

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

get_bbox()

get_boxstyle()

Возвращает объект boxstyle

get_height()

Возвращает высоту прямоугольника

get_mutation_aspect()

Возвращает коэффициент масштабирования рамки.

get_mutation_scale()

Возвращает масштаб мутации.

get_path()

Возвращает изменённый путь прямоугольника

get_width()

Возвращает ширину прямоугольника

get_x()

Возвращает левую координату прямоугольника

get_y()

Возвращает нижнюю координату прямоугольника

set_bounds(*args)

Устанавливает границы прямоугольника: l,b,w,h

ПРИНИМАЕТ: (левая, нижняя, ширина, высота)

set_boxstyle(boxstyle=None, **kw)

Устанавливает стиль рамки.

boxstyle может быть строкой с именем стиля рамки и необязательными атрибутами, разделенными запятыми. В качестве альтернативы атрибуты можно указать в качестве ключевых слов:

set_boxstyle("round,pad=0.2")
set_boxstyle("round", pad=0.2)

Старые атрибуты просто игнорируются.

Без аргумента (или с boxstyle = None) возвращаются доступные стили рамок.

Доступные стили рамок:

Класс	Имя	Атрибуты
Circle	circle	pad=0.3
DArrow	darrow	pad=0.3
LArrow	larrow	pad=0.3
RArrow	rarrow	pad=0.3
Round	round	pad=0.3,rounding_size=None
Round4	round4	pad=0.3,rounding_size=None
Roundtooth	roundtooth	pad=0.3,tooth_size=None
Sawtooth	sawtooth	pad=0.3,tooth_size=None
Square	square	pad=0.3

ПРИНИМАЕТ: [‘circle’ | ‘darrow’ | ‘larrow’ | ‘rarrow’ | ‘round’ | ‘round4’ | ‘roundtooth’ | ‘sawtooth’ | ‘square’]

set_height(h)

Устанавливает высоту прямоугольника

ПРИНИМАЕТ: число с плавающей точкой

set_mutation_aspect(aspect)

Устанавливает коэффициент пропорциональности изменения рамки.

ПРИНИМАЕТ: число с плавающей точкой

set_mutation_scale(scale)

Устанавливает масштаб изменения.

ПРИНИМАЕТ: число с плавающей точкой

set_width(w)

Устанавливает ширину прямоугольника

ПРИНИМАЕТ: число с плавающей точкой

set_x(x)

Устанавливает левую координату прямоугольника

ПРИНИМАЕТ: число с плавающей точкой

set_y(y)

Устанавливает нижнюю координату прямоугольника

ПРИНИМАЕТ: число с плавающей точкой

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)

Bases: matplotlib.artist.Artist

Объект заливки представляет собой 2D-объект с цветом заливки и цветом контура.

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

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

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

contains(mouseevent, radius=None)

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

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

contains_point(point, radius=None)

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

draw(artist, renderer, *args, **kwargs)

Отображение Patch на заданном рендерере.

fill

Возвращает значение, установленное для заливки.

get_aa()

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

get_antialiased()

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

get_capstyle()

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

get_data_transform()

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

get_ec()

Возвращает цвет контура объекта Patch.

get_edgecolor()

Возвращает цвет контура объекта Patch.

get_extents()

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

get_facecolor()

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

get_fc()

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

get_fill()

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

get_hatch()

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

get_joinstyle()

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

get_linestyle()

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

get_linewidth()

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

get_ls()

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

get_lw()

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

get_patch_transform()

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

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

get_path()

Возвращает путь этой фигуры

get_transform()

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

get_verts()

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

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

get_window_extent(renderer=None)

set_aa(aa)

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

set_alpha(alpha)

Устанавливает прозрачность фигуры альфой.

ПРИНИМАЕТ: число с плавающей точкой или None

set_antialiased(aa)

Устанавливает, использовать ли антиалиасирование

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

set_capstyle(s)

Устанавливает стиль обрезки фигуры

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

set_color(c)

Устанавливает цвет границы и заливки.

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

См. также

set_facecolor(), set_edgecolor()

Для установки цвета границы или заливки индивидуально.

set_ec(color)

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

set_edgecolor(color)

Устанавливает цвет границы фигуры

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

set_facecolor(color)

Устанавливает цвет заливки фигуры

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

set_fc(color)

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

set_fill(b)

Устанавливает, заполнять ли фигуру

ПРИНИМАЕТ: [True | False]

set_hatch(hatch)

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

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

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

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

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

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

set_joinstyle(s)

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

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

set_linestyle(ls)

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

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

В качестве альтернативы можно указать кортеж штрихов, имеющий следующий вид:

(offset, onoffseq),

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

ПРИНИМАЕТ: [‘сплошная’ | ‘штриховая’, ‘пунктирная’, ‘точечная’ |

(смещение, последовательность штриха) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : { ‘-‘, ‘–’, ‘-.’, ‘:’} и более см. описание Стиль линии.

set_linewidth(w)

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

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

set_ls(ls)

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

set_lw(lw)

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

update_from(other)

Обновляет эту Patch из свойств other.

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

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

zorder = 1

class matplotlib.patches.PathPatch(path, **kwargs)

Bases: matplotlib.patches.Patch

Объект пути с поликривыми.

path — объект matplotlib.path.Path.

Допустимые значения kwargs:

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

См. также

Patch

Для дополнительных параметров kwargs

get_path()

class matplotlib.patches.Polygon(xy, closed=True, **kwargs)

Основы: matplotlib.patches.Patch

Общий полигональный элемент.

xy — массив NumPy с формой Nx2.

Если closed имеет значение True, многоугольник будет замкнутым, так что начальная и конечная точки будут совпадать.

Допустимые ключевые параметры:

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

См. также

Patch

Дополнительные ключевые параметры

get_closed()

Возвращает, замкнута ли фигура

Возвращает:	closed : bool Замкнута ли фигура

get_path()

Получить путь полигона

Возвращает:	path : Path Объект Path для полигона

get_xy()

Получить вершины пути

Возвращает:	vertices : массив NumPy Координаты вершин в виде массива Nx2.

set_closed(closed)

Установить, замкнута ли фигура

Параметры:	closed : bool True, если многоугольник замкнут

set_xy(xy)

Установить вершины полигона

Параметры:	xy : массив NumPy или итерируемый объект пар Координаты вершин в виде массива Nx2 или итерируемого объекта пар.

xy

Устанавливает/получает вершины многоугольника. Это свойство предоставлено для обратной совместимости с matplotlib 0.91.x. Новый код должен использовать get_xy() и set_xy() вместо него.

class matplotlib.patches.Rectangle(xy, width, height, angle=0.0, **kwargs)

Bases: matplotlib.patches.Patch

Отрисовать прямоугольник с левым нижним углом в точке xy = (x, y) заданной шириной и высотой.

angle

угол поворота в градусах (против часовой стрелки)

fill — логическое значение, указывающее, нужно ли заполнить прямоугольник

Допустимые значения kwargs:

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

get_bbox()

get_height()

Возвращает высоту прямоугольника

get_patch_transform()

get_path()

Возвращает вершины прямоугольника

get_width()

Возвращает ширину прямоугольника

get_x()

Возвращает левую координату прямоугольника

get_xy()

Возвращает левую и нижнюю координаты прямоугольника

get_y()

Возвращает нижнюю координату прямоугольника

set_bounds(*args)

Устанавливает границы прямоугольника: l,b,w,h

ПРИНИМАЕТ: (левый край, нижний край, ширина, высота)

set_height(h)

Устанавливает ширину прямоугольника

ПРИНИМАЕТ: число с плавающей точкой

set_width(w)

Устанавливает ширину прямоугольника

ПРИНИМАЕТ: число с плавающей точкой

set_x(x)

Устанавливает левую координату прямоугольника

ПРИНИМАЕТ: число с плавающей точкой

set_xy(xy)

Устанавливает левую и нижнюю координаты прямоугольника

ПРИНИМАЕТ: последовательность из 2 элементов

set_y(y)

Устанавливает нижнюю координату прямоугольника

ПРИНИМАЕТ: число с плавающей точкой

xy

Возвращает левую и нижнюю координаты прямоугольника

class matplotlib.patches.RegularPolygon(xy, numVertices, radius=5, orientation=0, **kwargs)

Bases: matplotlib.patches.Patch

Полигон с правильными сторонами.

Аргументы конструктора:

xy

Кортеж длиной 2 (x, y) координат центра.

numVertices

Количество вершин.

radius

Расстояние от центра до каждой вершины.

orientation

Поворот полигона (в радианах).

Допустимые значения kwargs:

Свойство	Описание
agg_filter	неизвестно
alpha	float или None
animated	[True | False]
antialiased или aa	[True | False] или None по умолчанию
axes	экземпляр Axes
capstyle	[‘butt’ | ‘round’ | ‘projecting’]
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
color	спецификация цвета matplotlib
contains	вызываемая функция
edgecolor или ec	спецификация цвета mpl, или None по умолчанию, или ‘none’ для отсутствия цвета
facecolor или fc	спецификация цвета mpl, или None по умолчанию, или ‘none’ для отсутствия цвета
figure	экземпляр matplotlib.figure.Figure
fill	[True | False]
gid	строка id
hatch	[‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
joinstyle	[‘miter’ | ‘round’ | ‘bevel’]
label	строка или что-либо выводимое с преобразованием ‘%s’
linestyle или ls	[‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (offset, on-off-dash-seq) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	float или None по умолчанию
path_effects	неизвестно
picker	[None|float|boolean|вызываемая функция]
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка url
visible	[True | False]
zorder	любое число

get_patch_transform()

get_path()

numvertices

orientation

radius

xy

class matplotlib.patches.Shadow(patch, ox, oy, props=None, **kwargs)

Bases: matplotlib.patches.Patch

Создаёт тень заданного patch, смещённую на ox, oy. Если props не равно None, это словарь свойств обновления патча. Если None, тень будет иметь тот же цвет, что и лицевая сторона, но затемнённый.

kwargs —

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

draw(renderer)

get_patch_transform()

get_path()

class matplotlib.patches.Wedge(center, r, theta1, theta2, width=None, **kwargs)

Основы: matplotlib.patches.Patch

Заплатка в форме сектора.

Отрисовывает сектор, центрированный в точке x, y с радиусом r, охватывающий угол от theta1 до theta2 (в градусах). Если задан параметр width, то отрисовывается частичный сектор от внутреннего радиуса r - width до внешнего радиуса r.

Допустимые значения kwargs:

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

get_path()

set_center(center)

set_radius(radius)

set_theta1(theta1)

set_theta2(theta2)

set_width(width)

class matplotlib.patches.YAArrow(figure, xytip, xybase, width=4, frac=0.1, headwidth=12, **kwargs)

Bases: matplotlib.patches.Patch

Ещё один класс стрелки.

Это стрелка, которая определена в пространстве отображения и имеет наконечник в точке x1, y1 и основание в точке x2, y2.

Аргументы конструктора:

xytip

(x, y) положение наконечника стрелки

xybase

(x, y) положение средней точки основания стрелки

figure

Экземпляр Figure (fig.dpi)

width

Ширина стрелки в пунктах

frac

Доля длины стрелки, занимаемая наконечником

headwidth

Ширина основания наконечника стрелки в пунктах

Допустимые значения kwargs:

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

get_patch_transform()

get_path()

getpoints(x1, y1, x2, y2, k)

Для отрезка прямой, заданного (x1, y1) и (x2, y2), вернуть точки на прямой, перпендикулярной этому отрезку и пересекающей точку (x2, y2), и расстояние от точки (x2, y2) до возвращаемых точек равно k.

matplotlib.patches.bbox_artist(artist, renderer, props=None, fill=True)

Это функция отладки для рисования прямоугольника вокруг области, возвращенной get_window_extent() элемента, для проверки правильности возвращаемой области.

props — это словарь свойств прямоугольника с дополнительным свойством ‘pad’, которое задает отступ вокруг области в пунктах.

matplotlib.patches.draw_bbox(bbox, renderer, color='k', trans=None)

Это функция отладки для рисования прямоугольника вокруг области, возвращенной get_window_extent() элемента, для проверки правильности возвращаемой области.