matplotlib.axes.Axes.secondary_xaxis
- Axes.secondary_xaxis(location, functions=None, *, transform=None, **kwargs)[исходный код]
-
Добавить вторую ось X к этому объекту
Axes.Например, если нужно добавить вторую шкалу для данных, отображаемых на оси X.
- Параметры:
-
- location{'top', 'bottom', 'left', 'right'} или float
-
Положение вторичной оси. Для orientation='x' строковые значения могут быть 'top' или 'bottom', а для orientation='y' — 'right' или 'left'. Значение с плавающей точкой задаёт относительное положение новой оси на родительском объекте Axes: 0.0 соответствует низу (или левому краю), а 1.0 — верху (или правому краю).
- functionsпара функций или Transform с обратным преобразованием
-
Если задана пара функций, пользователь указывает функцию преобразования и обратную к ней. Например,
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 может измениться.
Примеры
На основной оси показана частота, а на вторичной — период.
(
Source code,2x.png,png)Чтобы добавить вторичную ось относительно данных, можно передать преобразование новой оси.
(
Source code,2x.png,png)
Примеры использования matplotlib.axes.Axes.secondary_xaxis
© 2012–2026 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.secondary_xaxis.html