ATANH

Syntaxe

Paramètres

Description

Cette fonction permet de retourner la tangente hyperbolique inverse d'un nombre.

Remarques

• Fonction trigonométrique hyperbolique inverse : ATANH calcule la tangente hyperbolique inverse d'un nombre donné. Contrairement à ATAN, acceptant toutes les valeurs réelles, ATANH est limitée à des valeurs strictement comprises entre -1 et 1, car la tangente hyperbolique ne peut pas dépasser ces bornes.
• Paramètre strictement limité : Le paramètre number doit être compris entre -1 et 1 (exclus). Toute valeur en dehors de cet intervalle provoquera une erreur. Cette restriction est importante à respecter pour éviter les erreurs lors de l'évaluation des mesures ou colonnes calculées dans DAX.
• Résultat en radians : Le résultat retourné par ATANH est toujours exprimé en radians. Pour des analyses nécessitant des degrés, il faudra convertir le résultat en utilisant la fonction DEGREES(ATANH(number)), afin que les valeurs soient interprétables dans un contexte de mesure angulaire.
• Acceptation de valeurs positives et négatives : ATANH peut traiter à la fois des valeurs positives et négatives, ce qui permet de gérer des ratios ou des transformations symétriques. Cela la rend utile pour normaliser des données ou effectuer des calculs statistiques impliquant des valeurs comprises entre -1 et 1.
• Utilisation dans les colonnes et mesures DAX : La fonction peut être appliquée à une colonne entière ou utilisée dans une mesure pour calculer la tangente hyperbolique inverse ligne par ligne. Cela permet de créer de nouvelles colonnes calculées ou d'effectuer des transformations avancées dans Power BI ou Excel.
• Applications pratiques en statistiques et finance : ATANH est souvent utilisée pour transformer des données asymétriques ou pour linéariser des relations hyperboliques dans des modèles statistiques. Elle est utile dans les analyses financières, les transformations de ratios ou pour préparer des données pour des modèles de régression.
• Différence avec ATAN : ATAN calcule l'arctangente classique pour toute valeur réelle, tandis qu'ATANH calcule l'inverse de la tangente hyperbolique, mais seulement pour les valeurs comprises entre -1 et 1. Cette distinction est importante pour choisir la fonction adaptée à un modèle ou à une transformation mathématique spécifique.
• Précision et comportement aux limites : Lorsque les valeurs approchent les bornes -1 ou 1, le résultat de ATANH tend vers l'infini positif ou négatif. Il est donc recommandé de vérifier ou de filtrer les données avant utilisation pour éviter des valeurs extrêmes pouvant fausser les mesures ou provoquer des erreurs de calcul.