matplotlib.axes.Axes.secondary_xaxis#
- Axes.secondary_xaxis(location, functions=None, *, transform=None, **kwargs)[源代码]#
向此
Axes
添加第二个X轴。例如,如果我们想为X轴上绘制的数据添加第二个刻度。
- 参数:
- location{'top', 'bottom', 'left', 'right'} 或浮点数
放置次级轴的位置。字符串可以是 'top' 或 'bottom' 用于 orientation='x',以及 'right' 或 'left' 用于 orientation='y'。浮点数表示在新 Axes 上放置新 Axes 的相对位置,0.0 表示底部(或左侧),1.0 表示顶部(或右侧)。
- functionsfunc 的 2 元组,或带有逆变换的 Transform
如果是函数的 2 元组,用户需指定转换函数及其逆函数。即
functions=(lambda x: 2 / x, lambda x: 2 / x)
将是因子为 2 的倒数变换。两个函数都必须接受 numpy 数组作为输入。用户也可以直接提供
transforms.Transform
的子类,只要它具有逆变换。参见次级轴查看进行这些转换的示例。
- transform
Transform
, 可选 如果指定,location 将相对于此变换(沿轴方向)而不是父轴放置。即次级 X 轴将使用提供的 Y 变换和父级的 X 变换。
自 3.9 版本新增。
- 返回:
- axaxes._secondary_axes.SecondaryAxis
- 其他参数:
- **kwargs
Axes
属性。 其他杂项 Axes 参数。
- **kwargs
警告
此方法在 3.1 版中是实验性的,API 可能会更改。
示例
主轴显示频率,次轴显示周期。
要添加相对于数据的次级轴,可以将变换传递给新轴。