prepare ngspice-27

COPYING

@@ -1,6 +1,6 @@
 12345678901234567890123456789012345678901234567890123456789012345678901234567890
-Ngspice 26
+Ngspice 27
-Copyright (c) 2014,
+Copyright (c) 2017,
 All rights reserved.
 
 

FAQ

@@ -1,6 +1,6 @@
-  Ngspice F.A.Q.Version 2.0 (ngspice 26 release)
+  Ngspice F.A.Q.Version 2.1 (ngspice-27 release)
   Maintained by Paolo Nenzi, Holger Vogt
-  Last update: 02-01-2014
+  Last update: 08-23-2017
 
   This document contains the Frequently Asked Questions (and Answers)
   for ngspice project.
@@ -17,9 +17,9 @@
      1.5 What is the project's goal?
      1.6 What you are going to do?
      1.7 Legal issues
-     1.8 What mailing lists exist for ngspice?
+     1.8 Discussion groups
-     1.9 Are the mailing lists archived anywhere?
+     1.9 What mailing lists exist for ngspice?
-     1.10 What newsgroups exist for ngspice?
+     1.10 Are the mailing lists archived anywhere?
      1.11 Where can I get a copy of ngspice?
      1.12 Where should I look on the World Wide Web for ngspice stuff?
      1.13 Where should I look on the World Wide Web for Spice documentation?
@@ -73,7 +73,7 @@
     and simulation of digital components through an embedded event
     driven algorithm.
 
-  The NG prefix has lot of meanings: Next Generation, New Good, etc.
+  The NG prefix has lot of meanings: Next Generation, New (and) Good, etc.
   Choose or invent the one you prefer. The heart of the project is the
   ngspice program, with its tremendous advancements.
 
@@ -94,6 +94,7 @@
   from a tcl script and vector plotted or post processed using tcl. A small
   GUI may be built by the user to analyze a circuit or a set of circuits.
   Tclspice is obtained compiling ngspice activating an additional option.
+  This has not been used and tested for some time.
 
 
  1.4 Why resurrecting Berkeley's Spice?
@@ -158,7 +159,18 @@
   for details.
 
 
- 1.8  What mailing lists exist for ngspice?
+ 1.8  Discussion groups
+
+  Vivid discussion are going on in the ngspice discussion groups.
+  They are found at https://sourceforge.net/p/ngspice/discussion/
+  A new group 'ngspice tips and examples' will present interesting
+  ngspice tips (your input is welcome!)
+
+
+ 1.9  What mailing lists exist for ngspice?
+
+  Mailing lists have somewhat lost importance compared to the
+  discussion groups described above.
 
   There are two general mailing lists dedicated to the ngspice project.
 
@@ -187,7 +199,7 @@
      http://www.gnu.org/software/mailman/mailman-member
 
 
- 1.9   Are the mailing lists archived anywhere ?
+ 1.10  Are the mailing lists archived anywhere ?
 
   Yes, the lists are archived. There are two places where to look for
   archives. The project started on the IEEE Central and South Italy
@@ -197,18 +209,6 @@
   http://sourceforge.net/p/ngspice/mailman/
 
 
-
- 1.10  What newsgroups exist for ngspice?
-
-  There is no ngspice specific newsgroup. Sourceforge offers additional
-  discussion groups for ngspice, please see
-
-  http://sourceforge.net/p/ngspice/discussion/
-
-  ngspice threads may appear on newsgroups dedicated to circuit
-  simulation and electronic design.
-
-
  1.11  Where can I get a copy of ngspice?
 
   You can download ngspice from:
@@ -240,45 +240,74 @@
 
   The latest version released is:
 
-  * ngspice-26 (released on 04/01/2013)
+  * ngspice-27 (released on 28/08/2017)
 
 
  2.2.  What are the latest features in the current release?
 
 - New features:
-        + add temperature coefficients for B source
+    + check for correct inductor coefficients
-        + commands "mdump", "mrdump" to dump matrix to file
+    + add variable 'win_console'
-        + allow `time', `temper', and `hertz' in expressions with behavioral R, L, C
+    + --enable-relpath configure flag to set preprocessor flag HAS_RELPATH
-        + Enable ctrl-c to interrupt a simulation also for Windows GUI
+    +    sets search path for spinit relativ to current directory
-        + tests/bsim4: use the standard CMC model check
+    + shared ngspice: search path for spinit: current dir, HOME dir, USERPROFILE dir
-        + implement exit code for command "quit"
+    + new function stddev to calculate the standard deviation of all elements of a vector
-        + .nodeset all = value
+    + xspice digital n-input x m-output look-up table gate
-        + memristor code model in extradev
+    + xspice digital model d_lut (digital n-input look-up table gate)
-        + new scalable diode model including tunnel component
+    + add variable $sharedmode (if shared ngspice is running), to be used in scripts
-        + variable xtrtol may override the XSPICE reduction of trtol
+    + enable msys2 for mingw compilation
-        + XSPICE example: delta-sigma converter
+    + OMP support for bsim3v3.24 model
-        + XSPICE: new d_source model
+    + bsim3v3.24: add model parameter lmlt (Channel length scaling)
-        + new option noopac
+    + OMP support for BSIM4.5 model
-        + bsim3: make additonal parameters accessible with @mxx[par]
+    + update and extension of command 'wrdata'
-        + enable Mac OS X compilation
+    + option xmu to set damping in trapezoid integration
-        + option reseries = val
+    + command 'linearize' will take time data from transient analysis vector if no circuit is loaded
-        + commands "snsave", "snload"
+    + two new commands: edisplay and eprvcd
-        + update hisim to version 2.7.0, new qa tests
+    +     'edisplay' will show a list of all event nodes
-        + hisimhv update to version 1.2.3, new qa tests
+    +     'eprvcd' will print all event nodes in vcd format
-        + allow Ctrl-d to quit
+    + XSPICE 2D and 3D table models
-        + jfet model temperature extension, tcv and bex parameter
+    + add variable 'batchmode' which is set when command line option `-b' is active
-        + speed up vector handling by hash table for vector address storage and retrieval
+    + enable backquote substitution for Visual Studio console apps
-        + update PSS code
+    + update how-to-ngspice-vstudio.txt
-
+    + update visualc directory and project files, add XSPICE code model generation by VS2015
+    + allow access to 4 GB memory of 32 bit ngspice on 64 bit Windows, 8 TB for 64 bit ngspice
+    + new variable `interactive'
+    + xspice, introduce cm_message_printf()
+    + add variable `width' to command "print line ..."
+    + support msys2
+    + favor exponential temperatur equation if all parameters tc1, tc2 and tce are given for R
+    + move libfftw3 sideways out of the ngspice tree
+    + remove visual studio 2008 .vcproj files
+    + visualc/sharedspice.vcxproj, updated and migrated with visual studio 2015
+    + `E..table {expr} {pairs}', `G..', allow an optional `=' after `table'
+    + `E..value=', `G..value=', allow `=' being optional
+    + introduce TCE, exponential temperature coefficient for R
+    + allow `temper' to be recognised when preceded by '='
+    + allow cross-compilation, especially for MinGW-w64
+    + allow "plot xlog ylog" (equiv to "plot loglog")
+    + extend qa test to hisimhv version 2
+    + update hisimhv model to version 2.2.0
+    + update hisim model to version 2.8.0
+    + .control variable "sqrnoise" to deliver noise data in squared representation
+    + noise analysis, deliver results in V/sqrt(Hz) and A/sqrt(Hz)
+    + add delvt0 for bsim4 models
+    + bug fixes for diode model
+    + allow a xspice circuit with exclusively xspice event nodes
+    + man pages for cmpp ngmakeidx and ngproc2mod
+    + implement `nint()'
+    + everywhere: ln to the base e, log to the base e, log10 to the base 10
+    + allow an optional '=' in ".func foo() = {expr}"
+    + bsim4, update to version 4.8
+    + update hisimhv to version 1.2.4
+    + cmc quality check for bsim3 model
+    + nested indexing for vectors
+    + option savecurrents to save current through all devices
+    + option interp to plot interpolated raw file data
+    + MS VS 2010 project file added for compatibility
+    + XSPICE: new callback function cm_get_path
 
 - Bug fixes:
-    + many, many ... please see
+    + many, many ... as always
-          http://ngspice.git.sourceforge.net/git/gitweb.cgi?p=ngspice/ngspice;a=shortlog;pg=0
-    + remove memory leaks
-    + update tclspice for MS Windows
-    + adms3 removed due to licensing issues
-    + Many small bugs
-
 
 
  2.3.  What does it look like?
@@ -331,7 +360,7 @@
 
   This is a one-million-euros question :).
 
-  Write a mail to the user's list describing the problem and providing
+  Write to the user's discussion group describing the problem and providing
   information on the type of hardware, the flavour of operating system.
 
 
@@ -351,12 +380,7 @@
  4.1.  Feedback
 
   Send your comments about this F.A.Q. to:
-
+  https://sourceforge.net/p/ngspice/discussion/127605/
-  Paolo Nenzi <p.nenzi@ieee.org>.
-
-  Send your comments about ngspice to:
-
-  Paolo Nenzi <p.nenzi@ieee.org>.
 
 
  4.2.  Formats in which this FAQ is available
@@ -367,7 +391,8 @@
 
  4.3.  Authorship and acknowledgements
 
-  Parts of the questions and answers are originate from Paolo Nenzi.
+  Parts of the questions and answers are originate from Paolo Nenzi
+  and are updated by Holger Vogt.
 
 
  4.4.  Disclaimer and Copyright

INSTALL

@@ -5,7 +5,7 @@ Table of contents
 
   1 Ngspice installation (LINUX)
    1.1 Prerequisites
-   1.2 Install from tarball (e.g. ngspice-26.tar.gz)
+   1.2 Install from tarball (e.g. ngspice-27.tar.gz)
    1.3 Install from git repository
    1.4 Advanced Install
     1.4.1 Most useful options
@@ -20,10 +20,10 @@ Table of contents
   8 Operation Controls
   9 NGSPICE COMPILATION UNDER WINDOWS OS
    9.1 How to make ngspice with MINGW and MSYS
-   9.2 make ngspice with MS Visual Studio 2008
+   9.2 make ngspice with MS Visual Studio 2015/2017
    9.3 make ngspice with pure CYGWIN
    9.4 ngspice console app with MINGW or CYGWIN
-
+  10 NGSPICE COMPILATION UNDER MAC OS X
 
 This file describes the procedures to install ngspice from sources.
 
@@ -33,7 +33,7 @@ This file describes the procedures to install ngspice from sources.
 
 1.1 Prerequisites
 
-     Ngspice is written in C and thus a complete C compilation environment
+ Ngspice is written in C and thus a complete C compilation environment
  is needed. Almost any LINUX offers a complete C development environment.
  Ngspice is developed on GNU/Linux with gcc and GNU make.
 
@@ -51,14 +51,14 @@ This file describes the procedures to install ngspice from sources.
  information on ngspice and its usage.
 
 
-1.2 Install from tarball (e.g. ngspice-26.tar.gz)
+1.2 Install from tarball (e.g. ngspice-27.tar.gz)
 
  This covers installation from a release distribution (for example
- ngspice-26.tar.gz, the so called tar ball).
+ ngspice-27.tar.gz, the so called tar ball).
 
  After downloading the tar ball to a local directory unpack it using:
 
- $ tar -zxvf ngspice-26.tar.gz
+ $ tar -zxvf ngspice-27.tar.gz
 
  Now change directories in to the top-level source directory (where this
  INSTALL file can be found).
@@ -160,7 +160,7 @@ This file describes the procedures to install ngspice from sources.
  --enable-adms
         ADMS is an experimental model compiler that translates
         Verilog-A compact models into C code that can be compiled into
-        ngspice. This is (as of ngspice-26) still experimental, some
+        ngspice. This is (as of ngspice-27) still experimental, some
         features (e.g. noise) are missing. If you want to use it, please
         refer to the ADMS section on ngspice web site.
 
@@ -451,8 +451,8 @@ Most of the options now following are not well maintained, are not tested or eve
  to the standard install (FLEX and BISON have to be made available in MSYS).
  Some links are given below which describe the procedures.
 
-     Installing from the tarball, e.g. ngspice-26.tar.gz, is now simple: After
+     Installing from the tarball, e.g. ngspice-27.tar.gz, is now simple: After
- expanding, you may just run ./compile_min.sh from the ngspice-26 directory.
+ expanding, you may just run ./compile_min.sh from the ngspice-27 directory.
 
      The default installation location of ngspice is the Windows path
  C:\spice. The install path can be altered by passing --prefix=NEWPATH
@@ -466,7 +466,7 @@ Most of the options now following are not well maintained, are not tested or eve
  The procedure of compiling a distribution (for example, a tarball from
  the ngspice website), is as follows:
 
- $ cd ngspice-26
+ $ cd ngspice-27
  $ mkdir release
  $ cd release
  $ ../configure --with-wingui ...and other options
@@ -548,12 +548,10 @@ Most of the options now following are not well maintained, are not tested or eve
 
 9.2 make ngspice with MS Visual Studio 2008
 
- ngspice may be compiled with MS Visual Studio 2008 or 2010.
+ ngspice may be compiled with MS Visual Studio 2015 or newer.
 
- CIDER and XSPICE are included, but the code models for XSPICE
+ CIDER and XSPICE are included, the code models for XSPICE
- (*.cm) are not (yet) made. You may however use the code models
+ (*.cm) are made as well.
- created with MINGW (which in fact are dlls), as e.g. found in
- the ngspice binary distribution our made as described in 9.1.
 
  There is currently no installation procedure provided, you may
  however install the executable manually as described in the
@@ -562,21 +560,23 @@ Most of the options now following are not well maintained, are not tested or eve
      The directory (visualc) with its files
  vngspice.sln (project starter) and
  vngspice.vcproj (project contents)
- allows to compile and link ngspice with MS Visual Studio 2008.
+ allows to compile and link ngspice with MS Visual Studio 2015.
  Newer Visual Studio versions will translate the project files
- into their compatible format (tested with MS Visual Studio 2010).
+ into their compatible format (tested with MS Visual Studio 2017).
+ You may however deny the translation and compile in a VS 2015
+ compatibility mode.
 
  /visualc/include contains a dedicated config.h file. It contains the
  preprocessor definitions required to properly compile the code.
  strings.h has been necessary during setting up the project.
 
- Install Microsoft Visual Studio 2008 C++ . The
+ Install Microsoft Visual Studio 2017 Community with C/C++. For
- MS VS 2008 C++ Express Edition (which is available at no cost from
+ example the  German edition is available at no cost from
- http://www.microsoft.com/express/product/default.aspx) is adequate.
+ https://www.visualstudio.com/de/vs/community/.
 
  Goto  /ngspice/visualc.
 
- Start MS Visual Studio 2008 by double click onto vngspice.sln.
+ Start MS Visual Studio 2017 by double click onto vngspice.sln.
 
  After MS Visual Studio has opened up, select debug or release version
  by checking 'Erstellen' , 'Konfigurations-Manager' 'Debug' or 'Release'.

NEWS

@@ -1,3 +1,70 @@
+Ngspice-27, Aug 28th, 2017
+============
+
+- New features:
+    + check for correct inductor coefficients
+    + add variable 'win_console'
+    + --enable-relpath configure flag to set preprocessor flag HAS_RELPATH
+    +    sets search path for spinit relativ to current directory
+    + shared ngspice: search path for spinit: current dir, HOME dir, USERPROFILE dir
+    + new function stddev to calculate the standard deviation of all elements of a vector
+    + xspice digital n-input x m-output look-up table gate
+    + xspice digital model d_lut (digital n-input look-up table gate)
+    + add variable $sharedmode (if shared ngspice is running), to be used in scripts
+    + enable msys2 for mingw compilation
+    + OMP support for bsim3v3.24 model
+    + bsim3v3.24: add model parameter lmlt (Channel length scaling)
+    + OMP support for BSIM4.5 model
+    + update and extension of command 'wrdata'
+    + option xmu to set damping in trapezoid integration
+    + command 'linearize' will take time data from transient analysis vector if no circuit is loaded
+    + two new commands: edisplay and eprvcd
+    +     'edisplay' will show a list of all event nodes
+    +     'eprvcd' will print all event nodes in vcd format
+    + XSPICE 2D and 3D table models
+    + add variable 'batchmode' which is set when command line option `-b' is active
+    + enable backquote substitution for Visual Studio console apps
+    + update how-to-ngspice-vstudio.txt
+    + update visualc directory and project files, add XSPICE code model generation by VS2015
+    + allow access to 4 GB memory of 32 bit ngspice on 64 bit Windows, 8 TB for 64 bit ngspice
+    + new variable `interactive'
+    + xspice, introduce cm_message_printf()
+    + add variable `width' to command "print line ..."
+    + support msys2
+    + favor exponential temperatur equation if all parameters tc1, tc2 and tce are given for R
+    + move libfftw3 sideways out of the ngspice tree
+    + remove visual studio 2008 .vcproj files
+    + visualc/sharedspice.vcxproj, updated and migrated with visual studio 2015
+    + `E..table {expr} {pairs}', `G..', allow an optional `=' after `table'
+    + `E..value=', `G..value=', allow `=' being optional
+    + introduce TCE, exponential temperature coefficient for R
+    + allow `temper' to be recognised when preceded by '='
+    + allow cross-compilation, especially for MinGW-w64
+    + allow "plot xlog ylog" (equiv to "plot loglog")
+    + extend qa test to hisimhv version 2
+    + update hisimhv model to version 2.2.0
+    + update hisim model to version 2.8.0
+    + .control variable "sqrnoise" to deliver noise data in squared representation
+    + noise analysis, deliver results in V/sqrt(Hz) and A/sqrt(Hz)
+    + add delvt0 for bsim4 models
+    + bug fixes for diode model
+    + allow a xspice circuit with exclusively xspice event nodes
+    + man pages for cmpp ngmakeidx and ngproc2mod
+    + implement `nint()'
+    + everywhere: ln to the base e, log to the base e, log10 to the base 10
+    + allow an optional '=' in ".func foo() = {expr}"
+    + bsim4, update to version 4.8
+    + update hisimhv to version 1.2.4
+    + cmc quality check for bsim3 model
+    + nested indexing for vectors
+    + option savecurrents to save current through all devices
+    + option interp to plot interpolated raw file data
+    + MS VS 2010 project file added for compatibility
+    + XSPICE: new callback function cm_get_path
+
+- Bug fixes:
+    + many, many ... as always
+
 Ngspice-26, Jan 4th, 2014
 ============
 

README.tcl

@@ -63,8 +63,8 @@ tcl : the tcl command interpreter, for interpretion of user scipt
 tk  : the graphical extension of tcl, to represent data graphically and for GUIs
 blt : BLT toolkit gives number handling and plotting features to tcl/tk
 
-The most tested configuration is the latest:
+The latest configuration is (not much tested):
-tclspice-26
+tclspice-27
 tcl 8.4
 tk 8.4
 blt 2.4

configure.ac

@@ -12,7 +12,7 @@
 # ---------------
 
 # Initialisation of configure
-AC_INIT([ngspice], [26], [http://ngspice.sourceforge.net/bugrep.html])
+AC_INIT([ngspice], [27], [http://ngspice.sourceforge.net/bugrep.html])
 
 # Unique file in the source directory
 AC_CONFIG_SRCDIR([src/ngspice.c])

visualc/src/include/ngspice/config.h

@@ -479,13 +479,13 @@
 #define PACKAGE_NAME "ngspice"
 
 /* Define to the full name and version of this package. */
-#define PACKAGE_STRING "ngspice 26"
+#define PACKAGE_STRING "ngspice 27"
 
 /* Define to the one symbol short name of this package. */
 #define PACKAGE_TARNAME "ngspice"
 
 /* Define to the version of this package. */
-#define PACKAGE_VERSION "26"
+#define PACKAGE_VERSION "27"
 
 /* Define if we want predictor algorithm */
 /* #undef PREDICTOR */
@@ -540,7 +540,7 @@
 /* #undef TM_IN_SYS_TIME */
 
 /* Version number of package */
-#define VERSION "26"
+#define VERSION "27"
 
 /* Define if we want spice2 sensitivity analysis */
 /* #undef WANT_SENSE2 */