.. image:: https://github.com/SCM-NV/qmflows/workflows/Tests/badge.svg
:target: https://github.com/SCM-NV/qmflows/actions
.. image:: https://codecov.io/gh/SCM-NV/qmflows/branch/master/graph/badge.svg
:target: https://codecov.io/gh/SCM-NV/qmflows
.. image:: https://readthedocs.org/projects/qmflows/badge/?version=latest
:target: https://qmflows.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3274284.svg
:target: https://doi.org/10.5281/zenodo.3274284
.. image:: https://badge.fury.io/py/qmflows.svg
:target: https://badge.fury.io/py/qmflows
.. image:: qmflows.png
QMFlows
#######
See documentation_ for tutorials and documentation.
Motivation
==========
Research on modern computational quantum chemistry relies on a set of computational
tools to carry out calculations. The complexity of the calculations usually requires
intercommunication between the aforementioned tools, such communication is usually done
through shell scripts that try to automate input/output actions like: launching
the computations in a cluster, reading the resulting output and feeding the relevant
numerical result to another program. Such scripts are difficult to maintain and extend,
requiring a significant programming expertise to work with them. Being then desirable a
set of automatic and extensible tools that allows to perform complex simulations in
heterogeneous hardware platforms.
This library tackles the construction and efficient execution of computational chemistry workflows.
This allows computational chemists to use the emerging massively parallel compute environments in
an easy manner and focus on interpretation of scientific data rather than on tedious job submission
procedures and manual data processing.
Description
===========
This library consists of a set of modules written in Python3 to
automate the following tasks:
1. Input generation.
2. Handle tasks dependencies (Noodles_).
3. Advanced molecular manipulation capabilities with (rdkit_).
4. Jobs failure detection and recovery.
5. Numerical data storage (h5py_).
Tutorial and Examples
---------------------
A tutorial written as a jupyter-notebook_ is available from: tutorial-qmflows_. You can
also access direclty more advanced examples_.
Installation
============
- Download miniconda for python3: miniconda_ (also you can install the complete anaconda_ version).
- Install according to: installConda_.
- Create a new virtual environment using the following commands:
- ``conda create -n qmflows``
- Activate the new virtual environment
- ``source activate qmflows``
To exit the virtual environment type ``source deactivate``.
.. _dependecies:
Dependencies installation
-------------------------
- Type in your terminal:
``conda activate qmflows``
Using the conda environment the following packages should be installed:
- install rdkit_ and h5py_ using conda:
- ``conda install -y -q -c conda-forge rdkit h5py``
- Note that ``rdkit`` is optional for Python 3.7 and later.
.. _installation:
Package installation
--------------------
Finally install the package:
- Install **QMFlows** using pip:
- ``pip install qmflows``
Now you are ready to use *qmflows*.
**Notes:**
- Once the libraries and the virtual environment are installed, you only need to type
``conda activate qmflows`` each time that you want to use the software.
.. _documentation: https://qmflows.readthedocs.io/en/latest/
.. _miniconda: https://docs.conda.io/en/latest/miniconda.html
.. _anaconda: https://www.anaconda.com/distribution/#download-section
.. _installConda: https://conda.io/projects/conda/en/latest/user-guide/install/index.html
.. _Noodles: http://nlesc.github.io/noodles/
.. _h5py: http://www.h5py.org/
.. _here: https://www.python.org/downloads/
.. _rdkit: http://www.rdkit.org
.. _jupyter-notebook: http://jupyter.org/
.. _tutorial-qmflows: https://github.com/SCM-NV/qmflows/tree/master/jupyterNotebooks
.. _examples: https://github.com/SCM-NV/qmflows/tree/master/src/qmflows/examples
.. _PLAMS: https://github.com/SCM-NV/PLAMS
Raw data
{
"_id": null,
"home_page": "",
"name": "qmflows",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "chemistry,workflows,simulation,materials",
"author": "",
"author_email": "Felipe Zapata <f.zapata@esciencecenter.nl>",
"download_url": "https://files.pythonhosted.org/packages/91/2d/fa46e0991258d0bb11b069d85949d679a92b8729f5518ce6fe9deb9495a1/qmflows-1.0.0.tar.gz",
"platform": null,
"description": "\n.. image:: https://github.com/SCM-NV/qmflows/workflows/Tests/badge.svg\n :target: https://github.com/SCM-NV/qmflows/actions\n.. image:: https://codecov.io/gh/SCM-NV/qmflows/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/SCM-NV/qmflows\n.. image:: https://readthedocs.org/projects/qmflows/badge/?version=latest\n :target: https://qmflows.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3274284.svg\n :target: https://doi.org/10.5281/zenodo.3274284\n.. image:: https://badge.fury.io/py/qmflows.svg\n :target: https://badge.fury.io/py/qmflows\n.. image:: qmflows.png\n\nQMFlows\n#######\nSee documentation_ for tutorials and documentation.\n\nMotivation\n==========\nResearch on modern computational quantum chemistry relies on a set of computational\ntools to carry out calculations. The complexity of the calculations usually requires\nintercommunication between the aforementioned tools, such communication is usually done\nthrough shell scripts that try to automate input/output actions like: launching\nthe computations in a cluster, reading the resulting output and feeding the relevant\nnumerical result to another program. Such scripts are difficult to maintain and extend,\nrequiring a significant programming expertise to work with them. Being then desirable a\nset of automatic and extensible tools that allows to perform complex simulations in\nheterogeneous hardware platforms.\n\nThis library tackles the construction and efficient execution of computational chemistry workflows.\nThis allows computational chemists to use the emerging massively parallel compute environments in\nan easy manner and focus on interpretation of scientific data rather than on tedious job submission\nprocedures and manual data processing.\n\nDescription\n===========\nThis library consists of a set of modules written in Python3 to\nautomate the following tasks:\n\n 1. Input generation.\n 2. Handle tasks dependencies (Noodles_).\n 3. Advanced molecular manipulation capabilities with (rdkit_).\n 4. Jobs failure detection and recovery.\n 5. Numerical data storage (h5py_).\n\nTutorial and Examples\n---------------------\nA tutorial written as a jupyter-notebook_ is available from: tutorial-qmflows_. You can\nalso access direclty more advanced examples_.\n\nInstallation\n============\n\n- Download miniconda for python3: miniconda_ (also you can install the complete anaconda_ version).\n\n- Install according to: installConda_.\n\n- Create a new virtual environment using the following commands:\n\n - ``conda create -n qmflows``\n\n- Activate the new virtual environment\n\n - ``source activate qmflows``\n\nTo exit the virtual environment type ``source deactivate``.\n\n\n.. _dependecies:\n\nDependencies installation\n-------------------------\n\n- Type in your terminal:\n\n ``conda activate qmflows``\n\nUsing the conda environment the following packages should be installed:\n\n\n- install rdkit_ and h5py_ using conda:\n\n - ``conda install -y -q -c conda-forge rdkit h5py``\n\n - Note that ``rdkit`` is optional for Python 3.7 and later.\n\n.. _installation:\n\nPackage installation\n--------------------\nFinally install the package:\n\n- Install **QMFlows** using pip:\n - ``pip install qmflows``\n\nNow you are ready to use *qmflows*.\n\n\n **Notes:**\n\n - Once the libraries and the virtual environment are installed, you only need to type\n ``conda activate qmflows`` each time that you want to use the software.\n\n\n.. _documentation: https://qmflows.readthedocs.io/en/latest/\n.. _miniconda: https://docs.conda.io/en/latest/miniconda.html\n.. _anaconda: https://www.anaconda.com/distribution/#download-section\n.. _installConda: https://conda.io/projects/conda/en/latest/user-guide/install/index.html\n.. _Noodles: http://nlesc.github.io/noodles/\n.. _h5py: http://www.h5py.org/\n.. _here: https://www.python.org/downloads/\n.. _rdkit: http://www.rdkit.org\n.. _jupyter-notebook: http://jupyter.org/\n.. _tutorial-qmflows: https://github.com/SCM-NV/qmflows/tree/master/jupyterNotebooks\n.. _examples: https://github.com/SCM-NV/qmflows/tree/master/src/qmflows/examples\n.. _PLAMS: https://github.com/SCM-NV/PLAMS\n",
"bugtrack_url": null,
"license": "QMFlows is an Open Source project supported by the VU University Amsterdam, the Netherlands eScience Center (NLeSC) and Software for Chemistry & Materials BV (SCM, and previously known as Scientific Computing & Modelling NV). The terms of the [LGPL-3.0 license]* apply. As an exception to the LGPL-3.0 license, you agree to grant SCM a [BSD 3-Clause license]** to the contributions you commit on this Github or provide to SCM in another manner. \\* https://opensource.org/licenses/LGPL-3.0 ** https://opensource.org/licenses/BSD-3-Clause [LGPL-3.0 license]: https://opensource.org/licenses/LGPL-3.0 \"LGPL-3.0 license\" [BSD 3-Clause license]: https://opensource.org/licenses/BSD-3-Clause \"BSD 3-Clause license\" ",
"summary": "Automation of computations in quantum chemistry.",
"version": "1.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/SCM-NV/qmflows/issues",
"Documentation": "https://qmflows.readthedocs.io/en/latest/",
"Homepage": "https://github.com/SCM-NV/qmflows"
},
"split_keywords": [
"chemistry",
"workflows",
"simulation",
"materials"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2b1b81de3fe9f816c48bae9c0e95d58d8fb36ee298a245c5e5ae3ed672820c7c",
"md5": "f114e5b4e50ce5b169bd9e1566c3d17d",
"sha256": "4b039ce6017b1178bb288350cf38d8512d2da7b26b541771d776f47fa857eb30"
},
"downloads": -1,
"filename": "qmflows-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f114e5b4e50ce5b169bd9e1566c3d17d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 83911,
"upload_time": "2023-10-06T21:38:32",
"upload_time_iso_8601": "2023-10-06T21:38:32.676983Z",
"url": "https://files.pythonhosted.org/packages/2b/1b/81de3fe9f816c48bae9c0e95d58d8fb36ee298a245c5e5ae3ed672820c7c/qmflows-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "912dfa46e0991258d0bb11b069d85949d679a92b8729f5518ce6fe9deb9495a1",
"md5": "86fec6fc368d4378c29ce99505a8a81d",
"sha256": "c4b3ba80345d7cb921b582d27c2597caa27d4890067be74de103dec15f9ed5a5"
},
"downloads": -1,
"filename": "qmflows-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "86fec6fc368d4378c29ce99505a8a81d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 77047,
"upload_time": "2023-10-06T21:38:33",
"upload_time_iso_8601": "2023-10-06T21:38:33.955156Z",
"url": "https://files.pythonhosted.org/packages/91/2d/fa46e0991258d0bb11b069d85949d679a92b8729f5518ce6fe9deb9495a1/qmflows-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-06 21:38:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SCM-NV",
"github_project": "qmflows",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "qmflows"
}
