Ngspice as a Shared Library

As a new option ngspice may be compiled as a shared library (*.so in LINUX, *.dll in MS Windows).

A controlling application may acquire complete control over ngspice after loading the shared lib either during compilation/linking or dynamically at runtime.

The shared module offers an interface which exports functions controlling the simulator and callback functions for feedback.

So you may send an input "file" with a netlist to ngspice, start the simulation in a separate thread, read back simulation data at each time point, stop the simulator depending on some condition, alter device or model parameters and then resume the simulation.

The calling process may offer a graphical user interface which you may develop and optimize without a need to alter the ngspice source code.

Details of the shared ngspice API are documented in chapter 19 of the actual manual. A short description of the interface functions and the data structures used is given in the header file sharedspice.h, to be found in /src/include/ngspice. You may also have a look at the file /src/sharedspice.c, containing the function definitions.

Ngspice Shared Library Interfacing and Integration

Interfaces of ngspice.dll or are available for various languages. You may download example calling programs written in Turbo Delphi (a Pascal variant) and C language in the download section below. KiCad uses a C++ interface. (see file ngspice.cpp). A free basic interface has been published here.

Ngspice Shared Library Downloads

Three executables (coming with source code) serve as examples for controlling ngspice. These are not meant to be "productive" programs, but just give some commented example usages of the interface.

ng_start.exe is a MS Windows application loading ngspice.dll dynamically. All functions and callbacks of the interface are assessed. The source code, generated with Turbo Delphi 2006, may be found here, the binaries compiled for 32 Bit are here, including ngspice.dll and some example input files. Binaries of the console applications driving ngspice.dll (see below) are included as well.

Two C language console applications, compilable with LINUX, CYGWIN, MINGW or MS Visual Studio, are available as source code, demonstrating either statical linking or linking shared ngspice at runtime. A simple feedback loop is shown in tests 3 and 4, where a device parameter is changed upon having an output vector value crossing a limit.