Trigonometric Functions

acos()

Computes the angle in radians whose cosine is a given number. The resulting radians will be in the range [0, 𝜋]. If the result is needed in degrees (range [0º, 180º]), you can convert it using the degrees() function.

Syntax	`acos(<num>)`
Arguments	Name	Type	Description
Arguments	`<num>`	Numeric	The cosine value in the range of [-1,1]
Return Type	`DOUBLE`

UQL
return acos(0.5) * 180 / pi() as degree

Result:

degree
60

asin()

Computes the angle in radians whose sine is a given number. The resulting radians will be in the range [-𝜋/2, 𝜋/2]. If the result is needed in degrees (range [-90º, 90º]), you can convert it using the degrees() function.

Syntax	`asin(<num>)`
Arguments	Name	Type	Description
Arguments	`<num>`	Numeric	The sine value in the range of [-1,1]
Return Type	`DOUBLE`

UQL
return asin(0.5) * 180 / pi() as degree

Result:

degree
30

atan()

Computes the angle in radians whose tangent is a given number. The resulting radians will be in the range [-𝜋/2, 𝜋/2]. If the result is needed in degrees (range [-90º, 90º]), you can convert it using the degrees() function.

Syntax	`atan(<num>)`
Arguments	Name	Type	Description
Arguments	`<num>`	Numeric	The tangent value
Return Type	`DOUBLE`

UQL
return atan(1) * 180 / pi() as degree

Result:

degree
45

cos()

Computes the cosine of an angle expressed in radians. The output will be in the range [-1, 1]. If the angle is in degrees, you can convert it to radians using the radians() function.

Syntax	`cos(<radians>)`
Arguments	Name	Type	Description
Arguments	`<radians>`	Numeric	The angle expressed in radian
Return Type	`DOUBLE`

UQL
return cos(60 * pi() / 180)

Result:

cos(60 * pi() / 180)
0.5

cot()

Computes the cotangent of an angle expressed in radians. The output will be in the range (−∞, −1] ∪ [1, +∞). If the angle is in degrees, you can convert it to radians using the radians() function.

Syntax	`cot(<radians>)`
Arguments	Name	Type	Description
Arguments	`<radians>`	Numeric	The angle expressed in radian; `cot(0)` is undefined
Return Type	`DOUBLE`

UQL
return cot(45 * pi() / 180)

Result:

cot(45 * pi() / 180)
1

sin()

Computes the sine of an angle expressed in radians. The output will be in the range [-1, 1]. If the angle is in degrees, you can convert it to radians using the radians() function.

Syntax	`sin(<radians>)`
Arguments	Name	Type	Description
Arguments	`<radians>`	Numeric	The angle expressed in radian
Return Type	`DOUBLE`

UQL
return sin(30 * pi() / 180)

Result:

sin(30 * pi() / 180)
0.5

tan()

Computes the tangent of an angle expressed in radians. The output will be in the range (−∞, +∞). If the angle is in degrees, you can convert it to radians using the radians() function.

Syntax	`tan(<radians>)`
Arguments	Name	Type	Description
Arguments	`<radians>`	Numeric	The angle expressed in radian
Return Type	`DOUBLE`

UQL
return tan(45 * pi() / 180)

Result:

tan(45 * pi() / 180)
1