a tool for dimensional analysis: a "Unit CONverter"
Pronounced: yoo · cahn
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?".
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
The above calculation can be achieved using types defined in the
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>
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size ucon-0.2.1.tar.gz (2.8 kB)||File type Source||Python version None||Upload date||Hashes View|