| 1 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 2 | |
|---|
| 3 | KPP - symbolic chemistry Kinetics PreProcessor, Version 2.1 |
|---|
| 4 | (http://www.cs.vt.edu/~asandu/Software/KPP) |
|---|
| 5 | KPP is distributed under GPL, the general public licence |
|---|
| 6 | (http://www.gnu.org/copyleft/gpl.html) |
|---|
| 7 | (C) 1995-1997, V. Damian & A. Sandu, CGRER, Univ. Iowa |
|---|
| 8 | (C) 1997-2005, A. Sandu, Michigan Tech, Virginia Tech |
|---|
| 9 | with contributions from: |
|---|
| 10 | R. Sander, Max-Planck Institute for Chemistry, Mainz, Germany |
|---|
| 11 | |
|---|
| 12 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 13 | |
|---|
| 14 | To get started with KPP: Read user's manual (doc/kpp-UserManual.pdf) |
|---|
| 15 | ------------------------ |
|---|
| 16 | |
|---|
| 17 | To install KPP: |
|---|
| 18 | --------------- |
|---|
| 19 | |
|---|
| 20 | 1. Make sure that FLEX (public domain lexical analizer) is installed |
|---|
| 21 | on your machine. Type "flex --version" to test this. |
|---|
| 22 | |
|---|
| 23 | 2. Note down the exact path name where the FLEX library is installed. The |
|---|
| 24 | library is called: |
|---|
| 25 | libfl.a or libfl.sh |
|---|
| 26 | |
|---|
| 27 | 3. Define the KPP_HOME environment variable to point to the complete |
|---|
| 28 | path location of KPP. If, for example, KPP is installed in $HOME/kpp: |
|---|
| 29 | |
|---|
| 30 | - with C shell (or tcsh) edit the file .cshrc (or .tcshrc) in your |
|---|
| 31 | home directory and add: |
|---|
| 32 | setenv KPP_HOME $HOME/kpp |
|---|
| 33 | set path=( $path $HOME/kpp/bin ) |
|---|
| 34 | Execute 'source .cshrc' (or 'source .tcshrc') to make sure these |
|---|
| 35 | changes are in effect. |
|---|
| 36 | |
|---|
| 37 | - with bash shell edit the file .bashrc in your home directory and add: |
|---|
| 38 | export KPP_HOME=$HOME/kpp |
|---|
| 39 | export PATH=$PATH:$HOME/kpp/bin |
|---|
| 40 | |
|---|
| 41 | 3. In KPP_HOME directory edit: |
|---|
| 42 | Makefile.defs |
|---|
| 43 | and follow the instructions included to specify the compiler, |
|---|
| 44 | the location of the FLEX library, etc. |
|---|
| 45 | |
|---|
| 46 | 4. In KPP_HOME directory build the sources using: |
|---|
| 47 | make |
|---|
| 48 | |
|---|
| 49 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 50 | |
|---|
| 51 | To clean the KPP installation: |
|---|
| 52 | ------------------------------ |
|---|
| 53 | |
|---|
| 54 | 1. Delete the KPP object files with: |
|---|
| 55 | make clean |
|---|
| 56 | |
|---|
| 57 | 2. Delete the whole distribution (including the KPP binaries) with: |
|---|
| 58 | make distclean |
|---|
| 59 | |
|---|
| 60 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|---|
| 61 | |
|---|
| 62 | If you have any problems please send the detailed error report and the machine |
|---|
| 63 | environment to: |
|---|
| 64 | |
|---|
| 65 | sandu@cs.vt.edu |
|---|
