Roland Conybeare
d1fa15f248
git-subtree-dir: xo-unit git-subtree-mainline:e9ee6992cagit-subtree-split:b531e382c2
48 lines
1.6 KiB
ReStructuredText
48 lines
1.6 KiB
ReStructuredText
.. xo-unit-examples documentation master file, created by
|
|
sphinx-quickstart on Wed Mar 6 23:32:27 2024.
|
|
You can adapt this file completely to your liking, but it should at least
|
|
contain the root `toctree` directive.
|
|
|
|
xo-unit documentation
|
|
=====================
|
|
|
|
xo-unit is a lightweight header-only library that provides compile-time
|
|
dimension checking and unit conversion.
|
|
|
|
Functionality is similar in spirit to that provided by ``boost::units``;
|
|
however there are some important differences:
|
|
|
|
* streamlined implementation using c++20 features.
|
|
* along with no-runtime-overhead compile-time unit inference,
|
|
also provides defer-until-runtime representation.
|
|
* constexpr string representation for things like unit abbreviations.
|
|
* supports fractional dimensions, for concepts like volatility.
|
|
* integration with python (see sister project xo-pyunit)
|
|
|
|
Second, ``xo-unit`` supports fractional dimensions. This allows using it to naturally handle
|
|
concepts like volatility (dimension 1/sqrt(time)), for example.
|
|
|
|
Finally, ``xo-unit`` is written with the expectation of providing
|
|
python integration via pybind11. This requires a parallel set of data structures that can work at
|
|
runtime (since we can't construct new c++ types at runtime).
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
:caption: xo-unit contents
|
|
|
|
install
|
|
examples
|
|
implementation
|
|
quantity-reference
|
|
xquantity-reference
|
|
scaled-unit-reference
|
|
natural-unit-class
|
|
bpu-class
|
|
bu-store-class
|
|
basis-unit-reference
|
|
dimension-enum
|
|
development
|
|
ubuntu-github-workflow
|
|
glossary
|
|
genindex
|
|
search
|