Metadata-Version: 2.4
Name: mofsynth
Version: 2.1.0
Summary: Package for MOF synthesizability evaluation.
Author-email: "Charalampos G. Livas" <livas.charalampos@gmail.com>
License: GPL-3.0-only
Project-URL: Homepage, https://github.com/livaschar/mofsynth
Project-URL: Issues, https://github.com/livaschar/mofsynth/issues
Project-URL: Documentation, https://mofsynth.readthedocs.io/en/latest/
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: matplotlib>=3.7.1
Requires-Dist: numpy>=1.24.1
Requires-Dist: pymatgen>=2023.5.10
Requires-Dist: openpyxl>=3.1.2
Requires-Dist: rmsd==1.5.1
Requires-Dist: pyyaml
Dynamic: license-file

# MOFSynth

<h1 align="center">
<!--   <img alt="Logo" src="https://raw.githubusercontent.com/livaschar/mofsynth/main/docs/source/images/final_grey-removebg-preview.png" style="width: 500px;"/> -->
<!--   <img alt="Logo" src="https://github.com/livaschar/mofsynth/blob/main/docs/source/images/final_grey-removebg-preview.png" style="width: 500px;"/> -->
  <img alt="Logo" src="https://github.com/livaschar/mofsynth/blob/main/docs/source/images/mofsynth_logo.svg" style="width: 500px;"/>
</h1>

<h4 align="center">

[![Requires Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-g?logo=python&logoColor=blue&label=Python&labelColor=black)](https://www.python.org/downloads/)
[![Read the Docs](https://img.shields.io/badge/latest-b?logo=readthedocs&logoColor=blue&label=Read%20the%20Docs&labelColor=black)](https://mofsynth.readthedocs.io)
[![PyPI](https://img.shields.io/badge/PyPI%20-%20v%202.0.0%20-b?style=flat&logo=pypi&logoColor=blue&logoSize=auto&label=PyPI&labelColor=black)](https://pypi.org/project/mofsynth/)
[![Licensed under GPL-3.0-only](https://img.shields.io/badge/GPL--3.0--only-gold?label=License&labelColor=black)](https://spdx.org/licenses/GPL-3.0-only.html)  

[![Online App](https://img.shields.io/badge/🔥%20MOFSYNTH%20Online-Try%20Now!-red?style=for-the-badge&labelColor=black)](https://mofsynth.website)  

</h4>

MOFSynth is a Python package for **MOF synthesizability evaluation**, with
emphasis on reticular chemistry.

In materials science, especially in the synthesis of metal-organic frameworks (MOFs),
a significant portion of time and effort is spent on the experimental process of synthesizing
and evaluating the viability of MOFs.

MOFSynth aims to provide a simple and efficient interface for evaluating
the synthesizability of metal-organic frameworks (MOFs) in an experiment-ready format,
minimizing the time and labor traditionally required for these experimental preprocessing steps.
This allows researchers to focus more on innovative synthesis and experimental validation
rather than on preparatory tasks.

## ⚙️  Installation

It is strongly recommended to **perform the installation inside a virtual environment**.

```sh
python -m venv <venvir_name>
source <venvir_name>/bin/activate
```

```sh
pip install mofsynth
```

### Requires

To run MOFSynth, the following modules and tools must be present in your system:

1. [**mofid v1.1.0**](https://github.com/snurr-group/mofid): A Python library for MOF identification and characterization.
2. [**TURBOMOLE v6.5**](https://www.turbomole.org/): A computational chemistry program package.

## 💻 Browser-Based MOFSynth

Easy to use [Web version](https://mofsynth.website) of the tool.

## 📖 Usage example

Check the [tutorial](https://mofsynth.readthedocs.io/en/latest/tutorial.html).

## :warning: Problems?

You can start by [opening an issue](https://github.com/livaschar/mofsynth/issues) or communicate via [email](mailto:chemp1167@edu.chemistry.uoc.gr).

## 📰 Citing MOFSynth

Please consider citing [this publication](https://pubs.acs.org/doi/full/10.1021/acs.jcim.4c01298) or use the following BibTex.

<details>
<summary>Show BibTex entry</summary>

```bibtex
@article{doi:10.1021/acs.jcim.4c01298,
  author = {Livas, Charalampos G. and Trikalitis, Pantelis N. and Froudakis, George E.},
  title = {MOFSynth: A Computational Tool toward Synthetic Likelihood Predictions of MOFs},
  journal = {Journal of Chemical Information and Modeling},
  volume = {64},
  number = {21},
  pages = {8193-8200},
  year = {2024},
  doi = {10.1021/acs.jcim.4c01298},
  note ={PMID: 39481084},
  URL = {https://doi.org/10.1021/acs.jcim.4c01298},
  eprint = {https://doi.org/10.1021/acs.jcim.4c01298}
  }
```

</details>

## 📑 License

MOFSynth is released under the [GNU General Public License v3.0 only](https://spdx.org/licenses/GPL-3.0-only.html).
