Skip to main content

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

Project description

Build Status codecov Language grade: Python 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.

ChemML

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.

Latest Version:

  • to find out about 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
  • scikit-learn
  • matplotlib
  • seaborn
  • lxml
  • openpyxl
  • ipywidgets

We strongly recommend you to install ChemML in an Anaconda environment. The instructions to create the environment, install ChemML’s dependencies, and subsequently install Chemml using the Python Package Index (PyPI) via pip are as follows:

conda create --name chemml_env python=3.8
source activate chemml_env
conda install -c conda-forge openbabel rdkit nb_conda_kernels python-graphviz
pip install chemml

Citation:

Please cite the use of ChemML as:

Main citation:

@article{haghighatlari2019chemml,
    title        = {{ChemML}: A machine learning and informatics program package for the analysis, mining, and modeling of chemical and materials data},
    author       = {Haghighatlari, Mojtaba and Vishwakarma, Gaurav and Altarawy, Doaa and Subramanian, Ramachandran and Kota, Bhargava U and Sonpal, Aditya and Setlur, Srirangaraj and Hachmann, Johannes},
    year         = 2020,
    journal      = {Wiley Interdisciplinary Reviews: Computational Molecular Science},
    publisher    = {Wiley Online Library},
    volume       = 10,
    doi          = {https://doi.org/10.1002/wcms.1458},
    pages        = {e1458},
}


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}
}

@article{vishwakarma2019towards,
title={Towards autonomous machine learning in chemistry via evolutionary algorithms},
author={Vishwakarma, Gaurav and Haghighatlari, Mojtaba and Hachmann, Johannes},
journal={ChemRxiv preprint},
year={2019}
}

License:

ChemML is copyright (C) 2014-2022 Johannes Hachmann and Mojtaba Haghighatlari, Aditya Sonpal, Gaurav Vishwakarma and Aatish Pradhan 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
- Aditya Sonpal, adityaso@buffalo.edu
- Aatish Pradhan, aatishpr@buffalo.edu
University at Buffalo - The State University of New York (UB)

Contributors:

- Doaa Altarawy (MolSSI): scientific advice and software mentor 
- Aditya Sonpal (UB): graph convolution NNs, XAI
- Aatish Pradhan (UB): autoML and Jupyter GUI developer
- Gaurav Vishwakarma (UB): automated model optimization
- Ramachandran Subramanian (UB): Magpie descriptor library port
- Bhargava Urala Kota (UB): library database
- 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-1.3.tar.gz (52.8 MB view details)

Uploaded Source

Built Distribution

chemml-1.3-py3-none-any.whl (52.9 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: chemml-1.3.tar.gz
  • Upload date:
  • Size: 52.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.12

File hashes

Hashes for chemml-1.3.tar.gz
Algorithm Hash digest
SHA256 0efae4b5b8c730aca058ef87b203914b384ede017449be185221a69635d0885a
MD5 bf31adc43f28be35768bd77246b1b9b7
BLAKE2b-256 2e55178d74ff57b0dc1cb9d5b4b3e5b9e836463a5596813a6a74b6ab6e658da4

See more details on using hashes here.

File details

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

File metadata

  • Download URL: chemml-1.3-py3-none-any.whl
  • Upload date:
  • Size: 52.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.12

File hashes

Hashes for chemml-1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 2897bd32446d63abb0b3699b89d55e451aadbc1c9661d2fba95b460704ebc30a
MD5 ab1c5c7440e81a12d0fb149997f47b43
BLAKE2b-256 e5c8f4b29b7d43a9c9ad40d56fb61693c9ca812dd8ded9856dd5d91e040525b3

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