Next: asLong() Up: MacAnova Help File Previous: asciisave()   Contents


asin(x [, degrees:T or radians:T or cycles:T]), x REAL or a structure
  with REAL components value in radians (default), cycles, or degrees as
  specified by option "angles" or the optional keyword

Keywords: transformations
asin(x) computes the inverse sine of the elements of x, where x is a
REAL scalar, vector, matrix or array.  The result has the same shape as
x.  sin(asin(x)) is the same as x except for rounding error.

The units of the result are radians, degrees or cycles as determined by
the value of option 'angles'.  The default is radians.  See subtopic

asin(x, radians:T), asin(x, degrees:T), asin(x, cycles:T) return results
in the indicated units, regardless of the value of option 'angles'.

When any element of x is MISSING or is above 1 or below -1, the
corresponding element of the result is MISSING and a warning message is

When x is a structure, all of whose non-structure components are REAL,
asin(x [,UNITS:T]), where UNITS is one of 'radians', 'degrees' or
'cycles', is a structure of the same shape and with the same component
names as x with each non-structure component transformed by asin().

  Cmd> vector(asin(.5),asin(.5,degrees:T),asin(.5,cycles:T))
  (1)      0.5236          30    0.083333

See topic 'transformations' for information on asin().

Gary Oehlert 2003-01-15