Features

Core Calculations

Cable sizing and selection
Voltage drop analysis
Vector and phase visualisations
Basic electrical calculations

Getting Started

Prerequisites

Python 3.8 or later
PySide6
reportlab
numpy

Basic Installation

Clone the repository:

git clone https://github.com/yourusername/electrical-calculator.git
cd electrical-calculator

Install virtual environment via virtualenv:

virtualenv venv
source venv/bin/activate

Install dependencies:
```
pip install -r requirements.txt
```

Generate resources:

pyside6-rcc resources.qrc -o data/rc_resources.py

Run the application:
```
python main.py
```

Building From Source

Windows Build

Install build requirements:
```
pip install -r build_requirements.txt
```
Run the build script:
```
python scripts/windows_build.py
```
Create installer (requires NSIS):
- Install NSIS from https://nsis.sourceforge.io/
- Right-click installer/windows_installer.nsi and select “Compile NSIS Script”

The executable will be in the dist folder, and the installer will be created as ElectricalCalculator_Setup.exe.

Build Requirements

Python 3.8 or later
PyInstaller
PySide6
NSIS (for creating installer)

Cross-Platform Building

Building Windows Executable from Linux

Install Wine:
```
sudo apt install wine64
```
Run cross-platform build script:
```
python scripts/cross_build.py
```

The script will automatically:

Download Python 3.12.10 for Windows
Set up Wine environment
Install Python in Wine
Install dependencies in Wine Python
Build the Windows executable

pip install -r build_requirements.txt
python scripts/windows_build.py

Development

Project Structure

electrical-calculator/
├── qml/components/         # Reusable QML components
├── qml/components/menus/   # Define all menus here
├── qml/pages/              # Main application pages
├── qml/calculators/        # Calculators
├── data/                   # Data files and resources
├── icons/                  # Application icons
├── docs/                   # Documentation
└── scripts/                # Build automation scripts

License

This project is licensed under the MIT License - see the LICENSE file for details.