Calculates trigonometric values.

Description

Primary functions

The Cos function returns the cosine of its argument, an angle specified in radians.

The Cot function returns the cotangent of its argument, an angle specified in radians.

The Sin function returns the sine of its argument, an angle specified in radians.

The Tan function returns the tangent of its argument, an angle specified in radians.

Inverse functions

The Acos function returns the arccosine, or inverse cosine, of its argument. The arccosine is the angle whose cosine is the argument. The returned angle is given in radians in the range 0 (zero) to π.

The Acot function returns the principal value of the arccotangent, or inverse cotangent, of its argument. The returned angle is given in radians in the range 0 (zero) to π.

The Asin function returns the arcsine, or inverse sine, of its argument. The arcsine is the angle whose sine is the argument. The returned angle is given in radians in the range -π/2 to π/2.

The Atan function returns the arctangent, or inverse tangent, of its argument. The arctangent is the angle whose tangent is the argument. The returned angle is given in radians in the range -π/2 to π/2.

The Atan2 function returns the arctangent, or inverse tangent, of the specified x and y coordinates as arguments. The arctangent is the angle from the x-axis to a line that contains the origin (0, 0) and a point with coordinates (x, y). The angle is given in radians between -π and π, excluding -π. A positive result represents a counterclockwise angle from the x-axis; a negative result represents a clockwise angle. Atan2( ab ) equals Atan( b/a ), except that a can equal 0 (zero) with the Atan2 function.

Helper functions

The Degrees function converts radians to degrees. π radians equals 180 degrees.

The Pi function returns the transcendental number π, which begins 3.141592...

Notes

If you pass a single number to these functions, the return value is a single result. If you pass a single-column table that contains numbers, the return value is a single-column table of results, one result for each record in the argument's table. If you have a multi-column table, you can shape it into a single-column table, as working with tables describes.

If an argument would result in an undefined value, the result is blank. This can happen, for example, when using inverse functions with arguments that are out of range.

Syntax

Primary Functions

• Radians - Required. Angle to operate on.

Cos( SingleColumnTable )
Cot( SingleColumnTable )
Sin( SingleColumnTable )
Tan( SingleColumnTable )

• SingleColumnTable - Required. A single-column table of angles to operate on.

Inverse Functions

Acos( Number )
Acot( Number )
Asin( Number )
Atan( Number )

• Number - Required. Number to operate on.

Acos( SingleColumnTable )
Acot( SingleColumnTable )
Asin( SingleColumnTable )
Atan( SingleColumnTable )

• SingleColumnTable - Required. A single-column table of numbers to operate on.

Atan2( X, Y )

• X - Required. X-axis coordinate.
• Y - Required. Y-axis coordinate.

Helper Functions

Pi()

• Degrees - Required. Angle in degrees to convert to radians.

Examples

Single-column table

The examples in this section use a data source that's named ValueTable and that contains the following data. The last record in the table is π/2 radians or 90 degrees.

 Formula Description Result Cos( ValueTable ) Returns the cosine of each number in the table. img { max-width: none } Cot( ValueTable ) Returns the cotangent of each number in the table. img { max-width: none } Sin( ValueTable ) Returns the sine of each number in the table. img { max-width: none } Tan( ValueTable ) Returns the tangent of each number in the table. img { max-width: none } Acos( ValueTable ) Returns the arccosine of each number in the table. img { max-width: none } Acot( ValueTable ) Returns the arccotangent of each number in the table. img { max-width: none } Asin( ValueTable ) Returns the arcsine of each number in the table. img { max-width: none } Atan( ValueTable ) Returns the arctangent of each number in the table. img { max-width: none } Degrees( ValueTable ) Returns the equivalent number of degrees for each number in the table, assumed to be angles in radians. img { max-width: none } Radians( ValueTable ) Returns the equivalent number of radians for each number in the table, assumed to be angles in degrees. img { max-width: none }