> 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/spanish/function-blocks/blocks-reference/data-logic/mathmetical-operations/trigonometry.md).

# Trigonometry

Este bloque de función realiza operaciones trigonométricas comunes usando grados y razones simples. Es ideal para convertir ángulos a valores de razón (`Sin`/`Tan`) o convertir razones de vuelta a ángulos (funciones inversas como `Asin`/`Atan`) para tareas de medición y geometría.

## 📥 Entradas

`Number`\
Proporciona un valor numérico. Para funciones directas (`Sin`, `Tan`) introduce un ángulo en grados. Para funciones inversas (`Asin`, `Atan`) introduce un valor de razón (el rango depende de la función).

## 📤 Salidas

`Number`\
El resultado numérico de la operación trigonométrica seleccionada. Las salidas de las operaciones inversas están en grados.

## 🕹️ Controles

`Method`\
Elige la operación trigonométrica a aplicar. Las opciones habituales incluyen `Sin`, `Asin`, `Tan` y `Atan`.

## 🎨 Características

* Selección sencilla entre funciones trigonométricas directas e inversas mediante un menú desplegable.
* Acepta una sola entrada numérica y devuelve una sola salida numérica.
* Usa grados para entradas y salidas angulares, lo que resulta más intuitivo para usuarios no técnicos.

## ⚙️ Mecanismo de ejecución

Al ejecutarse, el bloque aplica la operación seleccionada al valor que proporciones:

* Para `Sin` y `Tan`: el bloque trata la entrada como grados, la convierte internamente a la representación necesaria y devuelve el valor de la razón resultante.
* Para `Asin` y `Atan`: el bloque trata la entrada como una razón y devuelve el ángulo correspondiente en grados.

Esto te permite alternar entre convertir un ángulo en una razón (útil para proyectar longitudes o calcular componentes) y convertir razones medidas de vuelta a ángulos para informes o lógica de control.

## 📝 Instrucciones de uso

1. Alimenta un valor numérico al input `Number`.
2. Selecciona la operación deseada mediante el control `Method`.
3. Lee el resultado en la salida `Number`.
   * Para conversiones de ángulo a razón usa `Sin` o `Tan`.
   * Para conversiones de razón a ángulo usa `Asin` o `Atan`.

## 💡 Consejos y trucos

* Usa `Measure Position Distance` para obtener las distancias X e Y entre dos puntos, luego emplea `Divide` para obtener una razón y `Atan` para calcular el ángulo entre ellos.
* Para calcular una hipotenusa a partir de lados, combina `Square Root` y `Add` (después de elevar los componentes con `Multiply`) y luego usa `Asin` o `Atan` según necesites obtener ángulos.
* Empareja con `Round` para mostrar valores angulares más legibles (por ejemplo, redondear a 1 o 2 decimales).
* Usa `Absolute` antes de funciones inversas cuando solo te interese la magnitud de una razón.
* Combínalo con `Line Geometry` al trabajar con líneas dibujadas: utiliza este bloque para convertir entre razones medidas y ángulos para anotaciones o lógica posterior.

## 🛠️ Solución de problemas

* Si los resultados parecen inesperadamente grandes o pequeños, revisa si debes proporcionar un ángulo (en grados) o una razón al input `Number` según el `Method` seleccionado.
* Para funciones inversas, asegúrate de que las razones de entrada estén dentro de los rangos válidos (por ejemplo, valores fuera del dominio válido para `Asin` no producirán ángulos significativos).