'\" t
.\"     Title: rink
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.21
.\"      Date: 2024-05-01
.\"    Manual: Rink Manual
.\"    Source: Rink Manual
.\"  Language: English
.\"
.TH "RINK" "7" "2024-05-01" "Rink Manual" "Rink Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
rink \- Query language documentation
.SH "SYNPOSIS"
.sp
Rink\(cqs query language follows a somewhat natural language style for its
syntax. Many expressions like \fB3.5 meters to feet\fP will work without any
modification. This manual is meant for those who want to get a deeper
understanding of the query language.
.SH "DESCRIPTION"
.sp
In order to understand Rink, an understanding of units themselves is
required. Fundamentally, a \fBunit\fP is a way of assigning a concrete
value to a specific \fBquantity\fP such as length, volume, energy, power,
current, etc. Each \fBquantity\fP can be reduced into other quantities
(for example, area is length × length), except for 7 \fBbase units\fP.
.sp
The 7 \fBbase units\fP (as well as the physical quantities they represent):
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
meter (length)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
second (time)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
kilogram (mass)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
ampere (current)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
kelvin (temperature)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
mol (amount of substance)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
candela (human\-subjective luminous intensity)
.RE
.sp
In addition, Rink defines a few non\-SI base units:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
euro (money)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
bit (information)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
radian (angle)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
steradian (solid angle)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
wholenote (musical note length)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
IU (biological activity)
.RE
.sp
Each of these quantities is treated as irreducible. The 7 base units
are the foundations of SI, and customary systems as well. (Customary
systems are defined in terms of SI.)
.sp
Every \fBunit\fP is composed of two parts: A numerical value, and its
\fBdimensionality\fP. The dimensionality is how a unit relates itself to
the \fBbase units\fP. Each base unit is raised to a certain power to
construct the dimensionality. For example, the dimensionality of the
quantity of acceleration is \f(CRlength^1\fP × \f(CRtime^\-2\fP and then the rest of
the base units are to the 0th power, which is to say that they do not
matter. Two units are considered \fBconformable\fP if they have matching
dimensionalities, and they can then be used in conversions.
.sp
Because each unit has a numerical part, it is possible to do normal
math on them*.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Adding two units produces a new unit with matching dimensionality.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Multiplying two units produces a new unit with its dimensionality as
each base unit multiplied together, e.g. velocity (\f(CRlength time^\-1\fP) *
hertz (\f(CRtime^\-1\fP) = acceleration (\f(CRlength time^\-2\fP).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Dividing two units is like multiplication, but taking away from the
base units. A unit divided by itself is \fBdimensionless\fP, it has no
quantity. Normal numbers are dimensionless.
.RE
.sp
Because of this, units are essentially a special type of number. As
such, Rink is essentially a calculator which takes dimensionality into
account.
.SS "Weight vs Mass"
.sp
It is important to remember the differences between mass and weight
when working with mass and force units. Here are some tips:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Mass doesn\(cqt change depending on the amount of gravity, and directly
influences momentum.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Weight is the amount of downward force on an object due to gravity.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Mass is measured in kilograms or pounds.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Weight is measured in newtons, kilogram force (kgf), or pound force
(lbf).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
When someone says something weighs some amount of kg or lb, they\(cqre
saying it has a weight of that number of kgf or lbf. This includes
things like weight on the moon. (Don\(cqt correct anyone using this
common figure of speech.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
A scale displays an estimate of mass by measuring the force applied
to it divided by its calibrated measurement of the acceleration of
gravity. Its mass estimate would be incorrect on other planets
unless it was recalibrated. You can also think of the displayed
value as being weight in kgf or lbf.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
You can compute weight by multiplying mass by gravity. Both kgf and
lbf have earth gravity as part of their definition, so when you
multiply kg or lb by gravity you get the same numerical values back,
but with kgf or lbf units.
.RE
.SS "Numbers"
.sp
.if n .RS 4
.nf
.fam C
> 10.1e2
1010 (dimensionless)
> 10
10 (dimensionless)
> 0x10
16 (dimensionless)
> 0o10
8 (dimensionless)
> 0b10
2 (dimensionless)
> 9999999999999
approx. 9.99999e12 (dimensionless)
> 1.001
1.001 (dimensionless)
> 1e100
1.0e100 (dimensionless)
.fam
.fi
.if n .RE
.sp
Decimal numbers can be written with an integer component, an
after\-decimal\-point component, and an exponent. Numbers can optionally
have either \f(CRU+2009 THIN SPACE\fP or an underscore (\f(CR_\fP) for digit place
separators.
.sp
The decimal point is always written with a dot (\f(CR.\fP), not a comma or
other marker. If the decimal point is provided, it must be followed by
more digits. (\f(CR1.\fP is not allowed.)
.sp
The exponent starts with an \f(CRe\fP, followed by an integer with an
optional sign. The exponent is shorthand for writing out \f(CR*
10^exp\fP. There can be no spaces within the number other than allowed
digit separators. (\f(CR10 e10\fP is not allowed.)
.sp
Hexadecimal, octal, and binary integers can be written using \f(CR0x\fP,
\f(CR0o\fP, and \f(CR0b\fP prefixes, respectively. These literals do not currently
support decimal points or exponents.
.sp
Numbers can be written with a fraction, and can be written in
scientific notation. \f(CR1e24\fP is short for \f(CR1 * 10^24\fP.
.SS "Arithmetic"
.sp
.if n .RS 4
.nf
.fam C
> 3 4 m 5 s
60 m s
> 3 * 4 m 5 s
60 m s
.fam
.fi
.if n .RE
.sp
Multiplication can be either by juxtaposition (that is, without any
symbol) or using an explicit * operator.
.sp
.if n .RS 4
.nf
.fam C
> 10 km / 5 m
2000 (dimensionless)
> 1|2 m
0.5 m (length)
.fam
.fi
.if n .RE
.sp
There are two division operators, for separate purposes. \f(CR/\fP has lower
precedence than multiplication, and is used mainly for separating two
halves of an entire expression. \f(CR|\fP has higher precedence than
multiplication, and is used mainly for fractions of integers.
.sp
.if n .RS 4
.nf
.fam C
> 1 * 2 + 1 * 2
4 (dimensionless)
> 12 meters + 5 feet
13.524 m (length)
.fam
.fi
.if n .RE
.sp
Addition and subtraction have lower precedence than multiplication and
division.
.sp
.if n .RS 4
.nf
.fam C
> 12 ft^2
435483/390625, approx. 1.114836 m^2 (area)
.fam
.fi
.if n .RE
.sp
Powers have higher precedence than multiplication. Both \f(CR^\fP and \f(CR**\fP
can be used.
.sp
.if n .RS 4
.nf
.fam C
> 11 mod 3
2  (dimensionless)
> meter mod foot
85.6 millimeter (length)
.fam
.fi
.if n .RE
.sp
The \f(CRmod\fP operator can be used to find the remainder of division. It has
the same precedence as \f(CR*\fP. Requires both inputs to have the same
dimensionality.
.sp
.if n .RS 4
.nf
.fam C
> 1 << 24
16777216  (dimensionless)
> 16 >> 2
.fam
.fi
.if n .RE
.sp
Equivalent to multiplying or dividing by a power of two. The right side
must be dimensionless.
.sp
.if n .RS 4
.nf
.fam C
4  (dimensionless)
> 0b1010 and 0b1100 to base 2
1000  (dimensionless)
> 0b1010 or 0b1100 to base 2
1110  (dimensionless)
> 0b1010 xor 0b1100 to base 2
110  (dimensionless)
.fam
.fi
.if n .RE
.sp
Bitwise operators are supported. The inputs must be dimensionless, and
also must be integers.
.SS "Temperature"
.sp
.if n .RS 4
.nf
.fam C
> 12 °C
285.15 K (temperature)
.fam
.fi
.if n .RE
.sp
Temperature scales are operators with higher precedence than addition,
and lower than multiplication. See the Temperature conversion
section for more detailed syntax.
.SS "Inline Definitions"
.sp
.if n .RS 4
.nf
.fam C
> 2000 kcal \-> potato = 164 kcal
500/41, approx. 12.19512 potato (energy)
.fam
.fi
.if n .RE
.sp
An equals expression is one which simultaneously defines a new unit
with the right\-hand side, names it using the left\-hand side, and then
produces it as its result. This is useful for customizing the output
of the right\-hand side of a conversion or converting into things that
don\(cqt currently have units such as the amount of calories in a potato.
.SS "Custom base units"
.sp
.if n .RS 4
.nf
.fam C
> 12 \*(Aqcore\*(Aq hour / 3 \*(Aqcore\*(Aq \-> minutes
240 minutes (time)
.fam
.fi
.if n .RE
.sp
A unit name which is wrapped in quotation marks will not be checked
for whether it exists when it is evaluated. This means you can wrap
anything in quotes to in effect produce a new \fBbase unit\fP for the
purposes of a single calculation. This can be useful for doing
calculations in terms of things which are otherwise dimensionless.
.SS "Previous results"
.sp
.if n .RS 4
.nf
.fam C
> 100 ohm + 50 ohm
150 ohm (resistance)
> ANS * 10 mA
1.5 volt (electrical_potential)
.fam
.fi
.if n .RE
.sp
The result of the previous query can be accessed with \f(CR_\fP, \f(CRans\fP or
\f(CRANS\fP, which can be convenient for breaking up calculations into
multiple steps. Note that when rink returns an error occurs, the
previous result is kept. Also, currently only the results of
mathematical expressions are stored, the results for conversions aren\(cqt.
.SS "Prefixes"
.sp
Units can be prefixed with SI prefixes as well as a number of non\-SI
prefixes, such as: quarter, double, kibi, mebi, ⅞.
.sp
Rink will accept plural unit names as well.
.SS "Conversions"
.sp
.if n .RS 4
.nf
.fam C
> meter \-> feet
3.280839 foot (length)
> 12 °C \-> °F
53.6 °F (temperature)
.fam
.fi
.if n .RE
.sp
Conversions are done with the \f(CR\(->\fP, \f(CRto\fP, \f(CRin\fP operators.
.sp
The left hand side of the conversion is an arbitrary expression, and
the right hand side is one of:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
An arbitrary expression
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
A temperature scale (celsius, fahrenheit, and several historical
scales)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
A unit list (e.g. \f(CRhour;min;sec\fP)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
A timezone (e.g. \f(CR"US/Pacific"\fP)
.RE
.SS "Unit lists"
.sp
.if n .RS 4
.nf
.fam C
> 2^17 seconds \-> hour;min;sec
36 hour, 24 minute, 32 s (time)
> 2 km \-> mi;ft
1 mile, 1281.679 foot (length)
> liter \-> cup;tbsp;tsp
4 uscup, 3 ustablespoon, 1.884136 usteaspoon (volume)
.fam
.fi
.if n .RE
.sp
A unit list is a comma\- or semicolon\- delimited list of units with the
same dimensionality, which can be used for breaking down numbers into
more familiar quantities.
.SS "Temperature conversion"
.sp
.if n .RS 4
.nf
.fam C
> 12 °C
285.15 K (temperature)
> 12 degC
285.15 K (temperature)
> 12 celsius
285.15 K (temperature)
.fam
.fi
.if n .RE
.sp
Temperature scales in Rink are handled a little specially, because
only Kelvin and Rankine (the absolute zero version of Fahrenheit)
start at absolute zero. As such, they are \fBoperators\fP, not
units. These operators have looser binding precedence than
multiplication, but tighter than addition.
.sp
Available temperature scales:
.sp
\f(CRdegC\fP, \f(CR°C\fP, \f(CRcelsius\fP, \f(CR℃\fP
.RS 4
\fBCelsius\fP, the standard scale in most countries.
.RE
.sp
\f(CRdegF\fP, \f(CR°F\fP, \f(CRfahrenheit\fP, \f(CR℉\fP
.RS 4
\fBFahrenheit\fP, the scale used in households across the United States.
.RE
.sp
\f(CRdegRé\fP, \f(CR°Ré\fP, \f(CRdegRe\fP, \f(CR°Re\fP, \f(CRréaumur\fP, \f(CRreaumur\fP
.RS 4
\fBRéaumur\fP, A historical scale once used throughout Europe.
.RE
.sp
\f(CRdegRø\fP, \f(CR°Rø\fP, \f(CRdegRo\fP, \f(CR°Ro\fP, \f(CRrømer\fP, \f(CRromer\fP
.RS 4
\fBRomer\fP, Another historical scale.
.RE
.sp
\f(CRdegN\fP, \f(CR°N\fP, \f(CRdegnewton\fP
.RS 4
\fBNewton\fP, A historical scale created by Isaac Newton.
.RE
.sp
\f(CRdegDe\fP, \f(CR°De\fP, \f(CRdelisle\fP
.RS 4
\fBDelisle\fP, A historical scale which, alongside the original
Celsius scale, is reversed from the scales we are used to today. Its
zero point is boiling water, and the freezing point of water is
150°De.
.RE
.sp
Note that these temperature scale measurements are \fBabsolute\fP
measurements, not \fBdifferences\fP. If you wish to say something like "a
difference of 1°C", then you must use the absolute scale for the scale
you\(cqre using. These are:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
For Celsius, kelvin \f(CRK\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
For Fahrenheit, Rankine \f(CRdegR\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
For Réaumur, \f(CRreaumur_absolute\fP (absolute as in the zero point is absolute zero)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
For Rømer, \f(CRromer_absolute\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
For Newton, \f(CRnewton_absolute\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
For Delisle, \f(CRdelisle_absolute\fP
.RE
.SS "Numeric base conversion"
.sp
.if n .RS 4
.nf
.fam C
> 1000 \-> hex
3e8 (dimensionless)
> 10000 \-> base 36
7ps (dimensionless)
> pi meter \-> hex meter
approx. 3.243f6a meter (length)
.fam
.fi
.if n .RE
.sp
Base modifiers are specified with \f(CRbase\fP followed by a number,
followed by the rest of your conversion. Allowed bases are currently 2
through 36. There are some special base names which are also
recognized:
.sp
\f(CRhex\fP, \f(CRhexadecimal\fP, \f(CRbase16\fP
.RS 4
Base 16.
.RE
.sp
\f(CRoct\fP, \f(CRoctal\fP, \f(CRbase8\fP
.RS 4
Base 8.
.RE
.sp
\f(CRbin\fP, \f(CRbinary\fP, \f(CRbase2\fP
.RS 4
Base 2.
.RE
.SS "Digits modifier"
.sp
.if n .RS 4
.nf
.fam C
> 2^128 \-> digits
340282366920938463463374607431768211456 (dimensionless)
> 1/3937 \-> digits
0.[000254000508001016002032004064008128016256032512065024130048260096520193040386080772161544323088646177292354584709169418338836677673355346710693421386842773685547371094742189484378968757937515875031750063500127, period 210]...  (dimensionless)
> googol \-> digits
10000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 (dimensionless)
.fam
.fi
.if n .RE
.sp
Digits modifiers are specified with \f(CRdigits\fP optionally followed by a
number, before the base modifier and before the rest of the
conversion. Any number of digits are allowed, but large amounts may
not succeed.
.sp
The function of this modifier is that it forces the entire integer
part to be printed (i.e., scientific notation will \fBnot\fP be used), and
then it prints an additional \fBn\fP digits, using the default if not
specified.
.sp
Trancendental numbers currently cannot be precisely represented, so
asking for many digits of pi or e will produce unsatisfying results.
.sp
Rink makes an attempt to find recurring decimals. If you ask it to print
enough digits, it will find them.
.sp
Trigonometric and logarithmic functions are currently implemented
using a machine\-float fallback, because their results cannot be
precisely represented as finite rationals. Because of this, asking for
many digits of such numbers will also produce unsatisfying results.
.SS "Units for"
.sp
.if n .RS 4
.nf
.fam C
> units for power
Units for kg m^2 / s^3 (power): VA, airwatt, boilerhorsepower, brhorsepower,
donkeypower, electrichorsepower, horsepower, lusec, mbh, metrichorsepower,
poncelet, sccm, sccs, scfh, scfm, slph, slpm, solarluminosity,
tonrefrigeration, waterhorsepower, watt
.fam
.fi
.if n .RE
.sp
The \fBunits for\fP, \fBunits of\fP, and \fBunits\fP commands will find more units
which match the dimensionality of the one specified.
.SS "Factorization"
.sp
.if n .RS 4
.nf
.fam C
> factorize velocity
Factorizations: velocity;  frequency length;  area viscosity;
acceleration time;  length^2 viscosity
> factorize power
Factorizations: power;  force velocity;  radiant_intensity solid_angle;
area radiosity;  length spectral_flux_wavelength;  radiation_dose spectral_exposure_frequency;
spectral_irradiance_wavelength volume;  temperature thermal_conductance;
energy frequency;  current^2 resistance;  ...
.fam
.fi
.if n .RE
.sp
Unit factorization is what Rink names the process of finding
quantities which can be multiplied together to produce the original
quantity. This can be useful for discovering new ways to construct a
unit.
.SS "Search"
.sp
.if n .RS 4
.nf
.fam C
> search milk
Search results: milk (substance), mil (length), mile (length), mill (dimensionless), mi (length)
.fam
.fi
.if n .RE
.sp
Allows you to search for units based on their names, returning up to 5
results and showing the associated physical quantity of the unit.
.SS "Date and time"
.sp
.if n .RS 4
.nf
.fam C
> #jan 01, 1970#
1970\-01\-01 00:00:00 +00:00 (46 years ago)
> now \- #jan 01, 1970# \-> gigaseconds
1.472083 gigaseconds (time)
> #2016\-08\-24# + 500 weeks
2026\-03\-25 00:00:00 +00:00 (in 9 years)
.fam
.fi
.if n .RE
.sp
In addition to handling units, Rink is also capable of doing some
calculations with dates and times.
.sp
Converting to a timezone:
.sp
.if n .RS 4
.nf
.fam C
> now
2022\-08\-08 21:19:56.990897100 \-07:00 (now)
> now \-> "Europe/London"
2022\-08\-09 05:20:03.656075600 BST (now)
.fam
.fi
.if n .RE
.sp
Converting to a fixed offset:
.sp
.if n .RS 4
.nf
.fam C
> now \-> +01:00
2022\-08\-09 05:20:30.080703900 +01:00 (now)
.fam
.fi
.if n .RE
.sp
Inputting a time with an offset:
.sp
.if n .RS 4
.nf
.fam C
> #apr 1, 2016 12:00:00 +01:00#
2016\-04\-01 12:00:00 +01:00 (6 years ago)
.fam
.fi
.if n .RE
.SS "Substances"
.sp
.if n .RS 4
.nf
.fam C
> milk
milk: density = 242 gram \-> approx. 236588.2 millimeter^3
> gallon milk
milk: volume = approx. 3785411.7 millimeter^3; mass = 3.872 kilogram
> egg
egg: USA large egg. mass_shelled = 50 gram; mass_white = 30 gram;
mass_yolk = 18.6 gram; volume = approx. 46824.75 millimeter^3;
volume_white = approx. 29573.52 millimeter^3;
volume_yolk = approx. 17251.22 millimeter^3
> egg_shelled of kg egg
20 (dimensionless)
> gallon gasoline \-> btu
gasoline: volume = approx. 3785411.7 millimeter^3; energy_HHV = 125000 btu; energy_LHV = 115000 btu
.fam
.fi
.if n .RE
.sp
Substances are how Rink organizes the physical properties of
materials, objects, both countable and uncountable. Each substance has
a name, an associated amount (defaulting to dimensionless 1), and a
set of associated properties.
.sp
Each property maps a named input into a named output and vice versa,
and has a name itself. Countable objects often have properties with an
input being dimensionless, so that you do not need to specify an
amount to extract the property.
.sp
The properties of a substance are accessed with the \fBof\fP operator
(<_property_> \fBof\fP <_substance_>), which reads a multiplication
expression following it, so you may have to wrap it in parentheses.
.sp
Substances can be used in conversions, and can be added and multiplied
to transform them. Multiplication will change the amount of the
substance you have, so that you can write \fBkg egg\fP to specify one
kilogram of eggs. Addition will combine certain properties (currently
only \f(CRmolar_mass\fP) to create a new substance entirely. Conversions of
substances allow you to get multiple results simultaneously, for
example if there are multiple different measurements of some property
of the substance available.
.sp
If the result of a calculation results in a substance, Rink will show
all of the properties applicable for the given amount.
.SH "REFERENCE"
.sp
The full list of units is specified in the file \f(CRdefinitions.units\fP (see
rink\-defs(5)), but a small list of the most helpful ones will be listed
here. It is intended that most units should be easy to guess the names
of.
.SS "SI derived"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Newton \f(CRN\fP (force)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Pascal \f(CRPa\fP (pressure)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Joule \f(CRJ\fP (energy)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Watt \f(CRW\fP (power)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Coulomb \f(CRC\fP (charge)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Volt \f(CRV\fP (electrical potential)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Ohm (electrical resistance)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Siemens \f(CRS\fP (electrical conductance)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Farad \f(CRF\fP (capacitance)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Weber \f(CRWb\fP (magnetic flux)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Henry \f(CRH\fP (inductance)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Tesla \f(CRT\fP (magnetic flux density)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Hertz \f(CRHz\fP (frequency)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Lumen \f(CRlm\fP (luminous flux)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Lux \f(CRlx\fP (illuminance)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Gray \f(CRGy\fP (radiation dose)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Katal \f(CRkat\fP (catalytic activity)
.RE
.SS "Substances"
.sp
Compounds and materials
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Water \f(CRwater\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Ammonia \f(CRammonia\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Freon \f(CRfreon\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Tissue \f(CRtissue\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Diamond \f(CRdiamond\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Graphite \f(CRgraphite\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Water ice \f(CRice\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Asphalt \f(CRasphalt\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Brick \f(CRbrick\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Concrete \f(CRcocnrete\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Silica glass \f(CRglass_silica\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Flint glass \f(CRglass_flint\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Pyrex glass \f(CRglass_pyrex\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Gypsum \f(CRgypsum\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Marble \f(CRmarble\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Sand \f(CRsand\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Soil \f(CRsoil\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Air \f(CRair\fP
.RE
.RE
.sp
Particles
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Electron \f(CRelectron\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Proton \f(CRproton\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Neutron \f(CRneutron\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Deuterium nucleus \f(CRdeuteron\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Muon \f(CRmuon\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Helium nucleus \f(CRhelion\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Tau \f(CRtauparticle\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Alpha \f(CRalphaparticle\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Tritium nucleus \f(CRtriton\fP
.RE
.RE
.sp
Celestial bodies
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Sun \f(CRsun\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Mercury \f(CRmercury_planet\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Venus \f(CRvenus\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Earth \f(CRearth\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Earth\(cqs moon \f(CRmoon\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Mars \f(CRmars\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Jupiter \f(CRjupiter\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Saturn \f(CRsaturn\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Uranus \f(CRuranus\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Neptune \f(CRneptune\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Pluto \f(CRpluto\fP
.RE
.RE
.sp
Fuels
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Crude oil \f(CRoil\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Coal \f(CRcoal\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Natural gas \f(CRnaturalgas\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Charcoal \f(CRcharcoal\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Wood \f(CRwood\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Ethanol \f(CRethanol\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Diesel \f(CRdiesel\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Gasoline \f(CRgasoline\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Heating oil \f(CRheating_oil\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Fuel oil \f(CRfueloil\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Propane \f(CRpropane\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Butane \f(CRbutane\fP
.RE
.RE
.sp
Foods
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Butter \f(CRbutter\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Clarified butter \f(CRbutter_clarified\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Cocoa butter \f(CRcocoa_butter\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Vegetable shortening \f(CRshortening\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Vegetable oil \f(CRvegetable_oil\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Olive oil \f(CRolive_oil\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Flour \f(CRcakeflour\fP, \f(CRflour\fP, \f(CRbreadflour\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Corn starch \f(CRcornstarch\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Cocoa \f(CRdutchcocoa\fP, \f(CRcocoa\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Heavy cream \f(CRheavycream\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Milk \f(CRmilk\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Sour cream \f(CRsourcream\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Molasses \f(CRmolasses\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Corn syrup \f(CRcorrnsyrup\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Honey \f(CRhoney\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Sugar \f(CRsugar\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Powdered sugar \f(CRpowdered_sugar\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Brown sugar \f(CRbrownsugar_light\fP, \f(CRbrownsugar_dark\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Baking powder \f(CRbaking_powder\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Salt \f(CRsalt\fP, \f(CRkoshersalt\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Egg \f(CRegg\fP
.RE
.RE
.sp
Elements 1 through 118, by name (e.g. \f(CRhelium\fP)
.SS "Constants"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Pi \f(CRpi\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Speed of light \f(CRc\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Planck Constant \f(CRplanck_constant\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Gravitational Constant \f(CRG\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Avogadro\(cqs number \f(CRavogadro\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Gas Constant \f(CRgasconstant\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Boltzmann Constant \f(CRboltzmann\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Earth Gravity \f(CRgravity\fP, \f(CRforce\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Earth Atmosphere Density \f(CRatm\fP
.RE
.SS "Currencies"
.sp
These are only available if live currency fetching is enabled. (See
rink(5).)
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
EU Euro \f(CREUR\fP, \f(CR€\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
US dollar \f(CRUSD\fP, \f(CR$\fP, \f(CRdollar\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Japan yen \f(CRJPY\fP, \f(CR¥\fP, \f(CRyen\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Bulgaria lev \f(CRBGN\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Czech koruna \f(CRCZK\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Denmark kroner \f(CRDKK\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
UK pound \f(CRGBP\fP, \f(CR£\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Hungary forint \f(CRHUF\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Poland złoty \f(CRPLN\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Romania lei \f(CRRON\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Sweden krona \f(CRSEK\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Switzerland franc \f(CRCHF\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Norway krone \f(CRNOK\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Croatia kuna \f(CRHRK\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Russia ruble \f(CRRUB\fP, \f(CR₽\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Turkey lira \f(CRTRY\fP, \f(CR₺\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Australia dollar \f(CRAUD\fP, \f(CRA$\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Brazil real \f(CRBRL\fP, \f(CRR$\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Canada dollar \f(CRCAD\fP, \f(CRC$\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
PRC yuan \f(CRCNY\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Hong Kong dollar \f(CRHKD\fP, \f(CRH$\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Indonesia rupiah \f(CRIDR\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Israel shekel \f(CRILS\fP, \f(CR₪\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
India rupee \f(CRINR\fP, \f(CR₹\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
South Korea won \f(CR₩\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Mexico dollar \f(CRMXN\fP, \f(CRmex$\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Malaysia ringgit \f(CRMYR\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
New Zealand dollar \f(CRNZD\fP, \f(CRNZ$\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Phillipines piso \f(CRPHP\fP, \f(CR₱\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Singapore dollar \f(CRSGD\fP, \f(CRS$\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Thailand baht \f(CRTHB\fP, \f(CR฿\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
South Africa rand \f(CRZAR\fP
.RE
.SS "Functions"
.sp
Currently, all of these result in machine float fallback, because
their results are real numbers that cannot be precisely represented as
rationals.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRsqrt(x)\fP: Square root, √x.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRexp(x)\fP: The exponential function, e^x.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRln(x)\fP: The natural logarithm, log_e(x).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRlog(x,y)\fP: Logarithm in base \fBy\fP, log_y(x).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRlog2(x)\fP: Logarithm in base 2, log_2(x).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRlog10(x)\fP: Logarithm in base 10, log_10(x).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRhypot(x,y)\fP: The length of the hypotenuse of a right\-angle triangle
given adjacent edges of length x and y.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRsin(x)\fP: The sine function.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRcos(x)\fP: The cosine function.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRtan(x)\fP: The tangent function.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRasin(x)\fP: Inverse sine, or arcsine.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRacos(x)\fP: Inverse cosine, or arccosine.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRatan(x)\fP: Inverse tangent, or arctangent.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRatan2(x, y)\fP: Four\-quadrant arctangent, which can be used to
reverse sine+cosine back into an angle.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRsinh(x)\fP: Hyperbolic sine.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRcosh(x)\fP: Hyperbolic cosine.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRtanh(x)\fP: Hyperbolic tangent.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRasinh(x)\fP: Inverse hyperbolic sine function.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRacosh(x)\fP: Inverse hyperbolic cosine function.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRatanh(x)\fP: Inverse hyperbolic tangent function.
.RE
.SH "SEE ALSO"
.sp
rink(1), rink(5),
rink\-defs(5),
rink\-dates(5)