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.post1.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.post1-py3-none-any.whl (22.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pymoxel-0.5.0.post1.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.post1.tar.gz
Algorithm Hash digest
SHA256 07b81c6772d04516a190276fbfcf955e7f12ae81d3d13e281711d99212854182
MD5 a342b5d9c196ddfae345f7cb980fc764
BLAKE2b-256 266a3fd115f5806357c9d13e2c3204bf30c73fc86b37d9573d3d0690ebf1365e

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymoxel-0.5.0.post1.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.post1-py3-none-any.whl.

File metadata

  • Download URL: pymoxel-0.5.0.post1-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.post1-py3-none-any.whl
Algorithm Hash digest
SHA256 4b2f80e5f13260420a1aa68751397c7b7178ae55fdbbf7a2fc0e00b64b6a2b03
MD5 f4e966024c6af8d7e8b8fba24a1e9f58
BLAKE2b-256 b855f3134baae66ea045ae6c07f2e7129ad0c85824d9bc7afc53db26c2ee39cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for pymoxel-0.5.0.post1-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