| Name | mkite-db JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | |
| Summary | mkite: distributed computing platform for high-throughput materials simulations |
| upload_time | 2023-05-25 14:37:57 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.8 |
| license | |
| keywords |
workflow
materials-science
|
| 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/mkite-group/mkite_db/main/docs/_static/mkite-logo.svg" width="500"><br>
</div>
# What is mkite?
mkite is a suite of tools for running high-throughput materials simulations in distributed computing platforms.
The mkite suite decouples the production database from client workers, facilitating scaling of simulations across heterogeneous computing environments.
The infrastructure enables exploration of combinatorial materials spaces using workflows, recipes, data visualizations, and more.
Some advantages of mkite:
- It stores and organizes complex materials workflows on databases. For example, mkite allows creating workflows with more than one parent input branch (say, interfaces between solids and molecules).
- The server is agnostic to the computing environments where the tasks are performed, and the clients are unaware of the production database. This facilitates distributing the tasks across heterogeneous computing systems.
- It provides textual descriptions for workflows, and enables adapting them on-the-fly. This helps as a "lab notebook" for computational materials scientists.
- It is adaptable to many software packages and inputs. The recipe system also interacts well with other libraries, such as ASE, pymatgen, cclib, and more.
## Documentation
General tutorial for `mkite` and its plugins are available in the [main documentation](https://mkite.org).
Complete API documentation is pending.
## Installation
To install `mkite_db`, first install `mkite_core` and `mkite_engines`.
Then, install this repository with pip:
```bash
pip install mkite_core mkite_engines
pip install mkite_db
```
Alternatively, for a development version, clone this repo and install it in editable form:
```bash
pip install -U git+https://github.com/mkite-group/mkite_db
```
## Contributions
Contributions to the entire mkite suite are welcomed.
You can send a pull request or open an issue for this plugin or either of the packages in mkite.
When doing so, please adhere to the [Code of Conduct](CODE_OF_CONDUCT.md) in the mkite suite.
The mkite package was created by Daniel Schwalbe-Koda <dskoda@llnl.gov>.
### Citing mkite
If you use mkite in a publication, please cite the following paper:
```bibtex
@article{mkite2023,
title = {mkite: A distributed computing platform for high-throughput materials simulations},
author = {Schwalbe-Koda, Daniel},
year = {2023},
journal = {arXiv:2301.08841},
doi = {10.48550/arXiv.2301.08841},
url = {https://doi.org/10.48550/arXiv.2301.08841},
arxiv={2301.08841},
}
```
## License
The mkite suite is distributed under the following license: Apache 2.0 WITH LLVM exception.
All new contributions must be made under this license.
SPDX: Apache-2.0, LLVM-exception
LLNL-CODE-848161
Raw data
{
"_id": null,
"home_page": "",
"name": "mkite-db",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "workflow,materials-science",
"author": "",
"author_email": "Daniel Schwalbe-Koda <dskoda@llnl.gov>",
"download_url": "https://files.pythonhosted.org/packages/ae/e1/1c3556d71e793ca110f83120935a2a40d60ef91879d50dbd4aa3b94182e7/mkite_db-0.1.1.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <img src=\"https://raw.githubusercontent.com/mkite-group/mkite_db/main/docs/_static/mkite-logo.svg\" width=\"500\"><br>\n</div>\n\n# What is mkite?\n\nmkite is a suite of tools for running high-throughput materials simulations in distributed computing platforms.\nThe mkite suite decouples the production database from client workers, facilitating scaling of simulations across heterogeneous computing environments.\nThe infrastructure enables exploration of combinatorial materials spaces using workflows, recipes, data visualizations, and more.\n\nSome advantages of mkite:\n\n- It stores and organizes complex materials workflows on databases. For example, mkite allows creating workflows with more than one parent input branch (say, interfaces between solids and molecules).\n- The server is agnostic to the computing environments where the tasks are performed, and the clients are unaware of the production database. This facilitates distributing the tasks across heterogeneous computing systems.\n- It provides textual descriptions for workflows, and enables adapting them on-the-fly. This helps as a \"lab notebook\" for computational materials scientists.\n- It is adaptable to many software packages and inputs. The recipe system also interacts well with other libraries, such as ASE, pymatgen, cclib, and more.\n\n## Documentation\n\nGeneral tutorial for `mkite` and its plugins are available in the [main documentation](https://mkite.org).\nComplete API documentation is pending.\n\n## Installation\n\nTo install `mkite_db`, first install `mkite_core` and `mkite_engines`.\nThen, install this repository with pip:\n\n```bash\npip install mkite_core mkite_engines\npip install mkite_db\n```\n\nAlternatively, for a development version, clone this repo and install it in editable form:\n\n```bash\npip install -U git+https://github.com/mkite-group/mkite_db\n```\n\n## Contributions\n\nContributions to the entire mkite suite are welcomed.\nYou can send a pull request or open an issue for this plugin or either of the packages in mkite.\nWhen doing so, please adhere to the [Code of Conduct](CODE_OF_CONDUCT.md) in the mkite suite.\n\nThe mkite package was created by Daniel Schwalbe-Koda <dskoda@llnl.gov>.\n\n### Citing mkite\n\nIf you use mkite in a publication, please cite the following paper:\n\n```bibtex\n@article{mkite2023,\n title = {mkite: A distributed computing platform for high-throughput materials simulations},\n author = {Schwalbe-Koda, Daniel},\n year = {2023},\n journal = {arXiv:2301.08841},\n doi = {10.48550/arXiv.2301.08841},\n url = {https://doi.org/10.48550/arXiv.2301.08841},\n arxiv={2301.08841},\n}\n```\n\n## License\n\nThe mkite suite is distributed under the following license: Apache 2.0 WITH LLVM exception.\n\nAll new contributions must be made under this license.\n\nSPDX: Apache-2.0, LLVM-exception\n\nLLNL-CODE-848161\n",
"bugtrack_url": null,
"license": "",
"summary": "mkite: distributed computing platform for high-throughput materials simulations",
"version": "0.1.1",
"project_urls": null,
"split_keywords": [
"workflow",
"materials-science"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "00b2796923b039b87161a107336a0238c6c73bacc7aabd7470fca05d12996d22",
"md5": "dcb539951d46de421b35630907ebdb91",
"sha256": "d03bf5293400fb97f5478f605700eb2fb145037e04f8abf46d85ddf172726fb1"
},
"downloads": -1,
"filename": "mkite_db-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "dcb539951d46de421b35630907ebdb91",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 80345,
"upload_time": "2023-05-25T14:37:56",
"upload_time_iso_8601": "2023-05-25T14:37:56.059373Z",
"url": "https://files.pythonhosted.org/packages/00/b2/796923b039b87161a107336a0238c6c73bacc7aabd7470fca05d12996d22/mkite_db-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "aee11c3556d71e793ca110f83120935a2a40d60ef91879d50dbd4aa3b94182e7",
"md5": "3b8bb208a14b86db0ab964d14cb1de1f",
"sha256": "2ccbf5e7d900dcf35ae1e3ac0cb9e3ccf3706e79393b057ccab0188915a2c783"
},
"downloads": -1,
"filename": "mkite_db-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "3b8bb208a14b86db0ab964d14cb1de1f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 96560,
"upload_time": "2023-05-25T14:37:57",
"upload_time_iso_8601": "2023-05-25T14:37:57.301470Z",
"url": "https://files.pythonhosted.org/packages/ae/e1/1c3556d71e793ca110f83120935a2a40d60ef91879d50dbd4aa3b94182e7/mkite_db-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-25 14:37:57",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "mkite-db"
}
