version 1.9, 1999/06/13 16:31:18 |
version 1.10, 2000/03/14 14:58:24 |
|
|
.Op Fl v |
.Op Fl v |
.Ar from-unit |
.Ar from-unit |
.Ar to-unit |
.Ar to-unit |
.Sh ARGUMENTS |
|
.Bl -tag -width Ds |
|
.It Fl f Ar filename |
|
Specifies the name of the units data file to load. |
|
.It Fl q |
|
Suppresses prompting of the user for units and the display of statistics |
|
about the number of units loaded. |
|
.It Fl v |
|
Prints the version number. |
|
.It Ar from-unit Ar to-unit |
|
Allows a single unit conversion to be done directly from the command |
|
line. No prompting will occur. The units program will print out |
|
only the result of this single conversion. |
|
.El |
|
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The units program converts quantities expression in various scales to |
The |
their equivalents in other scales. The units program can only |
.Nm |
handle multiplicative scale changes. It cannot convert Celsius |
program converts quantities expression in various scales to |
to Fahrenheit, for example. It works interactively by prompting |
their equivalents in other scales. |
the user for input: |
The |
|
.Nm |
|
program can only handle multiplicative scale changes. |
|
It cannot convert Celsius |
|
to Fahrenheit, for example. |
|
It works interactively by prompting the user for input: |
.Pp |
.Pp |
.nf |
.nf |
You have: meters |
You have: meters |
|
|
/ 3785.4118 |
/ 3785.4118 |
.fi |
.fi |
.Pp |
.Pp |
|
The options are as follows: |
|
.Bl -tag -width Ds |
|
.It Fl f Ar filename |
|
Specifies the name of the units data file to load. |
|
.It Fl q |
|
Suppresses prompting of the user for units and the display of statistics |
|
about the number of units loaded. |
|
.It Fl v |
|
Prints the version number. |
|
.It Ar from-unit Ar to-unit |
|
Allows a single unit conversion to be done directly from the command line. |
|
No prompting will occur. |
|
The units program will print out |
|
only the result of this single conversion. |
|
.El |
|
.Pp |
Powers of units can be specified using the |
Powers of units can be specified using the |
.Ql ^ |
.Ql ^ |
character as shown in |
character as shown in |
|
|
is equivalent to |
is equivalent to |
.Sq cm^3 . |
.Sq cm^3 . |
Multiplication of units can be specified by using spaces, a dash or |
Multiplication of units can be specified by using spaces, a dash or |
an asterisk. Division of units is indicated by the slash |
an asterisk. |
|
Division of units is indicated by the slash |
.Pq Ql / . |
.Pq Ql / . |
Note that multiplication has a higher precedence than division, so |
Note that multiplication has a higher precedence than division, so |
.Sq m/s/s |
.Sq m/s/s |
|
|
2.1166667e-05 kg^2 m / sec |
2.1166667e-05 kg^2 m / sec |
.fi |
.fi |
.Pp |
.Pp |
The conversion information is read from a units data file. The default |
The conversion information is read from a units data file. |
file includes definitions for most familiar units, abbreviations and |
The default file includes definitions for most familiar units, |
metric prefixes. Some constants of nature included are: |
abbreviations and metric prefixes. |
|
Some constants of nature included are: |
.Bl -tag -width mercury |
.Bl -tag -width mercury |
.It pi |
.It pi |
ratio of circumference to diameter |
ratio of circumference to diameter |
|
|
.El |
.El |
.Pp |
.Pp |
.Sq Pound |
.Sq Pound |
is a unit of mass. Compound names are run together |
is a unit of mass. |
so |
Compound names are run together so |
.Sq poundforce |
.Sq poundforce |
is a unit of force. British units that differ from their |
is a unit of force. |
US counterparts are prefixed with |
British units that differ from their US counterparts are prefixed with |
.Sq br , |
.Sq br , |
and currency is prefixed with its country name: |
and currency is prefixed with its country name: |
.Sq belgiumfranc , |
.Sq belgiumfranc , |
|
|
and check again for a match. |
and check again for a match. |
.Pp |
.Pp |
All of these definitions can be read in the standard units file, or you |
All of these definitions can be read in the standard units file, or you |
can supply your own file. A unit is specified on a single line by |
can supply your own file. |
giving its name and an equivalence. One should be careful to define |
A unit is specified on a single line by |
|
giving its name and an equivalence. |
|
One should be careful to define |
new units in terms of old ones so that a reduction leads to the |
new units in terms of old ones so that a reduction leads to the |
primitive units which are marked with |
primitive units which are marked with |
.Ql ! |
.Ql ! |
|
|
by careless unit definitions. |
by careless unit definitions. |
.Pp |
.Pp |
Prefixes are defined in the same way as standard units, but with |
Prefixes are defined in the same way as standard units, but with |
a trailing dash at the end of the prefix name. Prefixes are applied |
a trailing dash at the end of the prefix name. |
|
Prefixes are applied |
after the longest matching unit name is found; for example, |
after the longest matching unit name is found; for example, |
.Dq nmile |
.Dq nmile |
is taken to be a nautical mile rather than a nanomile. |
is taken to be a nautical mile rather than a nanomile. |
|
|
Exponents of units entered by the user can be only one digit. |
Exponents of units entered by the user can be only one digit. |
You can work around this by multiplying several terms. |
You can work around this by multiplying several terms. |
.Pp |
.Pp |
The user must use | to indicate division of numbers and / to |
The user must use |
indicate division of symbols. This distinction should not |
.Ql | |
be necessary. |
to indicate division of numbers and |
|
.Ql / |
|
to indicate division of symbols. |
|
This distinction should not be necessary. |
.Pp |
.Pp |
Prefixes specified without a unit are treated as dimensionless quantities. |
Prefixes specified without a unit are treated as dimensionless quantities. |
This can lead to confusion when some prefixes are also defined as units |
This can lead to confusion when some prefixes are also defined as units |
(e.g., m). For example, Tera- / Giga- is 1000, but one Tesla (T) is 10,000 |
(e.g., m). |
|
For example, Tera- / Giga- is 1000, but one Tesla (T) is 10,000 |
Gauss (G). |
Gauss (G). |
.Pp |
.Pp |
Some non-SI units have multiple definitions (e.g, barrel, calorie) and |
Some non-SI units have multiple definitions (e.g, barrel, calorie) and |
others have changed over time (e.g., cubit). In particular, monetary |
others have changed over time (e.g., cubit). |
values fluctuate. |
In particular, monetary values fluctuate. |
.Pp |
.Pp |
The program contains various arbitrary limits on the length |
The program contains various arbitrary limits on the length |
of the units converted and on the length of the data file. |
of the units converted and on the length of the data file. |