matplotlib.projections

class matplotlib.projections.ProjectionRegistry [source]

Bases: object

Управляет набором проекций, доступных системе.

get_projection_class(self, name) [source]

Получить класс проекции по её названию.

get_projection_names(self) [source]

Получить список имён всех зарегистрированных проекций.

register(self, *projections) [source]

Зарегистрировать новый набор проекций.

matplotlib.projections.get_projection_class(projection=None) [source]

Получить класс проекции по её имени.

Если projection равно None, возвращается стандартная прямолинейная проекция.

matplotlib.projections.get_projection_names() [source]

Получить список допустимых имён проекций.

matplotlib.projections.process_projection_requirements(figure, *args, **kwargs) [source]

[Устарело]

Примечания

Устарело начиная с версии 3.1:

matplotlib.projections.register_projection(cls) [source]

matplotlib.projections.polar

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

Bases: matplotlib.transforms.Transform

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

input_dims = 2

inverted(self) [source]

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

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

x === self.inverted().transform(self.transform(x))

is_separable = False

output_dims = 2

transform_non_affine(self, xy) [source]

Выполняет только неаффинную часть преобразования.

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

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

Принимает массив NumPy формы (N x input_dims) и возвращает массив NumPy формы (N x output_dims).

В качестве альтернативы принимает массив NumPy длины input_dims и возвращает массив NumPy длины output_dims.

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

Bases: matplotlib.transforms.Affine2DBase

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

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

get_matrix(self) [source]

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

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

Bases: matplotlib.axes._axes.Axes

Графическое отображение полярных координат, где входные измерения — theta, r.

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

class InvertedPolarTransform(axis=None, use_rmin=True, _apply_theta_transforms=True)

Bases: matplotlib.transforms.Transform

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

input_dims = 2

inverted(self)

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

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

x === self.inverted().transform(self.transform(x))

is_separable = False

output_dims = 2

transform_non_affine(self, xy)

Выполняет только неаффинное преобразование.

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

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

Принимает массив NumPy формы (N x input_dims) и возвращает массив NumPy формы (N x output_dims).

В качестве альтернативы, принимает массив NumPy длины input_dims и возвращает массив NumPy длины output_dims.

class PolarAffine(scale_transform, limits)

Bases: matplotlib.transforms.Affine2DBase

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

limits — предел отображения данных. Используется только часть границ, а именно y-пределы (для радиусных пределов). Диапазон углов theta обрабатывается неаффинным преобразованием.

get_matrix(self)

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

class PolarTransform(axis=None, use_rmin=True, _apply_theta_transforms=True)

Bases: matplotlib.transforms.Transform

Основное полярное преобразование. Оно обрабатывает проецирование theta и r в декартовы координаты x и y, но не выполняет окончательное аффинное преобразование в правильное положение.

input_dims = 2

inverted(self)

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

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

x === self.inverted().transform(self.transform(x))

is_separable = False

output_dims = 2

transform_non_affine(self, tr)

Выполняет только неаффинное преобразование.

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

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

Принимает массив NumPy формы (N x input_dims) и возвращает массив NumPy формы (N x output_dims).

В качестве альтернативы, принимает массив NumPy длины input_dims и возвращает массив NumPy длины output_dims.

transform_path_non_affine(self, path)

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

path: экземпляр Path.

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

class RadialLocator(base, axes=None)

Bases: matplotlib.ticker.Locator

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

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

autoscale(self)

Автоматическое масштабирование пределов отображения

pan(self, numsteps)

Перемещение на numticks (может быть положительным или отрицательным)

refresh(self)

Обновление внутренней информации на основе текущих пределов

view_limits(self, vmin, vmax)

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

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

zoom(self, direction)

Масштабирование по оси; если направление >0, то масштабирование увеличивается, иначе уменьшается

class ThetaFormatter

Bases: matplotlib.ticker.Formatter

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

class ThetaLocator(base)

Bases: matplotlib.ticker.Locator

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

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

autoscale(self)

Автоматическое масштабирование пределов отображения

pan(self, numsteps)

Перемещение на numticks (может быть положительным или отрицательным)

refresh(self)

Обновление внутренней информации на основе текущих пределов

set_axis(self, axis)

view_limits(self, vmin, vmax)

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

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

zoom(self, direction)

Масштабирование по оси; если направление >0, то масштабирование увеличивается, иначе уменьшается

can_pan(self) [source]

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

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

can_zoom(self) [source]

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

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

cla(self) [source]

Очистить текущую ось.

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

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

button — номер кнопки мыши:

• 1: ЛЕВАЯ
• 2: СРЕДНЯЯ
• 3: ПРАВАЯ

key — клавиша "shift"

x, y — координаты мыши в координатах отображения.

Примечание

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

draw(self, *args, **kwargs) [source]

Отрисовать все (линии графика, оси, метки)

end_pan(self) [source]

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

Примечание

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

format_coord(self, theta, r) [source]

Возвратить строку форматирования координат с использованием символов Юникода.

get_data_ratio(self) [source]

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

get_rlabel_position(self) [source]

Возвращает:	float Позиция меток радиуса в градусах.

get_rmax(self) [source]

Возвращает:	float Внешняя радиальная граница.

get_rmin(self) [source]

Возвращает:	float Внутренняя радиальная граница.

get_rorigin(self) [source]

Возвращает:	float

get_rsign(self) [source]

get_theta_direction(self) [source]

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

-1:

Увеличение тета по часовой стрелке

1:

Увеличение тета против часовой стрелки

get_theta_offset(self) [source]

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

get_thetamax(self) [source]

get_thetamin(self) [source]

get_xaxis_text1_transform(self, pad) [source]

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

Примечания

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

get_xaxis_text2_transform(self, pad) [source]

Возвращает:

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

Примечания

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

get_xaxis_transform(self, which='grid') [source]

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

Примечание

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

get_yaxis_text1_transform(self, pad) [source]

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

Примечания

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

get_yaxis_text2_transform(self, pad) [source]

Возвращает:

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

Примечания

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

get_yaxis_transform(self, which='grid') [source]

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

Примечание

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

name = 'polar'

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

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

Параметры:	radii : tuple with floats Радиусы для радиальных линий сетки labels : tuple with strings or None Метки, используемые для каждой радиальной линии сетки. Если None, будет использоваться matplotlib.ticker.ScalarFormatter. angle : float Угловое положение меток радиуса в градусах. fmt : str or None Форматная строка, используемая в matplotlib.ticker.FormatStrFormatter. Например, '%f'.
Возвращает:	lines, labels : list of lines.Line2D, list of text.Text lines — это радиальные линии сетки, а labels — метки делений.
Другие параметры:	**kwargs kwargs — это необязательные свойства Text для меток.

См. также

PolarAxes.set_thetagrids

Axis.get_gridlines

Axis.get_ticklabels

set_rlabel_position(self, value) [source]

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

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

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

См. set_ylim.

set_rmax(self, rmax) [source]

Установить внешнее радиальное ограничение.

Параметры:	rmax : float

set_rmin(self, rmin) [source]

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

Параметры:	rmin : float

set_rorigin(self, rorigin) [source]

Обновить радиальный ноль.

Параметры:	rorigin : float

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

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

set_theta_direction(self, direction) [source]

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

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

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

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

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

set_theta_offset(self, offset) [source]

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

set_theta_zero_location(self, loc, offset=0.0) [source]

Устанавливает расположение нуля θ. (Вызывает set_theta_offset с правильным значением в радианах под капотом.)

loc : str

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

offset : float, optional

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

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

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

Параметры:	angles : tuple with floats, degrees Углы линий сетки θ. labels : tuple with strings or None Метки, используемые для каждой линии сетки θ. Будет использоваться projections.polar.ThetaFormatter, если None. fmt : str or None Строка формата, используемая в matplotlib.ticker.FormatStrFormatter. Например, '%f'. Обратите внимание, что используемый угол находится в радианах.
Возвращает:	lines, labels : list of lines.Line2D, list of text.Text lines — линии сетки θ, а labels — метки делений.
Другие параметры:	**kwargs kwargs — необязательные свойства Text для меток.

См. также

PolarAxes.set_rgrids

Axis.get_gridlines

Axis.get_ticklabels

set_thetalim(self, *args, **kwargs) [source]

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

Параметры:	thetamin : float Минимальное значение в градусах. thetamax : float Максимальное значение в градусах.

set_thetamax(self, thetamax) [source]

set_thetamin(self, thetamin) [source]

set_xscale(self, scale, *args, **kwargs) [source]

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

Параметры:	value : {"linear", "log", "symlog", "logit", ...} Тип масштаба оси. **kwargs Разные ключевые аргументы принимаются в зависимости от масштаба. Смотрите соответствующие ключевые аргументы классов: matplotlib.scale.LinearScale matplotlib.scale.LogScale matplotlib.scale.SymmetricalLogScale matplotlib.scale.LogitScale

Примечания

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

set_ylim(self, bottom=None, top=None, emit=True, auto=False, *, ymin=None, ymax=None) [source]

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

Параметры:

bottom : scalar, optional Нижний предел (по умолчанию: None, что оставляет нижний предел неизменным). Нижний и верхний пределы ylim могут быть переданы как кортеж (bottom, top) в качестве первого позиционного аргумента (или в качестве ключевого аргумента bottom). top : scalar, optional Верхний предел (по умолчанию: None, что оставляет верхний предел неизменным). emit : bool, optional Уведомлять ли наблюдателей об изменении пределов (по умолчанию: True). auto : bool or None, optional Включить или выключить автоматический масштабирования оси y. True — включить, False — выключить (по умолчанию), None — оставить без изменений. ymin, ymax : scalar, optional Эти аргументы устарели и будут удалены в будущих версиях. Они эквивалентны bottom и top соответственно, и ошибка, если передать одновременно ymin и bottom или ymax и top.

Возвращает:

bottom, top : (float, float) Новые пределы оси y в координатах данных.

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

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

Параметры:	value : {"linear", "log", "symlog", "logit", ...} Тип масштаба оси. **kwargs Разные ключевые аргументы принимаются в зависимости от масштаба. Смотрите соответствующие ключевые аргументы классов: matplotlib.scale.LinearScale matplotlib.scale.LogScale matplotlib.scale.SymmetricalLogScale matplotlib.scale.LogitScale

Примечания

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

start_pan(self, x, y, button) [source]

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

x, y — координаты мыши в координатах отображения. button — номер кнопки мыши:

• 1: ЛЕВАЯ
• 2: СРЕДНЯЯ
• 3: ПРАВАЯ

Примечание

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

class matplotlib.projections.polar.PolarTransform(axis=None, use_rmin=True, _apply_theta_transforms=True) [source]

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

input_dims = 2

inverted(self) [source]

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

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

x === self.inverted().transform(self.transform(x))

is_separable = False

output_dims = 2

transform_non_affine(self, tr) [source]

Выполняет только часть преобразования, не связанную с аффинной трансформацией.

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

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

Принимает массив NumPy формы (N x input_dims) и возвращает массив NumPy формы (N x output_dims).

В качестве альтернативы принимает массив NumPy длины input_dims и возвращает массив NumPy длины output_dims.

transform_path_non_affine(self, path) [source]

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

path: экземпляр Path.

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

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

Осевая линия радиуса.

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

axis_name = 'radius'

cla(self) [source]

Очистить текущую ось.

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

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

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

autoscale(self) [source]

Автоматически масштабировать пределы отображения.

pan(self, numsteps) [source]

Перемещение на numticks (может быть положительным или отрицательным).

refresh(self) [source]

Обновить внутреннюю информацию на основе текущих пределов.

view_limits(self, vmin, vmax) [source]

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

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

zoom(self, direction) [source]

Масштабирование оси: если направление > 0, то масштабирование увеличивается, иначе уменьшается.

class matplotlib.projections.polar.RadialTick(axes, loc, label, size=None, width=None, color=None, tickdir=None, pad=None, labelsize=None, labelcolor=None, zorder=None, gridOn=None, tick1On=True, tick2On=True, label1On=True, label2On=False, major=True, labelrotation=0, grid_color=None, grid_linestyle=None, grid_linewidth=None, grid_alpha=None, **kw) [source]

Метка оси радиуса.

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

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

update_position(self, loc) [source]

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

class matplotlib.projections.polar.ThetaAxis(axes, pickradius=15) [source]

Ось угла.

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

Параметры:	axes : matplotlib.axes.Axes Экземпляр Axes, которому принадлежит созданная ось. pickradius : float Радиус приема для тестов включения. См. также Axis.contains.

axis_name = 'theta'

cla(self) [source]

Очистить текущую ось.

class matplotlib.projections.polar.ThetaFormatter [source]

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

class matplotlib.projections.polar.ThetaLocator(base) [source]

Bases: matplotlib.ticker.Locator

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

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

autoscale(self) [source]

Автоматическое масштабирование пределов отображения

pan(self, numsteps) [source]

Прокрутка на numticks (может быть положительной или отрицательной)

refresh(self) [source]

Обновление внутренней информации на основе текущих пределов

set_axis(self, axis) [source]

view_limits(self, vmin, vmax) [source]

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

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

zoom(self, direction) [source]

Увеличение/уменьшение масштаба оси; если направление >0, то увеличение, иначе уменьшение

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

Bases: matplotlib.axis.XTick

Метка оси θ.

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

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

update_position(self, loc) [source]

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