search

duartegroup / autodE

automated reaction profile generation
https://duartegroup.github.io/autodE/
MIT License
173 stars 52 forks source link
computational-chemistry open-science

readme

Build Status codecov Code style: black GitHub CodeQL Conda Recipe Conda Downloads

alt text

Introduction

autodE is a Python module initially designed for the automated calculation of reaction profiles from SMILES strings of reactant(s) and product(s). Current features include: transition state location, conformer searching, atom mapping, Python wrappers for a range of electronic structure theory codes, SMILES parsing, association complex generation, and reaction profile generation.

Dependencies

The Python dependencies are listed in requirements.txt are best satisfied using a conda install (Miniconda or Anaconda).

Installation

To install autodE with conda:

conda install autode -c conda-forge

see the installation guide for installing from source.

Usage

Reaction profiles in autodE are generated by initialising Reactant and Product objects, generating a Reaction from those and invoking _calculate_reactionprofile(). For example, to calculate the profile for a 1,2 hydrogen shift in a propyl radical:

import autode as ade
ade.Config.n_cores = 8

r = ade.Reactant(name='reactant', smiles='CC[C]([H])[H]')
p = ade.Product(name='product', smiles='C[C]([H])C')

reaction = ade.Reaction(r, p, name='1-2_shift')
reaction.calculate_reaction_profile()  # creates 1-2_shift/ and saves profile

See examples/ for more examples and duartegroup.github.io/autodE/ for additional documentation.

Development

There is a slack workspace for development and discussion - please email to be added. Pull requests are very welcome but must pass all the unit tests prior to being merged. Please write code and tests! See the todo list for features on the horizon. Bugs and feature requests should be raised on the issue page.

NOTE: We'd love more contributors to this project!

Citation

If autodE is used in a publication please consider citing the paper:

@article{autodE,
  doi = {10.1002/anie.202011941},
  url = {https://doi.org/10.1002/anie.202011941},
  year = {2021},
  publisher = {Wiley},
  volume = {60},
  number = {8},
  pages = {4266--4274},
  author = {Tom A. Young and Joseph J. Silcock and Alistair J. Sterling and Fernanda Duarte},
  title = {{autodE}: Automated Calculation of Reaction Energy Profiles -- Application to Organic and Organometallic Reactions},
  journal = {Angewandte Chemie International Edition}
}

Contributors