ucon
Pronounced: yoo · cahn
Background
Numbers are particularly helpful when describing quantities of some thing (say, 42 ice cream cones 🍦). They are also useful when describing characteristics of a thing such as it's weight or volume. Being able to describe a thing by measurements of its defining features and even monitoring said features over time, is foundational to developing an understanding of how the thing works in the world. "Units" is the general term for those quantifying descriptors that characterize an object. Specific units include those like grams for weight, liter for volume, and even the jiffy for time. With means to refer to an object's physical characteristics, their extent can be communicated using a scale to answer the question: "how many of a given unit accurately describe that aspect of the object?".
Introduction
Since the metric scale is fairly ubiquitous and straightfowrward to count with (being base 10 and all..), ucon uses the Metric System as the basis for measurement though binary prefixes are also supported.
The crux of this tiny library is to provide abstractions that simplify the answering of questions like:
"If given two milliliters of bromine (liquid Br2), how many grams of bromine does one have?"
To best answer this question, we turn to an age-old technique (dimensional analysis) which essentially allows for the solution to be written as a product of ratios.
2 mL bromine | 3.119 g bromine
--------------x----------------- #=> 6.238 g bromine
1 | 1 mL bromine
Setup
Ensure nox is installed.
pip install -r requirements.txt
Run nox -s install to install ucon and nox -s test to run tests.
Usage
The above calculation can be achieved using types defined in the ucon module.
two_milliliters_bromine = Number(unit=Units.liter, scale=Scale.milli, quantity=2)
bromine_density = Ratio(numerator=Number(unit=Units.gram, quantity=3.119)
denominator=Number(unit=Units.liter, scale=Scale.milli))
two_milliliters_bromine * bromine_density #=> <6.238 gram>
One can also arbitrarily change scale:
answer = two_milliliters_bromine * bromine_density #=> <6.238 gram>
answer.to(Scale.milli) #=> <6238.0 milligram>
answer.to(Scale.kibi) #=> <0.006091796875 kibigram>
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file ucon-0.3.0.tar.gz.
File metadata
- Download URL: ucon-0.3.0.tar.gz
- Upload date:
- Size: 20.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.9.24
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
380d3abacc362015513eb6eb0b72b3b7bb43f90ef6cc076cb185405bbb6b28e5
|
|
| MD5 |
9746b430f2c6f125231b21a9a9bcdfb7
|
|
| BLAKE2b-256 |
2c456b387ec2028d4a23ed61cf7ff5cf3dffc931d8febc03283a987bfb5d2e21
|
