Spaces:
Running
Running
| # CLAUDE.md | |
| This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. | |
| ## Project Overview | |
| This is a Gradio-based engineering calculator web application that provides multiple calculator modes with advanced functionality. The application serves as a comprehensive calculation tool for engineers, scientists, and developers. | |
| ## Application Architecture | |
| ### Core Modes | |
| - **Standard Mode**: Basic calculator operations with immediate evaluation | |
| - **Scientific Mode**: Scientific functions including trigonometry, logarithms, and advanced mathematical operations | |
| - **Engineering Mode**: Specialized engineering calculations with dropdown-based function selection | |
| - **Programming Mode**: Developer-focused calculations including base conversions and scripting capabilities | |
| ### Key Features | |
| - Infinite precision arithmetic for basic operations (addition, subtraction, multiplication, division) | |
| - Calculation history and memory capabilities | |
| - Embedded AI chat interface | |
| - Unit converters for various measurements and currencies | |
| - Real-time calculation evaluation | |
| ### Engineering Functions | |
| The engineering mode includes specialized calculations such as: | |
| - **3Ph Equivalent Impedance Calculator**: Calculates equivalent impedance and line currents for 5-wire (A,B,C,N,PE) electrical systems using Carson's equations and Kron reduction | |
| ## Development Setup | |
| ### Dependencies | |
| The project requires the following Python packages: | |
| - `gradio` - Web interface framework | |
| - `numpy` - Numerical computations | |
| - `pandas` - Data analysis and manipulation | |
| - `matplotlib` - Plotting and visualization | |
| - `seaborn` - Statistical visualization | |
| ### Installation Commands | |
| ```bash | |
| pip install gradio numpy pandas matplotlib seaborn | |
| ``` | |
| ### Running the Application | |
| ```bash | |
| python app.py # Main application file (to be created) | |
| ``` | |
| ## Code Structure | |
| ### Mathematical Operations | |
| - Implement infinite precision arithmetic using Python's `decimal` module for basic operations | |
| - Use `numpy` for complex mathematical functions and matrix operations | |
| - All trigonometric functions should support both degrees and radians | |
| ### Engineering Calculations | |
| - The 3Ph Impedance calculator implementation is provided in `app.txt` lines 54-451 | |
| - Uses modified Carson's equations for earth return impedance calculations | |
| - Implements Kron reduction technique for 5-wire to 3-wire system conversion | |
| - Required classes: `PowerSystemImpedanceCalculator`, `ConductorParams`, `Coordinate` | |
| ### UI Components | |
| - Main calculator interface with mode selection | |
| - Button layouts for different calculator modes | |
| - Text input/output areas for programming mode | |
| - Dropdown selection for engineering functions | |
| - History panel for calculation tracking | |
| - Embedded chat interface for AI assistance | |
| ## Testing and Validation | |
| ### Testing Commands | |
| ```bash | |
| python -m pytest tests/ # Run test suite (when created) | |
| python test_calculations.py # Test mathematical accuracy | |
| ``` | |
| ### Validation Requirements | |
| - All basic arithmetic operations must maintain infinite precision | |
| - Scientific functions should match standard calculator behavior | |
| - Engineering calculations must be validated against known engineering standards | |
| - UI responsiveness across different screen sizes | |
| ## Development Guidelines | |
| ### File Organization | |
| - `app.py` - Main Gradio application | |
| - `calculator/` - Calculator logic modules | |
| - `engineering/` - Engineering calculation implementations | |
| - `tests/` - Test files | |
| - `static/` - CSS and JavaScript assets | |
| ### Key Implementation Notes | |
| - Use Gradio's `gr.Interface` or `gr.Blocks` for the main application structure | |
| - Implement state management for calculation history and memory | |
| - Ensure all engineering calculations follow IEEE standards | |
| - Maintain separation between UI logic and calculation logic | |
| ### Scientific Function Requirements | |
| All scientific functions from app.txt lines 24-47 must be implemented: | |
| - Trigonometric: sin, cos, tan, asin, acos, atan | |
| - Reciprocal trigonometric: csc, sec, cot | |
| - Support for imaginary unit (i/j notation for electrical engineering) | |
| - Factorial calculations for positive integers | |
| ## Performance Considerations | |
| - Implement caching for complex engineering calculations | |
| - Use efficient algorithms for matrix operations in impedance calculations | |
| - Optimize UI updates for real-time calculation display |