NAME

       math - Tcl Math Library

SYNOPSIS

       package require Tcl  8.2

       package require math  ?1.2.5?

       ::math::cov value value ?value ...?

       ::math::integrate list of xy value pairs

       ::math::fibonacci n

       ::math::max value ?value ...?

       ::math::mean value ?value ...?

       ::math::min value ?value ...?

       ::math::product value ?value ...?

       ::math::random ?value1? ?value2?

       ::math::sigma value value ?value ...?

       ::math::stats value value ?value ...?

       ::math::sum value ?value ...?

_________________________________________________________________________________________________

DESCRIPTION

       The math package provides utility math functions.

       Besides  a  set  of  basic  commands,  available  via  the  package  math,  there are more
       specialised packages:

       •      math::bigfloat - Arbitrary-precision floating-point arithmetic

       •      math::bignum - Arbitrary-precision integer arithmetic

       •      math::calculus::romberg - Robust integration methods for functions of one variable,
              using Romberg integration

       •      math::calculus - Integration of functions, solving ordinary differential equations

       •      math::combinatorics  - Procedures for various combinatorial functions (for instance
              the Gamma function and "k out of n")

       •      math::complexnumbers - Complex number arithmetic

       •      math::constants - A set of well-known mathematical constants, such as  Pi,  E,  and
              the golden ratio

       •      math::fourier - Discrete Fourier transforms

       •      math::fuzzy - Fuzzy comparisons of floating-point numbers

       •      math::geometry - 2D geometrical computations

       •      math::interpolate - Various interpolation methods

       •      math::linearalgebra - Linear algebra package

       •      math::optimize - Optimization methods

       •      math::polynomials   -   Polynomial   arithmetic  (includes  families  of  classical
              polynomials)

       •      math::rationalfunctions - Arithmetic of rational functions

       •      math::roman - Manipulation (including arithmetic) of Roman numerals

       •      math::special - Approximations of special functions from mathematical physics

       •      math::statistics - Statistical operations and tests

BASIC COMMANDS

       ::math::cov value value ?value ...?
              Return the coefficient of variation expressed as percent of  two  or  more  numeric
              values.

       ::math::integrate list of xy value pairs
              Return  the  area under a "curve" defined by a set of x,y pairs and the error bound
              as a list.

       ::math::fibonacci n
              Return the n'th Fibonacci number.

       ::math::max value ?value ...?
              Return the maximum of one or more numeric values.

       ::math::mean value ?value ...?
              Return the mean, or "average" of one or more numeric values.

       ::math::min value ?value ...?
              Return the minimum of one or more numeric values.

       ::math::product value ?value ...?
              Return the product of one or more numeric values.

       ::math::random ?value1? ?value2?
              Return a random number.  If no arguments are given, the number is a floating  point
              value  between  0  and 1.  If one argument is given, the number is an integer value
              between 0 and value1.  If two arguments are given, the number is an  integer  value
              between value1 and value2.

       ::math::sigma value value ?value ...?
              Return the population standard deviation of two or more numeric values.

       ::math::stats value value ?value ...?
              Return the mean, standard deviation, and coefficient of variation (as percent) as a
              list.

       ::math::sum value ?value ...?
              Return the sum of one or more numeric values.

BUGS, IDEAS, FEEDBACK

       This document, and the package it describes,  will  undoubtedly  contain  bugs  and  other
       problems.    Please   report   such   in   the   category  math  of  the  Tcllib  Trackers
       [http://core.tcl.tk/tcllib/reportlist].  Please also report any ideas for enhancements you
       may have for either package and/or documentation.

       When proposing code changes, please provide unified diffs, i.e the output of diff -u.

       Note further that attachments are strongly preferred over inlined patches. Attachments can
       be made by going to the Edit form of the ticket immediately after its creation,  and  then
       using the left-most button in the secondary navigation bar.

KEYWORDS

       math, statistics

CATEGORY

       Mathematics