Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aurora-opensource/au
A C++14-compatible physical units library with no dependencies and a single-file delivery option. Emphasis on safety, accessibility, performance, and developer experience.
https://github.com/aurora-opensource/au
bazel compile-time cpp cpp14 cpp14-library dimensional-analysis header-only header-only-library no-dependencies physical-quantities physical-units quantity single-header-library unit-of-measure units units-of-measure
Last synced: 5 days ago
JSON representation
A C++14-compatible physical units library with no dependencies and a single-file delivery option. Emphasis on safety, accessibility, performance, and developer experience.
- Host: GitHub
- URL: https://github.com/aurora-opensource/au
- Owner: aurora-opensource
- License: apache-2.0
- Created: 2022-09-22T19:37:38.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-19T01:02:58.000Z (7 months ago)
- Last Synced: 2023-12-19T15:59:52.765Z (7 months ago)
- Topics: bazel, compile-time, cpp, cpp14, cpp14-library, dimensional-analysis, header-only, header-only-library, no-dependencies, physical-quantities, physical-units, quantity, single-header-library, unit-of-measure, units, units-of-measure
- Language: C++
- Homepage:
- Size: 6.2 MB
- Stars: 184
- Watchers: 5
- Forks: 11
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Support: docs/supported-compilers.md
Lists
- awesome-cpp - Au - A C++14-compatible physical units library with no dependencies and a single-file delivery option. Emphasis on safety, accessibility, performance, and developer experience. [Apache 2.0] [website](https://aurora-opensource.github.io/au/main/) (Scientific Computing)
- fucking-awesome-cpp - Au - A C++14-compatible physical units library with no dependencies and a single-file delivery option. Emphasis on safety, accessibility, performance, and developer experience. [Apache 2.0] 🌎 [website](aurora-opensource.github.io/au/main/) (Scientific Computing)
README
[](
https://github.com/aurora-opensource/au/actions/workflows/clang14-ubuntu.yml) [](
https://github.com/aurora-opensource/au/actions/workflows/clang11-ubuntu.yml) [](
https://github.com/aurora-opensource/au/actions/workflows/gcc10-ubuntu.yml) [](
https://github.com/aurora-opensource/au/actions/workflows/msvc-x64-19-29-30151.yml) [](
https://github.com/aurora-opensource/au/actions/workflows/msvc-x64-19-35-32217-1.yml)
# Au: A C++14-compatible units library, by Aurora
Au (pronounced "ay yoo") is a C++ units library, by [Aurora](https://aurora.tech/). What the
`` library did for time variables, _Au_ does for _all physical quantities_ (lengths, speeds,
voltages, and so on). Namely:
- Catch unit errors at compile time, with **no runtime penalty**.
- Make unit conversions effortless to get right.
- _Accelerate and improve your general developer experience._
In short: if your C++ programs handle physical quantities, Au will make you faster and more
effective at your job. You'll find everything you need in our [full documentation
website](https://aurora-opensource.github.io/au).
> _Try it out on [Compiler Explorer ("godbolt")](https://godbolt.org/z/KrvfhP4M3)!_
## Why Au?
There are many other C++ units libraries, several quite well established. Each of them offers
_some_ of the following properties, but **only Au** offers _all_ of them:
- Wide compatibility with C++ versions (anything C++14 or newer).
- Easy installation in any project (including a customizable single-header option).
- Small compile time burden.
- Concise, readable typenames in compiler errors.
We also provide several totally new features, including fully unit-safe APIs, an adaptive "safety
surface" that protects conversions against overflow, unit-aware rounding and inverse functions, and
many more.
Forged in the crucible of Aurora's diverse, demanding use cases, Au has a proven track record of
usability and reliability. This **includes embedded support**: Aurora's embedded teams have been
first class customers since the library's inception.
To learn more about our place in the C++ units library ecosystem, see our [detailed library
comparison](https://aurora-opensource.github.io/au/main/alternatives/).
## Getting started
Our [installation instructions](https://aurora-opensource.github.io/au/main/install/) can have you
up and running in minutes, in any project that supports C++14 or newer.
To use the library effectively, we recommend working through the
[tutorials](https://aurora-opensource.github.io/au/main/tutorial/), starting with [Au 101: Quantity
Makers](https://aurora-opensource.github.io/au/main/tutorial/101-quantity-makers/). To
get set up with the tutorials — or, to contribute to the library — check out our [development
guide](https://aurora-opensource.github.io/au/main/develop/).
## As seen at CppCon 2021
At CppCon 2021, we
[presented](https://cppcon2021.sched.com/event/nvCp/units-libraries-and-autonomous-vehicles-lessons-from-the-trenches)
the properties we found to be most important in units libraries, and advice on using them
effectively. Because Au was designed from the ground up with these best practices in mind, it
thoroughly exemplifies them. Check out the video below, and follow along with [the slide
deck](https://chogg.name/cppcon-2021-units/) if you like.
[](https://www.youtube.com/watch?v=5dhFtSu3wCo)
> NOTE: This open-source version has been significantly improved from what was presented in the
talk: both in its user interfaces, _and_ under the hood! The one downside is that matrix and vector
support hasn't yet been implemented. See [#70](https://github.com/aurora-opensource/au/issues/70)
for more details, and subscribe to that issue to watch for progress.