https://github.com/adosar/moxel

Python package for parallel calculation of energy voxels.

https://github.com/adosar/moxel

Science Score: 39.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (17.9%) to scientific vocabulary

Keywords

deep-learning feature-engineering material-science metal-organic-frameworks porous-materials reticular-chemistry voxels
Last synced: 6 months ago · JSON representation

Repository

Python package for parallel calculation of energy voxels.

Basic Info
Statistics
  • Stars: 2
  • Watchers: 1
  • Forks: 2
  • Open Issues: 3
  • Releases: 5
Topics
deep-learning feature-engineering material-science metal-organic-frameworks porous-materials reticular-chemistry voxels
Created over 2 years ago · Last pushed 9 months ago
Metadata Files
Readme License

README.md

Logo

[![Requires Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-blue?logo=python&logoColor=yellow&label=Python&labelColor=black&color=blue)](https://www.python.org/downloads/) [![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) [![Read the Docs](https://img.shields.io/badge/stable-green?logo=readthedocs&logoColor=blue&label=Read%20the%20Docs&labelColor=black)](https://moxel.readthedocs.io) [![pip install pymoxel](https://img.shields.io/badge/install-blue?logo=pypi&logoColor=yellow&label=PyPI&labelColor=black)](https://pypi.org/project/pymoxel/) [![Documentation Status](https://readthedocs.org/projects/moxel/badge/?version=stable)](https://moxel.readthedocs.io/en/stable/?badge=stable) [![PyPI version](https://badge.fury.io/py/pymoxel.svg)](https://badge.fury.io/py/pymoxel)

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: sh 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.

Owner

  • Name: Antonios P. Sarikas
  • Login: adosar
  • Kind: user
  • Company: Department of Chemistry, University of Crete

GitHub Events

Total
  • Create event: 3
  • Release event: 1
  • Issues event: 11
  • Watch event: 1
  • Delete event: 1
  • Issue comment event: 1
  • Push event: 12
  • Pull request event: 2
Last Year
  • Create event: 3
  • Release event: 1
  • Issues event: 11
  • Watch event: 1
  • Delete event: 1
  • Issue comment event: 1
  • Push event: 12
  • Pull request event: 2

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 92
  • Total Committers: 2
  • Avg Commits per committer: 46.0
  • Development Distribution Score (DDS): 0.065
Past Year
  • Commits: 28
  • Committers: 1
  • Avg Commits per committer: 28.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Antonios Sarikas a****s@g****m 86
Francois-Xavier Coudert f****t@g****m 6

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 5
  • Total pull requests: 8
  • Average time to close issues: 3 days
  • Average time to close pull requests: 5 months
  • Total issue authors: 1
  • Total pull request authors: 2
  • Average comments per issue: 0.2
  • Average comments per pull request: 0.5
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 1
Past Year
  • Issues: 5
  • Pull requests: 0
  • Average time to close issues: 3 days
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 0.2
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • adosar (4)
Pull Request Authors
  • fxcoudert (11)
  • dependabot[bot] (1)
Top Labels
Issue Labels
enhancement (3)
Pull Request Labels
dependencies (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 34 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 7
  • Total maintainers: 1
pypi.org: pymoxel

Package for parallel calculation of energy voxels.

  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 34 Last month
Rankings
Dependent packages count: 7.4%
Forks count: 30.0%
Average: 36.4%
Stargazers count: 38.9%
Dependent repos count: 69.1%
Maintainers (1)
Last synced: 6 months ago