Skip to main content

Automation of computations in quantum chemistry

Project description

https://github.com/SCM-NV/qmflows/workflows/build%20with%20conda/badge.svg https://codecov.io/gh/SCM-NV/qmflows/branch/master/graph/badge.svg Documentation Status https://zenodo.org/badge/DOI/10.5281/zenodo.3274284.svg https://badge.fury.io/py/qmflows.svg 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.

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.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qmflows-0.11.2.tar.gz (80.9 kB view details)

Uploaded Source

Built Distribution

qmflows-0.11.2-py3-none-any.whl (82.5 kB view details)

Uploaded Python 3

File details

Details for the file qmflows-0.11.2.tar.gz.

File metadata

  • Download URL: qmflows-0.11.2.tar.gz
  • Upload date:
  • Size: 80.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.10.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

File hashes

Hashes for qmflows-0.11.2.tar.gz
Algorithm Hash digest
SHA256 eaa3443b0672035238d2a5792001c625d90f24acf95243206c8a9de1f5f60e63
MD5 cbf918a8a9c15555d4900786b8f514d1
BLAKE2b-256 58303cb345283805aa0787252a8415c2627494a7f4c24a97701e33e16878c0fb

See more details on using hashes here.

File details

Details for the file qmflows-0.11.2-py3-none-any.whl.

File metadata

  • Download URL: qmflows-0.11.2-py3-none-any.whl
  • Upload date:
  • Size: 82.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/32.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.62.3 importlib-metadata/4.10.1 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.10

File hashes

Hashes for qmflows-0.11.2-py3-none-any.whl
Algorithm Hash digest
SHA256 cfd9cbb665ae436df3263d2c654db46ccd25901fcdb08d906620cceca9fe6f35
MD5 97a5db5166af0ad9a548468ef55088fd
BLAKE2b-256 75695885691bed9a94862c73f319a2db55cd5184746838c305b62c0e88a30b38

See more details on using hashes here.

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