Trigonometric Operation¶
Applies a selected trigonometric or inverse trigonometric function to a numeric input. Supports sine, cosine, tangent, their inverses (asin, acos, atan), and hyperbolic variants (sinh, cosh, tanh). Can interpret the input as degrees for forward trig functions and optionally return inverse trig results in degrees.
Usage¶
Use this node whenever you need trigonometric calculations in a workflow, such as converting angles to ratios, computing angles from ratios, or working with hyperbolic functions. Set whether the input angle is given in degrees via use_degrees for sin/cos/tan, and choose the appropriate operation from the list. For inverse functions, ensure the input value is within the valid domain.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| value | True | FLOAT | Primary numeric input. For sin/cos/tan, this is the angle; its unit depends on use_degrees. For inverse functions, this is a unitless ratio in the domain [-1, 1]. For hyperbolic functions, this is a real number argument. | 45.0 |
| operation | True | STRING | The trigonometric operation to perform. One of: sin, cos, tan, asin, acos, atan, sinh, cosh, tanh. | sin |
| use_degrees | True | BOOLEAN | When true, the input for sin/cos/tan is interpreted as degrees. For inverse functions, when true, the output angle is returned in degrees; when false, the output is in radians. | true |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| result | FLOAT | The numeric result of the chosen trigonometric operation. For inverse functions, the angle is in degrees if use_degrees is true, otherwise radians. | 0.70710678 |
Important Notes¶
- Angle units (sin/cos/tan): If use_degrees is true, the node interprets the input angle in degrees; otherwise it treats it as radians.
- Angle units (asin/acos/atan): The input must be a unitless ratio in [-1, 1]. The output angle is returned in degrees when use_degrees is true, or radians when false.
- Domain checks: asin and acos validate that the input is within [-1, 1]. Out-of-range inputs return 0.0.
- Edge behavior for tan: Near odd multiples of 90 degrees (or π/2 radians), tan grows very large in magnitude and can produce extreme values.
- Hyperbolic functions: sinh, cosh, tanh accept any real input and return real outputs.
- Error handling: On invalid inputs or unknown operations, the node returns 0.0.
Troubleshooting¶
- Result is 0.0 for inverse functions: Ensure the input value is within [-1, 1].
- Unexpected magnitude for tan: Avoid angles near 90°, 270° (or π/2, 3π/2 radians) where tan is undefined and numerically unstable.
- Units confusion: For sin/cos/tan, confirm whether your angle is degrees or radians and set use_degrees accordingly. For asin/acos/atan, remember the input is a ratio, not an angle.
- Clamped UI range: The input field UI ranges from -360 to 360, which is suitable for many angle uses but does not limit function domains (e.g., ratios for inverse functions); ensure your value is meaningful for the selected operation.