chemtools 0.9.2

.. image:: https://readthedocs.org/projects/chemtools/badge/
:target: https://chemtools.readthedocs.org
:alt: Documentation Status

.. image:: https://img.shields.io/pypi/v/chemtools.svg?style=flat-square&label=PyPI%20version
:target: https://pypi.python.org/pypi/chemtools
:alt: Latest version released on PyPi

.. image:: https://www.travis-ci.org/lmmentel/chemtools.svg?branch=master
:target: https://www.travis-ci.org/lmmentel/chemtools
:alt: Build Status

.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
:target: https://opensource.org/licenses/MIT
:alt: MIT license

.. image:: https://pepy.tech/badge/chemtools
:target: https://pepy.tech/project/chemtools
:alt: pepy


======================================================
chemtools_: Python toolbox for Computational Chemistry
======================================================

Chemtools is a set of modules that is intended to help with more
advanced computations using common electronic structure programs.

The main to goal was to enable convenient `basis set <https://en.wikipedia.org/wiki/Basis_set_%28chemistry%29>`_ manipulations, including designing and optimizing exponents of basis sets. To achieve that there are several modules abstracting various functionalities.

Currently there is support optimizing basis set (or doing general computations) with:

* Dalton_
* Gamess-US_
* MolPro_
* PSI4_


Table of Contents
=================

* `Getting Started`_

* Installation_
* Documentation_

* Contributing_
* Contact_
* Citing_
* Funding_
* License_

Getting Started
===============

The best way to get started is to go over the `tutorials <https://chemtools.readthedocs.io/en/latest/tutorial.html>`_ illustrating the functionalities and giving examples of basis set optimization tasks.

Installation
------------

Most convenient way to install the package is with `pip <https://pip.pypa.io/en/stable/>`_

.. code-block:: bash

pip install chemtools


Documentation
-------------

The documentation in hosted at `Read The Docs <http://chemtools.readthedocs.org/en/latest/>`_.


Contributing
============

* `Source <https://github.com/lmmentel/chemtools>`_
* `Report a bug <https://github.com/lmmentel/chemtools/issues>`_
* `Request a feature <https://github.com/lmmentel/chemtools/issues>`_
* `Submit a pull request <https://github.com/lmmentel/chemtools/pulls>`_

Contact
=======

Łukasz Mentel

* github: `lmmentel <https://github.com/lmmentel>`_
* email: lmmentel <at> gmail.com


Citing
======

If you use *chemtools* in a scientific publication, please consider citing the software as

Łukasz Mentel, *chemtools* -- A Python toolbox for computational chemistry, 2014-- . Available at: `https://github.com/lmmentel/chemtools <https://github.com/lmmentel/chemtools>`_.


Here's the reference in the `BibLaTeX <https://www.ctan.org/pkg/biblatex?lang=en>`_ format

.. code-block:: latex

@software{chemtools2014,
author = {Mentel, Łukasz},
title = {{chemtools} -- A Python toolbox for computational chemistry},
url = {https://github.com/lmmentel/chemtools},
version = {0.9.2},
date = {2014--},
}

or the older `BibTeX <http://www.bibtex.org/>`_ format

.. code-block:: latex

@misc{chemtools2014,
auhor = {Mentel, Łukasz},
title = {{chemtools} -- A Python toolbox for computational chemistry, ver. 0.9.2},
howpublished = {\url{https://github.com/lmmentel/chemtools}},
year = {2014--},
}

Funding
=======

This project was realized through the support from the National Science Center
(Poland) grant number UMO-2012/07/B/ST4/01347.

License
=======

The project is distributed under the MIT License. See `LICENSE <LICENSE.rst>`_ for more information.

.. _chemtools: http://chemtools.readthedocs.org
.. _Gamess-US: https://www.msg.chem.iastate.edu/gamess/gamess.html
.. _MolPro: http://www.molpro.net/
.. _Dalton: https://www.daltonprogram.org/
.. _PSI4: http://www.psicode.org/