Numerinus.UnitConversion 1.0.1

Prefix Reserved
.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Numerinus.UnitConversion --version 1.0.1
                    


                    

                
NuGet\Install-Package Numerinus.UnitConversion -Version 1.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Numerinus.UnitConversion" Version="1.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Numerinus.UnitConversion" Version="1.0.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Numerinus.UnitConversion" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Numerinus.UnitConversion --version 1.0.1
                    


                    

                
#r "nuget: Numerinus.UnitConversion, 1.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Numerinus.UnitConversion@1.0.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Numerinus.UnitConversion&version=1.0.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Numerinus.UnitConversion&version=1.0.1
                    


                            Install as a Cake Tool

Project Title

A brief description of what this project does and who it's for

Numerinus.UnitConversion

Unit conversion module for the Numerinus mathematical suite. Built on top of Numerinus.Core, this package provides accurate, strongly-typed unit conversions across a range of physical measurement categories.

NuGet License: MIT

Features

  • IUnitConversion<TUnit> — Generic interface for all unit converters, enabling consistent and type-safe conversions
  • LengthConverter — Convert between metric and imperial length units
  • VolumeConverter — Convert between metric and imperial volume units
  • All converters use a base unit strategy for accurate multi-step conversions

Installation

Length Conversion

Base unit: Meter

Supported Units (LengthEnum)

Enum Value Unit
Nanometer Nanometer (nm)
Micrometer Micrometer (µm)
Millimeter Millimeter (mm)
Centimeter Centimeter (cm)
Decimeter Decimeter (dm)
Meter Meter (m) — base unit
Decameter Decameter (dam)
Hectometer Hectometer (hm)
Kilometer Kilometer (km)
Inch Inch (in)
Foot Foot (ft)
Yard Yard (yd)
Furlong Furlong
Mile Mile (mi)
NauticalMile Nautical Mile (nmi)

Usage

using Numerinus.Core.Enums; using Numerinus.UnitConversion.Calculators; var converter = new LengthConverter();

// Kilometers to Miles double miles = converter.Convert(10, LengthEnum.Kilometer, LengthEnum.Mile); Console.WriteLine(miles); // ~6.2137

// Feet to Meters double meters = converter.Convert(100, LengthEnum.Foot, LengthEnum.Meter); Console.WriteLine(meters); // 30.48

// To base unit (Meter) double baseValue = converter.ConvertToBaseUnit(5, LengthEnum.Kilometer); Console.WriteLine(baseValue); // 5000

// From base unit (Meter) double inches = converter.ConvertFromBaseUnit(1, LengthEnum.Inch); Console.WriteLine(inches); // ~39.3701

Volume Conversion

Base unit: Cubic Meter

Supported Units (VolumeEnum)

Enum Value Unit
CubicMillimeter Cubic Millimeter (mm³)
CubicCentimeter Cubic Centimeter (cm³)
CubicDecimeter Cubic Decimeter (dm³)
CubicMeter Cubic Meter (m³) — base unit
CubicKilometer Cubic Kilometer (km³)
Milliliter Milliliter (mL)
Liter Liter (L)
Deciliter Deciliter (dL)
Hectoliter Hectoliter (hL)
Kiloliter Kiloliter (kL)
FluidOunce Fluid Ounce (US fl oz)
Pint Pint (US liquid pt)
Quart Quart (US liquid qt)
Gallon Gallon (US liquid gal)

Usage

using Numerinus.Core.Enums; using Numerinus.UnitConversion.Calculators; var converter = new VolumeConverter();

// Liters to Gallons double gallons = converter.Convert(10, VolumeEnum.Liter, VolumeEnum.Gallon); Console.WriteLine(gallons); // ~2.6417

// Cubic Meters to Liters double liters = converter.Convert(1, VolumeEnum.CubicMeter, VolumeEnum.Liter); Console.WriteLine(liters); // 1000

// Fluid Ounces to Milliliters double ml = converter.Convert(8, VolumeEnum.FluidOunce, VolumeEnum.Milliliter); Console.WriteLine(ml); // ~236.588

// To base unit (Cubic Meter) double baseValue = converter.ConvertToBaseUnit(500, VolumeEnum.Liter); Console.WriteLine(baseValue); // 0.5

// From base unit (Cubic Meter) double pints = converter.ConvertFromBaseUnit(1, VolumeEnum.Pint); Console.WriteLine(pints); // ~2113.38

Speed

Enum Value Unit
MeterPerSecond Meter per Second (m/s) — base unit
KilometerPerHour Kilometer per Hour (km/h)
MeterPerMinute Meter per Minute (m/min)
CentimeterPerSecond Centimeter per Second (cm/s)
MilePerHour Mile per Hour (mph)
FootPerSecond Foot per Second (ft/s)
FootPerMinute Foot per Minute (ft/min)
InchPerSecond Inch per Second (in/s)
Knot Knot (nmi/h)
MachNumber Mach Number (≈ 343 m/s at sea level, 20°C)
SpeedOfLight Speed of Light (c = 299,792,458 m/s)

Usage

using Numerinus.Core.Enums; using Numerinus.UnitConversion.Calculators;

var converter = new SpeedConverter();

// Kilometers per Hour to Miles per Hour double mph = converter.Convert(100, SpeedEnum.KilometerPerHour, SpeedEnum.MilePerHour); Console.WriteLine(mph); // ~62.1371

// Meters per Second to Knots double knots = converter.Convert(10, SpeedEnum.MeterPerSecond, SpeedEnum.Knot); Console.WriteLine(knots); // ~19.4384

// Miles per Hour to Mach Number double mach = converter.Convert(767, SpeedEnum.MilePerHour, SpeedEnum.MachNumber); Console.WriteLine(mach); // ~1.0 (approximately Mach 1)

// To base unit (m/s) double ms = converter.ConvertToBaseUnit(120, SpeedEnum.KilometerPerHour); Console.WriteLine(ms); // 33.3333

// From base unit (m/s) double ftps = converter.ConvertFromBaseUnit(10, SpeedEnum.FootPerSecond); Console.WriteLine(ftps); // ~32.8084

Architecture

All converters implement the generic IUnitConversion<TUnit> interface from Numerinus.Core:

public interface IUnitConversion<TUnit> where TUnit : Enum { double Convert(double value, TUnit fromUnit, TUnit toUnit); double ConvertToBaseUnit(double value, TUnit fromUnit); double ConvertFromBaseUnit(double baseValue, TUnit toUnit); }

Conversions follow a two-step base unit strategy:

  1. Convert the input value to the base unit
  2. Convert the base unit to the target unit

This ensures accuracy across any combination of units without requiring an N×N conversion table.

Dependencies

  • Numerinus.Core — For the IUnitConversion<TUnit> interface and unit enums
Package Description
Numerinus.Core Foundational types and interfaces
Numerinus.Algebra Polynomial, rational functions, and linear systems
Numerinus.Geometry Geometric types and transformations

Support & Maintenance

Numerinus is an actively maintained suite of .NET libraries. To ensure updates, bug fixes, and new converters continue to ship, consider supporting the project:

License

Copyright (c) 2026 Sunil Chaware. Licensed under the MIT License. https://opensource.org/licenses/MIT

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  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 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
1.0.4 79 4/6/2026
1.0.2 87 4/1/2026
1.0.1 90 3/31/2026
1.0.0 80 3/30/2026