CircuitCalculator 0.4.22

Library for analysing and calculating electric networks.

CircuitCalculator

CircuitCalculator is a Python library for symbolic and numeric analysis of electrical circuits. It supports DC and AC analysis, nodal analysis, state-space modeling, and works with both numeric and symbolic component values. The library is designed for engineers, students, and researchers who want to analyze, simulate, or teach circuit theory using Python.

Features

• Symbolic and numeric circuit analysis
• Support for resistors, capacitors, inductors, voltage sources, and current sources
• Nodal analysis and state-space modeling
• Easy-to-use API for building and solving circuits
• Integration with Jupyter/IPython notebooks for interactive exploration

Installation

You can install CircuitCalculator and its dependencies using pip (e.g. in a virtual environment):

python -m venv ./venv
source ./venv/bin activate
pip install CircuitCalculator

Usage

The most convenient interface is the Circuit class, which allows you to define a circuit as a list of components and then solve it. Below is a minimal example for DC analysis:

Example

from CircuitCalculator.Circuit.circuit import Circuit
import CircuitCalculator.Circuit.Components.components as ccp
from CircuitCalculator.Circuit.solution import dc_solution

# Define the circuit
circuit = Circuit([
    ccp.dc_voltage_source(V=1, id='Vs', nodes=('1', '0')),
    ccp.resistor(R=1, id='R', nodes=('1', '0'))
])

# Solve the circuit
solution = dc_solution(circuit)
print(f'I(R)={solution.get_current("R"):2.2f}A')
print(f'V(R)={solution.get_voltage("R"):2.2f}V')

Output:

I(R)=1.00A
V(R)=1.00V

Examples

Several Jupyter/IPython notebook examples can be found in the examples directory.

Three-Phase API

The three-phase API is available in CircuitCalculator.ThreePhaseCircuit and uses explicit factory functions per topology.

from CircuitCalculator.ThreePhaseCircuit import (
    ThreePhaseCircuit,
    three_phase_voltage_source_star,
    three_phase_voltage_source_delta,
    three_phase_current_source_star,
    three_phase_current_source_delta,
    three_phase_impedance_load_star,
    three_phase_impedance_load_delta,
    three_phase_custom_component_line,
    three_phase_custom_component_star,
    three_phase_custom_component_delta,
    three_phase_complex_solution,
)

Main functions:

• three_phase_voltage_source_star(id, nodes=(phase_bus, neutral_bus), V, Z=0j)
• three_phase_voltage_source_delta(id, nodes=(phase_bus,), V, Z=0j)
• three_phase_current_source_star(id, nodes=(phase_bus, neutral_bus), I, Y=0j)
• three_phase_current_source_delta(id, nodes=(phase_bus,), I, Y=0j)
• three_phase_impedance_load_star(id, nodes=(phase_bus, neutral_bus), Z)
• three_phase_impedance_load_delta(id, nodes=(phase_bus,), Z)
• three_phase_custom_component_line(id, nodes=(from_bus, to_bus), phase_a, phase_b, phase_c)
• three_phase_custom_component_star(id, nodes=(phase_bus, neutral_bus), phase_a, phase_b, phase_c)
• three_phase_custom_component_delta(id, nodes=(phase_bus,), phase_a, phase_b, phase_c)

Solver note:

• three_phase_current_source_delta may lead to a solver contradiction in pure-current-source setups without a stabilizing voltage-defined branch. See examples/python/three_phase/example_three_phase_delta_current_source_conflict.ipynb.

Contribution

This project is open-source and contributions are welcome. If you would like to contribute, please fork the repository and make a pull request.

License

This project is licensed under the MIT License.

Contact

If you have any questions or issues, please open an issue on the GitHub repository.