/Console-Based-Equation-System

Console system for creating, solving, and manipulating first and second degree equations.

Primary LanguageC++

🧮 Console-Based Equation System

Authors: Valdo Castiglia, Giuliana Giusiano, Shoan Genes
Professor: José Clavijo
Due Date: February 17, 2025

📌 Description

This system allows users to create, display, solve, add, save, and retrieve first and second-degree equations through a command-line interface. It was developed as part of Workshop 1, applying data structure techniques, Abstract Data Types (ADTs), and file persistence.

🧠 Features

The system recognizes and executes the following commands:

  • crear <id> <a> <b> [c] → Creates an equation (1st or 2nd degree)
  • mostrar → Displays all equations loaded in memory
  • resolver <id> → Solves the equation with the specified identifier
  • sumar <id1> <id2> <idResultado> → Adds two equations and saves the result
  • guardar <id> → Saves an equation to disk (.dat file)
  • recuperar <id> → Retrieves an equation from disk
  • salir → Frees memory and terminates execution

🧪 Data Structures Used: Linear list for commands and Binary Search Tree (BST) for storing equations.

🔧 Technologies and Structures

  • Language: C++
  • Paradigm: Structured programming with intensive use of Abstract Data Types (ADTs)
  • Data Structures:
    • Binary Search Tree (BST) for equation storage
    • Linked list of strings for command processing
    • union to distinguish between 1st and 2nd degree equations
    • Binary files for data persistence (.dat format)
  • Architecture: Modular design with header files (.h) and separate ADT implementations

💻 Usage Example

crear eq1 2 3
crear eq2 1 4 5
sumar eq1 eq2 eq3
resolver eq3
guardar eq3
salir

Command Explanations

Command Parameters Description Example
crear <id> <a> <b> [c] Creates equation: ax + b = 0 (linear) or ax² + bx + c = 0 (quadratic) crear eq1 2 -5 creates 2x - 5 = 0
mostrar None Lists all equations in memory mostrar
resolver <id> Solves the specified equation resolver eq1
sumar <id1> <id2> <result_id> Adds two equations coefficient-wise sumar eq1 eq2 eq3
guardar <id> Saves equation to binary file guardar eq1
recuperar <id> Loads equation from binary file recuperar eq1
salir None Exits program and frees memory salir

🏗️ Project Structure

├── include/
│   ├── abbecuaciones.h     # Binary Search Tree ADT for equations
│   ├── ecuacion.h          # Equation ADT (supports 1st & 2nd degree)
│   ├── comando.h           # Command parsing ADT
│   ├── primergrado.h       # First-degree equation operations
│   ├── segundogrado.h      # Second-degree equation operations
│   ├── ejecucion.h         # Command execution handlers
│   ├── string.h            # Custom string ADT
│   ├── boolean.h           # Boolean type definition
│   └── grado.h             # Degree enumeration
├── src/
│   ├── abbecuaciones.cpp   # BST implementation
│   ├── ecuacion.cpp        # Equation management
│   ├── comando.cpp         # Command parsing logic
│   ├── primergrado.cpp     # Linear equation solver
│   ├── segundogrado.cpp    # Quadratic equation solver
│   ├── ejecucion.cpp       # Command execution logic
│   ├── string.cpp          # String utilities
│   └── main.cpp            # Program entry point
├── .gitignore
└── README.md

🎯 Key Features

Equation Types Supported

  • Linear Equations (1st degree): ax + b = 0
  • Quadratic Equations (2nd degree): ax² + bx + c = 0

Solving Capabilities

  • Linear equations: Direct solution x = -b/a
  • Quadratic equations:
    • No real solutions (negative discriminant)
    • One solution (zero discriminant)
    • Two solutions (positive discriminant)

Data Persistence

  • Binary file storage with .dat extension
  • Automatic file management for save/load operations
  • Prevents overwriting existing files

Error Handling

  • Validates command syntax and parameter count
  • Checks for duplicate identifiers
  • Ensures non-zero leading coefficients
  • Validates alphabetic identifiers and numeric coefficients

🚀 Getting Started

Prerequisites

  • C++ compiler (g++, clang++, etc.)
  • Standard C++ libraries

Building the Project

# Compile all source files
g++ -I include src/*.cpp -o equation_system

# Run the program
./equation_system

Sample Session

Ingrese comando: crear linear 3 -9
linear: 3x - 9 = 0

Ingrese comando: crear quadratic 1 -5 6
quadratic: x^2 - 5x + 6 = 0

Ingrese comando: resolver linear
[ Resultado ]: x = 3.00

Ingrese comando: resolver quadratic
[ Resultado ]: x1 = 3.00, x2 = 2.00

Ingrese comando: salir
[ MENSAJE ]: Hasta la proxima!

📚 Learning Objectives

This project demonstrates proficiency in:

  • Abstract Data Types (ADTs) design and implementation
  • Binary Search Trees for efficient data storage and retrieval
  • Memory management in C++ with proper allocation/deallocation
  • File I/O operations for data persistence
  • Modular programming with header/implementation separation
  • Command-line interface design and user input validation

🤝 Contributing

This is an academic project developed for educational purposes. The codebase showcases fundamental computer science concepts including data structures, algorithms, and software engineering principles.

📝 License

This project is part of an academic assignment and is intended for educational use.