matplotlib.projections

class matplotlib.projections.ProjectionRegistry

基类：object

注册的投影名称到投影类的映射。

get_projection_class(name)

从它的 name .

get_projection_names()

返回当前注册的所有投影的名称。

register(*projections)

注册一组新的投影。

matplotlib.projections.get_projection_class(projection=None)

从其名称中获取投影类。

如果 投影 如果为“无”，则返回标准的直线投影。

matplotlib.projections.get_projection_names()

返回当前注册的所有投影的名称。

matplotlib.projections.register_projection(cls)

matplotlib.projections.polar

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

基类：matplotlib.transforms.Transform

极坐标变换的逆映射笛卡尔坐标空间 x 和 y 回到 θ 和 r .

参数:

shorthand_nameSTR

表示转换的“名称”的字符串。除了提高 str(transform) 当debug=true时。

has_inverse = True

input_dims = 2

inverted()

返回相应的逆变换。

它坚持住了 x == self.inverted().transform(self.transform(x)) .

此方法的返回值应视为临时值。对…的更新 self 不会对其反向副本进行相应的更新。

output_dims = 2

transform_non_affine(xy)

仅应用此变换的非仿射部分。

transform(values) 总是等价于 transform_affine(transform_non_affine(values)) .

在非仿射变换中，这通常等价于 transform(values) . 在仿射变换中，这总是一个不运算。

参数:

values数组

输入值为NumPy数组的长度 input_dims 或形状（nx input_dims ）

返回:

数组

输出值为NumPy数组的长度 input_dims 或形状（nx output_dims )，取决于输入。

class matplotlib.projections.polar.PolarAffine(scale_transform, limits)

基类：matplotlib.transforms.Affine2DBase

极投影的仿射部分。缩放输出，使最大半径取决于轴圆的边缘。

限制 是数据的视图限制。其边界的唯一部分是Y限制（用于半径限制）。theta范围由非仿射变换处理。

get_matrix()

得到这个变换的仿射部分的矩阵。

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

基类：matplotlib.axes._axes.Axes

极坐标图投影，输入尺寸为 θ ， r .

θ开始向东，逆时针方向移动。

在图形中构建轴。

参数:

fig ： Figure图形

轴内置于 Figure fig .

rect[左、下、宽、高]

轴内置在矩形中 rect . rect 是在 Figure 协调。

斯莱西 ： Axes 可选可选轴

X或Y axis 与输入中的X或Y轴共享 Axes .

frameonbool，默认值：True

轴框架是否可见。

box_aspect无，或数字，可选

设置轴框的纵横比。看到了吗 set_box_aspect 有关详细信息。

**kwargs

其他可选关键字参数：

财产	描述
adjustable	'box'、'datalim'
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动或无
anchor	2-浮点数或'c'、'sw'、's'、'se'、…
animated	布尔
aspect	{auto}或num
autoscale_on	布尔
autoscalex_on	布尔
autoscaley_on	布尔
axes_locator	可赎回的 [[轴，渲染器]] Bbox
axisbelow	布尔或“线”
box_aspect	没有，或者是一个数字
clip_box	Bbox
clip_on	布尔
clip_path	面片或（路径、变换）或无
contains	未知的
facecolor 或fc	颜色
figure	Figure
frame_on	布尔
gid	STR
in_layout	布尔
label	对象
navigate	布尔
navigate_mode	未知的
path_effects	AbstractPathEffect
picker	无、布尔或可呼叫
position	[左、下、宽、高] 或 Bbox
prop_cycle	未知的
rasterization_zorder	浮动或无
rasterized	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
title	STR
transform	Transform
url	STR
visible	布尔
xbound	未知的
xlabel	STR
xlim	（底部：浮动，顶部：浮动）
xmargin	浮动大于-0.5
xscale	“Linear”，“Log”，“SymLog”，“Logit”，…
xticklabels	未知的
xticks	未知的
ybound	未知的
ylabel	STR
ylim	（底部：浮动，顶部：浮动）
ymargin	浮动大于-0.5
yscale	“Linear”，“Log”，“SymLog”，“Logit”，…
yticklabels	未知的
yticks	未知的
zorder	浮动

返回:

Axes

新的 Axes 对象。

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

基类：matplotlib.transforms.Transform

极坐标变换的逆映射笛卡尔坐标空间 x 和 y 回到 θ 和 r .

参数:

shorthand_nameSTR

表示转换的“名称”的字符串。除了提高 str(transform) 当debug=true时。

has_inverse = True

input_dims = 2

inverted()

返回相应的逆变换。

它坚持住了 x == self.inverted().transform(self.transform(x)) .

此方法的返回值应视为临时值。对…的更新 self 不会对其反向副本进行相应的更新。

output_dims = 2

transform_non_affine(xy)

仅应用此变换的非仿射部分。

transform(values) 总是等价于 transform_affine(transform_non_affine(values)) .

在非仿射变换中，这通常等价于 transform(values) . 在仿射变换中，这总是一个不运算。

参数:

values数组

输入值为NumPy数组的长度 input_dims 或形状（nx input_dims ）

返回:

数组

输出值为NumPy数组的长度 input_dims 或形状（nx output_dims )，取决于输入。

class PolarAffine(scale_transform, limits)

基类：matplotlib.transforms.Affine2DBase

极投影的仿射部分。缩放输出，使最大半径取决于轴圆的边缘。

限制 是数据的视图限制。其边界的唯一部分是Y限制（用于半径限制）。theta范围由非仿射变换处理。

get_matrix()

得到这个变换的仿射部分的矩阵。

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

基类：matplotlib.transforms.Transform

基极变换。这个处理投影 θ 和 r 进入笛卡尔坐标空间 x 和 y 但不能将最终仿射变换到正确的位置。

参数:

shorthand_nameSTR

表示转换的“名称”的字符串。除了提高 str(transform) 当debug=true时。

has_inverse = True

input_dims = 2

inverted()

返回相应的逆变换。

它坚持住了 x == self.inverted().transform(self.transform(x)) .

此方法的返回值应视为临时值。对…的更新 self 不会对其反向副本进行相应的更新。

output_dims = 2

transform_non_affine(tr)

仅应用此变换的非仿射部分。

transform(values) 总是等价于 transform_affine(transform_non_affine(values)) .

在非仿射变换中，这通常等价于 transform(values) . 在仿射变换中，这总是一个不运算。

参数:

values数组

输入值为NumPy数组的长度 input_dims 或形状（nx input_dims ）

返回:

数组

输出值为NumPy数组的长度 input_dims 或形状（nx output_dims )，取决于输入。

transform_path_non_affine(path)

Apply the non-affine part of this transform to Path path, returning a new Path.

transform_path(path) 等于 transform_path_affine(transform_path_non_affine(values)) .

class RadialLocator(base, axes=None)

基类：matplotlib.ticker.Locator

用于定位半径刻度。

确保所有刻度都为正。对于所有其他任务，它将委托给基础 Locator （取决于 r 轴。

autoscale()

[Deprecated]

笔记

3.2 版后已移除:

nonsingular(vmin, vmax)

根据需要调整一个范围以避免出现奇点。

此方法在自动缩放期间调用，使用 (v0, v1) 如果轴包含任何数据，则设置为轴上的数据限制，或 (-inf, +inf) 如果没有。

• 如果 v0 == v1 （可能达到某个浮点斜率），此方法返回此值周围的扩展间隔。
• 如果 (v0, v1) == (-inf, +inf) ，此方法返回适当的默认视图限制。
• 否则， (v0, v1) 未经修改而返回。

pan(numsteps)

[Deprecated]

笔记

3.3 版后已移除:

refresh()

[Deprecated]

笔记

3.3 版后已移除:

view_limits(vmin, vmax)

为范围从vmin到vmax选择一个刻度。

子类应重写此方法以更改定位器行为。

zoom(direction)

[Deprecated]

笔记

3.3 版后已移除:

class ThetaFormatter

基类：matplotlib.ticker.Formatter

用于格式化 θ 滴答标签。将本机弧度单位转换为度数并添加度数符号。

class ThetaLocator(base)

基类：matplotlib.ticker.Locator

用于定位theta ticks。

这与基础定位器的工作原理相同，只是在视图跨越整个圆的情况下。在这种情况下，将返回以前使用的每45度的默认位置。

autoscale()

[Deprecated]

笔记

3.2 版后已移除:

pan(numsteps)

[Deprecated]

笔记

3.3 版后已移除:

refresh()

[Deprecated] 根据当前限制刷新内部信息。

笔记

3.3 版后已移除.

set_axis(axis)

view_limits(vmin, vmax)

为范围从vmin到vmax选择一个刻度。

子类应重写此方法以更改定位器行为。

zoom(direction)

[Deprecated]

笔记

3.3 版后已移除:

can_pan()

返回 True 如果此轴支持“平移/缩放”按钮功能。

对于极轴，这有点误导。平移和缩放都由同一按钮执行。当沿着径向进行缩放时，以方位角执行平移。

can_zoom()

返回 True 如果此轴支持缩放框按钮功能。

极轴不支持缩放框。

cla()

清除当前轴。

drag_pan(button, key, x, y)

当鼠标在平移操作期间移动时调用。

参数:

按钮 ： MouseButtonMouseButton

按下鼠标键。

keySTR或无

按下的键（如果有的话）。

x, y浮动

显示坐标中的鼠标坐标。

笔记

这将被新的投影类型覆盖。

draw(renderer, *args, **kwargs)

使用给定的渲染器绘制艺术家（及其子对象）。

如果艺术家不可见，则此操作无效 (Artist.get_visible 返回False）。

参数:

渲染器 ： RendererBase 子类。RenderBase子类。

笔记

此方法在Artist子类中被重写。

end_pan()

当pan操作完成时调用（当鼠标按钮打开时）。

笔记

这将被新的投影类型覆盖。

format_coord(theta, r)

返回格式化字符串 x ， y 协调。

get_data_ratio()

返回数据本身的纵横比。对于极坐标图，该值应始终为1.0。

get_rlabel_position()

返回:

浮动

半径标签的θ位置（度）。

get_rmax()

返回:

浮动

外径向极限。

get_rmin()

返回:

浮动

内部径向极限。

get_rorigin()

返回:

浮动

get_rsign()

get_theta_direction()

得到θ增加的方向。

-1:

θ沿顺时针方向增加

1：

θ沿逆时针方向增加

get_theta_offset()

获取0位置的偏移量（以弧度表示）。

get_thetamax()

返回最大θ限制（以度为单位）。

get_thetamin()

得到最小θ极限，单位为度。

get_xaxis_text1_transform(pad)

返回:

transform变换

用于绘制x轴标签的转换，它将添加 pad_points 轴和标签之间的填充（以点为单位）。x方向在数据坐标中，y方向在坐标轴上

valign‘中心’、‘顶部’、‘底部’、‘基线’、‘中心基线’；

文本垂直对齐。

halign{'center'、'left'、'right'}

文本水平对齐。

笔记

此转换主要由 Axis 类，并将被可能需要将轴元素放置在不同位置的新类型投影覆盖。

get_xaxis_text2_transform(pad)

返回:

transform变换

用于绘制辅助x轴标签的转换，它将添加 pad_points 轴和标签之间的填充（以点为单位）。x方向在数据坐标中，y方向在坐标轴上

valign‘中心’、‘顶部’、‘底部’、‘基线’、‘中心基线’；

文本垂直对齐。

halign{'center'、'left'、'right'}

文本水平对齐。

笔记

此转换主要由 Axis 类，并将被可能需要将轴元素放置在不同位置的新类型投影覆盖。

get_xaxis_transform(which='grid')

获取用于绘制X轴标签、刻度和网格线的转换。X方向是数据坐标，Y方向是轴坐标。

注解

此转换主要由 Axis 类，并将被可能需要将轴元素放置在不同位置的新类型投影覆盖。

get_yaxis_text1_transform(pad)

返回:

transform变换

用于绘制y轴标签的转换，它将添加 pad_points 轴和标签之间的填充（以点为单位）。x方向在轴坐标中，y方向在数据对应中

valign‘中心’、‘顶部’、‘底部’、‘基线’、‘中心基线’；

文本垂直对齐。

halign{'center'、'left'、'right'}

文本水平对齐。

笔记

此转换主要由 Axis 类，并将被可能需要将轴元素放置在不同位置的新类型投影覆盖。

get_yaxis_text2_transform(pad)

返回:

transform变换

用于绘制第二部分y轴标签的转换，它将添加 pad_points 轴和标签之间的填充（以点为单位）。x方向在轴坐标中，y方向在数据对应中

valign‘中心’、‘顶部’、‘底部’、‘基线’、‘中心基线’；

文本垂直对齐。

halign{'center'、'left'、'right'}

文本水平对齐。

笔记

此转换主要由 Axis 类，并将被可能需要将轴元素放置在不同位置的新类型投影覆盖。

get_yaxis_transform(which='grid')

获取用于绘制Y轴标签、刻度和网格线的转换。X方向为轴坐标，Y方向为数据坐标。

注解

此转换主要由 Axis 类，并将被可能需要将轴元素放置在不同位置的新类型投影覆盖。

name = 'polar'

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

在极坐标图上设置径向网格线。

参数:

radii带浮点数的元组

径向网格线的半径

labels带字符串或无字符串的元组

用于每个径向网格线的标签。这个 matplotlib.ticker.ScalarFormatter 如果没有，将使用。

angle浮动

半径标签的角度位置（度）。

fmtSTR或无

中使用的格式字符串 matplotlib.ticker.FormatStrFormatter . 例如“%f”。

返回:

线 名单 lines.Line2D名单

径向网格线。

标签 名单 text.Text名单

勾选标签。

其他参数:

**kwargs

关键字参数 是可选的 Text 标签的属性。

参见

PolarAxes.set_thetagrids

Axis.get_gridlines

Axis.get_ticklabels

set_rlabel_position(value)

更新半径标签的θ位置。

参数:

value数

半径标签的角度位置（度）。

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

见 set_ylim .

set_rmax(rmax)

设置外半径限制。

参数:

rmax浮动

set_rmin(rmin)

设置内半径限制。

参数:

rmin浮动

set_rorigin(rorigin)

更新径向原点。

参数:

rorigin浮动

set_rscale(*args, **kwargs)

set_rticks(*args, **kwargs)

set_theta_direction(direction)

设定θ增加的方向。

顺时针，- 1：

θ沿顺时针方向增加

逆时针，逆时针，1：

θ沿逆时针方向增加

set_theta_offset(offset)

以弧度设置0位置的偏移。

set_theta_zero_location(loc, offset=0.0)

设置θ零点的位置。

这就是所谓的 set_theta_offset 具有正确的弧度值。

参数:

locSTR

可以是“n”、“n w”、“w”、“s w”、“s”、“s e”、“e”或“n e”之一。

offset浮点，默认值：0

从指定的角度应用的偏移量 loc . 注： 此偏移量为 总是 无论方向设置如何，逆时针应用。

set_thetagrids(angles, labels=None, fmt=None, **kwargs)

在极坐标图中设置theta网格线。

参数:

angles带浮点数的元组，度数

θ网格线的角度。

labels带字符串或无字符串的元组

用于每个theta网格线的标签。这个 projections.polar.ThetaFormatter 如果没有，将使用。

fmtSTR或无

中使用的格式字符串 matplotlib.ticker.FormatStrFormatter . 例如“%f”。请注意，使用的角度是以弧度表示的。

返回:

线 名单 lines.Line2D名单

θ网格线。

标签 名单 text.Text名单

勾选标签。

其他参数:

**kwargs

关键字参数 是可选的 Text 标签的属性。

参见

PolarAxes.set_rgrids

Axis.get_gridlines

Axis.get_ticklabels

set_thetalim(*args, **kwargs)

设置最小和最大θ值。

可以采取以下签名：

• set_thetalim(minval, maxval) ：以弧度为单位设置限制。
• set_thetalim(thetamin=minval, thetamax=maxval) ：以度为单位设置限制。

其中minval和maxval是最小和最大限值。值被包装到范围内 \([0, 2\pi]\) （以弧度为单位），例如 set_thetalim(-np.pi / 2, np.pi / 2) 使轴对称于0。如果绝对角度差大于 \(2\pi\) .

set_thetamax(thetamax)

以度为单位设置最大θ限制。

set_thetamin(thetamin)

以度为单位设置最小θ限制。

set_xscale(scale, *args, **kwargs)

设置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(bottom=None, top=None, emit=True, auto=False, *, ymin=None, ymax=None)

设置径向轴的数据限制。

参数:

bottom可选浮动

底部限制（默认值：无，保持底部限制不变）。底部和顶部的ylims可以作为元组传递( 底部 ， top ）作为第一个位置参数（或作为 底部 关键字参数）。

top可选浮动

上限（默认值：无，这将使上限保持不变）。

emitbool，默认值：True

是否通知观察者限额变更。

autobool或None，默认值：False

是否启用自动缩放轴。True打开，False关闭，None保持不变。

YMIN，YMAX可选浮动

这些参数已弃用，将在将来的版本中删除。它们相当于 底部 和 top 两个都通过是错误的 ymin 和 底部 或 ymax 和 top .

返回:

底部，顶部（浮标，浮标）

新的Y轴限制在数据坐标中。

set_yscale(*args, **kwargs)

设置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(x, y, button)

在启动PAN操作时调用。

参数:

x, y浮动

显示坐标中的鼠标坐标。

按钮 ： MouseButtonMouseButton

按下鼠标键。

笔记

这将被新的投影类型覆盖。

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

基类：matplotlib.transforms.Transform

基极变换。这个处理投影 θ 和 r 进入笛卡尔坐标空间 x 和 y 但不能将最终仿射变换到正确的位置。

参数:

shorthand_nameSTR

表示转换的“名称”的字符串。除了提高 str(transform) 当debug=true时。

has_inverse = True

input_dims = 2

inverted()

返回相应的逆变换。

它坚持住了 x == self.inverted().transform(self.transform(x)) .

此方法的返回值应视为临时值。对…的更新 self 不会对其反向副本进行相应的更新。

output_dims = 2

transform_non_affine(tr)

仅应用此变换的非仿射部分。

transform(values) 总是等价于 transform_affine(transform_non_affine(values)) .

在非仿射变换中，这通常等价于 transform(values) . 在仿射变换中，这总是一个不运算。

参数:

values数组

输入值为NumPy数组的长度 input_dims 或形状（nx input_dims ）

返回:

数组

输出值为NumPy数组的长度 input_dims 或形状（nx output_dims )，取决于输入。

transform_path_non_affine(path)

Apply the non-affine part of this transform to Path path, returning a new Path.

transform_path(path) 等于 transform_path_affine(transform_path_non_affine(values)) .

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

基类：matplotlib.axis.YAxis

径向轴。

这将覆盖 YAxis 为径向轴提供特殊外壳。

参数:

axes ： matplotlib.axes.Axesmatplotlib.axes.Axes

这个 Axes 创建的轴所属的。

pickradius浮动

安全壳试验的验收半径。另请参见 Axis.contains .

axis_name = 'radius'

标识轴的只读名称。

cla()

清除此轴。

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

基类：matplotlib.ticker.Locator

用于定位半径刻度。

确保所有刻度都为正。对于所有其他任务，它将委托给基础 Locator （取决于 r 轴。

autoscale()

[Deprecated]

笔记

3.2 版后已移除:

nonsingular(vmin, vmax)

根据需要调整一个范围以避免出现奇点。

此方法在自动缩放期间调用，使用 (v0, v1) 如果轴包含任何数据，则设置为轴上的数据限制，或 (-inf, +inf) 如果没有。

• 如果 v0 == v1 （可能达到某个浮点斜率），此方法返回此值周围的扩展间隔。
• 如果 (v0, v1) == (-inf, +inf) ，此方法返回适当的默认视图限制。
• 否则， (v0, v1) 未经修改而返回。

pan(numsteps)

[Deprecated]

笔记

3.3 版后已移除:

refresh()

[Deprecated]

笔记

3.3 版后已移除:

view_limits(vmin, vmax)

为范围从vmin到vmax选择一个刻度。

子类应重写此方法以更改定位器行为。

zoom(direction)

[Deprecated]

笔记

3.3 版后已移除:

class matplotlib.projections.polar.RadialTick(*args, **kwargs)

基类：matplotlib.axis.YTick

径向轴刻度。

此子类 YTick 提供径向记号，并对其重新定位进行一些小的修改，以便记号根据轴的限制进行旋转。这将导致正确垂直于脊椎的记号。启用“自动”旋转时，标签也会旋转为垂直于脊椎。

bbox是轴显示坐标中的边界2d边界框loc是数据坐标中的刻度位置size是点的刻度大小

update_position(loc)

使用标量设置数据坐标中的刻度位置 loc .

class matplotlib.projections.polar.ThetaAxis(*args, **kwargs)

基类：matplotlib.axis.XAxis

θ轴。

这将覆盖 XAxis 为角轴提供特殊外壳。

参数:

axes ： matplotlib.axes.Axesmatplotlib.axes.Axes

这个 Axes 创建的轴所属的。

pickradius浮动

安全壳试验的验收半径。另请参见 Axis.contains .

axis_name = 'theta'

标识轴的只读名称。

cla()

清除此轴。

class matplotlib.projections.polar.ThetaFormatter

基类：matplotlib.ticker.Formatter

用于格式化 θ 滴答标签。将本机弧度单位转换为度数并添加度数符号。

class matplotlib.projections.polar.ThetaLocator(base)

基类：matplotlib.ticker.Locator

用于定位theta ticks。

这与基础定位器的工作原理相同，只是在视图跨越整个圆的情况下。在这种情况下，将返回以前使用的每45度的默认位置。

autoscale()

[Deprecated]

笔记

3.2 版后已移除:

pan(numsteps)

[Deprecated]

笔记

3.3 版后已移除:

refresh()

[Deprecated] 根据当前限制刷新内部信息。

笔记

3.3 版后已移除.

set_axis(axis)

view_limits(vmin, vmax)

为范围从vmin到vmax选择一个刻度。

子类应重写此方法以更改定位器行为。

zoom(direction)

[Deprecated]

笔记

3.3 版后已移除:

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

基类：matplotlib.axis.XTick

θ轴刻度。

此子类 XTick 提供角度刻度，并对其重新定位进行一些小修改，以便根据刻度位置旋转刻度。这将导致正确垂直于弧形脊椎的刻度。

启用“自动”旋转时，标签也会旋转到与脊椎平行。这里也应用了标签填充，因为不可能使用通用轴转换来生成特定于刻度的填充。

bbox是轴显示坐标中的边界2d边界框loc是数据坐标中的刻度位置size是点的刻度大小

update_position(loc)

使用标量设置数据坐标中的刻度位置 loc .