Electrical Circuit Analysis with Python

Overview

This project demonstrates fundamental electrical engineering analysis using Python. It covers core circuit analysis concepts including Ohm's Law, Kirchhoff's Current Law (KCL), and Kirchhoff's Voltage Law (KVL).

The repository includes engineering calculations, Jupyter Notebook demonstrations, automated testing, report generation, and visual documentation to showcase practical Python applications in electrical engineering.

---

Project Structure

electrical-circuit-analysis-python/

├── data/
│   └── sample_circuit_data.csv
│
├── notebooks/
│   ├── ohms_law.ipynb
│   ├── kcl_analysis.ipynb
│   └── kvl_analysis.ipynb
│
├── src/
│   └── circuit_solver.py
│
├── reports/
│   ├── analysis_report.pdf
│   └── generate_report.py
│
├── tests/
│   └── test_circuit_solver.py
│
├── assets/
│   ├── workflow_diagram.png
│   └── results_preview.png
│
├── requirements.txt
├── circuit_diagram.png
└── README.md

---

Features

• Ohm's Law calculations
• Kirchhoff's Current Law (KCL) verification
• Kirchhoff's Voltage Law (KVL) verification
• Circuit analysis using Python
• Automated testing with PyTest
• Engineering report generation in PDF format
• Data visualization and result presentation
• Jupyter Notebook examples for educational and analytical purposes

---

Technologies Used

• Python
• NumPy
• Pandas
• Matplotlib
• Jupyter Notebook
• PyTest
• ReportLab

---

Engineering Topics Covered

Ohm's Law

Calculate:

• Voltage (V)
• Current (I)
• Resistance (R)

Using:

V = I × R
I = V / R
R = V / I

Kirchhoff's Current Law (KCL)

Verify current conservation at electrical nodes:

Σ I_in = Σ I_out

Kirchhoff's Voltage Law (KVL)

Verify voltage conservation in closed loops:

Σ V = 0

---

Visual Assets

Workflow Diagram

assets/workflow_diagram.png

Illustrates the complete workflow:

Input Data
    ↓
Python Analysis
    ↓
Circuit Solver
    ↓
Validation (KCL/KVL)
    ↓
Visualization
    ↓
PDF Report

Results Preview

assets/results_preview.png

Contains example outputs, plots, and calculation results generated during circuit analysis.

---

Report Generation

The project includes an engineering report generated automatically using Python.

Generated Report:

reports/analysis_report.pdf

Source Code:

reports/generate_report.py

The report summarizes:

• Ohm's Law calculations
• KCL verification
• KVL verification
• Engineering conclusions

---

Testing

Run automated tests:

pytest tests/

Test file:

tests/test_circuit_solver.py

Covered functions:

• Current calculation
• Voltage calculation
• Resistance calculation

---

Example Use Cases

• Electrical engineering education
• Circuit analysis demonstrations
• Engineering computation with Python
• Technical portfolio projects
• AI-assisted engineering workflows
• Validation of basic circuit laws

---

Installation

Clone the repository:

git clone https://github.com/koswadi/electrical-circuit-analysis-python.git

Install dependencies:

pip install -r requirements.txt

Launch Jupyter Notebook:

jupyter notebook

---

Future Improvements

• AC circuit analysis
• Complex impedance calculations
• Nodal analysis solver
• Mesh analysis solver
• SPICE data integration
• Interactive visualization dashboard

---

Author

Agoes Koswadi

Electrical Engineering & Python Portfolio Project