Evaluation of chemical kinetic models with experimental data
Project description
# PyTeCK
[![Build Status](https://travis-ci.org/kyleniemeyer/PyTeCK.svg?branch=master)](https://travis-ci.org/kyleniemeyer/PyTeCK)
[![codecov](https://codecov.io/gh/kyleniemeyer/PyTeCK/branch/master/graph/badge.svg)](https://codecov.io/gh/kyleniemeyer/PyTeCK)
[![Dependency Status](https://dependencyci.com/github/kyleniemeyer/PyTeCK/badge)](https://dependencyci.com/github/kyleniemeyer/PyTeCK)
[![Code of Conduct](https://img.shields.io/badge/code%20of%20conduct-contributor%20covenant-green.svg)](http://contributor-covenant.org/version/1/4/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Anaconda](https://anaconda.org/kyleniemeyer/pyteck/badges/version.svg)](https://anaconda.org/kyleniemeyer/pyteck)
This software package automatically evaluates the performance of a chemical kinetic
model using experimental data given in a specified YAML format.
## Installation
The easiest way to install PyTeCK is via `conda`. You can install to your environment with
> conda install -c kyleniemeyer pyteck
which will also handle all the dependencies. Alternatively, you can install from
PyPI with
> pip install pyteck
If you prefer to install manually, or want a particular version outside of the
tagged releases distributed to those services, you can download the source files
from this repository, navigate to the directory, and install using either `setuptools`
> python setup.py install
or `pip`
> pip install .
`pip` is recommended due to its easy uninstall option (`pip uninstall pyteck`).
## Usage
Once installed, the full list of options can be seen using `pyteck -h` or `pyteck --help`.
## Code of Conduct
In order to have a more open and welcoming community, PyTeCK adheres to a code of
conduct adapted from the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
Please adhere to this code of conduct in any interactions you have in the PyTeCK community.
It is strictly enforced on all official PyTeCK repositories, websites, and resources.
If you encounter someone violating these terms, please let
[@kyleniemeyer](https://github.com/kyleniemeyer) know via email at <kyle.niemeyer@gmail.com>
and we will address it as soon as possible.
## Citation
If you use this package as part of a scholarly publication, please refer to
[CITATION.md](https://github.com/kyleniemeyer/PyTeCK/blob/master/CITATION.md)
for instructions on how to cite this resource directly.
## License
PyTeCK is released under the MIT license; see
[LICENSE](https://github.com/kyleniemeyer/PyTeCK/blob/master/LICENSE) for details.
# Change Log
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/)
and this project adheres to [Semantic Versioning](http://semver.org/).
## [Unreleased]
### Added
### Fixed
### Changed
## [0.2.0] - 2017-04-13
### Added
- Adds initial web documentation using Sphinx/Doctr
- Deploys conda and PyPI packages with tagged releases
### Changed
- Major changes for compatibility with PyKED package and newer ChemKED format
## [0.1.0] - 2016-07-12
### Added
- First published version of PyTeCK.
- Supports validation using both shock tube and RCM experimental data in ChemKED format, but RCM not fully functional.
[Unreleased]: https://github.com/kyleniemeyer/PyTeCK/compare/v0.2.0...HEAD
[0.2.0]: https://github.com/kyleniemeyer/PyTeCK/compare/v0.1...0.2.0
[0.1.0]: https://github.com/kyleniemeyer/PyTeCK/compare/e99f757b7ea644065a0ee65ce86dbfb8f404be60...v0.1
# Citation of PyTeCK
To cite PyTeCK in a scholarly article, please use
> K. E. Niemeyer. (2017) PyTeCK v0.2.0 [software]. https://github.com/kyleniemeyer/PyTeCK
A BibTeX entry for LaTeX users is
```TeX
@misc{PyKED,
author = {Kyle E Niemeyer},
year = 2017,
title = {PyTeCK v0.2.0},
doi = {},
url = {https://github.com/kyleniemeyer/PyTeCK},
}
```
In both cases, please update the entry with the version used. The DOI for the latest version can be found in the badge at the top.
If you would like to cite a specific, older version, the DOIs for each release are:
*
[![Build Status](https://travis-ci.org/kyleniemeyer/PyTeCK.svg?branch=master)](https://travis-ci.org/kyleniemeyer/PyTeCK)
[![codecov](https://codecov.io/gh/kyleniemeyer/PyTeCK/branch/master/graph/badge.svg)](https://codecov.io/gh/kyleniemeyer/PyTeCK)
[![Dependency Status](https://dependencyci.com/github/kyleniemeyer/PyTeCK/badge)](https://dependencyci.com/github/kyleniemeyer/PyTeCK)
[![Code of Conduct](https://img.shields.io/badge/code%20of%20conduct-contributor%20covenant-green.svg)](http://contributor-covenant.org/version/1/4/)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Anaconda](https://anaconda.org/kyleniemeyer/pyteck/badges/version.svg)](https://anaconda.org/kyleniemeyer/pyteck)
This software package automatically evaluates the performance of a chemical kinetic
model using experimental data given in a specified YAML format.
## Installation
The easiest way to install PyTeCK is via `conda`. You can install to your environment with
> conda install -c kyleniemeyer pyteck
which will also handle all the dependencies. Alternatively, you can install from
PyPI with
> pip install pyteck
If you prefer to install manually, or want a particular version outside of the
tagged releases distributed to those services, you can download the source files
from this repository, navigate to the directory, and install using either `setuptools`
> python setup.py install
or `pip`
> pip install .
`pip` is recommended due to its easy uninstall option (`pip uninstall pyteck`).
## Usage
Once installed, the full list of options can be seen using `pyteck -h` or `pyteck --help`.
## Code of Conduct
In order to have a more open and welcoming community, PyTeCK adheres to a code of
conduct adapted from the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
Please adhere to this code of conduct in any interactions you have in the PyTeCK community.
It is strictly enforced on all official PyTeCK repositories, websites, and resources.
If you encounter someone violating these terms, please let
[@kyleniemeyer](https://github.com/kyleniemeyer) know via email at <kyle.niemeyer@gmail.com>
and we will address it as soon as possible.
## Citation
If you use this package as part of a scholarly publication, please refer to
[CITATION.md](https://github.com/kyleniemeyer/PyTeCK/blob/master/CITATION.md)
for instructions on how to cite this resource directly.
## License
PyTeCK is released under the MIT license; see
[LICENSE](https://github.com/kyleniemeyer/PyTeCK/blob/master/LICENSE) for details.
# Change Log
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/)
and this project adheres to [Semantic Versioning](http://semver.org/).
## [Unreleased]
### Added
### Fixed
### Changed
## [0.2.0] - 2017-04-13
### Added
- Adds initial web documentation using Sphinx/Doctr
- Deploys conda and PyPI packages with tagged releases
### Changed
- Major changes for compatibility with PyKED package and newer ChemKED format
## [0.1.0] - 2016-07-12
### Added
- First published version of PyTeCK.
- Supports validation using both shock tube and RCM experimental data in ChemKED format, but RCM not fully functional.
[Unreleased]: https://github.com/kyleniemeyer/PyTeCK/compare/v0.2.0...HEAD
[0.2.0]: https://github.com/kyleniemeyer/PyTeCK/compare/v0.1...0.2.0
[0.1.0]: https://github.com/kyleniemeyer/PyTeCK/compare/e99f757b7ea644065a0ee65ce86dbfb8f404be60...v0.1
# Citation of PyTeCK
To cite PyTeCK in a scholarly article, please use
> K. E. Niemeyer. (2017) PyTeCK v0.2.0 [software]. https://github.com/kyleniemeyer/PyTeCK
A BibTeX entry for LaTeX users is
```TeX
@misc{PyKED,
author = {Kyle E Niemeyer},
year = 2017,
title = {PyTeCK v0.2.0},
doi = {},
url = {https://github.com/kyleniemeyer/PyTeCK},
}
```
In both cases, please update the entry with the version used. The DOI for the latest version can be found in the badge at the top.
If you would like to cite a specific, older version, the DOIs for each release are:
*