Units

The rite.conversion.units submodule provides helpers for converting between units of measurement like temperature, length, weight, and intervals.

Unit Conversion Utilities

Physical unit conversions.

This submodule provides utilities for converting between different units of measurement: temperature, length, weight, time, etc.

Examples

from rite.conversion.units import ( ... units_celsius_to_fahrenheit, ... units_meters_to_feet, ... units_grams_to_pounds ... ) units_celsius_to_fahrenheit(0) 32.0 units_meters_to_feet(1) 3.28084 round(units_grams_to_pounds(453.592), 2) 1.0

Functions

units_celsius_to_fahrenheit(celsius: float) -> float

Convert Celsius to Fahrenheit.

Parameters:

Name	Type	Description	Default
celsius	float	Temperature in Celsius.	required

Returns:

Type	Description
float	Temperature in Fahrenheit.

Examples:

>>> units_celsius_to_fahrenheit(0)
32.0
>>> units_celsius_to_fahrenheit(100)
212.0
>>> units_celsius_to_fahrenheit(-40)
-40.0

units_celsius_to_kelvin(celsius: float) -> float

Convert Celsius to Kelvin.

Parameters:

Name	Type	Description	Default
celsius	float	Temperature in Celsius.	required

Returns:

Type	Description
float	Temperature in Kelvin.

Examples:

>>> units_celsius_to_kelvin(0)
273.15
>>> units_celsius_to_kelvin(100)
373.15
>>> units_celsius_to_kelvin(-273.15)
0.0

units_days_to_seconds(days: float) -> float

Convert days to seconds.

Parameters:

Name	Type	Description	Default
days	float	Time in days.	required

Returns:

Type	Description
float	Time in seconds.

Examples:

>>> units_days_to_seconds(1)
86400.0
>>> units_days_to_seconds(2)
172800.0

units_fahrenheit_to_celsius(fahrenheit: float) -> float

Convert Fahrenheit to Celsius.

Parameters:

Name	Type	Description	Default
fahrenheit	float	Temperature in Fahrenheit.	required

Returns:

Type	Description
float	Temperature in Celsius.

Examples:

>>> units_fahrenheit_to_celsius(32)
0.0
>>> units_fahrenheit_to_celsius(212)
100.0
>>> units_fahrenheit_to_celsius(-40)
-40.0

units_fahrenheit_to_kelvin(fahrenheit: float) -> float

Convert Fahrenheit to Kelvin.

Parameters:

Name	Type	Description	Default
fahrenheit	float	Temperature in Fahrenheit.	required

Returns:

Type	Description
float	Temperature in Kelvin.

Examples:

>>> units_fahrenheit_to_kelvin(32)
273.15
>>> units_fahrenheit_to_kelvin(212)
373.15

units_feet_to_meters(feet: float) -> float

Convert feet to meters.

Parameters:

Name	Type	Description	Default
feet	float	Length in feet.	required

Returns:

Type	Description
float	Length in meters.

Examples:

>>> round(units_feet_to_meters(3.28084), 2)
1.0
>>> round(units_feet_to_meters(10), 2)
3.05

units_grams_to_kilograms(grams: float) -> float

Convert grams to kilograms.

Parameters:

Name	Type	Description	Default
grams	float	Weight in grams.	required

Returns:

Type	Description
float	Weight in kilograms.

Examples:

>>> units_grams_to_kilograms(1000)
1.0
>>> units_grams_to_kilograms(500)
0.5

units_grams_to_ounces(grams: float) -> float

Convert grams to ounces.

Parameters:

Name	Type	Description	Default
grams	float	Weight in grams.	required

Returns:

Type	Description
float	Weight in ounces.

Examples:

>>> round(units_grams_to_ounces(28.3495), 2)
1.0
>>> round(units_grams_to_ounces(100), 2)
3.53

units_grams_to_pounds(grams: float) -> float

Convert grams to pounds.

Parameters:

Name	Type	Description	Default
grams	float	Weight in grams.	required

Returns:

Type	Description
float	Weight in pounds.

Examples:

>>> round(units_grams_to_pounds(453.592), 2)
1.0
>>> round(units_grams_to_pounds(1000), 2)
2.2

units_hours_to_minutes(hours: float) -> float

Convert hours to minutes.

Parameters:

Name	Type	Description	Default
hours	float	Time in hours.	required

Returns:

Type	Description
float	Time in minutes.

Examples:

>>> units_hours_to_minutes(1)
60.0
>>> units_hours_to_minutes(2)
120.0

units_hours_to_seconds(hours: float) -> float

Convert hours to seconds.

Parameters:

Name	Type	Description	Default
hours	float	Time in hours.	required

Returns:

Type	Description
float	Time in seconds.

Examples:

>>> units_hours_to_seconds(1)
3600.0
>>> units_hours_to_seconds(2)
7200.0

units_inches_to_meters(inches: float) -> float

Convert inches to meters.

Parameters:

Name	Type	Description	Default
inches	float	Length in inches.	required

Returns:

Type	Description
float	Length in meters.

Examples:

>>> round(units_inches_to_meters(39.3701), 2)
1.0
>>> round(units_inches_to_meters(10), 2)
0.25

units_kelvin_to_celsius(kelvin: float) -> float

Convert Kelvin to Celsius.

Parameters:

Name	Type	Description	Default
kelvin	float	Temperature in Kelvin.	required

Returns:

Type	Description
float	Temperature in Celsius.

Examples:

>>> units_kelvin_to_celsius(273.15)
0.0
>>> units_kelvin_to_celsius(373.15)
100.0
>>> units_kelvin_to_celsius(0)
-273.15

units_kelvin_to_fahrenheit(kelvin: float) -> float

Convert Kelvin to Fahrenheit.

Parameters:

Name	Type	Description	Default
kelvin	float	Temperature in Kelvin.	required

Returns:

Type	Description
float	Temperature in Fahrenheit.

Examples:

>>> units_kelvin_to_fahrenheit(273.15)
32.0
>>> units_kelvin_to_fahrenheit(373.15)
212.0

units_kilograms_to_grams(kilograms: float) -> float

Convert kilograms to grams.

Parameters:

Name	Type	Description	Default
kilograms	float	Weight in kilograms.	required

Returns:

Type	Description
float	Weight in grams.

Examples:

>>> units_kilograms_to_grams(1)
1000.0
>>> units_kilograms_to_grams(0.5)
500.0

units_kilometers_to_meters(kilometers: float) -> float

Convert kilometers to meters.

Parameters:

Name	Type	Description	Default
kilometers	float	Length in kilometers.	required

Returns:

Type	Description
float	Length in meters.

Examples:

>>> units_kilometers_to_meters(1)
1000.0
>>> units_kilometers_to_meters(0.5)
500.0

units_meters_to_feet(meters: float) -> float

Convert meters to feet.

Parameters:

Name	Type	Description	Default
meters	float	Length in meters.	required

Returns:

Type	Description
float	Length in feet.

Examples:

>>> units_meters_to_feet(1)
3.28084
>>> units_meters_to_feet(10)
32.8084

units_meters_to_inches(meters: float) -> float

Convert meters to inches.

Parameters:

Name	Type	Description	Default
meters	float	Length in meters.	required

Returns:

Type	Description
float	Length in inches.

Examples:

>>> round(units_meters_to_inches(1), 2)
39.37
>>> round(units_meters_to_inches(0.1), 2)
3.94

units_meters_to_kilometers(meters: float) -> float

Convert meters to kilometers.

Parameters:

Name	Type	Description	Default
meters	float	Length in meters.	required

Returns:

Type	Description
float	Length in kilometers.

Examples:

>>> units_meters_to_kilometers(1000)
1.0
>>> units_meters_to_kilometers(500)
0.5

units_meters_to_miles(meters: float) -> float

Convert meters to miles.

Parameters:

Name	Type	Description	Default
meters	float	Length in meters.	required

Returns:

Type	Description
float	Length in miles.

Examples:

>>> round(units_meters_to_miles(1609.34), 2)
1.0
>>> round(units_meters_to_miles(1000), 2)
0.62

units_miles_to_meters(miles: float) -> float

Convert miles to meters.

Parameters:

Name	Type	Description	Default
miles	float	Length in miles.	required

Returns:

Type	Description
float	Length in meters.

Examples:

>>> round(units_miles_to_meters(1), 2)
1609.34
>>> round(units_miles_to_meters(10), 2)
16093.4

units_minutes_to_hours(minutes: float) -> float

Convert minutes to hours.

Parameters:

Name	Type	Description	Default
minutes	float	Time in minutes.	required

Returns:

Type	Description
float	Time in hours.

Examples:

>>> units_minutes_to_hours(60)
1.0
>>> units_minutes_to_hours(120)
2.0

units_minutes_to_seconds(minutes: float) -> float

Convert minutes to seconds.

Parameters:

Name	Type	Description	Default
minutes	float	Time in minutes.	required

Returns:

Type	Description
float	Time in seconds.

Examples:

>>> units_minutes_to_seconds(1)
60.0
>>> units_minutes_to_seconds(2)
120.0

units_ounces_to_grams(ounces: float) -> float

Convert ounces to grams.

Parameters:

Name	Type	Description	Default
ounces	float	Weight in ounces.	required

Returns:

Type	Description
float	Weight in grams.

Examples:

>>> round(units_ounces_to_grams(1), 4)
28.3495
>>> round(units_ounces_to_grams(10), 2)
283.5

units_pounds_to_grams(pounds: float) -> float

Convert pounds to grams.

Parameters:

Name	Type	Description	Default
pounds	float	Weight in pounds.	required

Returns:

Type	Description
float	Weight in grams.

Examples:

>>> round(units_pounds_to_grams(1), 3)
453.592
>>> round(units_pounds_to_grams(2.2), 2)
997.9

units_seconds_to_days(seconds: float) -> float

Convert seconds to days.

Parameters:

Name	Type	Description	Default
seconds	float	Time in seconds.	required

Returns:

Type	Description
float	Time in days.

Examples:

>>> units_seconds_to_days(86400)
1.0
>>> units_seconds_to_days(172800)
2.0

units_seconds_to_hours(seconds: float) -> float

Convert seconds to hours.

Parameters:

Name	Type	Description	Default
seconds	float	Time in seconds.	required

Returns:

Type	Description
float	Time in hours.

Examples:

>>> units_seconds_to_hours(3600)
1.0
>>> units_seconds_to_hours(7200)
2.0

units_seconds_to_minutes(seconds: float) -> float

Convert seconds to minutes.

Parameters:

Name	Type	Description	Default
seconds	float	Time in seconds.	required

Returns:

Type	Description
float	Time in minutes.

Examples:

>>> units_seconds_to_minutes(60)
1.0
>>> units_seconds_to_minutes(120)
2.0

Modules

units_length

Length Unit Conversion

Convert between meters, feet, inches, miles, and kilometers.

Examples

from rite.conversion.units import units_meters_to_feet units_meters_to_feet(1) 3.28084 units_meters_to_feet(10) 32.8084

Functions

units_feet_to_meters(feet: float) -> float

Convert feet to meters.

Parameters:

Name	Type	Description	Default
feet	float	Length in feet.	required

Returns:

Type	Description
float	Length in meters.

Examples:

>>> round(units_feet_to_meters(3.28084), 2)
1.0
>>> round(units_feet_to_meters(10), 2)
3.05

units_inches_to_meters(inches: float) -> float

Convert inches to meters.

Parameters:

Name	Type	Description	Default
inches	float	Length in inches.	required

Returns:

Type	Description
float	Length in meters.

Examples:

>>> round(units_inches_to_meters(39.3701), 2)
1.0
>>> round(units_inches_to_meters(10), 2)
0.25

units_kilometers_to_meters(kilometers: float) -> float

Convert kilometers to meters.

Parameters:

Name	Type	Description	Default
kilometers	float	Length in kilometers.	required

Returns:

Type	Description
float	Length in meters.

Examples:

>>> units_kilometers_to_meters(1)
1000.0
>>> units_kilometers_to_meters(0.5)
500.0

units_meters_to_feet(meters: float) -> float

Convert meters to feet.

Parameters:

Name	Type	Description	Default
meters	float	Length in meters.	required

Returns:

Type	Description
float	Length in feet.

Examples:

>>> units_meters_to_feet(1)
3.28084
>>> units_meters_to_feet(10)
32.8084

units_meters_to_inches(meters: float) -> float

Convert meters to inches.

Parameters:

Name	Type	Description	Default
meters	float	Length in meters.	required

Returns:

Type	Description
float	Length in inches.

Examples:

>>> round(units_meters_to_inches(1), 2)
39.37
>>> round(units_meters_to_inches(0.1), 2)
3.94

units_meters_to_kilometers(meters: float) -> float

Convert meters to kilometers.

Parameters:

Name	Type	Description	Default
meters	float	Length in meters.	required

Returns:

Type	Description
float	Length in kilometers.

Examples:

>>> units_meters_to_kilometers(1000)
1.0
>>> units_meters_to_kilometers(500)
0.5

units_meters_to_miles(meters: float) -> float

Convert meters to miles.

Parameters:

Name	Type	Description	Default
meters	float	Length in meters.	required

Returns:

Type	Description
float	Length in miles.

Examples:

>>> round(units_meters_to_miles(1609.34), 2)
1.0
>>> round(units_meters_to_miles(1000), 2)
0.62

units_miles_to_meters(miles: float) -> float

Convert miles to meters.

Parameters:

Name	Type	Description	Default
miles	float	Length in miles.	required

Returns:

Type	Description
float	Length in meters.

Examples:

>>> round(units_miles_to_meters(1), 2)
1609.34
>>> round(units_miles_to_meters(10), 2)
16093.4

units_temperature

Temperature Unit Conversion

Convert between Celsius, Fahrenheit, and Kelvin.

Examples

from rite.conversion.units import units_celsius_to_fahrenheit units_celsius_to_fahrenheit(0) 32.0 units_celsius_to_fahrenheit(100) 212.0

Functions

units_celsius_to_fahrenheit(celsius: float) -> float

Convert Celsius to Fahrenheit.

Parameters:

Name	Type	Description	Default
celsius	float	Temperature in Celsius.	required

Returns:

Type	Description
float	Temperature in Fahrenheit.

Examples:

>>> units_celsius_to_fahrenheit(0)
32.0
>>> units_celsius_to_fahrenheit(100)
212.0
>>> units_celsius_to_fahrenheit(-40)
-40.0

units_celsius_to_kelvin(celsius: float) -> float

Convert Celsius to Kelvin.

Parameters:

Name	Type	Description	Default
celsius	float	Temperature in Celsius.	required

Returns:

Type	Description
float	Temperature in Kelvin.

Examples:

>>> units_celsius_to_kelvin(0)
273.15
>>> units_celsius_to_kelvin(100)
373.15
>>> units_celsius_to_kelvin(-273.15)
0.0

units_fahrenheit_to_celsius(fahrenheit: float) -> float

Convert Fahrenheit to Celsius.

Parameters:

Name	Type	Description	Default
fahrenheit	float	Temperature in Fahrenheit.	required

Returns:

Type	Description
float	Temperature in Celsius.

Examples:

>>> units_fahrenheit_to_celsius(32)
0.0
>>> units_fahrenheit_to_celsius(212)
100.0
>>> units_fahrenheit_to_celsius(-40)
-40.0

units_fahrenheit_to_kelvin(fahrenheit: float) -> float

Convert Fahrenheit to Kelvin.

Parameters:

Name	Type	Description	Default
fahrenheit	float	Temperature in Fahrenheit.	required

Returns:

Type	Description
float	Temperature in Kelvin.

Examples:

>>> units_fahrenheit_to_kelvin(32)
273.15
>>> units_fahrenheit_to_kelvin(212)
373.15

units_kelvin_to_celsius(kelvin: float) -> float

Convert Kelvin to Celsius.

Parameters:

Name	Type	Description	Default
kelvin	float	Temperature in Kelvin.	required

Returns:

Type	Description
float	Temperature in Celsius.

Examples:

>>> units_kelvin_to_celsius(273.15)
0.0
>>> units_kelvin_to_celsius(373.15)
100.0
>>> units_kelvin_to_celsius(0)
-273.15

units_kelvin_to_fahrenheit(kelvin: float) -> float

Convert Kelvin to Fahrenheit.

Parameters:

Name	Type	Description	Default
kelvin	float	Temperature in Kelvin.	required

Returns:

Type	Description
float	Temperature in Fahrenheit.

Examples:

>>> units_kelvin_to_fahrenheit(273.15)
32.0
>>> units_kelvin_to_fahrenheit(373.15)
212.0

units_time

Time Unit Conversion

Convert between seconds, minutes, hours, and days.

Examples

from rite.conversion.units import units_seconds_to_minutes units_seconds_to_minutes(60) 1.0 units_seconds_to_minutes(120) 2.0

Functions

units_days_to_seconds(days: float) -> float

Convert days to seconds.

Parameters:

Name	Type	Description	Default
days	float	Time in days.	required

Returns:

Type	Description
float	Time in seconds.

Examples:

>>> units_days_to_seconds(1)
86400.0
>>> units_days_to_seconds(2)
172800.0

units_hours_to_minutes(hours: float) -> float

Convert hours to minutes.

Parameters:

Name	Type	Description	Default
hours	float	Time in hours.	required

Returns:

Type	Description
float	Time in minutes.

Examples:

>>> units_hours_to_minutes(1)
60.0
>>> units_hours_to_minutes(2)
120.0

units_hours_to_seconds(hours: float) -> float

Convert hours to seconds.

Parameters:

Name	Type	Description	Default
hours	float	Time in hours.	required

Returns:

Type	Description
float	Time in seconds.

Examples:

>>> units_hours_to_seconds(1)
3600.0
>>> units_hours_to_seconds(2)
7200.0

units_minutes_to_hours(minutes: float) -> float

Convert minutes to hours.

Parameters:

Name	Type	Description	Default
minutes	float	Time in minutes.	required

Returns:

Type	Description
float	Time in hours.

Examples:

>>> units_minutes_to_hours(60)
1.0
>>> units_minutes_to_hours(120)
2.0

units_minutes_to_seconds(minutes: float) -> float

Convert minutes to seconds.

Parameters:

Name	Type	Description	Default
minutes	float	Time in minutes.	required

Returns:

Type	Description
float	Time in seconds.

Examples:

>>> units_minutes_to_seconds(1)
60.0
>>> units_minutes_to_seconds(2)
120.0

units_seconds_to_days(seconds: float) -> float

Convert seconds to days.

Parameters:

Name	Type	Description	Default
seconds	float	Time in seconds.	required

Returns:

Type	Description
float	Time in days.

Examples:

>>> units_seconds_to_days(86400)
1.0
>>> units_seconds_to_days(172800)
2.0

units_seconds_to_hours(seconds: float) -> float

Convert seconds to hours.

Parameters:

Name	Type	Description	Default
seconds	float	Time in seconds.	required

Returns:

Type	Description
float	Time in hours.

Examples:

>>> units_seconds_to_hours(3600)
1.0
>>> units_seconds_to_hours(7200)
2.0

units_seconds_to_minutes(seconds: float) -> float

Convert seconds to minutes.

Parameters:

Name	Type	Description	Default
seconds	float	Time in seconds.	required

Returns:

Type	Description
float	Time in minutes.

Examples:

>>> units_seconds_to_minutes(60)
1.0
>>> units_seconds_to_minutes(120)
2.0

units_weight

Weight Unit Conversion

Convert between grams, kilograms, pounds, and ounces.

Examples

from rite.conversion.units import units_grams_to_kilograms units_grams_to_kilograms(1000) 1.0 units_grams_to_kilograms(500) 0.5

Functions

units_grams_to_kilograms(grams: float) -> float

Convert grams to kilograms.

Parameters:

Name	Type	Description	Default
grams	float	Weight in grams.	required

Returns:

Type	Description
float	Weight in kilograms.

Examples:

>>> units_grams_to_kilograms(1000)
1.0
>>> units_grams_to_kilograms(500)
0.5

units_grams_to_ounces(grams: float) -> float

Convert grams to ounces.

Parameters:

Name	Type	Description	Default
grams	float	Weight in grams.	required

Returns:

Type	Description
float	Weight in ounces.

Examples:

>>> round(units_grams_to_ounces(28.3495), 2)
1.0
>>> round(units_grams_to_ounces(100), 2)
3.53

units_grams_to_pounds(grams: float) -> float

Convert grams to pounds.

Parameters:

Name	Type	Description	Default
grams	float	Weight in grams.	required

Returns:

Type	Description
float	Weight in pounds.

Examples:

>>> round(units_grams_to_pounds(453.592), 2)
1.0
>>> round(units_grams_to_pounds(1000), 2)
2.2

units_kilograms_to_grams(kilograms: float) -> float

Convert kilograms to grams.

Parameters:

Name	Type	Description	Default
kilograms	float	Weight in kilograms.	required

Returns:

Type	Description
float	Weight in grams.

Examples:

>>> units_kilograms_to_grams(1)
1000.0
>>> units_kilograms_to_grams(0.5)
500.0

units_ounces_to_grams(ounces: float) -> float

Convert ounces to grams.

Parameters:

Name	Type	Description	Default
ounces	float	Weight in ounces.	required

Returns:

Type	Description
float	Weight in grams.

Examples:

>>> round(units_ounces_to_grams(1), 4)
28.3495
>>> round(units_ounces_to_grams(10), 2)
283.5

units_pounds_to_grams(pounds: float) -> float

Convert pounds to grams.

Parameters:

Name	Type	Description	Default
pounds	float	Weight in pounds.	required

Returns:

Type	Description
float	Weight in grams.

Examples:

>>> round(units_pounds_to_grams(1), 3)
453.592
>>> round(units_pounds_to_grams(2.2), 2)
997.9

options: show_root_heading: true show_source: false heading_level: 2