polar

Calc Software Package for Number Calc

NAME
    polar - specify a complex number by modulus (radius) and argument (angle)

SYNOPSIS
    polar(r, t [, eps])

TYPES
    r		real
    t		real
    eps		nonzero real, defaults to epsilon()

    return	number (real or complex)

DESCRIPTION
    Returns the real or complex number with real and imaginary parts
    multiples of epps nearest or next to nearest to r * cos(t) and
    r * sin(t) respectively.  The error for each part will be less
    than 0.75 * abs(eps), but usually less than 0.5 * abs(eps).

EXAMPLE
    ; print polar(2, 0), polar(1, 2, 1e-5), polar(1, 2, 1e-10)
    2 -.41615+.9093i -.4161468365+.9092974268i

    ; pi = pi(1e-10); eps = 1e-5
    ; print polar(2, pi/4, eps), polar(2, pi/2, eps), polar(2, 3*pi/4, eps)
    1.41421+1.41421i 2i -1.414215+1.41421i

LIMITS
    none

LINK LIBRARY
    COMPLEX *c_polar(NUMBER *r, NUMBER *t, NUMBER *eps);

SEE ALSO
    abs, arg, re, im

## Copyright (C) 1999  Landon Curt Noll
##
## Calc is open software; you can redistribute it and/or modify it under
## the terms of the version 2.1 of the GNU Lesser General Public License
## as published by the Free Software Foundation.
##
## Calc is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
## or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU Lesser General
## Public License for more details.
##
## A copy of version 2.1 of the GNU Lesser General Public License is
## distributed with calc under the filename COPYING-LGPL.  You should have
## received a copy with calc; if not, write to Free Software Foundation, Inc.
## 59 Temple Place, Suite 330, Boston, MA  02111-1307, USA.
##
## @(#) $Revision: 29.4 $
## @(#) $Id: polar,v 29.4 2006/05/07 07:25:46 chongo Exp $
## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/polar,v $
##
## Under source code control:	1995/10/25 04:03:46
## File existed as early as:	1995
##
## chongo <was here> /\oo/\	http://www.isthe.com/chongo/
## Share and enjoy!  :-)	http://www.isthe.com/chongo/tech/comp/calc/