Skip to main content

A Machine Learning and Informatics Program Suite for the Chemical and Materials Sciences

Project description

Build Status codecov version status license

ChemML

ChemML is a machine learning and informatics program suite for the analysis, mining, and modeling of chemical and materials data. Please check the ChemML website for more information.

Code Design:

ChemML is developed in the Python 3 programming language and makes use of a host of data analysis and ML libraries(accessible through the Anaconda distribution), as well as domain-specific libraries. The development follows a strictly modular and object-oriented design to make the overall code as flexible and versatile as possible.

The format of library is similar to the well known libraries like Scikit-learn. ChemML will be soon available via graphical user interface provided by ChemEco. ChemEco is a general-purpose framework for data mining without coding. It also interfaces with many of the libraries that supply methods for the representation, preprocessing, analysis, mining, and modeling of large-scale chemical data sets.

Latest Version:

  • to find the latest version and release history, click here

Installation and Dependencies:

You can download ChemML from PyPI via pip.

pip install chemml --user -U

Here is a list of external libraries that will be installed with chemml:

  • numpy
  • pandas
  • tensorflow
  • keras
  • scikit-learn
  • matplotlib
  • seaborn
  • lxml

Since conda installation is not available for ChemML yet, we recommend installing rdkit and openbabel in a conda virtual environment prior to installing ChemML. For doing so, you need to follow the conda installer:

conda create --name my_chemml_env python=3.6
source activate my_chemml_env
conda install -c openbabel openbabel
conda install -c rdkit rdkit
pip install chemml

Python 2 Fans

The library was initially compatible with Python 2 and 3, and we still develop compatible codes. However, since the Python community and some of the dependencies are phasing out support for Python 2, we also removed it from the classifier languages. However, you should still be able to clone the ChemML repository from github and install the older versions of some of the dependencies that support Python 2, prior to using ChemML locally.

Citation:

Please cite the use of ChemML as:

Main citation:

@article{chemml2019,
author = {Haghighatlari, Mojtaba and Vishwakarma, Gaurav and Altarawy, Doaa and Subramanian, Ramachandran and Kota, Bhargava Urala and Sonpal, Aditya and Setlur, Srirangaraj and Hachmann, Johannes},
journal = {ChemRxiv},
pages = {8323271},
title = {ChemML: A Machine Learning and Informatics Program Package for the Analysis, Mining, and Modeling of Chemical and Materials Data},
doi = {10.26434/chemrxiv.8323271.v1},
year = {2019}
}


Other references:

@article{chemml_review2019,
author = {Haghighatlari, Mojtaba and Hachmann, Johannes},
doi = {https://doi.org/10.1016/j.coche.2019.02.009},
issn = {2211-3398},
journal = {Current Opinion in Chemical Engineering},
month = {jan},
pages = {51--57},
title = {Advances of machine learning in molecular modeling and simulation},
volume = {23},
year = {2019}
}

@article{Hachmann2018,
author = {Hachmann, Johannes and Afzal, Mohammad Atif Faiz and Haghighatlari, Mojtaba and Pal, Yudhajit},
doi = {10.1080/08927022.2018.1471692},
issn = {10290435},
journal = {Molecular Simulation},
number = {11},
pages = {921--929},
title = {Building and deploying a cyberinfrastructure for the data-driven design of chemical systems and the exploration of chemical space},
volume = {44},
year = {2018}
}

License:

ChemML is copyright (C) 2014-2018 Johannes Hachmann and Mojtaba Haghighatlari, all rights reserved. ChemML is distributed under 3-Clause BSD License (https://opensource.org/licenses/BSD-3-Clause).

About us:

Maintainers:

- Johannes Hachmann, hachmann@buffalo.edu
- Mojtaba Haghighatlari
University at Buffalo - The State University of New York (UB)

Contributors:

- Doaa Altarawy (MolSSI): scientific advice and software mentor 
- Gaurav Vishwakarma (UB): automated model optimization
- Ramachandran Subramanian (UB): Magpie descriptor library port
- Bhargava Urala Kota (UB): library database
- Aditya Sonpal (UB): debugging
- Srirangaraj Setlur (UB): scientific advice
- Venugopal Govindaraju (UB): scientific advice
- Krishna Rajan (UB): scientific advice

- We encourage any contributions and feedback. Feel free to fork and make pull-request to the "development" branch.

Acknowledgements:

- ChemML is based upon work supported by the U.S. National Science Foundation under grant #OAC-1751161 and in part by #OAC-1640867.
- ChemML was also supported by start-up funds provided by UB's School of Engineering and Applied Science and UB's Department of Chemical and Biological Engineering, the New York State Center of Excellence in Materials Informatics through seed grant #1140384-8-75163, and the U.S. Department of Energy under grant #DE-SC0017193.
- Mojtaba Haghighatlari received 2018 Phase-I and 2019 Phase-II Software Fellowships by the Molecular Sciences Software Institute (MolSSI) for his work on ChemML.

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

chemml-0.5.4.tar.gz (406.0 kB view details)

Uploaded Source

Built Distribution

chemml-0.5.4-py3-none-any.whl (476.9 kB view details)

Uploaded Python 3

File details

Details for the file chemml-0.5.4.tar.gz.

File metadata

  • Download URL: chemml-0.5.4.tar.gz
  • Upload date:
  • Size: 406.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/2.7.3

File hashes

Hashes for chemml-0.5.4.tar.gz
Algorithm Hash digest
SHA256 d69bddaa279fc1e84ed02c5ec7c3b1856ddd00379f4663aa8cd50ae439aef422
MD5 a28de7c74db618b32770bc5cc4e9777f
BLAKE2b-256 4dd5daec6f5f66ef7118a31f45c26b1a8f07307fadb5878d5b9c1543361a491a

See more details on using hashes here.

File details

Details for the file chemml-0.5.4-py3-none-any.whl.

File metadata

  • Download URL: chemml-0.5.4-py3-none-any.whl
  • Upload date:
  • Size: 476.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/2.7.3

File hashes

Hashes for chemml-0.5.4-py3-none-any.whl
Algorithm Hash digest
SHA256 77d92cc10a00df600332c43ea61e1b795502a07700342385c855240a34536947
MD5 319a482f5fc20f414002a84e0e820c9e
BLAKE2b-256 4549d3ff1876b32a6df061023cfe48653fe742b2cccb47eb6f7694ab921290dd

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