quadratic-solver 1.0.0

A package that solves and graphs quadratic equations

Quadratic Solver

A powerful and easy-to-use Command Line Interface (CLI) application for solving and visualizing quadratic equations. This tool computes key properties of quadratic functions and provides a graphical representation of the curve.

🚀 Features

• Solve quadratic equations of the form: ax² + bx + c = 0

• Compute:

  • ✅ Real or complex roots
  • ✅ Discriminant
  • ✅ Vertex (turning point)
  • ✅ Axis of symmetry
  • ✅ Ordered pairs (for plotting)
  • ✅ Nature of roots (distinct, repeated, or complex)

• 📈 Graph the quadratic function directly from the CLI

📦 Installation

Install via pip:

pip install quadratic-solver

🛠️ Usage

Run the CLI tool from your terminal:

quadratic-solver

You will be prompted to input the coefficients:

Enter coefficient a: 1
Enter coefficient b: -3
Enter coefficient c: 2

📊 Example Output

Quadratic Equation: 1x² - 3x + 2 = 0

Discriminant: 1
Roots: x₁ = 2, x₂ = 1

Nature of Roots: Real and Distinct

Vertex: (1.5, -0.25)
Axis of Symmetry: x = 1.5

Sample Points:
(0, 2)
(1, 0)
(2, 0)
(3, 2)

A graph window will also appear displaying the parabola.

📈 Graphing

The application automatically generates a plot of the quadratic function, highlighting:

• The roots
• The vertex
• The curve shape (concave up or down)

🧠 How It Works

The app uses standard quadratic formula logic:

x = (-b ± √(b² - 4ac)) / (2a)

• If the discriminant is:

  • > 0 → Two real roots
  • = 0 → One repeated root
  • < 0 → Two complex roots

Graphing is handled programmatically using Python plotting libraries.

🧪 Requirements

• Python 3.10+

• Required dependencies (installed automatically):

  • matplotlib
  • numpy

📁 Project Structure

quadratic_solver/
│── quadratic_model.py
│── run.py
│── solve_and_graph.py

🤝 Contributing

Contributions are welcome!

1. Fork the repository
2. Create a new branch
3. Make your changes
4. Submit a pull request

📜 License

This project is licensed under the MIT License.

💡 Future Improvements

• Export graph as image file
• Batch processing of multiple equations
• Interactive mode with command flags

👨‍💻 Author

Built with ❤️ by Uchenna Adubasim

⭐ Support

If you find this project useful, consider giving it a star on GitHub!