Reaction-network is a Python package for predicting likely inorganic chemical reaction pathways using graph theory.
Project description
Reaction network (rxn-network) is a Python package for predicting chemical reaction pathways in solid-state materials synthesis using combinatorial and graph-theorteical methods.
Installation directions
This package can be easily installed using pip:
pip install reaction-network
:warning: While this will take care of most dependencies, if you are using any of the network-based features (i.e. within rxn_network.network), then graph-tool must be installed. Unfortunately, this cannot
be installed through pip; please see https://graph-tool.skewed.de/ for more details. :warning:
We recommend the following installation procedure which installs graph-tool through conda-forge.
conda install -c conda-forge graph-tool
For developers:
To install an editable version of the rxn-network code, simply clone the code from this repository, navigate to its directory, and then run the following command to install the requirements:
pip install -r requirements.txt
pip install -e .
Note that this only works if the repository is cloned from GitHub, such that it contains the proper metadata.
Tutorial notebooks
The notebooks folder contains two (2) demonstration notebooks:
- enumerators.ipynb: how to enumerate reactions from a set of entries; running enumerators using Fireworks
- network.ipynb: how to build reaction networks from a list of enumerators and entries; how to perform pathfinding to recommend balanced reaction pathways; running reaction network analysis using Fireworks
Citation
If you use this code or Python package in your work, please consider citing the following paper:
McDermott, M. J., Dwaraknath, S. S., and Persson, K. A. (2021). A graph-based network for predicting chemical reaction pathways in solid-state materials synthesis. Nature Communications, 12(1). https://doi.org/10.1038/s41467-021-23339-x
Acknowledgements
This work was supported as part of GENESIS: A Next Generation Synthesis Center, an Energy Frontier Research Center funded by the U.S. Department of Energy, Office of Science, Basic Energy Sciences under Award Number DE-SC0019212.
Learn more about the GENESIS EFRC here: https://www.stonybrook.edu/genesis/
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file reaction-network-5.1.0.tar.gz.
File metadata
- Download URL: reaction-network-5.1.0.tar.gz
- Upload date:
- Size: 8.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.9.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4fcb2c7e00797e563a539850412a13d66c04f288ad15490ae781a844041e0a4a |
|
| MD5 | dae1e28529bff17315c7688defe66267 |
|
| BLAKE2b-256 | fc1447b1b986d4c2ca1016dd96daa520ca71db0596df8655ae10e1b0c566bf9d |
