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

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

Масштабирует вывод так, что максимальный радиус находится на краю области Axes, а начало отсчета отображается в (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

Проекция графика в полярных координатах, где входные параметры — θ, 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.

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

Управляет тем, передаются ли события масштабирования/приближения в подлежащую область построения графиков. "auto" — True для областей построения графиков с невидимым фрагментом и False в противном случае.

**kwargs

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

Свойство	Описание
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	BboxBase или None
clip_on	логическое значение
clip_path	Patch или (Path, Transform) или None
facecolor или fc	цвет
figure	Figure
forward_navigation_events	логическое значение или "auto"
frame_on	логическое значение
gid	строка
in_layout	логическое значение
label	объект
mouseover	логическое значение
navigate	логическое значение
navigate_mode	неизвестно
path_effects	список AbstractPathEffect
picker	None или логическое значение или число или вызываемый объект
position	[слева, снизу, ширина, высота] или Bbox
prop_cycle	Cycler
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.

classОбратныйПолярныйПреобразователь(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), в зависимости от входных данных.

classPolarAffine(scale_transform, limits)[source]

Bases: Affine2DBase

Часть аффинного преобразования полярной проекции.

Масштабирует вывод так, чтобы максимальный радиус располагался на краю области Axes, а начало координат отображалось в (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]

Основание: 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]

Основание: Formatter

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

classThetaLocator(base)[source]

Основание: Locator

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

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

set_axis(axis)[source]

view_limits(vmin, vmax)[source]

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

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

can_pan()[source]

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

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

can_zoom()[source]

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

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

clear()[source]

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

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

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

Параметры:

buttonMouseButton

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

keystr или None

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

x, yfloat

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

Примечания

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

draw(renderer)[source]

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

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

Параметры:

rendererRendererBase подкласс.

Примечания

Этот метод переопределен в подклассах элементов-объектов.

end_pan()[source]

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

Примечания

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

format_coord(theta, r)[source]

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

get_data_ratio()[source]

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

get_rlabel_position()[source]

Возвращает:

float

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

get_rmax()[source]

Возвращает:

float

Внешний предел радиуса.

get_rmin()[source]

Возвращает:

float

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

get_rorigin()[source]

Возвращает:

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]

Возвращает:

transformПреобразование

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

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

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

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

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

Примечания

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

get_xaxis_text2_transform(pad)[source]

Возвращает:

transformПреобразование

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

Возвращает:

transformПреобразование

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

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

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

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

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

Примечания

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

get_yaxis_text2_transform(pad)[source]

Возвращает:

transformПреобразование

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

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

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

Свойство	Описание
adjustable	{'рамка', '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	BboxBase или None
clip_on	логическое значение
clip_path	Patch или (Path, Transform) или None
facecolor или fc	цвет
figure	Figure
forward_navigation_events	логическое значение или "auto"
frame_on	логическое значение
gid	строка
in_layout	логическое значение
label	объект
mouseover	логическое значение
navigate	логическое значение
navigate_mode	неизвестно
path_effects	список AbstractPathEffect
picker	None или логическое значение или число или вызываемый объект
position	[слева, снизу, ширина, высота] или 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]

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

Параметры:

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

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

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

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

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

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

fmtстрока или None

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

Возвращает:

linesсписок lines.Line2D

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

labelsсписок text.Text

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

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

**kwargs

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

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

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

Вместо этого используйте 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.

clockwise, -1:

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

counterclockwise, anticlockwise, 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 для меток.

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

Это только устанавливает свойства текущих делений. Деления не гарантируются как постоянные. Различные операции могут создавать, удалять и изменять экземпляры 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.scale.AsinhScale

Примечания

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

start_pan(x, y, button)[source]

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

Параметры:

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

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

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, необязательно

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

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). В аффинных преобразованиях это всегда операция без действия.

Parameters:

valuesмассив

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

Returns:

массив

Выходные значения как массив длины 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

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	{'слева', 'справа'}
label_text	строка
major_formatter	Formatter, str, или функция
major_locator	Locator
minor_formatter	Formatter, str, или функция
minor_locator	Locator
mouseover	bool
offset_position	{'слева', 'справа'}
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	последовательность строк или Text
ticks	одномерный массив
ticks_position	{'слева', 'справа', 'обе', 'по умолчанию', 'нет'}
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]

Bases: YTick

Отметка шкалы радиуса.

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

bbox — прямоугольник, определяющий границы отметки в координатах отображения осей. 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	функция фильтра, которая принимает массив (m, n, 3) float и значение 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	строка
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	строка (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	(масштаб: float, длина: float, случайность: float)
snap	bool или None
tick_params	неизвестно
ticklabels	последовательность строк или объектов Text
ticks	одномерный массив
ticks_position	{'верх', 'низ', 'оба', 'по умолчанию', 'нет'}
transform	Transform
units	тег единиц
url	строка (str)
view_interval	неизвестно
visible	bool
zorder	float

classmatplotlib.projections.polar.ThetaFormatter[source]

Bases: Formatter

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

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

Bases: Locator

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

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

set_axis(axis)[source]

view_limits(vmin, vmax)[source]

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

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

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

Bases: 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.