CACTI.Units 1.1.0

CACTI.Units

Manage units with conversions and mathematical operations.

Most code is generated through ISourceGenerator with AdditionalFiles for units descriptions.

Unit Dimensions

Units are defined by their base dimensions like (with international system and imperial units support):

• Activity
• Angle
• Count
• Current
• Disk size
• Distance
  • SI: Meter, Kilometer, ...
  • Imperial: Inch, Foot, Yard, Mile, ...
• Duration
• Energy
• Force
• Gravity
• Mass
• Radiation dose
• Resistance
• Revolution
• Temperature
• Voltage
• Watt
• Ratio

Composed unit dimensions

Some units dimensions are composed by other dimensions like:

• Accelerations (Speed / Duration)
• Count rate
• Radiation rate
• Revolution speed
• Speeds (Distance / Duration)
  • SI: Meter per second, ...
  • Imperial: Mile per hour, ...
• Radation rates (Dose / Duration)
• Surface (Distance²)
• Volume (Distance ^ 3)
  • SI: cubic meter, liter, ...
  • Imperial: Pint, Gallon, ...

Comparisons

Units of the same dimensions can be compared:

• Equality (Equals or ==)
• Difference ( != )
• Superior ( > )
• Inferior ( < )
• Superior or equal ( >= )
• Inferior or equal ( ⇐ )

Speed speed = (MeterPerSecond)10;
KilometerPerHour kilometerPerHour = 60;
Assert.IsTrue(kilometerPerHour > speed);
Assert.IsTrue(kilometerPerHour >= speed);
Assert.IsTrue(kilometerPerHour != speed);

MeterPerSecond meterPerSecond = 60;
kilometerPerHour = 216;
Assert.IsTrue(meterPerSecond >= kilometerPerHour);
Assert.IsTrue(meterPerSecond == kilometerPerHour);

Mathematical operations

All unit dimensions support the bellows operations:

• Division (unit = unit / double)
• Multiplication (unit = unit * double)
• Addition (unit = unit + unit)
• Substraction (unit = unit - unit)

The unit of an operation result is always the left operand unit.

SquareMeter squareMeter = 120;
Surface surface = squareMeter - (SquareMeter)30;
Assert.AreEqual("90 m2", surface.ToString());

Ratios operations

Along with mathematical operations bellow ratios operations are supported:

• Ratio (ratio = unit / unit)
• Division (unit = unit / ratio)
• Multiplicaiton (unit = unit * ratio)
• Addition (unit = unit + ratio)
• Subsraction (unit = unit - ratio)

Ratio ratio = (MillisievertPerHour)50 / (MillisievertPerHour)200;
Assert.AreEqual("0.25", ratio.ToString());

MillisievertPerHour millisievertPerHour = (MillisievertPerHour)50 + (Percent)50;
Assert.AreEqual("75 mSv/h", millisievertPerHour.ToString());

Custom operators

Some units are extended with custom operators allowing conversions to another unit.

• Speed = Distance / Duration
• RadiationRate = RadiationDose / Duration
• Surface = Distance * Distance
• Volume = Surface * Distance

Volume volume = (Meter)5 * (Meter)5 * (Meter)2;
Assert.AreEqual("50 m3", volume.ToString());

SI units conversions to non SI

Some units are extended to support non SI conversions like volumes (exponent of distances) to liters:

CubicDecimeter cubicDecimeter = 5;
Liter liter = Liter.Convert(cubicDecimeter);
Assert.AreEqual("5 L", liter.ToString("0.###"));

liter += (Liter)5;
Assert.AreEqual("10 L", liter.ToString());

liter += (CubicDecimeter)3;
Assert.AreEqual("13 L", liter.ToString());

Serialization

All units can be serialized with formatting:

Meter distance = 50.555;
Assert.AreEqual("50.555 m", distance.ToString());
Assert.AreEqual("50.555 m", string.Format("{0}", distance));
Assert.AreEqual("50.55 m", distance.ToString("F2"));
Assert.AreEqual("50.55 m", string.Format("{0:F2}", distance));

Parsing

A text can be parsed with the

Speed speed = Speed.Parse("5 m/s");
Assert.AreEqual("5 m/s", speed.ToString());

KilometerPerHour kilometerPerHour = KilometerPerHour.Parse("5 m/s");
Assert.AreEqual("18 km/h", kilometerPerHour.ToString());