Skip to main content

Package for parallel calculation of energy voxels.

Project description

Logo

Requires Python 3.10+ Licensed under GPL-3.0-only Read the Docs pip install pymoxel Documentation Status PyPI version

MOXελ is a Python package for parallel calculation of energy voxels, with emphasis on reticular chemistry.

The majority of time in a ML workflow goes into constructing the inputs and making sure they are clean, rather than focusing on the ML part itself.

MOXελ aims to provide a simple and fast interface to generate energy voxels in a ML-ready format, minimizing as much as possible the time spent on these preprocessing steps.

Voxels

⚙️ Installation

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

Check the installation steps.

Assuming an activated virtual environment:

pip install pymoxel

🚀 Usage

moxel path/to/CIFs path/to/voxels_data/ --grid_size=5

You can also use a configuration file:

moxel --config=path/to/config.yaml

[!NOTE] For more information, please refer to the 📚 Documentation.

📰 Citing MOXελ

If you use ΜΟΧελ in your research, please consider citing the following work:

@article{Sarikas2024,
title = {Gas adsorption meets deep learning: voxelizing the potential energy surface of metal-organic frameworks},
volume = {14},
ISSN = {2045-2322},
url = {http://dx.doi.org/10.1038/s41598-023-50309-8},
DOI = {10.1038/s41598-023-50309-8},
number = {1},
journal = {Scientific Reports},
publisher = {Springer Science and Business Media LLC},
author = {Sarikas,  Antonios P. and Gkagkas,  Konstantinos and Froudakis,  George E.},
year = {2024},
month = jan
}

📇 TODO

  1. Improve performance
  2. Improve voxelization scheme
  3. Improve modeling of interactions

📑 License

MOXελ is released under the GNU General Public License v3.0 only.

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

pymoxel-0.5.0.post2.tar.gz (2.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pymoxel-0.5.0.post2-py3-none-any.whl (22.6 kB view details)

Uploaded Python 3

File details

Details for the file pymoxel-0.5.0.post2.tar.gz.

File metadata

  • Download URL: pymoxel-0.5.0.post2.tar.gz
  • Upload date:
  • Size: 2.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pymoxel-0.5.0.post2.tar.gz
Algorithm Hash digest
SHA256 6b685c4a3c39dba29fb964a5e33077a5114b80d1bc9e98ffcc0783a249853643
MD5 93b2e403981158954538bfd0a817c381
BLAKE2b-256 7b0d87dbdf9728fd84706561a39a4bb20280461fc854174ee8323bdbb2574e8c

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymoxel-0.5.0.post2.tar.gz:

Publisher: python-publish.yaml on adosar/moxel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pymoxel-0.5.0.post2-py3-none-any.whl.

File metadata

  • Download URL: pymoxel-0.5.0.post2-py3-none-any.whl
  • Upload date:
  • Size: 22.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pymoxel-0.5.0.post2-py3-none-any.whl
Algorithm Hash digest
SHA256 ba188272b275f2c4af808523d5decc523607024b9d882e2819c5cdc1e1141775
MD5 98248cf34db91156228339f3cf3f82bd
BLAKE2b-256 10dadd173c5050ff7943ac2a37b2c6b001c01f4fe30ef85b1ed44e0becb5429f

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymoxel-0.5.0.post2-py3-none-any.whl:

Publisher: python-publish.yaml on adosar/moxel

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page