####
2.8 KiB

# Metrify

Metrify is a tool for converting commonly-used non-metric units to metric.

## Usage

Simplest way to use metrify is to invoke it with an expression in terms of non-metric units as its arguments:

```
metrify 1.4 short tons
```

The expression can contain several number + unit sequences, which are summed together if the units are compatible:

```
metrify 5′8″
metrify 1 acre 15 square feet
```

You can also invoke metrify without arguments, in which case it will give you a prompt to type the expression into. Press ^D to exit.

## Result display

Metrify will pick the appropriate prefix for the given result and unit automatically. The value is rounded so that results <1 have 4 digits, <10 3 digits, <100 2 digits, <1000 1 digit and ≥1000 no digits after the decimal point. The digits before the decimal point are grouped into groups of three.

```
0.4929 ml
1.609 km
28.35 g
907.2 kg
28 317 cm³
```

## Supported units

### Length units based on the international yard

- inch (in)
- foot (ft)
- yard (yd)
- mile (mi)

### Mass units based on the international pound

- ounce (oz)
- pound (lb)
- stone (st)
- short ton
- long ton

### Temperature

- degrees Fahrenheit (°F)

### Area units based on the international yard

- square inch (in²)
- square foot (ft²)
- square yard (yd²)
- acre (ac)
- square mile (mi²)

### Volume units based on the international yard

- cubic inch (in³)
- cubic foot (ft³)
- cubic yard (yd³)

### Imperial fluid volume units

- imperial fluid ounce (imp fl oz)
- imperial pint (imp pt)
- imperial quart (imp qt)
- imperial gallon (imp gal)

### US customary fluid volume units

- US teaspoon (tsp)
- US tablespoon (tbsp)
- US fluid ounce (us fl oz)
- US cup (cup)
- US pint (us pt)
- US quart (us qt)
- US gallon (us gal)

## Why should I use metrify instead of units(1)?

Metrify is more special-purpose than units(1), which allows it to present the user a nicer interface for the purposes it does support. For example with metrify you do not need to explicitly tell it the unit you are converting to, because due to its requirements (conversion is always from non-metric to metric) it can automatically pick the correct one.

## Why should I use units(1) instead of metrify?

units(1) includes many more units than covered by metrify, in addition to allowing other conversions than non-metric to metric. It can also be used for calculations involving units, which metrify does not handle outside of addition.

## Building and installation

You can build and test out metrify with `cargo run`

. If you want to install it
locally, you can use `cargo install --path .`

in the source directory.

## License

Metrify is under Creative Commons Zero 1.0.