Magnitudo 0.3.0-beta.4
See the version list below for details.
dotnet add package Magnitudo --version 0.3.0-beta.4
NuGet\Install-Package Magnitudo -Version 0.3.0-beta.4
<PackageReference Include="Magnitudo" Version="0.3.0-beta.4" />
<PackageVersion Include="Magnitudo" Version="0.3.0-beta.4" />
<PackageReference Include="Magnitudo" />
paket add Magnitudo --version 0.3.0-beta.4
#r "nuget: Magnitudo, 0.3.0-beta.4"
#:package Magnitudo@0.3.0-beta.4
#addin nuget:?package=Magnitudo&version=0.3.0-beta.4&prerelease
#tool nuget:?package=Magnitudo&version=0.3.0-beta.4&prerelease
Magnitudo
Magnitudo is a compile-time dimensional analysis library for C#.
Magnitudo itself is simple:
- You list your quantities in a catalog file,
- A source generator turns each one into a
global usingalias, and - An analyzer fails the build when an expression mixes dimensions.
static float Total(Pascal pressure, Kelvin temperature) => pressure + temperature;
// error QNT001: Operator '+' cannot combine 'length^-1 mass^1 time^-2' and 'temperature'
Strengths
- Zero runtime cost: a
Kelvinis afloatin the compiled assembly - Arrays stay primitive arrays, so SIMD, spans, and interop work as usual
- Native AOT and trimming are unaffected
- Dimensions are integer exponent vectors over any base names you choose, not a fixed SI set
- Several storage types per quantity (
KelvinandKelvin64) - Generated, checked conversions to and from external units such as Celsius
- Quantities survive across assemblies through
[Quantity]and[ElementQuantity] - Mismatches are ordinary Roslyn errors, controlled with
.editorconfiglike any other
Weaknesses
- The C# compiler cannot tell
KelvinfromPascal, so checks cover only annotated code - Quantities with the same exponents are interchangeable, so torque and energy look identical
Math.Sqrt,Math.Pow, and most other functions return an unknown quantity- Tuples,
foreachvariables, and whole-collection assignments are not checked - No fractional exponents
Installation
dotnet add package Magnitudo --prerelease
dotnet add package Magnitudo.Analyzers --prerelease
Then add a .magnitudo catalog as an AdditionalFiles item. Getting started walks through it.
Recommended reading
- Getting started
- How Magnitudo works
- The catalog format
- Diagnostics
- Gotchas
- What the analyzer does not check
- Versioning and releasing
Bug reports and contributions
Bug reports and pull requests are welcome on GitHub. Build and test with:
dotnet build Magnitudo.slnx -c Release
dotnet test Magnitudo.slnx -c Release
Copyright, credits, and license
Magnitudo is licensed under the MIT license. See LICENSE.TXT for more info.
Magnitudo began as Numos.Units, the dimensional analysis layer of the Numos
atmospherics library. Numos needed to track quantities through a solution without wrapper types or runtime cost.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- No dependencies.
-
net10.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.4.0-beta.1 | 231 | 10/25/2026 |
| 0.3.0-beta.4 | 119 | 10/23/2026 |
| 0.3.0-beta.3 | 66 | 10/23/2026 |
| 0.3.0-beta.2 | 72 | 10/22/2026 |
| 0.3.0-beta.1 | 60 | 10/22/2026 |
| 0.2.0-alpha.1 | 87 | 10/1/2026 |