> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/data-logic/mathmetical-operations/trigonometry.md).

# Trigonometry

Ce bloc de fonction effectue des opérations trigonométriques courantes en degrés et avec des rapports simples. Il est idéal pour convertir des angles en valeurs de rapport (`Sin`/`Tan`) ou pour convertir des rapports en angles inverses (`Asin`/`Atan`) pour des tâches de mesure et de géométrie.

## 📥 Entrées

`Number`\
Fournissez une valeur numérique. Pour les fonctions directes (`Sin`, `Tan`) donnez un angle en degrés. Pour les fonctions inverses (`Asin`, `Atan`) fournissez une valeur de rapport (la plage valide dépend de la fonction).

## 📤 Sorties

`Number`\
Le résultat numérique de l'opération trigonométrique sélectionnée. Les sorties des opérations inverses sont données en degrés.

## 🕹️ Contrôles

`Method`\
Choisissez l'opération trigonométrique à appliquer. Les choix disponibles incluent typiquement `Sin`, `Asin`, `Tan` et `Atan`.

## 🎨 Fonctionnalités

* Sélection simple entre fonctions trigonométriques directes et inverses via un menu déroulant.
* Accepte une seule entrée numérique et renvoie une seule sortie numérique.
* Utilisation des degrés pour les entrées et sorties d'angles afin de rester intuitive pour les utilisateurs non techniques.

## ⚙️ Mécanisme d'exécution

Lorsque le bloc s'exécute, il applique l'opération sélectionnée à la valeur fournie :

* Pour `Sin` et `Tan` : le bloc considère l'entrée comme un angle en degrés, effectue la conversion interne nécessaire et renvoie la valeur de rapport correspondante.
* Pour `Asin` et `Atan` : le bloc considère l'entrée comme un rapport et renvoie l'angle correspondant en degrés.

Cela permet de passer facilement de la conversion d'un angle en rapport (utile pour projeter des longueurs ou calculer des composantes) et de convertir des rapports mesurés en angles pour des rapports ou de la logique de contrôle.

## 📝 Instructions d'utilisation

1. Renseignez une valeur numérique dans l'entrée `Number`.
2. Sélectionnez l'opération souhaitée via le contrôle `Method`.
3. Lisez le résultat à la sortie `Number`.
   * Pour convertir un angle en rapport, utilisez `Sin` ou `Tan`.
   * Pour convertir un rapport en angle, utilisez `Asin` ou `Atan`.

## 💡 Astuces

* Utilisez `Measure Position Distance` pour obtenir les distances X et Y entre deux points, puis `Divide` pour obtenir un rapport et `Atan` pour calculer l'angle entre eux.
* Pour calculer une hypothénuse à partir de longueurs de côtés, combinez `Square Root` et `Add` (après avoir mis au carré les composantes avec `Multiply`), puis utilisez `Asin` ou `Atan` si besoin pour obtenir des angles.
* Associez à `Round` pour afficher des valeurs d'angle lisibles (par ex. arrondir à 1 ou 2 décimales).
* Utilisez `Absolute` avant les fonctions inverses si seule la magnitude du rapport vous intéresse.
* Combinez avec `Line Geometry` lorsque vous travaillez avec des lignes dessinées : ce bloc permet de convertir entre rapports mesurés et angles pour les annotations ou la logique en aval.

## 🛠️ Dépannage

* Si les résultats semblent anormalement grands ou petits, vérifiez si vous devez fournir un angle (en degrés) ou un rapport à l'entrée `Number` en fonction du `Method` sélectionné.
* Pour les fonctions inverses, assurez-vous que les rapports en entrée sont dans des plages valides (par exemple, des valeurs hors domaine valide pour `Asin` ne donneront pas d'angles significatifs).