Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update docs & README.md #87

Merged
merged 15 commits into from
Aug 2, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 39 additions & 39 deletions .github/workflows/pythonpackage.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,46 +4,46 @@
name: build

on:
push:
branches: [ main, dev ]
pull_request:
branches: [ main, dev ]
push:
branches: [main, dev]
pull_request:
branches: [main, dev]

jobs:
build:
strategy:
matrix:
os:
- ubuntu-latest
# - windows-latest
# - macos-latest
python-version: [ 3.6, '3.x' ]
build:
strategy:
matrix:
os:
- ubuntu-latest
# - windows-latest
# - macos-latest
python-version: [3.6, "3.x"]

runs-on: ${{ matrix.os }}
runs-on: ${{ matrix.os }}

steps:
- uses: actions/checkout@v2
with:
token: ${{ secrets.INTEGRATIVE_KEY }}
submodules: true
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v1
with:
python-version: ${{ matrix.python-version }}
- name: Install package and dependencies
run: |
python -m pip install --upgrade pip
pip install .
pip install -r requirements.txt
- name: Lint with flake8
run: |
pip install flake8
# stop the build if there are Python syntax errors or undefined names
flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
# exit-zero treats all errors as warnings.
flake8 . --count --exit-zero --statistics
- name: Test with pytest and coverage
run: |
pip install pytest coverage
coverage run -m pytest
coverage report
steps:
- uses: actions/checkout@v2
with:
token: ${{ secrets.INTEGRATIVE_KEY }}
submodules: true
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v1
with:
python-version: ${{ matrix.python-version }}
- name: Install package and dependencies
run: |
python -m pip install --upgrade pip
pip install .
pip install -r requirements.txt
- name: Lint with flake8
run: |
pip install flake8
# stop the build if there are Python syntax errors or undefined names
flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
# exit-zero treats all errors as warnings.
flake8 . --count --exit-zero --statistics
- name: Test with pytest and coverage
run: |
pip install pytest coverage
coverage run -m pytest
coverage report
4 changes: 0 additions & 4 deletions AUTHORS.rst

This file was deleted.

9 changes: 0 additions & 9 deletions CHANGELOG.rst

This file was deleted.

2 changes: 0 additions & 2 deletions FAQ.rst

This file was deleted.

28 changes: 0 additions & 28 deletions INSTALL.rst

This file was deleted.

66 changes: 66 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Welcome to **overreact**!

<div style="text-align:center;">

![overreact](https://raw.githubusercontent.com/geem-lab/overreact-docs/master/logo.png)

</div>

**overreact** is a _library_ and a _command-line tool_ for creating and
analyzing [microkinetic models](https://geem-lab.github.io/overreact-docs/#microkinetic).
Data is parsed directly from computational chemistry output files thanks to
[`cclib`](https://cclib.github.io/) (see the [list of supported programs](https://cclib.github.io/#summary)).

## Installation

**overreact** is a Python package, so you can easily install it with `pip`.
See the [installation instructions](https://geem-lab.github.io/overreact-docs/install.html).

## License

**overreact** is open-source, released under the permissive **MIT license**.
See [our LICENSE file](https://github.com/geem-lab/overreact/blob/main/LICENSE).

## Citing **overreact**

If you use **overreact** in your research, please cite:

> F. S. S. Schneider and G. F. Caramori. _**overreact**: a tool for creating and analyzing microkinetic models built from computational chemistry data_. **2021**.
> Available at: <https://github.com/geem-lab/overreact>.

Here's the reference in [BibTeX](http://www.bibtex.org/) format:

<!-- @article{overreact,
title = \textbf{overreact}: a tool for creating and analyzing microkinetic models built from computational chemistry data},
author = {Schneider, F. S. S. and Caramori, G. F.},
journal={J. Chem. Phys.},
volume={155},
number={1},
pages={0},
year = {2021},
publisher={American Chemical Society (ACS)},
doi={10.1063/1.5058983},
url={https://doi.org/10.1063/1.5058983}
} -->

```bibtex
@misc{overreact2021,
title = {
\textbf{overreact}: a tool for creating and analyzing microkinetic models
built from computational chemistry data, ver. 1.0
},
author = {Schneider, F. S. S. and Caramori, G. F.},
year = 2021,
howpublished = {\url{https://github.com/geem-lab/overreact}}
}
```

A paper describing **overreact** is currently being prepared.
When it is published, the above BibTeX entry will be updated.

## Funding

This project was developed at the [GEEM lab](https://geem-ufsc.org/) ([Federal University of Santa
Catarina](https://en.ufsc.br/), Brazil), and was partially funded by the
[Brazilian National Council for Scientific and Technological Development (CNPq)](https://cnpq.br/),
grant number 140485/2017-1.
27 changes: 0 additions & 27 deletions README.rst

This file was deleted.

2 changes: 1 addition & 1 deletion data
Submodule data updated from f4c8d2 to f77872
1 change: 0 additions & 1 deletion docs/_sources/authors.rst.txt

This file was deleted.

1 change: 0 additions & 1 deletion docs/_sources/changelog.rst.txt

This file was deleted.

1 change: 0 additions & 1 deletion docs/_sources/contributing.rst.txt

This file was deleted.

1 change: 0 additions & 1 deletion docs/_sources/faq.rst.txt

This file was deleted.

25 changes: 0 additions & 25 deletions docs/_sources/foreword.rst.txt

This file was deleted.

36 changes: 0 additions & 36 deletions docs/_sources/index.rst.txt

This file was deleted.

1 change: 0 additions & 1 deletion docs/_sources/installation.rst.txt

This file was deleted.

4 changes: 0 additions & 4 deletions docs/_sources/license.rst.txt

This file was deleted.

74 changes: 0 additions & 74 deletions docs/_sources/quickstart.rst.txt

This file was deleted.

Loading