matplotlib.axes.Axes.secondary_yaxis#

Axes.secondary_yaxis(location, functions=None, *, transform=None, **kwargs)[源代码]#

为此 Axes 添加第二个 y 轴。

此轴通常用于为绘制在 Axes 上的数据显示第二个 y 轴刻度。

参数:
location{'top', 'bottom', 'left', 'right'} 或 float

放置辅助轴的位置。对于 orientation='x',字符串可以是 'top' 或 'bottom';对于 orientation='y',字符串可以是 'right' 或 'left'。浮点数表示在新 Axes 在父 Axes 上放置的相对位置,0.0 为底部(或左侧),1.0 为顶部(或右侧)。

functions函数组成的 2-元组,或带有逆变换的 Transform

如果是函数的 2-元组,用户需指定转换函数及其逆函数。例如,functions=(lambda x: 2 / x, lambda x: 2 / x) 将是一个因子为 2 的倒数变换。这两个函数都必须接受 numpy 数组作为输入。

用户也可以直接提供 transforms.Transform 的子类,只要它具有逆变换即可。

有关进行此类转换的示例,请参阅 辅助轴。

transformTransform, 可选

如果指定了 transform,location 将相对于此变换(沿轴方向)放置,而不是相对于父级的轴。即辅助 x 轴将使用提供的 y 变换和父级的 x 变换。

自 3.9 版本新增。

返回:
axaxes._secondary_axes.SecondaryAxis

返回的 Axes 叠加在原始 Axes 之上,除互补轴以外的所有组件均被隐藏。您可以修改互补轴,例如通过设置刻度或轴标签。但是,它并非设计用于存储数据,因此您不应在其上调用任何绘图方法。其范围从父 Axes 通过指定的变换导出,在辅助轴上设置范围(例如通过 set_xlim 或 set_ylim)无效。

其他参数:
**kwargsAxes 属性。

其他杂项 Axes 参数。

警告

此方法自 3.1 版本起为实验性功能,API 可能会有变化。

示例

添加一个将弧度转换为角度的辅助轴

(源代码, 2x.png, png)

若要添加相对于数据的辅助轴,可以将变换传递给新轴。

(源代码, 2x.png, png)

使用 matplotlib.axes.Axes.secondary_yaxis 的示例#

次坐标轴

次坐标轴