# `NumberF.Metrics`
[🔗](https://github.com/jamesnjovu/elixir_number_functions/blob/v0.3.0/lib/number_f/metrics.ex#L1)

Functions for handling unit conversions between different measurement systems.

# `acres_to_hectares`

Converts acres to hectares.

## Parameters
  - `acres`: The area in acres

## Examples

    iex> NumberF.Metrics.acres_to_hectares(2.47)
    1.0

# `area_units`

# `celsius_to_fahrenheit`

Converts Celsius to Fahrenheit.

## Parameters
  - `celsius`: The temperature in Celsius

## Examples

    iex> NumberF.Metrics.celsius_to_fahrenheit(0)
    32.0

    iex> NumberF.Metrics.celsius_to_fahrenheit(100)
    212.0

# `cm_to_inches`

Converts centimeters to inches.

## Parameters
  - `cm`: The length in centimeters

## Examples

    iex> NumberF.Metrics.cm_to_inches(25.4)
    10.0

    iex> NumberF.Metrics.cm_to_inches(8.89)
    3.5

# `convert_units`

Converts between different metric units of the same type.

## Parameters
  - `value`: The value to convert
  - `from_unit`: The source unit
  - `to_unit`: The target unit
  - `conversion_map`: A map of conversion factors

## Examples

    iex> conversion_map = %{
    ...>   "mm" => 0.001,
    ...>   "cm" => 0.01,
    ...>   "m" => 1,
    ...>   "km" => 1000
    ...> }
    iex> NumberF.Metrics.convert_units(5, "cm", "m", conversion_map)
    0.05

# `fahrenheit_to_celsius`

Converts Fahrenheit to Celsius.

## Parameters
  - `fahrenheit`: The temperature in Fahrenheit

## Examples

    iex> NumberF.Metrics.fahrenheit_to_celsius(32)
    0.0

    iex> NumberF.Metrics.fahrenheit_to_celsius(212)
    100.0

# `hectares_to_acres`

Converts hectares to acres.

## Parameters
  - `hectares`: The area in hectares

## Examples

    iex> NumberF.Metrics.hectares_to_acres(1)
    2.47

# `inches_to_cm`

Converts inches to centimeters.

## Parameters
  - `inches`: The length in inches

## Examples

    iex> NumberF.Metrics.inches_to_cm(10)
    25.4

    iex> NumberF.Metrics.inches_to_cm(3.5)
    8.89

# `kg_to_pounds`

Converts kilograms to pounds.

## Parameters
  - `kg`: The weight in kilograms

## Examples

    iex> NumberF.Metrics.kg_to_pounds(4.54)
    10.01

# `km_to_miles`

Converts kilometers to miles.

## Parameters
  - `km`: The distance in kilometers

## Examples

    iex> NumberF.Metrics.km_to_miles(16.09)
    10.0

# `length_units`

# `miles_to_km`

Converts miles to kilometers.

## Parameters
  - `miles`: The distance in miles

## Examples

    iex> NumberF.Metrics.miles_to_km(10)
    16.09

# `ml_to_oz`

Converts milliliters to fluid ounces.

## Parameters
  - `ml`: The volume in milliliters

## Examples

    iex> NumberF.Metrics.ml_to_oz(29.57)
    1.0

# `oz_to_ml`

Converts fluid ounces to milliliters.

## Parameters
  - `oz`: The volume in fluid ounces

## Examples

    iex> NumberF.Metrics.oz_to_ml(1)
    29.57

# `pounds_to_kg`

Converts pounds to kilograms.

## Parameters
  - `pounds`: The weight in pounds

## Examples

    iex> NumberF.Metrics.pounds_to_kg(10)
    4.54

# `volume_units`

# `weight_units`

---

*Consult [api-reference.md](api-reference.md) for complete listing*
