matplotlib.projections.polar

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

Основы: Transform

Обратное преобразование полярных координат, отображающее декартовы координаты x и y обратно в theta и 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(xy)[source]

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

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

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

Параметры:

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

Возвращает:

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

классmatplotlib.projections.polar.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]: Получает матрицу для аффинной части этого преобразования.

END_OF_DOCUMENT_MARKER ```

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

Bases: Axes

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

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

Построение осей в области графика.

Параметры:

figFigure

Оси строятся в области графика Figure fig.

*args

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

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

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

Ось x или y совмещена с осью x или y в входном Axes.

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

Отображается ли рамка осей.

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

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

**kwargs

END_OF_DOCUMENT_MARKER

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

Свойство	Описание
`adjustable`	{'box', 'datalim'}
`agg_filter`	функция фильтра, которая принимает массив float (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`	`Bbox`
`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`	[левое, нижнее, ширина, высота] или `Bbox`
`prop_cycle`	неизвестно
`rasterization_zorder`	число или None
`rasterized`	булево значение
`sketch_params`	(масштаб: число, длина: число, случайность: число)
`snap`	булево значение или None
`subplotspec`	неизвестно
`title`	строка
`transform`	`Transform`
`url`	строка
`visible`	булево значение
`xbound`	неизвестно
`xlabel`	строка
`xlim`	(низ: число, верх: число)
`xmargin`	число, большее -0,5
`xscale`	неизвестно
`xticklabels`	неизвестно
`xticks`	неизвестно

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

Возвращает:

Axes: Объект нового Axes.

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

Базы: Transform

Обратное полярное преобразование, отображающее декартовы координаты x и y обратно в theta и 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(xy)[source]

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

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

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

Параметры:

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

Возвращает:

массив: Выходные значения как массив NumPy длины output_dims или формы (N x 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]: Получить матрицу для аффинной части этого преобразования.

END_OF_DOCUMENT_MARKER

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

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

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

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

Параметры:

valuesмассив: Входные значения как массив NumPy длиной input_dims или формы (N x input_dims).

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

массив: Выходные значения как массив NumPy длиной output_dims или формы (N x 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. Преобразует исходную единицу радиан в градусы и добавляет символ градуса.

END_OF_DOCUMENT_MARKER

classThetaLocator(base)[source]

Bases: Locator

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

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

set_axis(axis)[source]

view_limits(vmin, vmax)[source]

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

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

can_pan()[source]

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

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

can_zoom()[source]

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

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

clear()[source]: Очистить Axes.

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

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

Parameters:

buttonMouseButton: Кнопка мыши, нажатая.
keystr or None: Нажатая клавиша, если есть.
x, yfloat: Координаты мыши в координатах отображения.

Примечания

Предполагается переопределение типами новых проекций.

draw(renderer)[source]

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

Это не имеет эффекта, если компонент не отображается (Artist.get_visible возвращает False).

Parameters:

rendererRendererBase подкласс.

Примечания

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

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]: Возвращает максимальное значение угла theta в градусах.

get_thetamin()[source]: Получить минимальное значение угла theta в градусах.

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'}: Горизонтальное выравнивание текста.

Примечания

get_xaxis_transform(which='grid')[source]

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

Примечание

Параметры:

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'}: Горизонтальное выравнивание текста.

Примечания

get_yaxis_text2_transform(pad)[source]

Возвращает:

transformTransform: Преобразование, используемое для рисования дополнительных меток оси y, которое добавит отступ pad_points (в пунктах) между осью и меткой. Направление x в координатах оси, а направление y в координатах данных
valign{'center', 'top', 'bottom', 'baseline', 'center_baseline'}: Вертикальное выравнивание текста.
halign{'center', 'left', 'right'}: Горизонтальное выравнивание текста.

Примечания

get_yaxis_transform(which='grid')[source]

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

Примечание

Параметры:

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`	`Bbox`
`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`	[левое, нижнее, ширина, высота] или `Bbox`
`prop_cycle`	неизвестно
`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]

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

Параметры:

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

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

Параметры:

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]

Установите направление, в котором увеличивается theta.

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

set_theta_offset(offset)[source]: Установите смещение для расположения 0 в радианах.

set_theta_zero_location(loc, offset=0.0)[source]

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

Это просто вызывает 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: Метки для каждой линии сетки θ. Будет использоваться projections.polar.ThetaFormatter, если None.
fmtстрока или None: Форматная строка, используемая в matplotlib.ticker.FormatStrFormatter. Например, '%f'. Обратите внимание, что используемый угол находится в радианах.

Возвращает:

linesсписок lines.Line2D: Линии сетки θ.
labelsсписок text.Text: Метки делений.

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

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

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

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

Используйте 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 поддерживает вышеупомянутые масштабы. Кроме того, пользовательские масштабы могут быть зарегистрированы с помощью 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)\) (но не полностью преобразует в координаты осей или не обрабатывает позиционирование в пространстве экрана).

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

Параметры:

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

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

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

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

Параметры:

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

Возвращает:

массив: Выходные значения как массив NumPy длиной output_dims или формы (N x 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: Объект Axes, к которому принадлежит созданная ось.
pickradiusfloat: Радиус приёма для тестов вхождения. См. также Axis.contains.

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`	булево значение
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	Объект Patch или (объект Path, преобразование) или None
`data_interval`	неизвестно
`figure`	`Figure`
`gid`	строка
`in_layout`	булево значение
`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`	булево значение
`offset_position`	{'left', 'right'}
`path_effects`	`AbstractPathEffect`
`picker`	None или булево значение или число с плавающей точкой или вызываемая функция
`pickradius`	число с плавающей точкой
`rasterized`	булево значение
`remove_overlapping_locs`	неизвестно
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`tick_params`	неизвестно
`ticklabels`	неизвестно
`ticks`	список чисел с плавающей точкой
`ticks_position`	{'left', 'right', 'both', 'default', 'none'}
`transform`	`Transform`
`units`	тег единиц
`url`	строка
`view_interval`	неизвестно
`visible`	булево значение
`zorder`	число с плавающей точкой

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.

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

END_OF_DOCUMENT_MARKER

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

Bases: 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, и возвращает массив float (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	скаляр или None
`animated`	bool
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Объект Patch или (Path, Transform) или None
`figure`	`Figure`
`gid`	строка
`in_layout`	bool
`label`	строка
`label1`	строка
`label2`	строка
`mouseover`	bool
`pad`	число с плавающей точкой
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или число с плавающей точкой или вызываемая функция
`rasterized`	bool
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool или None
`transform`	`Transform`
`url`	строка
`visible`	bool
`zorder`	число с плавающей точкой

update_position(loc)[source]: Установить положение метки в координатах данных со скаляром loc.

END_OF_DOCUMENT_MARKER

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

Bases: XAxis

Ось theta.

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

Параметры:

axesAxes: Объект Axes, к которому принадлежит созданная ось.
pickradiusfloat: Радиус принятия для тестов соприкосновения. См. также Axis.contains.

axis_name='theta': Имя оси для чтения.

clear()[source]

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

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

метка
масштаб
локатороы, форматеры и метки
сетка major и minor
единицы
зарегистрированные обратные вызовы

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]

END_OF_DOCUMENT_MARKER

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

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	скаляр или None
`animated`	bool
`clip_box`	`Bbox`
`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]

Базируется на Formatter

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

END_OF_DOCUMENT_MARKER

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]

Bases: XTick

Отметка шкалы θ.

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

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

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

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

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

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