Simulate electronic circuit using Python and Ngspice simulator
Project description
PySpice
Developed by Fabrice Salvaire.
The official PySpice Home Page is located at https://pyspice.fabrice-salvaire.fr
PyParis2017 / Circuit Simulation using Python, by Fabrice Salvaire : talk given at the PyParis 2017 conference (PDF file)
V0.4.0
Git repository cleanup: filtered generated doc and useless files so as to shrink the repository size
Improved documentation generator: Implemented
formatfor RST content and Tikz figure.Improved unit support: It implements now the International System of Units. And we can now use unit helper like
u_mVor compute the value of1.2@u_kΩ / 2@u_mA. The relevant documentation is on this page.Added the Simulation instance to the Analysis class.
Refactored simulation parameters as classes.
V0.3.2
fixed CCCS and CCVS
V0.3.1
fixed ngspice shared
V0.3.0
Added an example to show how to use the NgSpice Shared Simulation Mode.
Completed the Spice netlist parser and added examples, we could now use a schematic editor to define the circuit. The program cir2py translates a circuit file to Python.
PySpice is a Python 3 library which interplay with Berkeley SPICE, the industrial circuit simulator reference.
SPICE (Simulation Program with Integrated Circuit Emphasis) was developed at the Electronics Research Laboratory of the University of California, Berkeley in 1973 by Laurence Nagel with direction from his research advisor, Prof. Donald Pederson. Then Spice emerged as an industrial standard through its descendants and is still the reference 40 years later.
PySpice is born as a personal project to relearn electronics where circuit simulation is a part of this goal. Since I use the Python language every day, I quickly feel the need to plug SPICE and Python.
The aim of PySpice is to address several needs:
SPICE language is fine to describe circuits, but it lacks a real language for circuit steering. By contrast Python is a powerful high level, oriented object and dynamic language which is perfectly suited for steering and reusing circuit. But it comes at the price its more general syntax is less fluent than SPICE for circuit description.
Ngspice provides some extension to Berkeley SPICE for data analysis, but its interactive environment or TCL module are now outdated. By contrast Python has scientific framework like Numpy and Matplotlib that compete with Matlab.
Ngspice source code is derived from Berkeley SPICE and thus has a very old basis. Moreover the sources are poorly documented. So it is really difficult to understand how it works and modify it. PySpice could serve to easily experiment extension.
As opposite to other SPICE derivatives, PySpice focus on programming and not on graphical user interface. Thus it doesn’t feature a schematic capture editor and we cannot pickup a node or an element and plot the associated waveform. Moreover we can notice the Modelica language treats diagrams as annotations. A choice which I consider judicious. Thus we can imagine to follow the same principle and extend PySpice later.
Features
The main features of PySpice are:
actually PySpice only supports Ngspice
an oriented-object API to describe circuit in a way similar to SPICE
a library and model manager that index recursively a directory
an (experimental) SPICE netlist parser. Kicad can be used as schematic editor to simplify the netlist writing.
a circuit can be simulated using a subprocess (aka server mode) or using the NgSpice shared library, NgSpice vectors are converted to Numpy array
the NgSpice shared library permits to plug voltage/current sources from Python to NgSpice and vice versa.
some data analysis add-ons
Since PySpice is born with a learning goal, many examples are provided with the sources. These examples could serve as learning materials. A tool to generate an HTML and PDF documentation is included in the tools directory. This tool could be extended to generate IPython Notebook as well.
Planned Features
These features are planned in the future:
implement a basic simulator featuring passive element like resistor, capacitor and inductor.
implement a Modelica backend. Modelica is a very interesting solution for transient analysis.
Advertisements
Users should be aware of these advertisements.
Installation
The installation of PySpice by itself is quite simple. However it will be easier to get the dependencies on Linux.
Dependencies
PySpice requires the following dependencies:
Also it is recommanded to have these Python modules:
To generate the documentation, you will need in addition:
circuit_macros and a LaTeX environment
Ngspice Compilation
Usually Ngspice is available as a package on the most popular Linux distributions. But I recommend to check the compilation options before to use it extensively. For example the Fedora package enables too many experimental codes that have side effects. The recommended way to compile Ngspice is given in the manual and in the INSTALLATION file. Ngspice is an example of complex software where we should not enable everything without care.
Installation from PyPi Repository
PySpice is available on the Python Packages PyPI repository at https://pypi.python.org/pypi/PySpice
Run this command in the console to install the latest release:
pip install PySpiceHow to get the Examples
Examples are not installed by pip or setup.pip. The installation process only install PySpice on your Python environment.
You have to download the PySpice archive or clone the Git repository to get the examples. See “Installation from Source”.
Installation from Source
The PySpice source code is hosted at https://github.com/FabriceSalvaire/PySpice
You have to solution to get the source code, the first one is to clone the repository, but if you are not familiar with Git then you can simply download an archive either from the PySpice Pypi page (at the bottom) or the GitHub page (see clone or download button).
To clone the Git repository, run this command in a console:
git clone git@github.com:FabriceSalvaire/PySpice.gitThen to build and install PySpice run these commands:
python setup.py build
python setup.py installRelease history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
