math(3tcl)

📦
version 2.0 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

math — the Tcl Math Library, aka your new bestie for numbers 💅

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

🌸 DESCRIPTION 🌸

okay so the math package is literally just a lil bundle of utility math functions. that's the vibe. 🧮✨

and like, besides the basic set of commands you get straight from the math package, there are also a whole bunch of more specialised packages, and honestly? iconic lineup:

  • 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

no cap, that's a whole squad 🫶

👑 BASIC COMMANDS 👑

the main character commands, fr fr:

  • ::math::cov value value ?value ...? — gives you the coefficient of variation expressed as percent of two or more numeric values 💯
  • ::math::integrate list of xy value pairs — gives you the area under a "curve" defined by a set of x,y pairs, plus the error bound, all as a list 🦋
  • ::math::fibonacci n — gives you the n'th Fibonacci number, yes the sequence, you know the one 🌈
  • ::math::max value ?value ...? — the maximum of one or more numeric values 👑
  • ::math::mean value ?value ...? — the mean, or "average", of one or more numeric values 🎀
  • ::math::min value ?value ...? — the minimum of one or more numeric values 🥺
  • ::math::product value ?value ...? — the product of one or more numeric values ✖️
  • ::math::random ?value1? ?value2? — a random number, and the vibe depends on how many args you pass:
    • no arguments → a floating point value between 0 and 1 🎲
    • one argument → an integer value between 0 and value1
    • two arguments → an integer value between value1 and value2
  • ::math::sigma value value ?value ...? — the sample standard deviation of two or more numeric values 📊
  • ::math::stats value value ?value ...? — the mean, standard deviation, and coefficient of variation (as percent), served up as a list ⭐
  • ::math::sum value ?value ...? — the sum of one or more numeric values ➕

💀 BUGS, IDEAS, FEEDBACK 💀

ngl, this document, and the package it describes, will undoubtedly contain bugs and other problems. like, that's just how it is 😭 please report such in the category math of the Tcllib Trackers [http://core.tcl.tk/tcllib/reportlist]. and please also report any ideas for enhancements you may have for either package and/or documentation — we love ideas, bestie 🫶

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

also 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. yes, that specific button. the left-most one. go off 💅

🔑 KEYWORDS 🔑

math, statistics

🍓 CATEGORY 🍓

Mathematics

and that's the whole page, periodt ✨ this was math(3tcl) from the Tcl Math Library, brought to you by tcllib version 1.2.6 — date stamped and everything, ily, go do some math bestie 💖🧚🌸

📦 where this page comes from