degrees

degrees is useful whenever you compute angles using trigonometric or inverse trigonometric functions, which return values in radians, but need the result expressed in degrees for display or comparison. For example, you can convert the output of atan2 or acos into a degree value that's easier to interpret.

Usage#

Syntax#

degrees(a)

Parameters#

Name	Type	Required	Description
`a`	real	Yes	The angle in radians to convert.

Returns#

The angle in degrees corresponding to the input radian value.

Example#

Use degrees to convert an angle in radians to degrees.

Query

print result = degrees(pi())

Run in Playground

Output

result
180

radians: Converts degrees to radians. Use it for the inverse conversion before passing values to trigonometric functions.
pi: Returns the constant π. Use it in manual radian-to-degree conversions as an alternative to degrees.
cos: Returns the cosine of an angle in radians. Use degrees to convert its output for display.
sin: Returns the sine of an angle in radians. Use degrees to convert angular results.
atan2: Returns an angle in radians from two coordinates. Use degrees to convert its output to degrees.

Other query languages#

Splunk SPL users

Splunk SPL doesn't include a built-in degrees() function. You compute the conversion manually by multiplying the radian value by 180 / pi().

Splunk example

| eval angle_deg = angle_rad * (180 / pi())

APL equivalent

['sample-http-logs']
| extend angle_deg = degrees(angle_rad)

ANSI SQL users

In SQL Server and PostgreSQL, DEGREES() is a built-in function with identical semantics to the APL version.

SQL example

SELECT DEGREES(angle_rad) AS angle_deg FROM logs