unitates 1.0.14

Python library for working with custom and predefined number measurement units

Unitates

It is a simple yet powerful package for creating and working with units of measurement. You can simply create your own units or use predefined ones.

Supports all mathematical operations, construction of complex units such as m/s, kg/m^2, etc., unit conversions, comparison of units, basic work with arrays.

Feel free to ask questions, suggest new ideas, open new issues and create pull requests.

I will be happy to cooperate!

Installation

git clone https://github.com/LubomyrIvanitskiy/unitates.git

or

pip install unitates

Usage

Using predefined units

from units.constants.time import *
from units.constants.length import *

>>> km(2) # create a unit with constructor
2 km
>>> 2*km # create a unit by multiplication
2 km
>>> 2>>km # create a unit by conversion operator (overloaded rshift)
2 km
>>> 2*km + 3*m # result will be always in lower units
2003 m
>>> 2*m/sec
2 m/sec
>>> 3*m / sec(2)
1.5 m/sec
>>> 2*m/sec >> km/hr # unit conversion
7.2 km/hr
>>> a=[[1,2,3], [4,5,6]] >> m/sec**2 # list conversion
>>> a
[[1 m/sec^2, 2 m/sec^2, 3 m/sec^2], [4 m/sec^2, 5 m/sec^2, 6 m/sec^2]]
>>> a >> km/hr**2
[[12960 km/hr^2, 25920 km/hr^2, 38880 km/hr^2], [51840 km/hr^2, 64800 km/hr^2, 77760 km/hr^2]]
>>> 10*m/sec**2 > 2*km/hr**2 # comparasion example 
True
>>> 60*min == 1*hr # equality
True
>>> d = {60*sec: "a"} #hash overriding
>>> min in d
True

Custom units

Creating your own units

To create you own units call create_units function with named parameters where the name is the unit name and the value is the weight of the unit relative to the previous one:

>>> from units import create_units
>>> characters, words, sentences, paragraphs, pages, chapters, books = create_units(
...     group_name="Book",
...     characters=1, 
...     words=4.7,
...     sentences=21, 
...     paragraphs=3.5, 
...     pages=3, 
...     chapters=13,
...     books=3)
>>> hound_of_the_baskervilles_book = 256*pages
>>> hound_of_the_baskervilles_book >> words
56447.99999999999 words

Use already created custom units

Loading group of units

>>> from units import load_units
>>> characters, words, sentences, paragraphs, pages, chapters, books = load_units(group_name="Book")
>>> 200*sentences >> pages
19.04761904761905 pages

Loading specific units

>>> from units import load_units
>>> words, pages = load_units("words", "pages")
>>> pages >> words
220.49999999999997 words

The result of load_units is a namedtuple, so you can use it in the following way:

>>> from units import load_units
>>> units = load_units("words", "pages")
>>> units.pages >> units.words
220.49999999999997 words

There is also additional argument for customising result according to your needs

Units cleanup

If your custom units is no longer needed make sure they are properly reset

>>> from units import destroy_units
>>> destroy_units(group_name="Book")