Skip to main content

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:

*

Project details


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