matplotlib.projections.polar

classmatplotlib.projections.polar.InvertedPolarTransform(axis=None, use_rmin=True, _apply_theta_transforms=True)[source]

Bases: Transform

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

Parameters:

axisAxis, optional

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

use_rminbool, optional

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

has_inverse=True

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

input_dims=2

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

inverted()[source]

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

Содержит x == self.inverted().transform(self.transform(x)).

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

output_dims=2

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

transform_non_affine(values)[source]

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

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

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

Parameters:

valuesarray

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

Returns:

array

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

classmatplotlib.projections.polar.PolarAffine(scale_transform, limits)[source]

Bases: 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}\) — минимальный и максимальный радиальные пределы после удаления любого масштабирования (например, логарифмического).

Parameters:

scale_transformTransform

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

limitsBboxBase

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

get_matrix()[source]

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

classmatplotlib.projections.polar.PolarAxes(*args, theta_offset=0, theta_direction=1, rlabel_position=22.5, **kwargs)[source]

Bases: Axes

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

Угол θ направлен на восток и изменяется против часовой стрелки.

Создание области построения графиков в фигуре.

Parameters:

figFigure

Область построения графиков создается в Figure fig.

*args

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

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

sharex, shareyAxes, optional

Ось x или y делится с осью x или y в входной Axes.

frameonbool, default: True

Отображать ли рамку области построения графиков.

box_aspectfloat, optional

Установить фиксированное соотношение сторон для области построения графиков, т. е. отношение высоты к ширине. Подробнее см. set_box_aspect.

**kwargs

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

Свойство	Описание
adjustable	{'box', 'datalim'}
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или 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
frame_on	bool
gid	str
in_layout	bool
label	объект
mouseover	bool
navigate	bool
navigate_mode	неизвестно
path_effects	список AbstractPathEffect
picker	None или bool или float или вызываемый объект
position	[слева, снизу, ширина, высота] или Bbox
prop_cycle	Cycler
rasterization_zorder	float или None
rasterized	bool
sketch_params	(масштаб: float, длина: float, случайность: float)
snap	bool или None
subplotspec	неизвестно
title	str
transform	Transform
url	str
visible	bool
xbound	(нижняя граница: float, верхняя граница: float)
xlabel	str
xlim	(левый край: float, правый край: float)
xmargin	float больше -0,5
xscale	неизвестно

xticklabels	неизвестно
xticks	неизвестно
ybound	(нижняя граница: float, верхняя граница: float)
ylabel	строка
ylim	(нижняя граница: float, верхняя граница: float)
ymargin	число, большее -0,5
yscale	неизвестно
yticklabels	неизвестно
yticks	неизвестно
zorder	число с плавающей точкой

Возвращаемое значение:

Axes

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

классInvertedPolarTransform(axis=None, use_rmin=True, _apply_theta_transforms=True)[source]

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

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

Параметры:

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

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

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

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

has_inverse=True

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

input_dims=2

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

inverted()[source]

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

Он содержит x == self.inverted().transform(self.transform(x)).

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

output_dims=2

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

transform_non_affine(values)[source]

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

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

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

Параметры:

valuesмассив

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

Возвращаемое значение:

массив

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

классPolarAffine(scale_transform, limits)[source]

Базовый класс: 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()[source]

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

classPolarTransform(axis=None, use_rmin=True, _apply_theta_transforms=True, *, scale_transform=None)[source]

Bases: Transform

Базовая полярная трансформация.

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

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

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

Параметры:

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

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

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

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

has_inverse=True

True, если для этой трансформации существует соответствующая обратная трансформация.

input_dims=2

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

inverted()[source]

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

Она x == self.inverted().transform(self.transform(x)).

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

output_dims=2

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

transform_non_affine(values)[source]

Применить только неаффинную часть этой трансформации.

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)[source]

Применить неаффинные части этой трансформации к Path path, вернув новый Path.

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

classRadialLocator(base, axes=None)[source]

Bases: Locator

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

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

nonsingular(vmin, vmax)[source]

Настройка диапазона для предотвращения особенностей.

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

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

set_axis(axis)[source]

view_limits(vmin, vmax)[source]

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

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

classThetaFormatter[source]

Bases: Formatter

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

classThetaLocator(base)[source]

Bases: Locator

Используется для определения отметки по оси θ.

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

set_axis(axis)[source]

view_limits(vmin, vmax)[source]

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

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

can_pan()[source]

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

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

can_zoom()[source]

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

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

clear()[source]

Очистить Axes.

drag_pan(button, key, x, y)[source]

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

Parameters:

buttonMouseButton

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

keystr or None

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

x, yfloat

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

Примечания

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

draw(renderer)[source]

Отрисовать объект Artist (и его потомков) с помощью заданного рендерера.

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

Parameters:

rendererRendererBase подкласс.

Примечания

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

end_pan()[source]

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

Примечания

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

format_coord(theta, r)[source]

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

get_data_ratio()[source]

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

get_rlabel_position()[source]

Returns:

float

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

get_rmax()[source]

Returns:

float

Внешний радиальный предел.

get_rmin()[source]

Returns:

float

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

get_rorigin()[source]

Returns:

float

get_rsign()[source]

get_theta_direction()[source]

Получить направление, в котором увеличивается θ.

-1:

Угол θ увеличивается по часовой стрелке

1:

Угол θ увеличивается против часовой стрелки

get_theta_offset()[source]

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

get_thetamax()[source]

Возвращает максимальное предельное значение угла θ в градусах.

get_thetamin()[source]

Получить минимальное предельное значение угла θ в градусах.

get_xaxis_text1_transform(pad)[source]

Возвращает:

transformTransform

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

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

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

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

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

Примечания

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

get_xaxis_text2_transform(pad)[source]

Возвращает:

transformTransform

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

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

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

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

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

Примечания

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

get_xaxis_transform(which='grid')[source]

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

Примечание

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

Параметры:

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

get_yaxis_text1_transform(pad)[source]

Возвращает:

transformTransform

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

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

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

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

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

Примечания

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

get_yaxis_text2_transform(pad)[source]

Возвращает:

transformTransform

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

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

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

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

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

Примечания

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

get_yaxis_transform(which='grid')[source]

Получить преобразование, используемое для рисования меток, делений и линий сетки оси 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>, 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>)[source]

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

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

Свойство	Описание
adjustable	{'box', 'datalim'}
agg_filter	функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
anchor	(число с плавающей точкой, число с плавающей точкой) или {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	булево значение
aspect	{'auto', 'equal'} или число с плавающей точкой
autoscale_on	булево значение
autoscalex_on	неизвестно
autoscaley_on	неизвестно
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	булево значение или 'line'
box_aspect	число с плавающей точкой или None
clip_box	BboxBase или None
clip_on	булево значение
clip_path	Объект Patch или (Path, Transform) или None
facecolor или fc	цвет
figure	Figure
frame_on	булево значение
gid	строка
in_layout	булево значение
label	объект
mouseover	булево значение
navigate	булево значение
navigate_mode	неизвестно
path_effects	список AbstractPathEffect
picker	None или булево значение или число с плавающей точкой или вызываемый объект
position	[left, bottom, width, height] или Bbox
prop_cycle	Cycler
rasterization_zorder	число с плавающей точкой или None
rasterized	булево значение
rgrids	кортеж с числами с плавающей точкой
rlabel_position	число
rlim	неизвестно
rmax	число с плавающей точкой
rmin	число с плавающей точкой
rorigin	число с плавающей точкой
rscale	неизвестно
rticks	неизвестно
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	булево значение или None
subplotspec	неизвестно
theta_direction	неизвестно
theta_offset	неизвестно

theta_zero_location	строка
thetagrids	кортеж с плавающими числами, градусы
thetalim	неизвестно
thetamax	неизвестно
thetamin	неизвестно
title	строка
transform	Transform
url	строка
visible	логическое значение
xbound	(нижняя: число, верхняя: число)
xlabel	строка
xlim	(левый: число, правый: число)
xmargin	число больше -0,5
xscale	неизвестно
xticklabels	неизвестно
xticks	неизвестно
ybound	(нижняя: число, верхняя: число)
ylabel	строка
ylim	(нижняя: число, верхняя: число)
ymargin	число больше -0,5
yscale	неизвестно
yticklabels	неизвестно
yticks	неизвестно
zorder	число с плавающей точкой

set_rgrids(radii, labels=None, angle=None, fmt=None, **kwargs)[source]

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

Parameters:

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

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

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

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

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

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

fmtстрока или None

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

Returns:

linesсписок lines.Line2D

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

labelsсписок text.Text

Метки делений.

Other Parameters:

**kwargs

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

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

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

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

См. также

PolarAxes.set_thetagrids

Axis.get_gridlines

Axis.get_ticklabels

set_rlabel_position(value)[source]

Обновление углового положения меток радиуса.

Parameters:

valueчисло

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

set_rlim(bottom=None, top=None, *, emit=True, auto=False, **kwargs)[source]

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

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

См. также

Axes.set_ylim

set_rmax(rmax)[source]

Установить внешний предел радиуса.

Параметры:

rmaxfloat

set_rmin(rmin)[source]

Установить внутренний предел радиуса.

Параметры:

rminfloat

set_rorigin(rorigin)[source]

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

Параметры:

roriginfloat

set_rscale(*args, **kwargs)[source]

set_rticks(*args, **kwargs)[source]

set_theta_direction(direction)[source]

Установить направление увеличения угла θ.

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

Угол θ увеличивается по часовой стрелке

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

Угол θ увеличивается против часовой стрелки

set_theta_offset(offset)[source]

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

set_theta_zero_location(loc, offset=0.0)[source]

Установить расположение нуля угла θ.

Просто вызывает set_theta_offset со значением в радианах.

Параметры:

locstr

Может быть одним из "N", "NW", "W", "SW", "S", "SE", "E" или "NE".

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

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

set_thetagrids(angles, labels=None, fmt=None, **kwargs)[source]

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

Параметры:

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)[source]

Устанавливает минимальное и максимальное значения угла.

Может принимать следующие подписи:

• 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)[source]

Устанавливает максимальное значение предела угла в градусах.

set_thetamin(thetamin)[source]

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

set_yscale(*args, **kwargs)[source]

Устанавливает масштаб оси y.

Параметры:

value{"linear", "log", "symlog", "logit", ...} или ScaleBase

Тип масштаба оси.

**kwargs

Принимаются различные ключевые аргументы, в зависимости от масштаба. См. соответствующие ключевые аргументы классов:

• matplotlib.scale.LinearScale
• matplotlib.scale.LogScale
• matplotlib.scale.SymmetricalLogScale
• matplotlib.scale.LogitScale
• matplotlib.scale.FuncScale

Примечания

По умолчанию Matplotlib поддерживает перечисленные выше масштабы. Кроме того, пользовательские масштабы могут быть зарегистрированы с помощью matplotlib.scale.register_scale. Эти масштабы также могут быть использованы здесь.

start_pan(x, y, button)[source]

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

Параметры:

x, yfloat

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

buttonMouseButton

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

Примечания

Это должно быть переопределено для новых типов проекций.

classmatplotlib.projections.polar.PolarTransform(axis=None, use_rmin=True, _apply_theta_transforms=True, *, scale_transform=None)[source]

Bases: Transform

Базовый полярный преобразователь.

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

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

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

Parameters:

axisAxis, optional

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

use_rminbool, optional

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

has_inverse=True

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

input_dims=2

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

inverted()[source]

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

Он содержит x == self.inverted().transform(self.transform(x)).

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

output_dims=2

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

transform_non_affine(values)[source]

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

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

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

Parameters:

valuesarray

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

Returns:

array

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

transform_path_non_affine(path)[source]

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

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

classmatplotlib.projections.polar.RadialAxis(*args, **kwargs)[source]

Bases: YAxis

Осевая ось.

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

Параметры:

axesAxes

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

pickradiusfloat

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

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

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

axis_name='radius'

Только для чтения имя, идентифицирующее ось.

clear()[source]

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

Это сбрасывает свойства оси до их значений по умолчанию:

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

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<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>)[source]

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

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

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
animated	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	объект Patch или (объект Path, Transform) или None
data_interval	неизвестно
figure	Figure
gid	str
in_layout	bool
inverted	неизвестно
label	объект
label_coords	неизвестно
label_position	{'left', 'right'}
label_text	строка
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	(масштаб: float, длина: float, случайность: float)
snap	bool или None
tick_params	неизвестно
ticklabels	неизвестно
ticks	одномерный массив-подобный объект
ticks_position	{'left', 'right', 'both', 'default', 'none'}
transform	Transform
units	метка единиц
url	строка
view_interval	неизвестно
visible	bool
zorder	float

classmatplotlib.projections.polar.RadialLocator(base, axes=None)[source]

Bases: Locator

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

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

nonsingular(vmin, vmax)[source]

Настройка диапазона для избежания особенностей.

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

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

set_axis(axis)[source]

view_limits(vmin, vmax)[source]

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

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

classmatplotlib.projections.polar.RadialTick(*args, **kwargs)[source]

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

Радиальная метка оси.

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

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>, label1=<UNSET>, label2=<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>)[source]

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

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

Свойство	Описание
agg_filter	функция фильтрации, которая принимает массив float (m, n, 3) и значение dpi и возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения
alpha	скаляр или None
animated	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
figure	Figure
gid	str
in_layout	bool
label	неизвестно
label1	неизвестно
label2	неизвестно
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)[source]

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

classmatplotlib.projections.polar.ThetaAxis(*args, **kwargs)[source]

Bases: XAxis

Ось θ.

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

Параметры:

axesAxes

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

pickradiusfloat

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

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

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

axis_name='theta'

Только для чтения имя, идентифицирующее ось.

clear()[source]

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

Это сбрасывает свойства оси до их значений по умолчанию:

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

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<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>)[source]

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

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

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
animated	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Объект Patch или (Path, Transform) или None
data_interval	неизвестно
figure	Figure
gid	str
in_layout	bool
inverted	неизвестно
label	объект
label_coords	неизвестно
label_position	{'верх', 'низ'}
label_text	строка
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	(масштаб: float, длина: float, случайность: float)
snap	bool или None
tick_params	неизвестно
ticklabels	неизвестно
ticks	одномерный массив-подобный объект
ticks_position	{'верх', 'низ', 'оба', 'по умолчанию', 'нет'}
transform	Transform
units	тег единиц
url	строка
view_interval	неизвестно
visible	bool
zorder	float

classmatplotlib.projections.polar.ThetaFormatter[source]

Bases: Formatter

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

classmatplotlib.projections.polar.ThetaLocator(base)[source]

Bases: Locator

Используется для определения отметки по углу θ.

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

set_axis(axis)[source]

view_limits(vmin, vmax)[source]

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

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

classmatplotlib.projections.polar.ThetaTick(axes, *args, **kwargs)[source]

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

Метка оси theta.

Этот подкласс 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>, label1=<UNSET>, label2=<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>)[source]

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

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

Свойство	Описание
agg_filter	функция фильтрации, которая принимает массив float (m, n, 3) и значение dpi и возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения
alpha	скаляр или None
animated	bool
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
figure	Figure
gid	str
in_layout	bool
label	неизвестно
label1	неизвестно
label2	неизвестно
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)[source]

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