matplotlib.patches.Arc

classmatplotlib.patches.Arc(xy, width, height, *, angle=0.0, theta1=0.0, theta2=360.0, **kwargs)[source]

Bases: Ellipse

Эллиптическая дуга, т.е. сегмент эллипса.

Из-за внутренних оптимизаций дугу нельзя заполнить.

Параметры:

xy(float, float)

Центр эллипса.

widthfloat

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

heightfloat

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

anglefloat

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

theta1, theta2float, по умолчанию: 0, 360

Углы начала и конца дуги в градусах. Эти значения относятся к angle, например, если angle = 45 и theta1 = 90, абсолютный начальный угол равен 135. По умолчанию theta1 = 0, theta2 = 360, т.е. полный эллипс. Дуга рисуется против часовой стрелки. Углы, большие или равные 360 или меньшие 0, представляются эквивалентным углом в диапазоне [0, 360), взяв входное значение по модулю 360.

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

**kwargsPatch свойства

Большинство свойств Patch поддерживаются в качестве ключевых аргументов, за исключением fill и facecolor, так как заполнение не поддерживается.

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

draw(renderer)[source]

Отрисовка дуги на заданном renderer.

Примечания

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

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

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

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

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

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

   Для этого используется алгоритм пересечения прямой и окружности из:

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

2. Вычисляются углы каждой из точек пересечения.
3. Двигаясь против часовой стрелки, начиная с положительного направления оси x, каждая из видимых дуговых сегментов между парами вершин отрисовывается с помощью техники аппроксимации дуги Безье, реализованной в Path.arc.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, angle=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, capstyle=<UNSET>, center=<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>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, width=<UNSET>, zorder=<UNSET>)[source]

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

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

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

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

Метка угла, инвариантная к масштабу

Метка угла, инвариантная к масштабу

Эллипс с единицами измерения

Эллипс с единицами измерения