| Name | quansino JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | None |
| Summary | `quansino` is a modular package based on the Atomic Simulation Environment (ASE) for quickly building custom Monte Carlo algorithms |
| upload_time | 2025-08-08 15:51:03 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.12 |
| license | BSD-3 |
| keywords |
monte carlo
computational chemistry
quantum chemistry
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<div align="center">
<img src=https://raw.githubusercontent.com/Atomic-Samplers/quansino/refs/heads/main/docs/images/quansino_logo.png width="500"><br>
</div>
<div align="center">
<h1><code>quansino</code> 🎲</h1>
<p><i>Modular Stochastic Simulations for Atomistic Modelling</i></p>
</div>
***
[](https://badge.fury.io/py/quansino)
[](https://codecov.io/gh/Atomic-Samplers/quansino)
[](https://github.com/Atomic-Samplers/quansino/blob/main/LICENSE.md)
[](https://github.com/psf/black)
[](https://github.com/pre-commit/pre-commit)
`quansino` is a Python framework for running Monte Carlo simulations on atomic systems, designed to be modular and work with popular quantum chemistry codes/forcefields. The package offer a flexible interface to build custom algorithms, and is designed to be modular and extensible. It is built to work with the [Atomic Simulation Environment (ASE)](https://wiki.fysik.dtu.dk/ase/) `Atoms` object.
## Key Features 🎰
- Perform simulations in various ensemble; (grand-)canonical, isobaric, more will be added in the future.
- The framework allows to design custom simulation algorithms by providing explicit interfaces for each step of the simulation, such as:
- **Moves**: Moves are the core of the simulation, allowing for the modification of atomic configurations. The framework supports a wide range of move types, including:
- **Displacement Moves**: Moves that displace atoms in the simulation box.
- **Cell Moves**: Moves that change the simulation box size or shape.
- **Exchange Moves**: Moves that add/remove atoms from the simulation box.
- **Contexts**: Hold the state of the simulation, such as temperature, pressure, and chemical potential.
- **Criteria**: Criteria objects are used to determine the acceptance of moves based on energy changes.
- The code makes use of Python's type hints and duck typing to ensure that the code is modular and extensible. Along with an extensive documentation, this makes it easy to understand and extend the codebase.
## Documentation 🎱
The full documentation can be found [here](https://atomic-samplers.github.io/quansino/), and includes detailed instructions about:
- 🔧 [Installation](https://atomic-samplers.github.io/quansino/installation/install.html)
- 📖 [Overview](https://atomic-samplers.github.io/quansino/documentation/overview.html)
- 💡 [Examples](https://atomic-samplers.github.io/quansino/documentation/examples.html)
## Citation 🎯
If you use `quansino` in your research, please cite the following repository: https://doi.org/10.5281/zenodo.14854001
## License 🃏
This project is licensed under the terms of the BSD 3-Clause license.
Raw data
{
"_id": null,
"home_page": null,
"name": "quansino",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "Monte Carlo, Computational Chemistry, Quantum Chemistry",
"author": null,
"author_email": "Tom Demeyere <tom.dmre@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c2/b6/6b1b38d6f1c0c54234e7b0c0de612fe85e62de60759a59bc855e9f041d82/quansino-0.1.1.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <img src=https://raw.githubusercontent.com/Atomic-Samplers/quansino/refs/heads/main/docs/images/quansino_logo.png width=\"500\"><br>\n</div>\n\n<div align=\"center\">\n <h1><code>quansino</code> \ud83c\udfb2</h1>\n <p><i>Modular Stochastic Simulations for Atomistic Modelling</i></p>\n</div>\n\n***\n\n[](https://badge.fury.io/py/quansino)\n\n[](https://codecov.io/gh/Atomic-Samplers/quansino)\n[](https://github.com/Atomic-Samplers/quansino/blob/main/LICENSE.md)\n[](https://github.com/psf/black)\n[](https://github.com/pre-commit/pre-commit)\n\n`quansino` is a Python framework for running Monte Carlo simulations on atomic systems, designed to be modular and work with popular quantum chemistry codes/forcefields. The package offer a flexible interface to build custom algorithms, and is designed to be modular and extensible. It is built to work with the [Atomic Simulation Environment (ASE)](https://wiki.fysik.dtu.dk/ase/) `Atoms` object.\n\n## Key Features \ud83c\udfb0\n\n- Perform simulations in various ensemble; (grand-)canonical, isobaric, more will be added in the future.\n- The framework allows to design custom simulation algorithms by providing explicit interfaces for each step of the simulation, such as:\n\n - **Moves**: Moves are the core of the simulation, allowing for the modification of atomic configurations. The framework supports a wide range of move types, including:\n\n - **Displacement Moves**: Moves that displace atoms in the simulation box.\n - **Cell Moves**: Moves that change the simulation box size or shape.\n - **Exchange Moves**: Moves that add/remove atoms from the simulation box.\n\n - **Contexts**: Hold the state of the simulation, such as temperature, pressure, and chemical potential.\n - **Criteria**: Criteria objects are used to determine the acceptance of moves based on energy changes.\n\n- The code makes use of Python's type hints and duck typing to ensure that the code is modular and extensible. Along with an extensive documentation, this makes it easy to understand and extend the codebase.\n\n## Documentation \ud83c\udfb1\n\nThe full documentation can be found [here](https://atomic-samplers.github.io/quansino/), and includes detailed instructions about:\n\n- \ud83d\udd27 [Installation](https://atomic-samplers.github.io/quansino/installation/install.html)\n- \ud83d\udcd6 [Overview](https://atomic-samplers.github.io/quansino/documentation/overview.html)\n- \ud83d\udca1 [Examples](https://atomic-samplers.github.io/quansino/documentation/examples.html)\n\n## Citation \ud83c\udfaf\n\nIf you use `quansino` in your research, please cite the following repository: https://doi.org/10.5281/zenodo.14854001\n\n## License \ud83c\udccf\n\nThis project is licensed under the terms of the BSD 3-Clause license.\n",
"bugtrack_url": null,
"license": "BSD-3",
"summary": "`quansino` is a modular package based on the Atomic Simulation Environment (ASE) for quickly building custom Monte Carlo algorithms",
"version": "0.1.1",
"project_urls": {
"changelog": "https://github.com/Atomic-Samplers/quansino/blob/main/CHANGELOG.md",
"documentation": "https://atomic-samplers.github.io/quansino/",
"repository": "https://github.com/Atomic-Samplers/quansino"
},
"split_keywords": [
"monte carlo",
" computational chemistry",
" quantum chemistry"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c2b66b1b38d6f1c0c54234e7b0c0de612fe85e62de60759a59bc855e9f041d82",
"md5": "a327c6bc9bdc87dcd3f6fed128d5fddf",
"sha256": "7939ce3c2dc1ca2679fe6e93cbf44431d0ea298e6dcc5222540f87a06d500b85"
},
"downloads": -1,
"filename": "quansino-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "a327c6bc9bdc87dcd3f6fed128d5fddf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 49304,
"upload_time": "2025-08-08T15:51:03",
"upload_time_iso_8601": "2025-08-08T15:51:03.787857Z",
"url": "https://files.pythonhosted.org/packages/c2/b6/6b1b38d6f1c0c54234e7b0c0de612fe85e62de60759a59bc855e9f041d82/quansino-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-08 15:51:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Atomic-Samplers",
"github_project": "quansino",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "quansino"
}
