c_cpp/etc/calc/help/atan2

   1 NAME
   2     atan2 - angle to point
   3
   4 SYNOPSIS
   5     atan2(y, x, [,eps])
   6
   7 TYPES
   8     y           real
   9     x           real
  10     eps         nonzero real, defaults to epsilon()
  11
  12     return      real
  13
  14 DESCRIPTION
  15     If x and y are not both zero, atan2(y, x, eps) returns, as a multiple of
  16     eps with error less than abs(eps), the angle t such that
  17     -pi < t <= pi and x = r * cos(t), y = r * sin(t), where
  18     r > 0.  Usually the error does not exceed abs(eps)/2.
  19
  20     Note that by convention, y is the first argument; if x > 0,
  21     atan2(y, x) = atan(y/x).
  22
  23     To conform to the 4.3BSD ANSI/IEEE 754-1985 math lib, atan2(0,0)
  24     returns 0.
  25
  26 EXAMPLE
  27     ; print atan2(0,0), atan2(1,sqrt(3)), atan2(17,53,1e-100)
  28     0 ~.52359877559829887307 ~.31038740713235146535
  29
  30 LIMITS
  31     none
  32
  33 LINK LIBRARY
  34     NUMBER *qatan2(NUMBER *y, *x, *acc)
  35
  36 SEE ALSO
  37     acos, asin, atan, cos, epsilon, sin, tan
  38
  39 ## Copyright (C) 1999  Landon Curt Noll
  40 ##
  41 ## Calc is open software; you can redistribute it and/or modify it under
  42 ## the terms of the version 2.1 of the GNU Lesser General Public License
  43 ## as published by the Free Software Foundation.
  44 ##
  45 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  46 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  47 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  48 ## Public License for more details.
  49 ##
  50 ## A copy of version 2.1 of the GNU Lesser General Public License is
  51 ## distributed with calc under the filename COPYING-LGPL.  You should have
  52 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  53 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  54 ##
  55 ## @(#) $Revision: 30.1 $
  56 ## @(#) $Id: atan2,v 30.1 2007/03/16 11:10:42 chongo Exp $
  57 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/atan2,v $
  58 ##
  59 ## Under source code control:   1994/03/19 01:40:26
  60 ## File existed as early as:    1994
  61 ##
  62 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  63 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/