Jazzy

PyPI Status Python Version License

Read the documentation at https://jazzy.readthedocs.io/ Tests Codecov

pre-commit Black

Full Author List

  • Eike Caldeweyher

  • Gian Marco Ghiandoni

Introduction

Jazzy is an efficient computational tool for the calculation of hydration free energies and hydrogen-bond acceptor and donor strengths. A publication describing the implementation, fitting, and validation of Jazzy can be found at doi.org/10.1038/s41598-023-30089-x.

If you are using Jazzy in your research, please remember to cite our publication as:
Ghiandoni, G.M., Caldeweyher, E. Fast calculation of hydrogen-bond strengths and free energy of hydration of small molecules. Sci Rep 13, 4143 (2023)

Features

  • Hydration free energies

  • Hydrogen-bond strengths

  • Visualisation functions (SVG)

  • Application programming interface

  • Command-line interface

Requirements

click==8.0.4            # Composable command line interface toolkit
kallisto==1.0.9         # Atomic and molecular featurizer
numpy==1.24.2           # NumPy array computing package
rdkit-pypi<=2021.9.4    # Chemoinformatics toolkit

Installation

You can install Jazzy via pip from PyPI:

$ pip install jazzy

Installation from Source

Requirements to install Jazzy from sources:

First check that poetry is running correctly (v1.0.10 at the time of writing)

$ poetry --version
Poetry version 1.0.10

Create a virtual environment (via pyenv or conda) and activate it. Afterwards, clone the Jazzy project from GitHub and install it using poetry

$ git clone git@github.com:AstraZeneca/jazzy.git
$ cd jazzy
$ poetry install

Usage and Cookbook

Please see the Usage and Cookbook sections for details.

Contributing

Jazzy is an open project in every shape and form, thus feedback on how to improve its documentation or functionalities is always welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the Apache 2.0 license, Jazzy is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @cjolowicz’s Hypermodern Python Cookiecutter template.