matplotlib.patches.Rectangle

classmatplotlib.patches.Rectangle(xy, width, height, angle=0.0, **kwargs)[source]

Bases: matplotlib.patches.Patch

Прямоугольник, определённый точкой привязки xy и его шириной и высотой.

Прямоугольник простирается от xy[0] до xy[0] + width по оси x и от xy[1] до xy[1] + height по оси y.

:                +------------------+
:                |                  |
:              height               |
:                |                  |
:               (xy)---- width -----+

Можно представить xy как левую нижнюю точку, но какая это точка в действительности зависит от направления оси и знаков ширины и высоты; например, xy будет правой нижней точкой, если ось x была инвертирована или если ширина была отрицательной.

Параметры

xy(float, float)

Точка привязки.

widthfloat

Ширина прямоугольника.

heightfloat

Высота прямоугольника.

anglefloat, по умолчанию: 0

Угол поворота против часовой стрелки вокруг xy в градусах.

Другие параметры

**kwargsPatch свойства

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

get_angle()[source]

Получить угол поворота в градусах.

get_bbox()[source]

Возвращает Bbox.

get_height()[source]

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

get_patch_transform()[source]

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

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

get_path()[source]

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

get_width()[source]

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

get_x()[source]

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

get_xy()[source]

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

get_y()[source]

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

set(*, agg_filter=<UNSET>, alpha=<UNSET>, angle=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, bounds=<UNSET>, capstyle=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, fill=<UNSET>, gid=<UNSET>, hatch=<UNSET>, height=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, width=<UNSET>, x=<UNSET>, xy=<UNSET>, y=<UNSET>, zorder=<UNSET>)[source]

Установить несколько свойств сразу.

Поддерживаемые свойства:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha	скаляр или None
angle	неизвестно
animated	bool
antialiased или aa	bool или None
bounds	(левый, нижний, ширина, высота)
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clip_box	Bbox
clip_on	bool
clip_path	Объект Patch или (Path, Transform) или None
color	цвет
edgecolor или ec	цвет или None
facecolor или fc	цвет или None
figure	Figure
fill	bool
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
height	неизвестно
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
linewidth или lw	вещественное число или None
path_effects	AbstractPathEffect
picker	None или bool или вещественное число или вызываемый объект
rasterized	bool
sketch_params	(масштаб: вещественное число, длина: вещественное число, случайность: вещественное число)
snap	bool или None
transform	Transform
url	строка
visible	bool
width	неизвестно
x	неизвестно
xy	(вещественное число, вещественное число)
y	неизвестно
zorder	вещественное число

set_angle(angle)[source]

Установить угол поворота в градусах.

Поворот выполняется против часовой стрелки вокруг xy.

set_bounds(*args)[source]

Установить границы прямоугольника как левый, нижний, ширина, высота.

Значения можно передать как отдельные параметры или как кортеж:

set_bounds(left, bottom, width, height)
set_bounds((left, bottom, width, height))

set_height(h)[source]

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

set_width(w)[source]

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

set_x(x)[source]

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

set_xy(xy)[source]

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

Параметры

xy(float, float)

set_y(y)[source]

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

propertyxy

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

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