math(n)

math(n) 💖✨

okay so bestie, welcome to the math(n) page, aka the Tcl Math Library — and yes it's as iconic as it sounds. sit down, grab a strawberry 🍓, we're doing numbers today.

---

✨ SYNOPSIS ✨

package require Tcl 8.5 9

package require math ?1.2.6?

::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 ...?

like. look at her. a whole roster. 💅

---

🦋 DESCRIPTION 🦋

so the math package is your go-to girl for utility math functions. that's the vibe. 🫶

but wait, there's more — besides this set of basic commands (which you get straight from the math package), there are a bunch of more specialised packages that are whole entire side quests. each one is its own main character:

• 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::complexnumbers… okay not repeating, next one:
• 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

okay so slight edit bestie, that list is exactly these, no more no less, don't let me gaslight you: math::bigfloat, math::bignum, math::calculus::romberg, math::calculus, math::combinatorics, math::complexnumbers, math::constants, math::fourier, math::fuzzy, math::geometry, math::interpolate, math::linearalgebra, math::optimize, math::polynomials, math::rationalfunctions, math::roman, math::special, math::statistics. periodt. 💜

---

👑 BASIC COMMANDS 👑

these are the day-ones. the ride-or-dies. the ones you get just by requiring math.

• ::math::cov value value ?value ...? — gives you the coefficient of variation, expressed as a percent, of two or more numeric values. (two minimum, bestie, it needs at least a duo.)
• ::math::integrate list of xy value pairs — returns the area under a "curve" defined by a set of x,y pairs, plus the error bound, all as a list. it's giving calculus but make it chill.
• ::math::fibonacci n — returns the n'th Fibonacci number. that's it. that's the tweet. ✨
• ::math::max value ?value ...? — the maximum of one or more numeric values. the biggest one. the main character. 👑
• ::math::mean value ?value ...? — the mean, or "average", of one or more numeric values. literally the average, no cap.
• ::math::min value ?value ...? — the minimum of one or more numeric values. the smallest, but she still matters. 🥺
• ::math::product value ?value ...? — the product of one or more numeric values. multiply, multiply, slay.
• ::math::random ?value1? ?value2? — returns a random number. the deets:
  • no arguments at all? you get a floating point value between 0 and 1. 🎲
  • one argument? you get an integer value between 0 and value1.
  • two arguments? you get an integer value between value1 and value2.
• ::math::sigma value value ?value ...? — returns the sample standard deviation of two or more numeric values.
• ::math::stats value value ?value ...? — returns the mean, standard deviation, and coefficient of variation (as percent) — all bundled up as a list. a little combo meal. 🍟
• ::math::sum value ?value ...? — the sum of one or more numeric values. adding things. iconic behaviour.

---

💀 BUGS, IDEAS, FEEDBACK 💀

ngl bestie, this document — and the package it describes — will undoubtedly contain bugs and other problems. it's not a vibe, it's just reality. 😭

so if you find one, please report it in the category math of the Tcllib Trackers at http://core.tcl.tk/tcllib/reportlist. 🫶

also please send in any ideas for enhancements you may have for either the package and/or the documentation. we want the glow-up.

when you're proposing code changes, please provide unified diffs, i.e the output of diff -u. that's the format, don't freestyle it.

and one more thing — note further that attachments are strongly preferred over inlined patches. here's how you do it: go to the Edit form of the ticket immediately after its creation, and then use the left-most button in the secondary navigation bar. easy. 💅

---

🌈 KEYWORDS 🌈

math, statistics

---

⭐ CATEGORY ⭐

Mathematics

---

okay that's the whole page, you ate it up 💖 and just so you know where this came from: it's from tcllib, version 1.2.6, page math(n). stan. bye bestie, go do some math 🧚✨🎀