SDToolbox(Python) Windows Installation Instructions.

1. Download

   a. python 2.5 for windows
      http://www.python.org/download/ 

   b. numarray for python 2.5 (windows) 
      http://www.stsci.edu/resources/software_hardware/numarray 

   c. scipy for python 2.5 (windows) 
      http://www.scipy.org/Download 

   d. numpy for python 2.5 (windows) (needed by scipy) 
      http://numpy.scipy.org/ 

   e. (optional download) matplotlib for python 2.5 (windows) 
      http://matplotlib.sourceforge.net/ 

   f. Cantera 1.71 for windows  (download Cantera1.7.0.msi)
      http://sourceforge.net/projects/cantera 

   g. SDToolbox:
      http://www.galcit.caltech.edu/EDL/public/cantera/1.7/python/lin/sdt/SDToolbox.zip 

   h. Demonstrations:
      http://www.galcit.caltech.edu/EDL/public/cantera/1.7/python/lin/sdt/demos.zip

   i. Cantera installation instructions
      http://www.galcit.caltech.edu/EDL/public/cantera/doc/install-V1.7.txt 

   j. Mixmaster script replacement
      http://www.galcit.caltech.edu/EDL/public/cantera/html/SD_Toolbox/Windows/ThermoFrame.py

2. Install in the Order below

   a. python 2.5

   b. All the other packages above (b - f)

   c. Cantera installation: 

      i. Run Cantera1.7.0.msi 

      ii. Run Cantera-1.7.0.win32-py2.5.exe
         (found in the Cantera installation directory, for example C:/Cantera or C:/Program\ Files/Cantera) 
         (also accessible by clicking on the Cantera icon on the Desktop).

      iii. Set the environment variable
           - Select "System" from the Control Panel to pull up a dialogue box, 
           - Press the "Environment Variables" button, 
           - Select New (user) Environment Variable
           - Variable Name: PYTHON_CMD  
	     Variable Value: C:\Python25\python.exe

      iv. Fix the Mixmaster bug in the Cantera 1.7 Distribution
          Replace 
            C:\Python25\Lib\site-packages\MixMaster\ThermoFrame.py 
          with
            http://www.galcit.caltech.edu/EDL/public/cantera/html/SD_Toolbox/Windows/ThermoFrame.py

      v. Download High Temperature (up to 6000 K) cti Files
            http://www.galcit.caltech.edu/EDL/public/cantera/mechs/cti/high_T_cti_files.zip
         Put Thermo/Reaction Data Files (.cti) in one of two places
            C:\Program Files\Common Files\Cantera\data 
         or 
            Your current python working directory

      vi. Test installation by running the Cantera python tutorials
          - Make sure to restart your computer for the environment variables to take effect)
   	  - Run tut1.py (python tutorial file) - Located in Cantera\tutorials\Python
          To Run: 
          - Right click on "tut1.py" 
          - Left click on "Edit with Idle"
          - In the tut1.py window enter "F5" (shortcut for Run > RunModule)

3. SD Toolbox installation

   a. Download SDToolbox.zip and demos.zip and save to a directory
      (e.g. Desktop\cantera.shock\SDToolbox\SDToolbox.zip and
       Desktop\cantera.shock\demos\demos.zip)

   b. Unzip the files.

   c. Go to C:\Python25\Lib\site-packages and create a directory named SDToolbox

   d. Copy the unzipped SDToolbox files from above into this newly created
      SDToolbox directory. (there should be 4 files; __init__.py, CV.py,
      PostShock.py & Thermo.py)

   e. Go up 1 directory to C:\Python25\Lib\site-packages.
      Use any plaintext editor to create the file SDToolbox.pth (not .txt!)
      and inside this file is a single line "SDToolbox" (without the quotes).
      Note: Using Wordpad or Notepad works for this if you save the file as the all files type
      you can also modify the file extension manually after creating the file

   f. Go up 1 directory to C:\Python\Lib. Go to the file site.py, right click 
      and "Edit with IDLE". In the site.py window, go to Menu->Run->Run Module.
      This should initialize the SDToolbox path into Python as shown in the Python Shell output window.

   g. SDToolbox installation is done!


4. Test with SD Toolbox Demo Scripts

   a. Go to the demo scripts directory that you unzipped the demo files into
      (Desktop\cantera.shock\demos in our example)

   b. Test the demos by "Edit with IDLE" & Run Module. (Section 3f)

Troubleshooting Note : Cantera files are scattered into 3 places; 
    ..\Cantera
    ..\Python25\Lib\site-packages\Cantera (Mixmaster & SDToolbox too), 
    Program Files\Common Files\Cantera\data (where the mechanisms are put)