Skip to content

Update comparison table #175

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
chiphogg merged 2 commits into from
Oct 9, 2023
Merged

Update comparison table #175

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5216431
Update comparison table
chiphogg Sep 29, 2023
9580fae
Address review feedback
chiphogg Oct 1, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
100 changes: 80 additions & 20 deletions docs/alternatives/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ indicate which version we considered, and say a few words about why we included
used C++ units library to date.
- [**bernedom/SI**](https://github.com/bernedom/SI) (version: 2.5.1)
- A newer, C++17-compatible offering with a large number of GitHub stars.
- [**mp-units**](https://github.com/mpusz/mp-units) (version: 2.0.0:testing)
- [**mp-units**](https://github.com/mpusz/mp-units) (version: 2.0.0)
- A library designed to take full advantage of ultra-modern (that is, post-C++20 watershed)
features, such as concepts and non-template type parameters (NTTPs).
- mp-units is leading the efforts towards a standard C++ units library, both by field testing
Expand Down Expand Up @@ -320,8 +320,8 @@ features.
<td class="fair"></td>
<td class="fair"></td>
<td class="fair"></td>
<td class="good">Contains unit-safe interfaces</td>
<td class="best">Only contains unit-safe interfaces</td>
<td class="good">Only contains unit-safe interfaces</td>
<td class="good">Only contains unit-safe interfaces</td>
</tr>
<tr>
<td>
Expand Down Expand Up @@ -391,11 +391,36 @@ features.
</p>
</details>
</td>
<td class="fair"><a href="https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2020/p1935r2.html#comparison">Prefix only</a></td>
<td class="good">
<ul>
<li class="check">
Can compose units, prefixes, dimensions, and quantity (point) makers
</li>
<li class="x">
Type names clunky to compose: must write <code>decltype</code>
</li>
</ul>
</td>
<td class="poor"><a href="https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2020/p1935r2.html#comparison">No</a></td>
<td class="poor">No</td>
<td class="good">Can compose units, prefixes, dimensions, and quantity types</td>
<td class="good">QuantityMaker and PrefixApplier APIs</td>
<td class="best">
<ul>
<li class="check">Can compose units, prefixes, dimensions, and quantity types</li>
<li class="check">
C++20's Non-type template parameters (NTTPs) enable composable <i>type names</i>
</li>
</ul>
</td>
<td class="good">
<ul>
<li class="check">
Can compose units, prefixes, dimensions, and quantity (point) makers
</li>
<li class="x">
Type names clunky to compose: must write <code>decltype</code> or use traits
</li>
</ul>
</td>
</tr>
<tr>
<td>
Expand Down Expand Up @@ -499,9 +524,12 @@ features.
<li class="check">
Unit-safe APIs for <code>round</code>, <code>ceil</code>, and so on
</li>
<li class="check">
Smart, unit-aware inverse functions
</li>
</ul>
</td>
<td class="best">
<td class="good">
<ul>
<li class="check">Wide variety of functions</li>
<li class="check">
Expand Down Expand Up @@ -586,11 +614,31 @@ features.
<td class="fair">No interop with other units libraries</td>
<td class="fair">No interop with other units libraries</td>
<td class="good">
<a href="https://mpusz.github.io/units/use_cases/interoperability.html">
<code>quantity_like_traits</code>
</a>
<ul>
<li class="check">
<a href="https://mpusz.github.io/mp-units/2.1/users_guide/framework_basics/basic_concepts/#QuantityLike">
<code>QuantityLike&lt;T&gt;</code> supports bidirectional conversions
</a>
</li>
<li class="check">
Can specify implicit or explicit
</li>
</ul>
</td>
<td class="good">
<ul>
<li class="check">
<a href="https://aurora-opensource.github.io/au/main/howto/interop/">
<code>CorrespondingQuantity</code> supports bidirectional implicit conversions
</a>
</li>
<li class="check">
Supports <a
href="https://aurora-opensource.github.io/au/main/reference/corresponding_quantity/#conversions">"two-hop"
conversions</a>
</li>
</ul>
</td>
<td class="best">"Equivalent types" feature gives more API compatibility</td>
</tr>
<tr>
<td>
Expand All @@ -613,7 +661,9 @@ features.
point</a>.
</td>
<td class="poor">None; would be hard to add, since units conflated with quantity type</td>
<td class="good"></td>
<td class="best">
Custom origins really easy to use and compose
</td>
<td class="good"></td>
</tr>
<tr>
Expand Down Expand Up @@ -698,7 +748,7 @@ features.
</p>
</details>
</td>
<td class="poor"></td>
<td class="na"></td>
<td class="good">User-defined literals (UDLs)</td>
<td class="good">User-defined literals (UDLs)</td>
<td class="best">
Expand Down Expand Up @@ -792,7 +842,12 @@ features.
</td>
<td class="fair">Supports <code>copysign()</code>, but no special construction or comparison</td>
<td class="poor">No special construction or comparison</td>
<td class="fair">Has <code>q::zero()</code> member, but no special construction or comparison</td>
<td class="good">
<li class="check">
<a href="https://mpusz.github.io/mp-units/2.1/users_guide/framework_basics/quantity_arithmetics/?h=zero#comparison-against-zero">Special comparison functions</a>
</li>
<li><code>zero()</code> member</li>
</td>
<td class="best">
Can use <a
href="https://aurora-opensource.github.io/au/main/discussion/concepts/zero/"><code>ZERO</code></a>
Expand Down Expand Up @@ -820,7 +875,7 @@ features.
<li class="x">pi represented as <code>std::ratio</code></li>
</ul>
</td>
<td class="good"></td>
<td class="best">Simultaneous support for both strongly-typed and "pure SI" angles</td>
<td class="good"></td>
</tr>
<tr>
Expand Down Expand Up @@ -904,7 +959,7 @@ features.
<tr>
<td>
<details class="criterion">
<summary>Units/Dimensions as types</summary>
<summary>Abstract Units/Dimensions</summary>
<p>
<li>
Types that represent abstract units (clearly distinct from quantities of
Expand Down Expand Up @@ -946,10 +1001,15 @@ features.
</p>
</details>
</td>
<td class="poor">Present in user-facing APIs</td>
<td class="poor">Present in user-facing APIs</td>
<td class="fair">Very few, and confined to implementation helpers</td>
<td class="fair">Very few, and confined to implementation helpers</td>
<td class="poor">Common in user-facing APIs</td>
<td class="poor">Common in user-facing APIs</td>
<td class="good">Very few, and confined to implementation helpers</td>
<td class="fair">
<ul>
<li>Very few, mostly implementation helpers</li>
<li>Only one user-facing macro for C++20 backwards compatibility</li>
</ul>
</td>
<td class="best">No macros</td>
</tr>
</table>