Merge branch 'release/3.1.0'

Author: angularsen

.gitattributes

@@ -0,0 +1,26 @@
+# Auto detect text files and perform LF normalization
+# http://davidlaing.com/2012/09/19/customise-your-gitattributes-to-become-a-git-ninja/
+* text=auto
+
+# Custom for Visual Studio
+*.cs     diff=csharp
+*.sln    merge=union
+*.csproj merge=union
+*.vbproj merge=union
+*.fsproj merge=union
+*.dbproj merge=union
+
+# Standard to msysgit
+*.doc	 diff=astextplain
+*.DOC	 diff=astextplain
+*.docx diff=astextplain
+*.DOCX diff=astextplain
+*.dot  diff=astextplain
+*.DOT  diff=astextplain
+*.pdf  diff=astextplain
+*.PDF	 diff=astextplain
+*.rtf	 diff=astextplain
+*.RTF	 diff=astextplain
+
+# Whitespace options
+* whitespace=trailing-space,space-before-tab,tab-in-indent,tabwidth=4

.gitignore

@@ -106,5 +106,6 @@ Generated_Code #added for RIA/Silverlight projects
 _UpgradeReport_Files/
 Backup*/
 UpgradeLog*.XML
-
-Build
+
+Build
+Thumbs.db

README.md

@@ -1,123 +1,141 @@
-Units.NET
-========
-
-Everyone have written their share of trivial conversions - or less obvious ones where you need to Google that magic constant. 
-
-Stop littering your code with unnecessary calculations. Units.NET gives you all the common units of measurement and the conversions between them. It is light-weight, unit tested and supports [PCL](http://msdn.microsoft.com/en-us/library/gg597391.aspx "MSDN PCL").
-
-
-Install
-=======
-To install Units.NET, run the following command in the [Package Manager Console](http://docs.nuget.org/docs/start-here/using-the-package-manager-console) or go to the [NuGet site](https://www.nuget.org/packages/UnitsNet/ "NuGet site") for the complete relase history.
-
-![Install-Package UnitsNet](Docs/Images/install_package_unitsnet.png "Install-Package UnitsNet")
-
-Build Targets:
-* .NET 3.5 Client
-* Silverlight 4
-* WinRT / .NET Core 4.5
-* Portable Class Library (.NET 4.0 + Silverlight 4 + Windows Phone 7 + Xbox 360)
-
-Features
-========
-
-* Immutable structs for units of measurement, such as Length, Mass, Force and Pressure. See full list [here](https://github.com/InitialForce/UnitsNet/blob/master/Src/UnitsNet/ "Data structures").
-* Convert between most popular units in the metric and imperial systems. See full list [here](https://github.com/InitialForce/UnitsNet/blob/master/Src/UnitsNet/Unit.cs "Unit.cs").
-* Choose between static (Length, Mass, Force etc.) or dynamic (UnitValue) representations for units of measurement.
-* Parse abbreviation string to unit taking culture into account.
-* Get abbreviation string for unit in different cultures.
-
-Static Representation and Explicit Conversion
------------------------------------------------
-```C#
-// Stop postfixing your variables and method names with the unit...
-double weightKg = GetPersonWeightInKg();
-UpdatePersonWeightInGrams(weightKg * 1000);
-
-// ...and start using a static representation for the measurement then 
-// explicitly convert to the unit of choice - when you need it.
-Mass weight = GetPersonWeight();
-UpdatePersonWeightInGrams(weight.Grams);
-
-// Convert between compatible units of measurement...
-Force scaleMeasurement = Force.FromNewtons(850);
-Mass personWeight = Mass.FromGravitationalForce(scaleMeasurement);
-double weightKg = personWeight.Kilograms;
-
-// ...while avoiding confusing conversions, such as between weight and mass.
-Mass weight = GetPersonWeight();
-double weightNewtons = weight.Newtons; // No such thing.
-
-// Some popular conversions.
-Length meter = Length.FromMeters(1);
-double cm = meter.Centimeters; // 100
-double yards = meter.Yards; // 1.09361
-double feet = meter.Feet; // 3.28084
-double inches = meter.Inches; // 39.3701
-
-Pressure p = Pressure.FromPascal(1);
-double kpa = p.KiloPascals; // 1×10-3
-double bar = p.Bars; // 1×10-5
-double atm = p.Atmosphere; // 9.86923267×10-6
-double psi = p.Psi; // 1.45037738×10-4
-```
-
-Dynamic Representation and Conversion
-------------------
-```C#
-// Explicitly
-double m = UnitConverter.Convert(1, Unit.Kilometer, Unit.Meter); // 1000
-double mi = UnitConverter.Convert(1, Unit.Kilometer, Unit.Mile); // 0.621371
-double yds = UnitConverter.Convert(1, Unit.Meter, Unit.Yard); // 1.09361
-
-// Or dynamically.
-UnitValue val = GetUnknownValueAndUnit();
-
-// Returns false if conversion was not possible.
-double cm;
-val.TryConvert(Unit.Centimeter, out cm);
-```
-
-Helper Methods to Construct Measurements
-----------------------------------------
-```C#
-var f = Force.FromPressureByArea(Pressure p, Length2d area);
-var f = Force.FromMassAcceleration(Mass mass, double metersPerSecondSquared);
-```
-
-Parse and Get Culture-Specific Abbreviations
--------------------------------------------------
-```C#
-  var us = new CultureInfo("en-US");
-  var norwegian = new CultureInfo("nb-NO");
-  
-  Unit.Tablespoon == UnitSystem.Create(us).Parse("tbsp")
-  Unit.Tablespoon == UnitSystem.Create(norwegian).Parse("ss")  
-
-  "T" == UnitSystem.GetDefaultAbbreviation(Unit.Tablespoon, us)
-  "ss" == UnitSystem.GetDefaultAbbreviation(Unit.Tablespoon, norwegian)
-```
-
-What It Is Not
-==============
-
-* It is not an equation solver. 
-* It does not figure out the units after a calculation.
-
-Work In Progress
-================
-This project is still early and many units and conversions are not yet covered. If you are missing something, please help by contributing.
-
-* Add more units.
-* Not all conversions are unit tested yet.
-* Parsing and getting textual representations not complete.
-* Document all the data structures, units and conversions.
-
-Want To Contribute?
-===================
-Please read the wiki on [Adding a New Unit](https://github.com/InitialForce/UnitsNet/wiki/Adding-a-New-Unit) 
-and [Adding a New Class of Units](https://github.com/InitialForce/UnitsNet/wiki/Adding-a-New-Class-of-Units).<br>
-For other things to do, see Work In Progress.
-
-
-[Contact me](https://github.com/anjdreas) if you have any questions.
+[![Build Status](http://anj.no:8500/app/rest/builds/buildType:(id:UnitsNet_ReleaseBuilds)/statusIcon)](http://anj.no:8500/viewType.html?buildTypeId=UnitsNet_ReleaseBuilds&guest=1 "Build Status")
+Units.NET
+===
+Everyone have written their share of trivial conversions - or less obvious ones where you need to Google that magic constant. 
+
+Stop littering your code with unnecessary calculations. Units.NET gives you all the common units of measurement and the conversions between them. It is light-weight, unit tested and supports [PCL](http://msdn.microsoft.com/en-us/library/gg597391.aspx "MSDN PCL").
+
+
+Installing
+===
+Run the following command in the [Package Manager Console](http://docs.nuget.org/docs/start-here/using-the-package-manager-console) or go to the [NuGet site](https://www.nuget.org/packages/UnitsNet/) for the complete relase history.
+
+![Install-Package UnitsNet](https://raw.github.com/InitialForce/UnitsNet/develop/Docs/Images/install_package_unitsnet.png "Install-Package UnitsNet")
+
+Build Targets:
+* Portable Class Library (.NET 4.0 + Silverlight 5 + Win8/WinPhone8)
+* .NET 3.5 Client
+
+Features
+===
+* 16 unit classes of measurement, [full list](https://github.com/InitialForce/UnitsNet/tree/develop/Src/UnitsNet/GeneratedCode/Enums)
+* Generated code for uniform implementations and fewer bugs
+* Immutable structs implementing IEquatable, IComparable and operator overloads
+* Parse unit abbreviations in multiple cultures
+* ToString() variants for custom cultures and format patterns
+* Extensible with [custom units](https://github.com/InitialForce/UnitsNet/wiki/Extending-with-Custom-Units)
+* Over 200 tests to ensure conversions and localizations are in order
+
+Static Typing
+---
+```C#
+// Convert to the unit of choice - when you need it
+Mass weight = GetPersonWeight();
+Console.WriteLine("You weigh {0:0.#} kg.", weight.Kilograms);
+
+// Avoid confusing conversions, such as between weight (force) and mass
+double weightNewtons = weight.Newtons; // No such thing
+
+// Some popular conversions
+Length meter = Length.FromMeters(1);
+double cm = meter.Centimeters; // 100
+double yards = meter.Yards; // 1.09361
+double feet = meter.Feet; // 3.28084
+double inches = meter.Inches; // 39.3701
+```
+
+Unit Enumeration
+---
+All units have a corresponding unit enum value. This is useful when selecting the unit representation at runtime, such as presenting a choice of units to the user.
+```C#
+/// <summary>Convert the previous height to the new unit.</summary>
+void OnUserChangedHeightUnit(LengthUnit prevUnit, double prevValue, LengthUnit newUnit)
+{
+    // Construct from dynamic unit and value
+    var prevHeight = Length.From(prevValue, prevUnit);
+
+    // Convert to the new unit
+    double newHeightValue = prevHeight.As(newUnit);
+
+    // Update UI with the converted value and the newly selected unit
+    UpdateHeightUI(newHeightValue, newUnit);
+}
+```
+
+Culture and Localization
+---
+The culture for abbreviations defaults to Thread.CurrentUICulture and falls back to US English if not defined. Thread.CurrentCulture affects number formatting unless a custom culture is specified. The relevant methods are:
+
+* ToString()
+* GetAbbreviation()
+* Parse/TryParse()
+* ParseUnit/TryParseUnit()
+```C#
+var usEnglish = new CultureInfo("en-US");
+var russian = new CultureInfo("ru-RU");
+var oneKg = Mass.FromKilograms(1);
+
+// ToString() with Thread.CurrentUICulture as US English and Russian respectively
+"1 kg" == oneKg.ToString();
+"1 кг" == oneKg.ToString();
+
+// ToString() with specific culture and string format pattern
+"mg 1.00" == oneKg.ToString(MassUnit.Milligram, usEnglish, "{1} {0:0.00}");
+"мг 1,00" == oneKg.ToString(MassUnit.Milligram, russian, "{1} {0:0.00}");
+
+// Parse measurement from string
+Mass kg = Mass.Parse(usEnglish, "1.0 kg");
+Mass kg = Mass.Parse(russian, "1,0 кг");
+
+// Parse unit from string, a unit can have multiple abbreviations
+RotationalSpeedUnit.RevolutionPerMinute == RotationalSpeed.ParseUnit("rpm");
+RotationalSpeedUnit.RevolutionPerMinute == RotationalSpeed.ParseUnit("r/min");
+
+// Get default abbreviation for a unit
+"kg" == Mass.GetAbbreviation(MassUnit.Kilogram);
+```
+
+Helper Construction Methods
+---
+Construct measurements with various helper methods for convenience and readability.
+```C#
+Force.FromPressureByArea(Pressure p, Length2d area)
+Force.FromMassAcceleration(Mass mass, double metersPerSecondSquared)
+```
+
+Precision and Accuracy
+===
+A base unit is chosen for each unit class, represented by a double value (64-bit), and all conversions go via this unit. This means there will always be a small error in both representing other units than the base unit as well as converting between units.
+
+Units.NET was intended for convenience and ease of use, not highly accurate conversions, but I am open to suggestions for improvements.
+
+The tests accept an error up to 1E-5 for most units added so far. Exceptions include units like Teaspoon, where the base unit cubic meter is a lot bigger. In many usecases this is sufficient, but for others this may be a showstopper and something you need to be aware of.
+
+For more details, see [Precision](https://github.com/InitialForce/UnitsNet/wiki/Precision).
+
+
+What It Is Not
+===
+* It is not an equation solver
+* It does not figure out the units after a calculation
+
+Want To Contribute?
+==
+This project is still early and many units and conversions are not yet covered. If you are missing something, please help by contributing or [ask for it](https://github.com/InitialForce/UnitsNet/issues) by creating an issue.
+
+Please read the wiki on [Adding a New Unit](https://github.com/InitialForce/UnitsNet/wiki/Adding-a-New-Unit).
+
+The repo uses [git-flow](https://github.com/nvie/gitflow) branch structure. 
+In practice this means:
+  * [Fork the repo](https://help.github.com/articles/fork-a-repo) as normal
+  * Checkout the default **develop** branch. There is no master branch.
+  * Do work on branches such as **feature/add-myunit** and **fix/34**
+  * [Create a pull request](https://help.github.com/articles/using-pull-requests) as normal.
+
+Continuous Integration
+===
+A [TeamCity build server](http://anj.no:8500/project.html?projectId=UnitsNet&tab=projectOverview&guest=1) performs the following:
+* Build and test pull requests. Notifies on success or error.
+* Build, test and publish nuget on commits to **stable** branch.
+
+[Contact me](https://github.com/anjdreas) if you have any questions.