agi.foundation.numericalmethods

(agi.foundation.core-2024r3.jar)

Class QuadraticRealPolynomial

java.lang.Object

agi.foundation.numericalmethods.advanced.RealPolynomial

agi.foundation.numericalmethods.QuadraticRealPolynomial

public class QuadraticRealPolynomial
extends RealPolynomial

Represents a 2nd order polynomial function of one variable with only real coefficients.

Constructor Summary

Constructors

Constructor and Description
QuadraticRealPolynomial(double a, double b, double c) Constructs a quadratic polynomial with the provided real coefficients.

Method Summary

Modifier and Type	Method and Description
double	discriminant() Provides the discriminant of the quadratic equation from the supplied coefficients.
static double	discriminant(double a, double b, double c) Provides the discriminant of the quadratic equation from the supplied coefficients.
double	getA() Gets the coefficient of the 2nd order monomial.
double	getB() Gets the coefficient of the 1st order monomial.
double	getC() Gets the coefficient of the 0th order monomial.
double[]	realRoots() Provides the real valued roots of the real polynomial.
static double[]	realRoots(double a, double b, double c) Provides the real valued roots of the real polynomial with the provided coefficients.

Methods inherited from class agi.foundation.numericalmethods.advanced.RealPolynomial

evaluate, evaluate, get, getOrder

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

QuadraticRealPolynomial

public QuadraticRealPolynomial(double a,
                               double b,
                               double c)

Constructs a quadratic polynomial with the provided real coefficients.

Parameters:

a - The coefficient of the 2nd order monomial.

b - The coefficient of the 1st order monomial.

c - The coefficient of the 0th order monomial.

Method Detail

getA

public final double getA()

Gets the coefficient of the 2nd order monomial.

getB

public final double getB()

Gets the coefficient of the 1st order monomial.

getC

public final double getC()

Gets the coefficient of the 0th order monomial.

realRoots

@Nonnull
public final double[] realRoots()

Provides the real valued roots of the real polynomial.

Returns:

An array containing the real valued roots.

discriminant

public final double discriminant()

Provides the discriminant of the quadratic equation from the supplied coefficients.

Note that when computing QuadraticRealPolynomial.realRoots(), a tolerance is used that may cause the number of roots to differ relative to what analysis of the discriminant would imply.

Returns:

The value of the discriminant.

discriminant

public static double discriminant(double a,
                                  double b,
                                  double c)

Provides the discriminant of the quadratic equation from the supplied coefficients.

Note that when computing QuadraticRealPolynomial.realRoots(), a tolerance is used that may cause the number of roots to differ relative to what analysis of the discriminant would imply.

Parameters:

a - The coefficient of the 2nd order monomial.

b - The coefficient of the 1st order monomial.

c - The coefficient of the 0th order monomial.

Returns:

The value of the discriminant.

realRoots

@Nonnull
public static double[] realRoots(double a,
                                           double b,
                                           double c)

Provides the real valued roots of the real polynomial with the provided coefficients.

Parameters:

a - The coefficient of the 2nd order monomial.

b - The coefficient of the 1st order monomial.

c - The coefficient of the 0th order monomial.

Returns:

An array containing the real valued roots, or an empty array if none.