Read Me

Vispect: a simple program for preliminary estimation of SO2 column amounts
Copyright (C) 2008 Tom Wright (tew24@esc.cam.ac.uk)

Program:   Vispect
Version:   0.2.0
Website:   http://vispect.sourceforge.net/
Contact:   Tom Wright
Email:     tew24@esc.cam.ac.uk

Contents:
  1. Software required to run Vispect
  2. Software required to package Vispect on Windows
  3. Running Vispect
  4. Creating a Windows executable

1. Software required to run Vispect:
	Python (http://www.python.org/)
	wxPython (http://www.wxpython.org/)
	Matplotlib (http://matplotlib.sourceforge.net/)
	NumPy (http://numpy.scipy.org/)

2. Software required to package Vispect on Windows:
	All of the above, plus:
	  py2exe (http://www.py2exe.org/)
	  Inno Setup (http://www.jrsoftware.org/isinfo.php)

3. Running Vispect:
	Vispect can be run as it is distributed - simply extract all files to a
	directory and launch the program:
	  
  $ python vispect.py

	Alternatively, on various unices you can make vispect.py executable
	and launch it directly from the shell prompt:

  $ ./vispect.py

	If your python executable is not /usr/bin/python, you will have to 
	change the first line of vispect.py.

4. Creating a Windows executable:
	If you want to create a single-executable installer for Vispect, you
	will need py2exe and Inno Setup.  To make the Vispect installer for
	Windows, change to the source directory and run the setup script:

  > python setup.py py2exe

	This will create two subdirectories: build and dist.  build is a
	temporary directory and dist will contain all of the files associated
	with the Vispect distribution.  When it's finished copying and
	byte-compiling files, it will launch Inno Setup.  If you have the
	ctypes package installed (it comes with	Python 2.5), this is all
	automated.

	If Inno Setup appears but then doesn't do anything, you will need to
	press the "Run" button, or the F9 key to create the setup program.
	When it's finished, it will launch the setup program.  You can cancel
	the install.

	The setup program will now be in the dist\Installer directory.

	BUG: There is an outstanding bug in py2exe
	(http://osdir.com/ml/python.py2exe/2005-09/msg00097.html)
	...which means that MSVCP71.dll is not automatically included in the
	setup file, even though it is needed.  This means that you'll get an
	error when Inno Setup cannot find the file.  You will need to copy it
	from [windir]\system32 or from [pythondir]\Lib\site-packages\[wxdir]\wx
	into the dist directory and re-run the Inno Setup script (vispect.iss).