Skip to content

tags: description: Функция atanh() вычисляет обратный гиперболический тангенс числа.

- mathematical functions pyspark

atanh(col)

Описание

Функция atanh() вычисляет обратный гиперболический тангенс числа.

Параметры

  • col: Column - числовое значение (должно быть в диапазоне (-1, 1))

Возвращаемое значение

Column - обратный гиперболический тангенс числа

Пример использования

from pyspark.sql.functions import atanh, lit
from pyspark.sql import SparkSession

# Создаем SparkSession
spark = SparkSession.builder.appName("atanh_example").getOrCreate()

# Создаем DataFrame с числами
data = [
    (-0.8,),    # atanh(-0.8) ≈ -1.099
    (-0.5,),    # atanh(-0.5) ≈ -0.549
    (0.0,),     # atanh(0) = 0
    (0.5,),     # atanh(0.5) ≈ 0.549
    (0.8,)      # atanh(0.8) ≈ 1.099
]
df = spark.createDataFrame(data, ["number"])

# Вычисляем обратные гиперболические тангенсы
df = df.withColumn("inverse_hyperbolic_tangent", atanh("number"))
df.show(truncate=False)

# Результат:
# +------+----------------------------+
# |number|inverse_hyperbolic_tangent  |
# +------+----------------------------+
# |-0.8  |-1.0986122886681098        |
# |-0.5  |-0.5493061443340548        |
# |0.0   |0.0                        |
# |0.5   |0.5493061443340548         |
# |0.8   |1.0986122886681098         |
# +------+----------------------------+

Примечания

  • Возвращает NULL, если входное значение NULL
  • Аргумент должен быть в диапазоне (-1, 1)
  • Обратный гиперболический тангенс определяется как 0.5 * ln((1 + x)/(1 - x))
  • Функция является нечетной: atanh(-x) = -atanh(x)
  • Полезно для:
  • Решения гиперболических уравнений
  • Вычислений в специальной теории относительности
  • Анализа цепных линий
  • Связанные функции:
  • tanh() - вычисление гиперболического тангенса
  • acosh() - вычисление обратного гиперболического косинуса
  • asinh() - вычисление обратного гиперболического синуса