Source code for pyquations.algebra.quadratic_formula

import cmath
from typing import Tuple




def quadratic_formula(a: float, b: float, c: float) -> Tuple[complex, complex]:
    """This function calculates the roots of a quadratic equation of the form:
        ax^2 + bx + c = 0

    Args:
        a (float): Coefficient of the quadratic term (x^2). Must not be zero.
        b (float): Coefficient of the linear term (x).
        c (float): Constant term.

    Returns:
        Tuple[complex, complex]: A tuple containing two roots of the quadratic
            equation. The roots may be real or complex numbers depending on the
            discriminant.

    Raises:
        ValueError: If 'a' is zero, as this would not represent a quadratic
            equation.
    """
    if a == 0:
        raise ValueError(
            "Coefficient 'a' must not be zero for a quadratic equation.",
        )

    discriminant: float = (b**2) - (4 * a * c)
    sol1: complex = (-b + cmath.sqrt(discriminant)) / (2 * a)
    sol2: complex = (-b - cmath.sqrt(discriminant)) / (2 * a)

    return sol1, sol2