GraduatedCylinder

• A typed implementation of measurable dimensions for .NET (i.e. Length, Speed, Acceleration, Jerk).

• There are 2 versions of this library:

  • GraduatedCylinder uses 64bit doubles to store the values of the dimension, and supports changing units 'in place' by setting the units property to the value of the wanted units, as well as using the 'In(units)' method to get a new instance of the dimension.
  • Pipette uses 32bit floats to store the values of the dimension, and supports changing units 'in place' by setting the units property to the value of the wanted units, as well as using the 'In(units)' method to get a new instance of the dimension.

• Many operators are implemented to allow derivative computations without you explicitly worrying about units, it is taken care of for you (i.e. Jerk = Acceleration / Time).

• Starting at version 6.0, this library uses Roslyn to generate many features from built in metadata, so no runtime reflection is required anymore.

Build

You can build GraduatedCylinder using Visual Studio 2022. We use Nuke as the build engine, and deliver packages on NuGet.org

Contribute

Contributions to GraduatedCylinder are gratefully received but we do ask you to follow certain conditions:

• Fork the main eddiegarmon/GraduatedCylinder
• Use a branch when developing in your own forked repository, DO NOT work against master
• Write one or more unit tests to validate new logic, ideally using TDD
• Ensure all projects build and all tests pass
• Make a pull request from your-fork/your-branch to GraduatedCylinder/master
• Provide a description of the motivation behind the changes

Versioning

The main contributors to the project will manage releases and SemVer-compliant version numbers.

A Simple Sample

    Mass vehicleMass = new Mass(2500, MassUnit.Pounds);
    Speed startSpeed = new Speed(72, SpeedUnit.MilesPerHour);
    Speed endSpeed = new Speed(0, SpeedUnit.MilesPerHour);
    Length stoppingDistance = new Length(1234, LengthUnit.Feet);
    Acceleration deceleration = MotionCalculator.ComputeConstantAcceleration(startSpeed, endSpeed, stoppingDistance);
    Force stoppingForceRequired = vehicleMass * deceleration;

    Console.WriteLine($"To stop a vehicle of {vehicleMass} moving at {startSpeed} within {stoppingDistance},");
    Console.WriteLine("the force required is:");
    Console.WriteLine($"\t{constantStoppingForce}");
    Console.WriteLine($"\t{constantStoppingForce.ToString(ForceUnit.Newtons, 3)}");
    Console.WriteLine($"\t{constantStoppingForce.ToString(ForceUnit.KilogramForce)}");
    Console.WriteLine($"\t{constantStoppingForce.ToString(ForceUnit.PoundForce, 5)}");
    
    The output is as follows:
    To stop a vehicle of 2,500.00 lbs moving at 72.00 mph within 1,234.00 ft,
    the force required is:
            -1,561.72 N
            -1,561.721 N
            -159.20 kgf
            -351.08893 lbf