matplotlib.axes.Axes.secondary_xaxis#

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

为当前 Axes 添加第二个 x 轴。

此轴通常用于为在坐标轴上绘制的数据显示第二个 x 标度（x-scale）。

参数:

location{'top', 'bottom', 'left', 'right'} 或 float

放置辅助轴的位置。对于 orientation='x'，字符串可以是 'top' 或 'bottom'；对于 orientation='y'，可以是 'right' 或 'left'。浮点数表示在新坐标轴在父坐标轴上的相对位置，0.0 表示底部（或左侧），1.0 表示顶部（或右侧）。

functions函数组成的 2-tuple，或带有逆变换的 Transform

如果提供由函数组成的 2-tuple，用户需指定变换函数及其逆函数。例如，functions=(lambda x: 2 / x, lambda x: 2 / x) 将是一个因子为 2 的倒数变换。这两个函数都必须能够接收 numpy 数组作为输入。

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

参见辅助轴（Secondary Axis）获取这些转换的示例。

transformTransform, 可选

如果指定了 transform，location 将相对于此变换（沿轴方向）而不是父轴放置。例如，辅助 x 轴将使用提供的 y 变换和父轴的 x 变换。

自 3.9 版本新增。

返回:

axaxes._secondary_axes.SecondaryAxis: 返回的 Axes 对象叠加在原始 Axes 之上，除互补轴外的所有组件均被隐藏。您可以修改互补轴，例如设置刻度或轴标签。但是，它并非设计用于容纳数据，因此不应在其上调用任何绘图方法。其范围（limits）通过指定的变换从父 Axes 派生，在辅助轴上设置范围（例如通过 set_xlim 或 set_ylim）不会产生任何效果。

其他参数: