Installation
------------

Unpack the distribution using

   tar xpzf tssp-v0.2.tgz

and 

   cd tssp-v0.2

Files
-----

tlap.c:  Source code for laplace solver. Sorry, this is untidy and
         uncommented and is undergoing lots of changes at the moment.

tsim.c:  Source code for simulator.

tsim-util.c: Supporting routines for simulator.

makefile: Makefile for tlap and tsim.

tsim-code.ps: Formatted listing of tsim.c.
tlap-code.ps: Formatted listing of tlap.c.

tsim-notes.ps: Theory notes.

complex.c:  Complex arithmetic routines.

complex.h:  Header for complex.c, includes some inline functions.

thor.in:   
albert.in:  Sample system description files.

viplot: Script to generate V/I distribution charts from a data.out
zplot: Script to generate input impedance charts from a data.out

Operation
---------

Compile the software with

   make

You may have to adjust the makefile slightly to suit your local environment.

Take one of the sample .in files and copy it to a new name in the current
directory. Edit to suit your resonator. We suppose you've called your coil
arthur and you've made a description file arthur.in

Run tlap over this file with

   ./tlap arthur

which will eventualy generate a file arthur.caps containing
the raw capacitance distribution data. Note that tlap assumes you have
an X workstation of some kind.

Run the simulator with 
   ./tsim arthur 30000 400000 4000 > arthur.data

which runs the simulator over the range 30kHz to 400kHz in 4kHz steps.
This will take a few hours to run. 

Inspect the impedance response with

   ./zplot < arthur.data > z_chart.ps
   gv z_chart.ps

Inspect the chart and make additional tsim runs at higher resolution
around the impedance zeroes, eg

   ./tsim arthur 92000 108000 500 >>  arthur.data

where this time we are appending to the data file.

Notes
-----

zplot and viplot assume you have gnuplot and imagemagic tools installed.
If not, modify the scripts to suit your local image processing toolset.

Problems
--------

Feedback to paul@abelian.demon.co.uk

If you're having trouble with tlap send your system
description file with your complaint.

Let me know if you have to edit makefile to build things on your system.