matplotlib.projections.polar

classmatplotlib.projections.polar.InvertedPolarTransform(axis=None, use_rmin=True, *, apply_theta_transforms=True)[исходный код]

Базовые классы: Transform

Обратное преобразование полярных координат, переводящее декартовы координаты x и y обратно в theta и r.

Параметры:

axisAxis, необязательно

Ось, связанная с этим преобразованием. Используется для получения минимального предела радиальной оси.

use_rminbool, необязательно

Если True, после преобразования декартовых координат добавляется минимальный предел радиальной оси. Чтобы это сработало, также необходимо указать axis.

has_inverse=True

True, если для этого преобразования существует соответствующее обратное преобразование.

input_dims=2

Количество входных измерений этого преобразования. В подклассе это значение необходимо переопределить (целым числом).

inverted()[исходный код]

Возвращает соответствующее обратное преобразование.

Выполняется x == self.inverted().transform(self.transform(x)).

Возвращаемое значение этого метода следует считать временным. Изменение self не приводит к соответствующему обновлению его обратной копии.

output_dims=2

Количество выходных измерений этого преобразования. В подклассе это значение необходимо переопределить (целым числом).

transform_non_affine(values)[исходный код]

Применяет только неаффинную часть этого преобразования.

transform(values) всегда эквивалентно transform_affine(transform_non_affine(values)).

Для неаффинных преобразований это, как правило, эквивалентно transform(values). Для аффинных преобразований это всегда пустая операция.

Параметры:

valuesмассив

Входные значения в виде массива длины input_dims или формы (N, input_dims).

Возвращает:

массив

Выходные значения в виде массива длины output_dims или формы (N, output_dims) в зависимости от входных данных.

classmatplotlib.projections.polar.PolarAffine(scale_transform, limits)[исходный код]

Базовые классы: Affine2DBase

Аффинная часть полярной проекции.

Масштабирует выходные данные так, чтобы максимальный радиус совпадал с краем круга осей, а начало координат отображалось в точку (0.5, 0.5). К компонентам x и y применяется одинаковое преобразование, заданное формулой:

\[x_{1} = 0.5 \left [ \frac{x_{0}}{(r_{\max} - r_{\min})} + 1 \right ]\]

\(r_{\min}, r_{\max}\) — минимальный и максимальный радиальные пределы после удаления масштабирования (например, логарифмического).

Параметры:

scale_transformTransform

Преобразование масштабирования данных. Используется для удаления масштабирования из пределов радиального вида.

limitsBboxBase

Пределы отображения данных. Используются только пределы y — для пределов радиуса.

get_matrix()[исходный код]

Возвращает матрицу аффинной части этого преобразования.

classmatplotlib.projections.polar.PolarAxes(*args, theta_offset=0, theta_direction=1, rlabel_position=22.5, **kwargs)[исходный код]

Базовые классы: Axes

Проекция полярного графика, входными измерениями которой являются theta и r.

Отсчёт theta начинается на востоке и идёт против часовой стрелки.

Создаёт Axes в фигуре.

Параметры:

figFigure

Объект Axes создаётся в фигуре Figure fig.

*args

*args может быть одним прямоугольником (left, bottom, width, height) или одним объектом Bbox. Он задаёт прямоугольник (в координатах фигуры), в котором располагается Axes.

*args также может состоять из трёх чисел или одного трёхзначного числа; во втором случае цифры рассматриваются как отдельные числа. Числа интерпретируются как (nrows, ncols, index): (nrows, ncols) задаёт размер массива подграфиков, а index — индекс создаваемого подграфика, начинающийся с 1. Наконец, *args может напрямую представлять собой экземпляр SubplotSpec.

sharex, shareyAxes, необязательно

Ось x или y axis является общей с осью x или y входного объекта Axes. Обратите внимание, что отменить совместное использование осей нельзя.

frameonbool, по умолчанию: True

Определяет, видна ли рамка Axes.

box_aspectfloat, необязательно

Задаёт фиксированное соотношение сторон рамки Axes, то есть отношение высоты к ширине. Подробности см. в set_box_aspect.

forward_navigation_eventsbool или "auto", по умолчанию: "auto"

Определяет, передаются ли события панорамирования и масштабирования расположенным ниже объектам Axes. Значение "auto" равно True для осей с невидимой областью заливки и False в остальных случаях.

**kwargs

Другие необязательные именованные аргументы:

Свойство	Описание
adjustable	{'box', 'datalim'}
agg_filter	функция фильтра, которая принимает массив чисел с плавающей точкой формы (m, n, 3) и значение dpi, а возвращает массив формы (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	float или None
anchor	(float, float) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'equal'} или float
autoscale_on	bool
autoscalex_on	неизвестно
autoscaley_on	неизвестно
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	bool или 'line'
box_aspect	float или None
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
facecolor или fc	цвет
figure	Figure или SubFigure
forward_navigation_events	bool или "auto"
frame_on	bool
gid	str
in_layout	bool
label	object
mouseover	bool
navigate	bool
navigate_mode	неизвестно
path_effects	список AbstractPathEffect
picker	None, bool, float или вызываемый объект
position	[left, bottom, width, height] или Bbox
prop_cycle	Cycler
rasterization_zorder	float или None
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
subplotspec	неизвестно
title	str
transform	Transform
url	str
visible	bool
xbound	(lower: float, upper: float)
xlabel	str
xlim	(left: float, right: float)
xmargin	float больше -0.5
xscale	неизвестно
xticklabels	неизвестно
xticks	неизвестно
ybound	(lower: float, upper: float)
ylabel	str
ylim	(bottom: float, top: float)
ymargin	float больше -0.5
yscale	неизвестно
yticklabels	неизвестно
yticks	неизвестно
zorder	float

Возвращает:

Axes

Новый объект Axes.

classInvertedPolarTransform(axis=None, use_rmin=True, *, apply_theta_transforms=True)[исходный код]

Основания: Transform

Обратное преобразование полярных координат, отображающее декартову систему координат x и y обратно в theta и r.

Параметры:

axisAxis, необязательный

Ось, связанная с этим преобразованием. Используется для получения минимального радиального предела.

use_rminbool, необязательный

Если True, после преобразования из декартовых координат добавляется минимальный предел радиальной оси. Чтобы это сработало, также необходимо указать axis.

has_inverse=True

True, если для этого преобразования существует соответствующее обратное преобразование.

input_dims=2

Количество входных измерений этого преобразования. В подклассе это значение необходимо переопределить (целым числом).

inverted()[исходный код]

Возвращает соответствующее обратное преобразование.

Выполняется x == self.inverted().transform(self.transform(x)).

Возвращаемое этим методом значение следует считать временным. Изменение self не приводит к соответствующему обновлению его обратной копии.

output_dims=2

Количество выходных измерений этого преобразования. В подклассе это значение необходимо переопределить (целым числом).

transform_non_affine(values)[исходный код]

Применяет только неаффинную часть этого преобразования.

transform(values) всегда эквивалентно transform_affine(transform_non_affine(values)).

Для неаффинных преобразований это обычно эквивалентно transform(values). Для аффинных преобразований это всегда ничего не делает.

Параметры:

valuesмассив

Входные значения в виде массива длины input_dims или формы (N, input_dims).

Возвращает:

массив

Выходные значения в виде массива длины output_dims или формы (N, output_dims), в зависимости от входных данных.

classPolarAffine(scale_transform, limits)[исходный код]

Основания: Affine2DBase

Аффинная часть полярной проекции.

Масштабирует результат так, чтобы максимальный радиус совпадал с краем окружности области осей, а начало координат отображалось в (0.5, 0.5). Преобразование одинаково применяется к компонентам x и y и задаётся формулой:

\[x_{1} = 0.5 \left [ \frac{x_{0}}{(r_{\max} - r_{\min})} + 1 \right ]\]

\(r_{\min}, r_{\max}\) — минимальный и максимальный радиальные пределы после удаления любого масштабирования (например, логарифмического).

Параметры:

scale_transformTransform

Преобразование масштабирования данных. Используется для удаления масштабирования из пределов радиального отображения.

limitsBboxBase

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

get_matrix()[исходный код]

Возвращает матрицу аффинной части этого преобразования.

classPolarTransform(axis=None, use_rmin=True, *, apply_theta_transforms=True, scale_transform=None)[исходный код]

Базовые классы: Transform

Базовое полярное преобразование.

Это преобразование переводит полярные координаты \(\theta, r\) в декартовы координаты \(x, y = r \cos(\theta), r \sin(\theta)\) (но не выполняет полное преобразование в координаты Axes и не обрабатывает позиционирование в пространстве экрана).

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

Сегменты пути с постоянным радиусом автоматически преобразуются в дуги окружности, если path._interpolation_steps > 1.

Параметры:

axisAxis, необязательный

Ось, связанная с этим преобразованием. Используется для получения минимального радиального предела.

use_rminbool, необязательный

Если True, перед преобразованием в декартовы координаты вычесть минимальный предел радиальной оси. Чтобы это вступило в силу, также необходимо указать axis.

has_inverse=True

True, если для этого преобразования существует обратное преобразование.

input_dims=2

Количество входных измерений этого преобразования. В подклассе необходимо переопределить (целыми числами).

inverted()[исходный код]

Возвращает соответствующее обратное преобразование.

Выполняется x == self.inverted().transform(self.transform(x)).

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

output_dims=2

Количество выходных измерений этого преобразования. В подклассе необходимо переопределить (целыми числами).

transform_non_affine(values)[исходный код]

Применяет только неаффинную часть этого преобразования.

transform(values) всегда эквивалентно transform_affine(transform_non_affine(values)).

Для неаффинных преобразований это, как правило, эквивалентно transform(values). Для аффинных преобразований это всегда пустая операция.

Параметры:

valuesмассив

Входные значения в виде массива длины input_dims или формы (N, input_dims).

Возвращает:

массив

Выходные значения в виде массива длины output_dims или формы (N, output_dims), в зависимости от входных данных.

transform_path_non_affine(path)[исходный код]

Применяет неаффинную часть этого преобразования к Path path и возвращает новый объект Path.

transform_path(path) эквивалентно transform_path_affine(transform_path_non_affine(values)).

classRadialLocator(base, axes=None)[исходный код]

Базовые классы: Locator

Используется для определения положений радиальных делений.

Гарантирует, что все деления строго положительны. Для всех остальных задач делегирует работу базовому Locator (который может различаться в зависимости от масштаба оси r).

nonsingular(vmin, vmax)[исходный код]

При необходимости корректирует диапазон, чтобы избежать особенностей.

Этот метод вызывается при автоматическом масштабировании; (v0, v1) задается пределами данных на Axes, если Axes содержит какие-либо данные, или (-inf, +inf), если данных нет.

• Если v0 == v1 (возможно, с учетом некоторой погрешности вычислений с плавающей точкой), этот метод возвращает расширенный интервал вокруг этого значения.
• Если (v0, v1) == (-inf, +inf), этот метод возвращает подходящие пределы по умолчанию для области просмотра.
• В противном случае (v0, v1) возвращается без изменений.

set_axis(axis)[исходный код]

view_limits(vmin, vmax)[исходный код]

Выбирает масштаб диапазона от vmin до vmax.

Для изменения поведения локатора подклассам следует переопределить этот метод.

classThetaFormatter[исходный код]

Базовые классы: Formatter

Используется для форматирования подписей делений theta. Преобразует радианы — исходную единицу измерения — в градусы и добавляет символ градуса.

classThetaLocator(base)[исходный код]

Базовые классы: Locator

Используется для определения положений делений theta.

Работает так же, как базовый локатор, за исключением случая, когда область просмотра охватывает всю окружность. В таких случаях возвращаются ранее использовавшиеся положения по умолчанию — через каждые 45 градусов.

set_axis(axis)[исходный код]

view_limits(vmin, vmax)[исходный код]

Выбирает масштаб диапазона от vmin до vmax.

Для изменения поведения локатора подклассам следует переопределить этот метод.

can_pan()[исходный код]

Возвращает, поддерживает ли этот Axes функции панорамирования/масштабирования с помощью кнопки.

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

can_zoom()[исходный код]

Возвращает, поддерживает ли этот Axes функцию масштабирования с помощью рамки.

Полярный Axes не поддерживает масштабирование с помощью рамки.

clear()[исходный код]

Очищает Axes.

drag_pan(button, key, x, y)[исходный код]

Вызывается при перемещении мыши во время панорамирования.

Параметры:

buttonMouseButton

Нажатая кнопка мыши.

keystr or None

Нажатая клавиша, если она есть.

x, yfloat

Координаты мыши в системе координат отображения.

Примечания

Предполагается, что этот метод будет переопределён в новых типах проекций.

draw(renderer)[исходный код]

Отрисовать Artist (и его дочерние элементы) с помощью заданного средства визуализации.

Метод ничего не делает, если объект Artist невидим (Artist.get_visible возвращает False).

Параметры:

rendererподкласс RendererBase.

Примечания

Этот метод переопределяется в подклассах Artist.

end_pan()[исходный код]

Вызывается по завершении панорамирования (когда кнопка мыши отпущена).

Примечания

Предполагается, что этот метод будет переопределён в новых типах проекций.

format_coord(theta, r)[исходный код]

Возвращает строку форматирования координат x, y.

get_data_ratio()[исходный код]

Возвращает соотношение сторон самих данных. Для полярного графика оно всегда должно быть равно 1.0

get_rlabel_position()[исходный код]

Возвращает:

float

Положение меток радиуса по углу theta в градусах.

get_rmax()[исходный код]

Возвращает:

float

Внешняя радиальная граница.

get_rmin()[исходный код]

Возвращает:

float

Внутренняя радиальная граница.

get_rorigin()[исходный код]

Возвращает:

float

get_rsign()[исходный код]

get_theta_direction()[исходный код]

Получить направление возрастания theta.

-1:

Theta возрастает по часовой стрелке

1:

Theta возрастает против часовой стрелки

get_theta_offset()[исходный код]

Получить смещение положения нуля в радианах.

get_thetamax()[исходный код]

Возвращает максимальную границу theta в градусах.

get_thetamin()[исходный код]

Получить минимальную границу theta в градусах.

get_xaxis_text1_transform(pad)[исходный код]

Возвращает:

transformTransform

Преобразование для отрисовки меток оси x, которое добавляет отступ pad_points (в пунктах) между осью и меткой. Направление x задано в координатах данных, а направление y — в координатах оси.

valign{'center', 'top', 'bottom', 'baseline', 'center_baseline'}

Вертикальное выравнивание текста.

halign{'center', 'left', 'right'}

Горизонтальное выравнивание текста.

Примечания

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

get_xaxis_text2_transform(pad)[исходный код]

Возвращает:

transformTransform

Преобразование для отрисовки меток вторичной оси x, которое добавляет отступ pad_points (в пунктах) между осью и меткой. Направление x задано в координатах данных, а направление y — в координатах оси.

valign{'center', 'top', 'bottom', 'baseline', 'center_baseline'}

Вертикальное выравнивание текста.

halign{'center', 'left', 'right'}

Горизонтальное выравнивание текста.

Примечания

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

get_xaxis_transform(which='grid')[исходный код]

Получить преобразование, используемое для отрисовки меток, делений и линий сетки оси x. Направление x задано в координатах данных, а направление y — в координатах оси.

Примечание

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

Параметры:

which{'grid', 'tick1', 'tick2'}

get_yaxis_text1_transform(pad)[исходный код]

Возвращает:

transformTransform

Преобразование для отрисовки меток оси y, которое добавляет отступ pad_points (в пунктах) между осью и меткой. Направление x задано в координатах оси, а направление y — в координатах данных.

valign{'center', 'top', 'bottom', 'baseline', 'center_baseline'}

Вертикальное выравнивание текста.

halign{'center', 'left', 'right'}

Горизонтальное выравнивание текста.

Примечания

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

get_yaxis_text2_transform(pad)[исходный код]

Возвращает:

transformTransform

Преобразование, используемое для отображения подписей второй оси y; оно добавляет отступ pad_points (в пунктах) между осью и подписью. Направление x задано в координатах оси, а направление y — в координатах данных

valign{'center', 'top', 'bottom', 'baseline', 'center_baseline'}

Вертикальное выравнивание текста.

halign{'center', 'left', 'right'}

Горизонтальное выравнивание текста.

Примечания

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

get_yaxis_transform(which='grid')[исходный код]

Получить преобразование, используемое для отображения подписей оси y, делений и линий сетки. Направление x задано в координатах оси, а направление y — в координатах данных.

Примечание

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

Параметры:

which{'grid', 'tick1', 'tick2'}

name='polar'

set(*, adjustable=<UNSET>, agg_filter=<UNSET>, alpha=<UNSET>, anchor=<UNSET>, animated=<UNSET>, aspect=<UNSET>, autoscale_on=<UNSET>, autoscalex_on=<UNSET>, autoscaley_on=<UNSET>, axes_locator=<UNSET>, axisbelow=<UNSET>, box_aspect=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, facecolor=<UNSET>, forward_navigation_events=<UNSET>, frame_on=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, navigate=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, position=<UNSET>, prop_cycle=<UNSET>, rasterization_zorder=<UNSET>, rasterized=<UNSET>, rgrids=<UNSET>, rlabel_position=<UNSET>, rlim=<UNSET>, rmax=<UNSET>, rmin=<UNSET>, rorigin=<UNSET>, rscale=<UNSET>, rticks=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, subplotspec=<UNSET>, theta_direction=<UNSET>, theta_offset=<UNSET>, theta_zero_location=<UNSET>, thetagrids=<UNSET>, thetalim=<UNSET>, thetamax=<UNSET>, thetamin=<UNSET>, title=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, xbound=<UNSET>, xlabel=<UNSET>, xlim=<UNSET>, xmargin=<UNSET>, xscale=<UNSET>, xticklabels=<UNSET>, xticks=<UNSET>, ybound=<UNSET>, ylabel=<UNSET>, ylim=<UNSET>, ymargin=<UNSET>, yscale=<UNSET>, yticklabels=<UNSET>, yticks=<UNSET>, zorder=<UNSET>)[исходный код]

Задайте несколько свойств одновременно.

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

Свойство	Описание
adjustable	{'box', 'datalim'}
agg_filter	функция фильтрации, принимающая массив вещественных чисел размером (m, n, 3) и значение dpi и возвращающая массив размером (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	float or None
anchor	(float, float) or {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'equal'} or float
autoscale_on	bool
autoscalex_on	unknown
autoscaley_on	unknown
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	bool or 'line'
box_aspect	float or None
clip_box	BboxBase or None
clip_on	bool
clip_path	Patch or (Path, Transform) or None
facecolor or fc	цвет
figure	Figure or SubFigure
forward_navigation_events	bool or "auto"
frame_on	bool
gid	str
in_layout	bool
label	object
mouseover	bool
navigate	bool
navigate_mode	unknown
path_effects	list of AbstractPathEffect
picker	None or bool or float or callable
position	[left, bottom, width, height] or Bbox
prop_cycle	Cycler
rasterization_zorder	float or None
rasterized	bool
rgrids	кортеж с числами с плавающей точкой
rlabel_position	число
rlim	unknown
rmax	float
rmin	float
rorigin	float
rscale	unknown
rticks	unknown
sketch_params	(scale: float, length: float, randomness: float)
snap	bool or None
subplotspec	unknown
theta_direction	unknown
theta_offset	unknown
theta_zero_location	str
thetagrids	кортеж с числами с плавающей точкой, градусы
thetalim	unknown
thetamax	unknown
thetamin	unknown
title	str
transform	Transform
url	str
visible	bool
xbound	(lower: float, upper: float)
xlabel	str
xlim	(left: float, right: float)

xmargin	число с плавающей точкой больше -0.5
xscale	неизвестно
xticklabels	неизвестно
xticks	неизвестно
ybound	(lower: float, upper: float)
ylabel	str
ylim	(bottom: float, top: float)
ymargin	число с плавающей точкой больше -0.5
yscale	неизвестно
yticklabels	неизвестно
yticks	неизвестно
zorder	число с плавающей точкой

set_rgrids(radii, labels=None, angle=None, fmt=None, **kwargs)[исходный код]

Задать радиальные линии сетки на полярном графике.

Параметры:

radiiкортеж чисел с плавающей точкой

Радиусы радиальных линий сетки

labelsкортеж строк или None

Подписи для каждой радиальной линии сетки. Если значение равно None, будет использоваться matplotlib.ticker.ScalarFormatter.

angleчисло с плавающей точкой

Угловое положение подписей радиусов в градусах.

fmtстрока или None

Строка формата, используемая в matplotlib.ticker.FormatStrFormatter. Например, '%f'.

Возвращает:

linesсписок объектов lines.Line2D

Радиальные линии сетки.

labelsсписок объектов text.Text

Подписи делений.

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

**kwargs

kwargs — необязательные свойства объектов Text для подписей.

Предупреждение

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

По возможности используйте вместо этого set_tick_params.

См. также

PolarAxes.set_thetagrids

Axis.get_gridlines

Axis.get_ticklabels

set_rlabel_position(value)[исходный код]

Обновить угловое положение подписей радиусов.

Параметры:

valueчисло

Угловое положение подписей радиусов в градусах.

set_rlim(bottom=None, top=None, *, emit=True, auto=False, **kwargs)[исходный код]

Задать пределы отображения радиальной оси.

Эта функция работает так же, как Axes.set_ylim, но дополнительно поддерживает rmin и rmax в качестве псевдонимов для bottom и top.

См. также

Axes.set_ylim

set_rmax(rmax)[исходный код]

Задать внешний радиальный предел.

Параметры:

rmaxчисло с плавающей точкой

set_rmin(rmin)[исходный код]

Задать внутренний радиальный предел.

Параметры:

rminчисло с плавающей точкой

set_rorigin(rorigin)[исходный код]

Обновить радиальное начало отсчёта.

Параметры:

roriginчисло с плавающей точкой

set_rscale(*args, **kwargs)[исходный код]

set_rticks(*args, **kwargs)[исходный код]

set_theta_direction(direction)[исходный код]

Задать направление возрастания theta.

по часовой стрелке, -1:

Theta увеличивается по часовой стрелке

против часовой стрелки, 1:

Theta увеличивается против часовой стрелки

set_theta_offset(offset)[исходный код]

Задать смещение положения точки 0 в радианах.

set_theta_zero_location(loc, offset=0.0)[исходный код]

Задать положение нуля угла тета.

Этот метод просто вызывает set_theta_offset с соответствующим значением в радианах.

Параметры:

locстрока

Может принимать одно из значений: "N", "NW", "W", "SW", "S", "SE", "E" или "NE".

offsetчисло с плавающей точкой, по умолчанию: 0

Смещение в градусах относительно указанного значения loc. Примечание: это смещение всегда применяется против часовой стрелки независимо от заданного направления.

set_thetagrids(angles, labels=None, fmt=None, **kwargs)[исходный код]

Задать линии сетки тета на полярном графике.

Параметры:

anglesкортеж чисел с плавающей точкой, градусы

Углы линий сетки тета.

labelsкортеж строк или None

Метки для каждой линии сетки тета. Если указано None, будет использован projections.polar.ThetaFormatter.

fmtстрока или None

Строка форматирования, используемая в matplotlib.ticker.FormatStrFormatter. Например, '%f'. Обратите внимание, что используемый угол задаётся в радианах.

Возвращает:

linesсписок объектов lines.Line2D

Линии сетки тета.

labelsсписок объектов text.Text

Подписи делений.

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

**kwargs

kwargs — необязательные свойства объектов Text для подписей.

Предупреждение

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

По возможности вместо этого используйте set_tick_params.

См. также

PolarAxes.set_rgrids

Axis.get_gridlines

Axis.get_ticklabels

set_thetalim(*args, **kwargs)[исходный код]

Задать минимальное и максимальное значения тета.

Можно использовать следующие сигнатуры:

• set_thetalim(minval, maxval): задать пределы в радианах.
• set_thetalim(thetamin=minval, thetamax=maxval): задать пределы в градусах.

где minval и maxval — минимальный и максимальный пределы. Значения приводятся к диапазону \([0, 2\pi]\) (в радианах), поэтому, например, можно использовать set_thetalim(-np.pi / 2, np.pi / 2), чтобы получить ось, симметричную относительно 0. Если абсолютная разность углов превышает полный круг, возникает ValueError.

set_thetamax(thetamax)[исходный код]

Задать максимальный предел тета в градусах.

set_thetamin(thetamin)[исходный код]

Задать минимальный предел тета в градусах.

set_yscale(*args, **kwargs)[исходный код]

Задать масштаб оси y.

Параметры:

valueстрока или ScaleBase

Тип масштаба оси. Допустимые строковые значения — имена классов масштабов ("linear", "log", "function",...). Это могут быть имена любых встроенных масштабов или пользовательских масштабов, зарегистрированных с помощью matplotlib.scale.register_scale.

**kwargs

Если value — строка, ключевые слова передаются методу создания соответствующего класса.

start_pan(x, y, button)[исходный код]

Вызывается при начале панорамирования.

Параметры:

x, yчисло с плавающей точкой

Координаты указателя мыши в координатах отображения.

buttonMouseButton

Нажатая кнопка мыши.

Примечания

Этот метод предназначен для переопределения в новых типах проекций.

classmatplotlib.projections.polar.PolarTransform(axis=None, use_rmin=True, *, apply_theta_transforms=True, scale_transform=None)[исходный код]

Базовые классы: Transform

Базовое преобразование полярных координат.

Это преобразование переводит полярные координаты \(\theta, r\) в декартовы координаты \(x, y = r \cos(\theta), r \sin(\theta)\) (но не выполняет полное преобразование в координаты Axes и не обрабатывает позиционирование в экранном пространстве).

Это преобразование предназначено для применения к данным после масштабирования вдоль радиальной оси (например, логарифмического масштабирования) входных данных.

Сегменты пути с постоянным радиусом автоматически преобразуются в дуги окружности, если path._interpolation_steps > 1.

Параметры:

axisAxis, необязательный

Ось, связанная с этим преобразованием. Используется для получения минимального радиального предела.

use_rminbool, необязательный

Если True, перед преобразованием в декартовы координаты вычесть минимальный предел радиальной оси. Чтобы это сработало, также необходимо указать axis.

has_inverse=True

True, если для этого преобразования существует обратное преобразование.

input_dims=2

Число входных измерений этого преобразования. В подклассе необходимо переопределить это значение (целым числом).

inverted()[исходный код]

Возвращает соответствующее обратное преобразование.

Выполняется условие x == self.inverted().transform(self.transform(x)).

Возвращаемое этим методом значение следует считать временным. Изменение self не приводит к соответствующему обновлению его обратной копии.

output_dims=2

Число выходных измерений этого преобразования. В подклассе необходимо переопределить это значение (целым числом).

transform_non_affine(values)[исходный код]

Применяет только неаффинную часть этого преобразования.

transform(values) всегда эквивалентно transform_affine(transform_non_affine(values)).

Для неаффинных преобразований это, как правило, эквивалентно transform(values). Для аффинных преобразований это всегда пустая операция.

Параметры:

valuesмассив

Входные значения в виде массива длины input_dims или формы (N, input_dims).

Возвращает:

массив

Выходные значения в виде массива длины output_dims или формы (N, output_dims) в зависимости от входных данных.

transform_path_non_affine(path)[исходный код]

Применяет неаффинную часть этого преобразования к Path path и возвращает новый Path.

transform_path(path) эквивалентно transform_path_affine(transform_path_non_affine(values)).

classmatplotlib.projections.polar.RadialAxis(*args, **kwargs)[исходный код]

Базовые классы: YAxis

Радиальная ось.

Этот класс переопределяет некоторые свойства YAxis, чтобы обеспечить особую обработку радиальной оси.

Параметры:

axesAxes

Axes, к которому относится созданная ось.

pickradiusчисло с плавающей точкой

Радиус допуска для проверки принадлежности. См. также Axis.contains.

clearлогическое значение, по умолчанию: True

Следует ли очищать ось при создании. Это не требуется, например, при создании оси как части Axes, поскольку Axes.clear вызовет Axis.clear. .. versionadded:: 3.8

axis_name='radius'

Имя оси, доступное только для чтения.

clear()[исходный код]

Очищает ось.

Сбрасывает свойства оси к значениям по умолчанию:

• метка
• масштаб
• локаторы, форматтеры и деления
• основная и вспомогательная сетка
• единицы измерения
• зарегистрированные обратные вызовы

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, converter=<UNSET>, data_interval=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, inverted=<UNSET>, label=<UNSET>, label_coords=<UNSET>, label_position=<UNSET>, label_text=<UNSET>, major_formatter=<UNSET>, major_locator=<UNSET>, minor_formatter=<UNSET>, minor_locator=<UNSET>, mouseover=<UNSET>, offset_position=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, remove_overlapping_locs=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, tick_params=<UNSET>, ticklabels=<UNSET>, ticks=<UNSET>, ticks_position=<UNSET>, transform=<UNSET>, units=<UNSET>, url=<UNSET>, view_interval=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[исходный код]

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

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

Свойство	Описание
agg_filter	функция фильтра, принимающая массив чисел с плавающей точкой формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения относительно левого нижнего угла изображения
alpha	float или None
animated	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
converter	ConversionInterface
data_interval	неизвестно
figure	Figure или SubFigure
gid	str
in_layout	bool
inverted	неизвестно
label	неизвестно
label_coords	неизвестно
label_position	{'left', 'right'}
label_text	str
major_formatter	Formatter, str или функция
major_locator	Locator
minor_formatter	Formatter, str или функция
minor_locator	Locator
mouseover	bool
offset_position	{'left', 'right'}
path_effects	список объектов AbstractPathEffect
picker	None, bool, float или вызываемый объект
pickradius	float
rasterized	bool
remove_overlapping_locs	неизвестно
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
tick_params	неизвестно
ticklabels	последовательность строк или объектов Text
ticks	подобный массиву объект размерности 1
ticks_position	{'left', 'right', 'both', 'default', 'none'}
transform	Transform
units	тег единиц измерения
url	str
view_interval	неизвестно
visible	bool
zorder	float

classmatplotlib.projections.polar.RadialLocator(base, axes=None)[исходный код]

Базовые классы: Locator

Используется для определения положения делений радиальной оси.

Гарантирует, что все деления строго положительны. Для всех остальных задач делегирует их базовому классу Locator (который может различаться в зависимости от масштаба оси r).

nonsingular(vmin, vmax)[исходный код]

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

Этот метод вызывается при автоматическом масштабировании: (v0, v1) задаётся пределами данных на Axes, если Axes содержит какие-либо данные, или (-inf, +inf), если данных нет.

• Если v0 == v1 (возможно, с небольшой погрешностью округления с плавающей точкой), этот метод возвращает расширенный интервал вокруг этого значения.
• Если (v0, v1) == (-inf, +inf), этот метод возвращает подходящие пределы просмотра по умолчанию.
• В противном случае (v0, v1) возвращается без изменений.

set_axis(axis)[исходный код]

view_limits(vmin, vmax)[исходный код]

Выбирает масштаб диапазона от vmin до vmax.

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

classmatplotlib.projections.polar.RadialTick(*args, **kwargs)[исходный код]

Базовые классы: YTick

Деление радиальной оси.

Этот подкласс YTick слегка изменяет перемещение делений радиальной оси: их поворот зависит от пределов осей. В результате деления правильно расположены перпендикулярно осевой линии. Если включён режим автоматического поворота 'auto', подписи также поворачиваются перпендикулярно осевой линии.

bbox — ограничивающая рамка Bound2D в координатах отображения для Axes; loc — положение деления в координатах данных; size — размер деления в пунктах

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, pad=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[исходный код]

Задаёт несколько свойств одновременно.

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

Свойство	Описание
agg_filter	функция фильтра, принимающая массив float формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	float или None
animated	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform), или None
figure	Figure или SubFigure
gid	str
in_layout	bool
label	object
mouseover	bool
pad	float
path_effects	список AbstractPathEffect
picker	None, bool, float или вызываемый объект
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	str
visible	bool
zorder	float

update_position(loc)[исходный код]

Задаёт положение деления в координатах данных с помощью скалярного значения loc.

classmatplotlib.projections.polar.ThetaAxis(*args, **kwargs)[исходный код]

Базовые классы: XAxis

Ось theta.

Этот класс переопределяет некоторые свойства XAxis, чтобы обеспечить особую обработку угловой оси.

Параметры:

axesAxes

Axes, которому принадлежит созданная ось.

pickradiusfloat

Радиус допуска для проверок принадлежности. См. также Axis.contains.

clearbool, default: True

Следует ли очищать ось при создании. Это не требуется, например, при создании оси в составе Axes, поскольку Axes.clear вызовет Axis.clear. .. versionadded:: 3.8

axis_name='theta'

Имя оси, доступное только для чтения.

clear()[исходный код]

Очистить ось.

Сбрасывает свойства оси к значениям по умолчанию:

• метка
• масштаб
• локаторы, форматтеры и деления
• основная и вспомогательная сетка
• единицы измерения
• зарегистрированные обратные вызовы

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, converter=<UNSET>, data_interval=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, inverted=<UNSET>, label=<UNSET>, label_coords=<UNSET>, label_position=<UNSET>, label_text=<UNSET>, major_formatter=<UNSET>, major_locator=<UNSET>, minor_formatter=<UNSET>, minor_locator=<UNSET>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, remove_overlapping_locs=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, tick_params=<UNSET>, ticklabels=<UNSET>, ticks=<UNSET>, ticks_position=<UNSET>, transform=<UNSET>, units=<UNSET>, url=<UNSET>, view_interval=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[исходный код]

Задать несколько свойств одновременно.

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

Свойство	Описание
agg_filter	функция фильтрации, принимающая массив вещественных чисел формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения от левого нижнего угла изображения
alpha	float или None
animated	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
converter	ConversionInterface
data_interval	неизвестно
figure	Figure или SubFigure
gid	str
in_layout	bool
inverted	неизвестно
label	неизвестно
label_coords	неизвестно
label_position	{'top', 'bottom'}
label_text	str
major_formatter	Formatter, str или функция
major_locator	Locator
minor_formatter	Formatter, str или функция
minor_locator	Locator
mouseover	bool
path_effects	список объектов AbstractPathEffect
picker	None, bool, float или вызываемый объект
pickradius	float
rasterized	bool
remove_overlapping_locs	неизвестно
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
tick_params	неизвестно
ticklabels	последовательность строк или объектов Text
ticks	подобный массиву объект размерности 1
ticks_position	{'top', 'bottom', 'both', 'default', 'none'}
transform	Transform
units	тег единиц измерения
url	str
view_interval	неизвестно
visible	bool
zorder	float

classmatplotlib.projections.polar.ThetaFormatter[исходный код]

Базовые классы: Formatter

Используется для форматирования подписей делений theta. Преобразует исходную единицу измерения — радианы — в градусы и добавляет символ градуса.

classmatplotlib.projections.polar.ThetaLocator(base)[исходный код]

Базовые классы: Locator

Используется для определения положения делений по углу тета.

Работает так же, как базовый локатор, за исключением случая, когда область просмотра охватывает всю окружность. В таких случаях возвращаются ранее использовавшиеся положения по умолчанию — через каждые 45 градусов.

set_axis(axis)[исходный код]

view_limits(vmin, vmax)[исходный код]

Выбирает масштаб для диапазона от vmin до vmax.

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

classmatplotlib.projections.polar.ThetaTick(axes, *args, **kwargs)[исходный код]

Базовые классы: XTick

Деление оси тета.

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

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

bbox — ограничивающая рамка Bound2D в координатах отображения для Axes; loc — положение деления в координатах данных; size — размер деления в пунктах

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, pad=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[исходный код]

Задаёт несколько свойств одновременно.

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

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив чисел с плавающей точкой формы (m, n, 3) и значение dpi, а возвращает массив формы (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	float или None
animated	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
figure	Figure или SubFigure
gid	str
in_layout	bool
label	object
mouseover	bool
pad	float
path_effects	список объектов AbstractPathEffect
picker	None, bool, float или вызываемый объект
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	str
visible	bool
zorder	float

update_position(loc)[исходный код]

Задаёт положение деления в координатах данных с помощью скалярного значения loc.