'\" te
.\" Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved.
.\" Copyright 1989 AT&T
.TH units 1 "14 Sep 1992" "SunOS 5.11" "User Commands"
.SH NAME
units \- converts quantities expressed in standard scales to other scales
.SH SYNOPSIS
.LP
.nf
\fBunits\fR 
.fi

.SH DESCRIPTION
.sp
.LP
\fBunits\fR converts quantities expressed in various standard scales to their equivalents in other scales. It works interactively in this fashion:
.sp
.in +2
.nf
You have:~~\fBinch\fR
You want:~~\fBcm\fR
        * 2.540000e+00
/ 3.937008e\(mi01
.fi
.in -2
.sp

.sp
.LP
A quantity is specified as a multiplicative combination of units optionally preceded by a numeric multiplier. Powers are indicated by suffixed positive integers, division by the usual sign:
.sp
.in +2
.nf
You have:~~\fB15 lbs force/in2\fR
You want:~~\fBatm\fR
        * 1.020689e+00
        / 9.797299e\(mi01
.fi
.in -2
.sp

.sp
.LP
\fBunits\fR only does multiplicative scale changes; thus it can convert Kelvin to Rankine, but not Celsius to Fahrenheit. Most familiar units, abbreviations, and metric prefixes are recognized, together with a generous leavening of exotica and a few constants of nature including:
.sp
.ne 2
.mk
.na
\fB\fBpi\fR\fR
.ad
.RS 9n
.rt  
ratio of circumference to diameter,
.RE

.sp
.ne 2
.mk
.na
\fB\fBc\fR\fR
.ad
.RS 9n
.rt  
speed of light,
.RE

.sp
.ne 2
.mk
.na
\fB\fBe\fR\fR
.ad
.RS 9n
.rt  
charge on an electron,
.RE

.sp
.ne 2
.mk
.na
\fB\fBg\fR\fR
.ad
.RS 9n
.rt  
acceleration of gravity,
.RE

.sp
.ne 2
.mk
.na
\fB\fBforce\fR\fR
.ad
.RS 9n
.rt  
same as \fBg\fR,
.RE

.sp
.ne 2
.mk
.na
\fB\fBmole\fR\fR
.ad
.RS 9n
.rt  
Avogadro's number,
.RE

.sp
.ne 2
.mk
.na
\fB\fBwater\fR\fR
.ad
.RS 9n
.rt  
pressure head per unit height of water,
.RE

.sp
.ne 2
.mk
.na
\fB\fBau\fR\fR
.ad
.RS 9n
.rt  
astronomical unit.
.RE

.sp
.LP
\fBPound\fR is not recognized as a unit of mass; \fBlb\fR is. Compound names are run together, (for example, \fBlightyear\fR). British units that differ from their U.S. counterparts are prefixed thus: \fBbrgallon\fR. For a complete list of units, type:
.sp
.LP
\fBcat /usr/share/lib/unittab\fR
.SH FILES
.sp
.LP
\fB/usr/share/lib/unittab\fR
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Availabilitysystem/core-os
.TE

.SH SEE ALSO
.sp
.LP
\fBattributes\fR(5)