This site is a static rendering of the Trac instance that was used by R7RS-WG1 for its work on R7RS-small (PDF), which was ratified in 2013. For more information, see Home.

Source for wiki NumericTower version 32

author

cowan

comment

ipnr

127.11.51.1

name

NumericTower

readonly

text

== The numeric tower ==

This is an analysis of the R5RS provision that the full numeric tower may be subsetted.  In this analysis, four boolean feature settings characterize different kinds of numeric towers: `exactness-preserving`, `ratios`, `inexact`, and `complex`.  These refer respectively to the closure of exact numbers under rational operations (except `/`), exact non-integer values, inexact rationals, and non-real numbers.

There are therefore 16 possible numeric towers.  9 of them are known to have implementations, as shown below.  I write `+` if a feature is present and `-` if it is absent, and give a general description of the resulting tower and some Scheme implementations that provide it.

||`exactness-preserving`||`ratios`||`inexact`||`complex`||Description||Implementations
||-||-||-||-||Bounded exact integers only||!SigScheme*||
||-||-||+||-||Fixnums and flonums||Plain Chicken 4, Shoe*, !TinyScheme*, RScheme, JScheme*, BDC*, XLisp*, Schemik*, VX, SXM*, Inlab, Llava, Sixx, Sizzle, Dfsch*, Stalin (also Elisp*, C*)||
||-||+||+||+||Limited-range exact and inexact numbers||S7, Wraith||
||+||-||+||-||Exact integers and inexact real numbers||Chicken 5, Bigloo, Scheme 9, Elk (also ISLisp)||
||+||-||+||+||Exact integers, inexact real numbers, and complex numbers||SCM||
||+||+||-||-||Exact rational numbers only||Dream, Oaklisp
||+||+||-||+||Exact numbers only||Owl Lisp
||+||+||+||-||Real numbers only||Psyche, Ikarus, Rep, Dfsch (also Clojure)||
||+||+||+||+||Full numeric tower||Racket, Gauche, MIT, Gambit, Chicken with the `numbers` egg, Scheme48/scsh, Kawa, SISC, Chibi, Guile, Chez, Vicare, Larceny, Ypsilon, Mosh, !IronScheme, STklos, KSi, UMB, Spark, Sagittarius (also R6RS, Common Lisp, Pure)||

*These systems are technically exactness-preserving, but silently return the wrong answers when their arithmetic operations overflow.  This makes them non-conformant.

NexJ's numeric tower is undocumented and behaves inconsistently in any case:  applying `expt` to two fixnums, for example, returns a bignum, but adding them returns a potentially incorrect fixnum.  Basically it does what Java does.

== Opinions ==

In my opinion, the reasonable general-purpose towers are --+- (fixnums and flonums), +-+- (fixnums, bignums, and flonums), +++- (fixnums, bignums, ratnums, and flonums) and ++++ (full).  The --+- tower's operations have the advantage of running in constant time on modern hardware.  The ++-- tower (ratnums but not flonums) may be reasonable for some purposes, but numerical code will often run very slowly without inexact support due to fractions which grow larger and larger. The ---- (fixnum-only) tower might possibly be appropriate where only a tiny amount of space is available and essentially no numerical work will be done.

See NumericTowerManisComments for Vincent Manis's comments on an earlier version of this page.

== See also ==

See also ComplexRepresentations for information on which Schemes support exact, inexact, and mixed-exactness complex numbers.

See also FloatPrecision for information on the different precisions of inexact numbers that some Schemes support.

time

2015-11-18 08:05:23