ExtendedNumerics.BigRational 2023.155.2020

There is a newer version of this package available.
See the version list below for details.
dotnet add package ExtendedNumerics.BigRational --version 2023.155.2020                
NuGet\Install-Package ExtendedNumerics.BigRational -Version 2023.155.2020                
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="ExtendedNumerics.BigRational" Version="2023.155.2020" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ExtendedNumerics.BigRational --version 2023.155.2020                
#r "nuget: ExtendedNumerics.BigRational, 2023.155.2020"                
#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.
// Install ExtendedNumerics.BigRational as a Cake Addin
#addin nuget:?package=ExtendedNumerics.BigRational&version=2023.155.2020

// Install ExtendedNumerics.BigRational as a Cake Tool
#tool nuget:?package=ExtendedNumerics.BigRational&version=2023.155.2020                

BigRational

Arbitrary precision rational number class

Here is the class signature, so you can see what it supports, but suffice it to say it supports all the typical arithmetic operations one would expect from an arithmetic class library.

public class BigRational : IComparable, IComparable<BigRational>, IEquatable<BigRational> { // // Static Members //

public static BigRational One;
public static BigRational Zero;
public static BigRational MinusOne;

//
// Instance Properties
//

public BigInteger WholePart { get; }
public Fraction FractionalPart { get; }

public int Sign { get; }
public bool IsZero { get; }

//
// Constructors
//

public BigRational();
public BigRational(int value);
public BigRational(BigInteger value);
public BigRational(Fraction fraction);
public BigRational(BigInteger whole, Fraction fraction);
public BigRational(BigInteger numerator, BigInteger denominator);
public BigRational(BigInteger whole, BigInteger numerator, BigInteger denominator);
public BigRational(float value);
public BigRational(double value);
public BigRational(decimal value);

// Parse from a string //
public static BigRational Parse(string value);

//
// Arithmetic Methods
//

public static BigRational Add(BigRational augend, BigRational addend);
public static BigRational Subtract(BigRational minuend, BigRational subtrahend);
public static BigRational Multiply(BigRational multiplicand, BigRational multiplier);
public static BigRational Divide(BigInteger dividend, BigInteger divisor);
public static BigRational Divide(BigRational dividend, BigRational divisor);
public static BigRational Remainder(BigInteger dividend, BigInteger divisor);
public static BigRational Mod(BigRational number, BigRational mod);
public static BigRational Pow(BigRational baseValue, BigInteger exponent);
public static BigRational Sqrt(BigRational value);
public static BigRational NthRoot(BigRational value, int root);

public static BigRational Abs(BigRational rational);
public static BigRational Negate(BigRational rational);	

public static double Log(BigRational rational);

public static BigRational Add(Fraction augend, Fraction addend);
public static BigRational Subtract(Fraction minuend, Fraction subtrahend);
public static BigRational Multiply(Fraction multiplicand, Fraction multiplier);
public static BigRational Divide(Fraction dividend, Fraction divisor);

//
// GCD & LCM
//

public static BigRational GreatestCommonDivisor(BigRational left, BigRational right);
public static BigRational LeastCommonDenominator(BigRational left, BigRational right);

//
// Arithmetic Operators
//

// Binary //
public static BigRational operator +(BigRational augend, BigRational addend);
public static BigRational operator -(BigRational minuend, BigRational subtrahend);
public static BigRational operator *(BigRational multiplicand, BigRational multiplier) ;
public static BigRational operator /(BigRational dividend, BigRational divisor);
public static BigRational operator %(BigRational dividend, BigRational divisor);

// Unitary //
public static BigRational operator +(BigRational rational) => Abs(rational);
public static BigRational operator -(BigRational rational) => Negate(rational);
public static BigRational operator ++(BigRational rational) => Add(rational, BigRational.One);
public static BigRational operator --(BigRational rational) => Subtract(rational, BigRational.One);

//
// Comparison Operators
//

public static bool operator ==(BigRational left, BigRational right);
public static bool operator !=(BigRational left, BigRational right);
public static bool operator <(BigRational left, BigRational right) ;
public static bool operator <=(BigRational left, BigRational right);
public static bool operator >(BigRational left, BigRational right) ;
public static bool operator >=(BigRational left, BigRational right);

//
// Compare To
//

public static int Compare(BigRational left, BigRational right);	
public int CompareTo(BigRational other); // IComparable<Fraction>
int IComparable.CompareTo(Object obj); // IComparable

//
// Conversion
//

// To BigRational //
public static implicit operator BigRational(byte value);
public static implicit operator BigRational(SByte value);
public static implicit operator BigRational(Int16 value);
public static implicit operator BigRational(UInt16 value);
public static implicit operator BigRational(Int32 value);
public static implicit operator BigRational(UInt32 value);
public static implicit operator BigRational(Int64 value);
public static implicit operator BigRational(UInt64 value);
public static implicit operator BigRational(BigInteger value);
public static explicit operator BigRational(float value);
public static explicit operator BigRational(double value);
public static explicit operator BigRational(decimal value);

// From BigRational //
public static explicit operator double(BigRational value);
public static explicit operator decimal(BigRational value);
public static implicit operator Fraction(BigRational value);

//
// Equality Methods
//

public bool Equals(BigRational other);
public override bool Equals(Object obj);
public override int GetHashCode();

//
// Transform Methods
//

public static BigRational Reduce(BigRational value);
public static BigRational NormalizeSign(BigRational value);
public Fraction GetImproperFraction();

//
// Overrides
//

public override string ToString();
public String ToString(String format);
public String ToString(IFormatProvider provider);
public String ToString(String format, IFormatProvider provider);

}

This library is also available on nuget: https://www.nuget.org/packages/ExtendedNumerics.BigRational

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).
  • 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.
Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 is compatible. 
.NET Standard netstandard2.1 is compatible. 
.NET Framework net45 is compatible.  net451 was computed.  net452 was computed.  net46 is compatible.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 is compatible.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETCoreApp 3.1

    • No dependencies.
  • .NETFramework 4.5

    • No dependencies.
  • .NETFramework 4.6

    • No dependencies.
  • .NETFramework 4.8

    • No dependencies.
  • .NETStandard 2.1

    • No dependencies.
  • net5.0

    • No dependencies.
  • net6.0

    • No dependencies.
  • net7.0

    • No dependencies.

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
2023.1000.2.328 3,496 11/25/2023
2023.1000.1.255 1,110 9/12/2023
2023.221.2134 619 8/10/2023
2023.179.1529 429 6/28/2023
2023.162.546 1,136 6/11/2023
2023.155.2020 299 6/5/2023
2023.122.547 218 5/2/2023
2023.121.2026 198 5/2/2023
2023.108.2235 251 4/19/2023
2022.319.1006 452 11/15/2022
2022.195.1437 4,054 7/14/2022
2022.195.942 496 7/14/2022
1.1.0.50000 783 7/10/2020
1.1.0.42648 652 7/6/2020
1.1.0.6 664 7/11/2020
1.0.0 712 9/2/2019