As a super-class of numbers, Kawa also provides quantities.
A quantity is a product of a unit and a pure number.
The number part can be an arbitrary complex number.
The unit is a product of integer powers of base units,
such as meter or second.
Quantity literals have the following syntax:
Some examples are 10pt (10 points), 5s (5 seconds),
and 4cm^2 (4 square centimeters).
Note the quantity syntax is not recognized by the reader.
Instead these are read as symbols.
Assuming there is no lexical binding the for the symbol, it will be
rewritten at compile-time into an expression. For example 4cm^2
is transformed into:
(* 4.0 (expt unit:cm 2))
Procedure: quantity? object
True iff object is a quantity. Note that all numbers are
quantities, but not the other way round.
Currently, there are no quantities that are not numbers.
To distinguish a plain unit-less number from a quantity,
you can use complex?.
Procedure: quantity->number q
Returns the pure number part of the quantity q, relative to
primitive (base) units.
If q is a number, returns q.
If q is a unit, yields the magitude of q relative to base units.
Procedure: quantity->unit q
Returns the unit of the quantity q.
If q is a number, returns the empty unit.
Procedure: make-quantity x unit
Returns the product of x (a pure number) and unit.
You can specify a string instead of unit, such as "cm"
or "s" (seconds).
Syntax: define-base-unit unit-name dimension
Define unit-name as a base (primitive) unit,
which is used to measure along the specified dimension.
(define-base-unit dollar "Money")
Syntax: define-unit unit-name expression
Define unit-name as a unit (that can be used in literals)
equal to the quantity expression.
(define-unit cent 0.01dollar)
The unit-name is declared in the unit namespace,
so the above is equivalent to:
(define-constant unit:cent (* 0.01 unit:dollar))
Angles
The following angle units are dimensionless, with no base unit.
Some procedures treat a unit-less real number as if it were in radians
(which mathematicians prefer);
some procedures (such as rotate) treat a unit-less real number
as if it were in degrees
(which is common in Web and other standards).
Unit: rad
A unit for angles specified in radians.
A full circle is 2*pi radians.
Note that (= 1.5 1.5rad) is true,
while (eqv? 1.5 1.5rad) is false.
Unit: deg
A unit for angles specified in degrees.
A full circle is 360 degrees.
Unit: grad
A unit for angles specified in gradians.
A full circle is 400 gradians.
