👁 Image
ExtendedNumerics.BigDecimal 3003.2.0.161

👁 BigDecimal Logo

BigDecimal

👁 NuGet Version
👁 Downloads

BigDecimal is an arbitrary precision floating point number type/class.

It stores a Mantissa and an Exponent. The Mantissa is of type BigInteger, enabling BigDecimal to have arbitrary precision. BigDecimal is a base-10 floating point number, like System.Decimal is. This is unlike System.Double, which is a base-2 floating point number.

BREAKING CHANGE NOTICE FOR VER. 3001.0.0: BigDecimal.Round(BigDecimal value, Int32 precision) now exhibits common/standard/normal/expected rounding behavior when the precision argument is zero or greater. Previously, this method truncated at the requested precision. For negative precision values, the behavior remains unaltered. For anyone who still needs the old behavior of BigDevimal.Round(BigDecimal value, Int32 precision), use BigDecimal.Truncate(BigDecimal value, int precision) instead. This method is functionally identical to Excel's ROUNDDOWN function.

BREAKING CHANGE NOTICE FOR VER. 3000.0.0: The default Precision value for the library has been changed from 5000 to 100. This should provide a much more reasonable default value for the vast majority of the users. 5000 digits of precision by default was a poor choice, is likely more precision than anyone needs, and resulted in performance issues after a couple of multiplications (assuming BigDecimal.AlwaysTruncate is false, which is the default).

QUICK START

Here is what you need to know: You will want to configure BigDecimal to obtain the behavior that you want. This is done via two static fields of BigDecimal:

• BigDecimal.Precision
• BigDecimal.AlwaysTruncate

You set them like this (these are the default values being set here, BTW):

BigDecimal.Precision = 100;
BigDecimal.AlwaysTruncate = false;

BigDecimal.Precision

This is the default precision that BigDecimal uses for all BigDecimal instances. The value is specified in the number of digits to the right of the decimal place that you want.

The default value is 100.

BigDecimal.AlwaysTruncate

This value specifies whether or not BigDecimal will round the value of a BigDecimal to BigDecimal.Precision places after every arithmetic operation.

The default value is false.

Setting this setting to true keeps the values constrained to only BigDecimal.Precision digits. This limits the amount of memory used and keeps the arithmetic performant.

However, the number has the potential to lose precision as you go, depending on how you use it.

The dynamics of if and when BigDecimals lose precision with this setting enabled isn't necessarily complicated, but it does require some discussion.

See the documentation for a more in depth discussion on this topic.

🆕 Now supports logarithms and trigonometric functions: LogN, Ln, Log2, Log10, Exp, Sin, Cos, Tan, Cot, Sec, Csc, Sinh, Cosh, Tanh, Coth, Sech, Csch, Arcsin, Arccos, Arctan, Arccot, Arcsec, Arccsc

⬇️ Download the latest package from NuGet if you just want the compiled binaries. You can either include the NuGet package in your project outright, or extract the assembly .dll from the nuget package. (Explaination: A .nupkg file is just a .zip file renamed. Use 7zip to extract the binaries from it.):

⁉️ See the Documentation Wiki Page for important information on correct and accurate usage, tips and other information.

🗨️ Visit the community discussion forums if you have a question or want to start a discussion relevant to the this project.

:cockroach: View open issues if you are experiencing a bug or have an idea for a new feature. You can also discuss new feature ideas in the discussion forums first. An 'issue' for the new feature can be created from a discussion at any time.

Example usage:

Console.WriteLine(BigDecimal.Precision);
// 5000
BigDecimal.Precision = 200; // Set the precision for this demo to 200 digits.
Console.WriteLine(BigDecimal.Precision);
// 200

BigDecimal goldenRatio = BigDecimal.Divide(BigDecimal.Add(BigDecimal.One, BigDecimal.Pow(5d, 0.5d)), BigDecimal.Parse("2"));
BigDecimal almostInteger = BigDecimal.Pow(goldenRatio, 23);
Console.WriteLine(almostInteger);
// 64079.00001560578384383500959972260039151833845477140599206350517199794937295147270152942235863491540475774000502741633359451934934882489092137272096824676971700933979751496900324221635899408750483174158953011851250910101237515143968376713756637230312138443375432324556317247823731646925119584432357765294362228759928426416872990657055876547580521657363887865665906948418349

Console.WriteLine(almostInteger.Mantissa);
// 6407900001560578384383500959972260039151833845477140599206350517199794937295147270152942235863491540475774000502741633359451934934882489092137272096824676971700933979751496900324221635899408750483174158953011851250910101237515143968376713756637230312138443375432324556317247823731646925119584432357765294362228759928426416872990657055876547580521657363887865665906948418349
Console.WriteLine(almostInteger.Exponent);
// -368

BigDecimal X = BigDecimal.Parse("0.000551876379690949227373068432671081677704194260485651214128035320088300220750");
Console.WriteLine(X);
// 0.00055187637969094922737306843267108167770419426048565121412803532008830022075

BigDecimal result = BigDecimal.Divide(BigDecimal.One, X);
Console.WriteLine(result);
// 1812.000000000000000000000000000000000000000000000000000000000000000000000001812000000000000000000000000000000000000000000000000000000000000000000000001812000000000000000000000000000000000000000000000000000000000000000000000001

Other mathy projects & numeric types

I've written a number of other polynomial implementations and numeric types catering to various specific scenarios. Depending on what you're trying to do, another implementation of this same library might be more appropriate. All of my polynomial projects should have feature parity, where appropriate[^1].

[^1]: For example, the ComplexPolynomial implementation may be missing certain operations (namely: Irreducibility), because such a notion does not make sense or is ill defined in the context of complex numbers).

• GenericArithmetic - A core math library. Its a class of static methods that allows you to perform arithmetic on an arbitrary numeric type, represented by the generic type T, who's concrete type is decided by the caller. This is implemented using System.Linq.Expressions and reflection to resolve the type's static overloadable operator methods at runtime, so it works on all the .NET numeric types automagically, as well as any custom numeric type, provided it overloads the numeric operators and standard method names for other common functions (Min, Max, Abs, Sqrt, Parse, Sign, Log, Round, etc.). Every generic arithmetic class listed below takes a dependency on this class.

• Polynomial - The original. A univariate polynomial that uses System.Numerics.BigInteger as the indeterminate type.

• GenericPolynomial - A univariate polynomial library that allows the indeterminate to be of an arbitrary type, as long as said type implements operator overloading. This is implemented dynamically, at run time, calling the operator overload methods using Linq.Expressions and reflection.

• CSharp11Preview.GenericMath.Polynomial - A univariate polynomial library that allows the indeterminate to be of an arbitrary type, but this version is implemented using C# 11's new Generic Math via static virtual members in interfaces.

• MultivariatePolynomial - A multivariate polynomial (meaning more than one indeterminate, e.g. 2XY^2) which uses BigInteger as the type for the indeterminates.
• GenericMultivariatePolynomial - A multivariate polynomial that allows the indeterminates to be of [the same] arbitrary type. GenericMultivariatePolynomial is to MultivariatePolynomial what GenericPolynomial is to Polynomial, and indeed is implemented using the same strategy as GenericPolynomial (i.e. dynamic calling of the operator overload methods at runtime using Linq.Expressions and reflection).

• ComplexPolynomial - A univariate polynomial library that has System.Numerics.Complex type indeterminates.
• ComplexMultivariatePolynomial - A multivariate polynomial library that has System.Numerics.Complex indeterminates.

• BigDecimal - An arbitrary precision, base-10 floating point number class.
• BigRational - Encodes a numeric value as an Integer + Fraction
• BigComplex - Essentially the same thing as System.Numerics.Complex but uses a System.Numerics.BigInteger type for the real and imaginary parts instead of a double.

• IntervalArithmetic. Instead of representing a value as a single number, interval arithmetic represents each value as a mathematical interval, or range of possibilities, [a,b], and allows the standard arithmetic operations to be performed upon them too, adjusting or scaling the underlying interval range as appropriate. See Wikipedia's article on Interval Arithmetic for further information.
• GNFS - A C# reference implementation of the General Number Field Sieve algorithm for the purpose of better understanding the General Number Field Sieve algorithm.