-
Notifications
You must be signed in to change notification settings - Fork 10
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Update the README.md for KPP 2.5.0 release
- Documentation now points to kpp.readthedocs.io - License information now points to LICENSE.txt in the Github repo - Added latest-release badge - Added ReadTheDocs badge - Added C-I test badge - Added GPLV3 Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>
- Loading branch information
Showing
1 changed file
with
6 additions
and
98 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,102 +1,10 @@ | ||
[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/geoschem/KPP/blob/GC_updates/LICENSE.txt) | ||
[![Latest Release](https://img.shields.io/github/v/release/KineticPreProcessor/KPP?label=Latest%20Release)](https://kpp.readthedocs.io) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://github.com/KineticPreProcessor/KPP/blob/main/LICENSE.txt) [![C-I tests](https://img.shields.io/azure-devops/build/KineticPreProcessor/KPP/1/main?label=C-I%20Tests)](https://dev.azure.com/KineticPreProcessor/KPP/_build) [![ReadTheDocs](https://assets.readthedocs.org/static/projects/badges/passing-flat.svg)](https://kpp.readthedocs.io/en/latest) | ||
|
||
# KPP | ||
|
||
This is the repository for the Kinetic PreProcessor (KPP). | ||
|
||
We are in the process of updating this repository. We will post | ||
updated documentation to our ReadTheDocs site: | ||
https://kpp.readthedocs.io in the near future. | ||
|
||
|
||
## Versions | ||
KPP - symbolic chemistry Kinetics PreProcessor: | ||
|
||
- Current: Version 2.4.0 (in the **main** branch) | ||
- In development: Version 2.5.0 (in the **dev** branch) | ||
# The Kinetic PreProcessor: KPP | ||
This is the repository for the The Kinetic PreProcessor (KPP) source code. | ||
|
||
## License | ||
KPP is distributed under [GPLv3, the general public license](https://github.com/KineticPreProcessor/KPP/blob/main/LICENSE.txt). | ||
|
||
KPP is distributed under GPL, the [general public license](http://www.gnu.org/copyleft/gpl.html) | ||
|
||
(C) 1995-1997, V. Damian & A. Sandu, CGRER, Univ. Iowa | ||
(C) 1997-2005, A. Sandu, Michigan Tech, Virginia Tech | ||
with contributions from: | ||
R. Sander, Max-Planck Institute for Chemistry, Mainz, Germany | ||
|
||
## Getting Started | ||
Read [user's manual](https://github.com/KineticPreProcessor/KPP/blob/master/doc/kpp_UserManual.pdf) | ||
|
||
## Installation | ||
|
||
1. Make sure that FLEX (public domain lexical analizer) is installed | ||
on your machine. Type "flex --version" to test this. | ||
|
||
2. Note down the exact path name where the FLEX library is installed. The | ||
library is called: | ||
libfl.a or libfl.sh | ||
|
||
3. Define the KPP_HOME environment variable to point to the complete | ||
path location of KPP. If, for example, KPP is installed in $HOME/kpp: | ||
|
||
- with C shell (or tcsh) edit the file .cshrc (or .tcshrc) in your | ||
home directory and add: | ||
setenv KPP_HOME $HOME/kpp | ||
set path=( $path $HOME/kpp/bin ) | ||
Execute 'source .cshrc' (or 'source .tcshrc') to make sure these | ||
changes are in effect. | ||
|
||
- with bash shell edit the file .bashrc in your home directory and add: | ||
export KPP_HOME=$HOME/kpp | ||
export PATH=$PATH:$HOME/kpp/bin | ||
|
||
3. In KPP_HOME directory edit: | ||
Makefile.defs | ||
and follow the instructions included to specify the compiler, | ||
the location of the FLEX library, etc. | ||
|
||
4. In KPP_HOME directory build the sources using: | ||
make | ||
|
||
## Cleanup | ||
|
||
1. Delete the KPP object files with: | ||
make clean | ||
|
||
2. Delete the whole distribution (including the KPP binaries) with: | ||
make distclean | ||
|
||
## Troubleshooting | ||
If you have any problems please send the detailed error report and the machine | ||
environment to: | ||
|
||
geos-chem-support@g.harvard.edu | ||
|
||
## Branches of development | ||
|
||
### main | ||
|
||
This is the default branch, which corresponds to the unmodified KPP version 2.2.3_01 as published by A. Sandu et al. For more information, [see the KPP website](https://people.cs.vt.edu/~asandu/Software/Kpp/). | ||
|
||
* NOTE: In keeping with Github best practices, we have renamed "master" to "main". | ||
|
||
### dev | ||
|
||
This is the development branch for KPP 3.0.0. | ||
|
||
### GC_updates | ||
|
||
This branch includes modifications to KPP that were made specifically for the GEOS-Chem model. For more information, please see the [README.md file in the GC_updates branch](https://github.com/KineticPreProcessor/KPP/blob/GC_updates/README.md). | ||
|
||
### F77 | ||
|
||
This branch incorporates fixes from Josue Bock for generating chemical mechanism solver files in Fortran-77 format. | ||
|
||
### mistra | ||
|
||
This branch contains modifications to KPP that were made specifically for the mistra project. | ||
|
||
## Documentation: | ||
|
||
* [KPP user manual](https://github.com/KineticPreProcessor/KPP/blob/main/doc/kpp_UserManual.pdf) | ||
* [KPP references](https://people.cs.vt.edu/~asandu/Software/Kpp/docsforkpp.htm) | ||
## Documentation | ||
Please see our comprehensive KPP User's Guide (https://kpp.readthedocs.io) for installation and usage instructions. |