Holger Vogt 130120
********************
tclspice for Windows
********************


Documentation, manuals:
http://ngspice.sourceforge.net/tclspice.html
http://ngspice.sourceforge.net/docs/ngspice-manual.pdf, chapter 19
http://tclspice.sourceforge.net/docs/tclspice_com.html

Expand tclspice-release.7z into a directory of your choice, e.g. d:\tclspice.

** From tclspice-release25 directory
Double click on one of
tb1_start.bat
tb2_start.bat
tb3_start.bat
tb4_start.bat
tbtcl_start.bat

to start test number 1-4 or tvr

** From Windows Command Prompt (cmd.exe)
Open a command console window.
cd into
D:\spice\tclspice-release\tests\tb1
then run
start /B ..\..\bin86r\wish  ./tb1r.tcl
voila! The window with graphics results opens.
Same with
cd /d/spice/tclspice-release/tests/tb2
start /B ..\..\bin86r\wish  ./tb2r.tcl
and tb3 
as well as tcl
start /B ..\..\bin86r\wish  ./tvr.tcl

Example 4 (tb4) requires a different command (tb4r.tcl is empty for cmd.exe):
start /B ..\..\bin86r\wish vspicechart.tcl example.cir. This has a bug 
however: if you click into the plot window, the program crashes 
(caused by blt2.4, t.b.d.).

Therefore example 4 has an improved version vspicechart-2.tcl, using a modified
blt2.5, with improved commands stop, resume, and restart. 


** From MSYS (http://sourceforge.net/projects/mingw/files/)
Open an msys console window.
cd into
/d/spice/tclspice-release/tests/tb1
then run
./tb1r.tcl

Same with
cd /d/spice/tclspice-release/tests/tb2
./tb2r.tcl
etc. (tb3, tb4) and
cd /d/spice/tclspice-release/tests/tcl
./tvr.tcl

Example tb3 will need the code model spice2poly.cm

Example tvr runs some tests and then offers a tcl console for further
tclspice experiments.

tclspice looks for a tclspinit file in  C:\Spice\share\ngspice\scripts
or in the local directory where spice.dll resides.


*** where to obtain the sources ****

Executables and dlls in dir bin86r were compiled with 
MS Visual Studio 2008 Professional from the following sources:

spice.dll: ngspice-25 sources as of Jan. 6th, 2013
http://sourceforge.net/projects/ngspice/files/ng-spice-rework/25/ngspice-25.tar.gz/download

tcl/tk, Version 8.6b2, as of Jan. 18th, 2012, from
http://www.tcl.tk/software/tcltk/download.html
http://prdownloads.sourceforge.net/tcl/tcl86b2-src.zip
http://prdownloads.sourceforge.net/tcl/tk86b2-src.zip

blt2.4, downloaded Jan 21st, 2012
http://blt.sourceforge.net/
ftp://www.sourceforge.net/projects/blt/files/BLT2.4z.tar.gz
with some modifications (to be reported elsewhere)

blt2.5
http://sourceforge.net/projects/wize/files/blt-src-2.5.3.zip/download
with some modifications of files in directory 'generic',
made in May 2012, available as a package for MS Visual Studio
at http://ngspice.sourceforge.net/experimental/blt2.5.3.7z

vcomp90.dll is a redistributable from Microsoft to enable 
OpenMP support in spice.dll

Contents in dir 'lib' stem from the same downloads as above.
