amath(1)

NAME
amath - Simple command line calculator

SYNOPSIS
[ --noansi ] [ --shell | expression ]

DESCRIPTION
amath features a case sensitive command line interface, internal IEEE 754 calculations with 15 significant digits, calculations with real and complex numbers, variables and user defined functions, logarithmic and exponential functions, trigonometric and hyperbolic function and selected mathematical constants and rounding functions.

OPTIONS

--noansi
    Disable output of ANSI escape codes. Default is enable.

--shell
    Open an interactive shell.

OPERATORS
+           Mathematical addition
-           Mathematical subtraction
*           Mathematical multiplication
/           Mathematical division
^           Mathematical exponentiation
=           Assignment of variable values
|           Absolute value of number

VARIABLES AND CONSTANT
pi          Trigonometric constant
e           Euler's number
i           Imaginary unit
ins         Result of last calculation

MISCELLANEOUS FUNCTIONS
abs         Absolute value of number
sgn         Mathematical signum function
round       Round to nearest integer number
trunc       Discard fraction part of number
floor       Mathematical floor function
ceil        Mathematical ceiling function
sqrt        Square root function (exp 1/2)
cbrt        Cube root function (exp 1/3)
lb          Binary logarithm function (base 2)
ln          Natural logarithm function (base e)
lg          Common logarithm function (base 10)

TRIGONOMETRIC FUNCTIONS
sin         Trigonometric sine function
cos         Trigonometric cosine function
tan         Trigonometric tangent function
cot         Trigonometric cotangent function
sec         Trigonometric secant function
csc         Trigonometric cosecant function
crd         Trigonometric chord function
exsec       Trigonometric exsecant function
excsc       Trigonometric excosecant function
arcsin      Inverse trigonometric sine function
arccos      Inverse trigonometric cosine function
arctan      Inverse trigonometric tangent function
arccot      Inverse trigonometric cotangent function
arcsec      Inverse trigonometric secant function
arccsc      Inverse trigonometric cosecant function
arccrd      Inverse trigonometric chord function
arcexsec    Inverse trigonometric exsecant function
arcexcsc    Inverse trigonometric excosecant function

HYPERBOLIC FUNCTIONS
sinh        Hyperbolic sine function
cosh        Hyperbolic cosine function
tanh        Hyperbolic tangent function
coth        Hyperbolic cotangent function
sech        Hyperbolic secant function
csch        Hyperbolic cosecant function
arcsinh     Inverse hyperbolic sine function
arccosh     Inverse hyperbolic cosine function
arctanh     Inverse hyperbolic tangent function
arccoth     Inverse hyperbolic cotangent function
arcsech     Inverse hyperbolic secant function
arccsch     Inverse hyperbolic cosecant function

EARLY TRIGONOMETRIC FUNCTIONS
ver         Versed sine function
vcs         Versed cosine function
cvs         Coversed sine function
cvc         Coversed cosine function
hv          Haversed sine function
hvc         Haversed cosine function
hcv         Hacoversed sine function
hcc         Hacoversed cosine function
arcver      Inverse versed sine function
arcvcs      Inverse versed cosine function
arccvs      Inverse coversed sine function
arccvc      Inverse coversed cosine function
archv       Inverse haversed sine function
archvc      Inverse haversed cosine function
archcv      Inverse hacoversed sine function
archcc      Inverse hacoversed cosine function

STATEMENTS
clear       Clear console window
def         Define function
delete      Delete variable or function
digits      Set number of significant digits
eval        Evaluate arithmetic expression
execute     Execute statements in a file
functions   Show list of user defined functions
input       Change numeral input system
help        Show basic help text
output      Change numeral output system
list        Show content of a directory
show        Show content of a file
load        Load variable and functions from file
save        Save variable and functions to file
variables   Show list of variables
version     Show version string
memory      Show internal memory usage
exit        Exit program

EXIT STATUS
amath exits 0 on success and >0 if an error occurs.

EXAMPLES
Add two numbers:
    $ amath 1.3 + 2.6

Find cosine of pi/2:
    $ amath "cos(pi/2)"

Find square root of minus 25:
    $ amath "sqrt(-25)"

Show only 5 digits in the result of a division:
    $ amath "digits 5;34/11"

Script block with functions:
    round(1.5461);round(-1.5461);
    ceil(43.5461);ceil(-43.5461);
    floor(39.9531);floor(-39.9531);
    trunc(23.827);trunc(-23.827);
    sqrt(100);sqrt(52.23);

Script block with user defined functions:
    f(x)=x*2+1;
    g(y)=y^2+y*1.5+2;
    a=2;b=3;c=a+b;
    f(2.2);c+1.1;

BUGS

•   If amath is linked with system libraries (-lm) sometimes the real part of a result of arccosh of a complex number, is negative instead of positive.

•   coth() with complex numbers is inaccurate on the 14th digit.

    Please report any other bugs that you encounter via:
    https://gitlab.com/rnger/amath/issues.

HOMEPAGE
https://amath.innolan.net/

SEE ALSO
amathc(3), amathr(3), amathi(3)

AUTHORS
Written by Carsten Sonne Larsen <cs@innolan.net>. Floating point to string conversion is based on software written by Ryan Juckett. The code in complex calculations is derived from software written by Stephen L. Moshier. The code in MemSet and MemCopy is derived from software contributed to Berkeley by Mike Hibler and Chris Torek.