Skip to main content

Chemical kinetics code

Project description

ChemKinLib [![Build Status](https://travis-ci.org/cs207-group11/cs207-FinalProject.svg?branch=master)](https://travis-ci.org/cs207-group11/cs207-FinalProject.svg?branch=master) [![Coverage Status](https://coveralls.io/repos/github/cs207-group11/cs207-FinalProject/badge.svg?branch=master)](https://coveralls.io/github/cs207-group11/cs207-FinalProject?branch=master)
===================

### Group #11: Karan R. Motwani, Shiyu Huang, Hannah Sim, and Haixing Yin.

ChemKinLib (Chemical Kinetics Library) consists of classes and functions to allow the user to interpret the kinetics of a system of chemical reaction by computing the associated reaction rates. The library currently supports:

- Elementary reactions: irreversible and reversible

And of these reactions, the following reaction rate coefficients are supported:
- Constant
- Arrhenius
- Modified Arrhenius

This Python library is designed to exhibit flexibility, extensibility, and ease of use. The initial input provided by the user is an `.xml` file while other individual parameters (temperature and concentrations) are entered during runtime.

## Installation
There are two options for installing ChemKinLib:

1) Clone the repository into you local system.

2) Execute in terminal: `python3 setup.py install` or `python3 -m pip install -e .`

OR

1) Execute in terminal: `pip3 install chemkinlib11`

2) Try executing `import chemkinlib` to test the installation in your terminal.

## Examples
There are two examples in the `examples` subdirectory: (a) `rev_rxns.py` (system of reversible, elementary reactions) and (b) `irrev_rxns.py` (system of irreversible, elementary reactions). They show the user how to set up a calculation using ChemKinLib to compute the reaction rate of each specie involved in the reactions. In addition, there is an iPython notebook tutorial (`basic-tutorial.ipynb`) that goes through the steps to compute reaction rates for a set of irreversible reactions.

## Documentation
The documentation for the library can be found [here](https://github.com/cs207-group11/cs207-FinalProject/blob/master/CS207_Documentation.pdf).

## Dependencies
See [requirements](https://github.com/cs207-group11/cs207-FinalProject/blob/master/requirements.txt) for dependencies.

## License
See [LICENSE](https://github.com/cs207-group11/cs207-FinalProject/blob/master/LICENSE) file distributed with ChemKinLib for more information.

## Contributing
Contributions are welcome (post project evaluation). If you wish to contribute, please take a few moment to review the [branching model](http://nvie.com/posts/a-successful-git-branching-model/) this repository utilizes.

## Support
If you have questions or need help with using or contributing to the repository, feel free to ask questions through: https://github.com/cs207-group11/cs207-FinalProject/issues


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

chemkinlib11-0.1.3-py3-none-any.whl (46.8 kB view details)

Uploaded Python 3

File details

Details for the file chemkinlib11-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for chemkinlib11-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 bb7f04307f15c0c151cf4422c55d28f86577b74db6f28115b2102767c90c49c7
MD5 f3440a57f52ff37633360942354d96df
BLAKE2b-256 af53cf24ebd57a1ddc5ebf35d1c2f8c79e0a83fe5adf9db8e83871c3620e7e48

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page