public class Cubicextends ObjectClass Cubic solves for the real roots of a cubic equation with real coefficients. The cubic equation is of the form
ax3 + bx2 + cx + d = 0
To solve a cubic equation, construct an instance of class Cubic; call the Cubic object's solve() method, passing in the coefficients a, b, c, and d; and obtain the roots from the Cubic object's fields. The number of (real) roots, either 1 or 3, is stored in field nRoots. If there is one root, it is stored in field x1, and fields x2 and x3 are set to NaN. If there are three roots, they are stored in fields x1, x2, and x3 in descending order.
The same Cubic object may be used to solve several cubic equations. Each time the solve() method is called, the solution is stored in the Cubic object's fields.
The formulas for the roots of a cubic equation come from:
E. Weisstein. "Cubic formula." From MathWorld--A Wolfram Web Resource. http://mathworld.wolfram.com/CubicFormula.html
Fields Modifier and Type Field and Description
nRootsThe number of real roots.
x1The first real root.
x2The second real root.
x3The third real root.
Constructors Constructor and Description
Cubic()Construct a new Cubic object.
Methods Modifier and Type Method and Description
main(String args)Unit test main program.
solve(double a, double b, double c, double d)Solve the cubic equation with the given coefficients.
public int nRootsThe number of real roots.
public double x1The first real root.
public double x2The second real root.
public double x3The third real root.
public void solve(double a, double b, double c, double d)Solve the cubic equation with the given coefficients. The results are stored in this Cubic object's fields.
a- Coefficient of x3.
b- Coefficient of x2.
c- Coefficient of x.
d- Constant coefficient.
DomainException- (unchecked exception) Thrown if a is 0; in other words, the coefficients do not represent a cubic equation.
SCaVis 2.1 © jWork.ORG