README for NGSPICE
==================

Ngspice is a mixed-level/mixed-signal circuit simulator. Its code
is based on three open source software packages: Spice3f5, Cider1b1
and Xspice.

Spice3 does not need any introduction, it is the ancestor of many
commercial or open source circuit simulators. In over 30 years
since its existence it has set several de-facto standards for
simulating circuits.

Cider couples the Spice3 circuit level simulator to a device simulator
to provide greater simulation accuracy of critical devices. So you may
create device models for diodes, bipolar, JFet and MOSFETs derived 
from their cross-sectional structures and materials.

Xspice is an extension to Spice3 that provides code modelling support
and simulation of digital components through an embedded event driven
algorithm.

Ngspice is, anyway, much more than the simple sum of the packages
above, as many people contributed to the project with their experience,
their bug fixes and their improvements. If you are interested, browse
the site and discover what ngspice offers and what needs. If you think
you can help, join the development team.

Ngspice is an ongoing project, growing everyday from users contributions,
suggestions and reports. What we will be able to do depends mostly on
user interests, contributions and feedback.



USER DISCUSSION FORUMS:
-----------------------

 For discussions on ngspice, there are five discussion forums, to be
 found at https://sourceforge.net/p/ngspice/discussion/. These
 typically provide quick answers to any question concerning ngspice.
 A new section on 'tips and examples' assembles useful tips provided
 by maintainers and users.



MAILING LISTS:
-------------

 There are two mailing lists dedicated to the use and development of ngspice.

 * ngspice-users@lists.sourceforge.net:
   This list is the list for the users of the ngspice simulator.

 * ngspice-devel@lists.sourceforge.net:
   ngspice development issues. Developers and "want to be" developers should
   subscribe here.

 To subscribe the list(s), send a message to:
   <ngspice-users-subscribe@lists.sourceforge.net>
   <ngspice-devel-subscribe@lists.sourceforge.net>



WEB SITEs:
--------

This project is hosted on Sourceforge.net.
The home page is https://ngspice.sourceforge.io
The page offering source code, MS Windows executables, and user interaction is
https://sourceforge.net/projects/ngspice