# Polya
![PyPI Version](https://img.shields.io/pypi/v/polyaenum.svg) ![PyPI Downloads](https://static.pepy.tech/badge/polyaenum)
A python implementation of Polya's enumeration theory and pattern inventory formula.
# Usage
Here is an example on how to extract the cycle index polynomial (p_g) and number of distinct first coordination polyhedron (nms) for the fcc crystal structure with a number of ntypes = 3 chemical elements. Additonal graph geometries can be defined in ``polya/_src/graphs.py``. This example can be found in the ``examples/`` folder.
```python
from polya import Polya
pl = Polya(graph_name="fcc")
p_g, nms = pl.get_gt(ntypes=3)
print(p_g)
```
## Installation
For a standalone Python package or Conda environment, please use:
```bash
pip install --user polya
```
If you want to install the lastest git commit, please replace ``polya`` by ``git+https://github.com/killiansheriff/polya.git``.
## Contact
If any questions, feel free to contact me (ksheriff at mit dot edu).
## References & Citing
If you use this repository in your work, please cite:
```
@article{TOBEUPDATED,
title={TOBEUPDATED},
author={Sheriff, Killian and Cao, Yifan and Freitas, Rodrigo},
journal={arXiv preprint TOBEUPDATED},
year={2024}
}
```
Raw data
{
"_id": null,
"home_page": "https://github.com/killiansheriff/polya",
"name": "polyaenum",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Killian Sheriff",
"author_email": "ksheriff@mit.edu",
"download_url": "https://files.pythonhosted.org/packages/9e/d7/0664ccffceb010214d681f1c9e53a4e9ca052fb4ed11e1dd0eab1b7fffcb/polyaenum-0.0.1.tar.gz",
"platform": null,
"description": "# Polya \n![PyPI Version](https://img.shields.io/pypi/v/polyaenum.svg) ![PyPI Downloads](https://static.pepy.tech/badge/polyaenum)\n\nA python implementation of Polya's enumeration theory and pattern inventory formula.\n\n# Usage \n\nHere is an example on how to extract the cycle index polynomial (p_g) and number of distinct first coordination polyhedron (nms) for the fcc crystal structure with a number of ntypes = 3 chemical elements. Additonal graph geometries can be defined in ``polya/_src/graphs.py``. This example can be found in the ``examples/`` folder. \n\n```python\nfrom polya import Polya\npl = Polya(graph_name=\"fcc\")\np_g, nms = pl.get_gt(ntypes=3)\nprint(p_g)\n```\n\n## Installation\nFor a standalone Python package or Conda environment, please use:\n```bash\npip install --user polya\n```\n\nIf you want to install the lastest git commit, please replace ``polya`` by ``git+https://github.com/killiansheriff/polya.git``.\n\n## Contact\nIf any questions, feel free to contact me (ksheriff at mit dot edu).\n\n## References & Citing \nIf you use this repository in your work, please cite:\n\n```\n@article{TOBEUPDATED,\n title={TOBEUPDATED},\n author={Sheriff, Killian and Cao, Yifan and Freitas, Rodrigo},\n journal={arXiv preprint TOBEUPDATED},\n year={2024}\n}\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A python implementation of Polya's enumeration theory.",
"version": "0.0.1",
"project_urls": {
"Homepage": "https://github.com/killiansheriff/polya"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "df3e64dc20843752583a86be0b56cbf7dd0f5fa39f78957266bf0090cf7b5ff7",
"md5": "81b45f84b66bcb66e125647b757588f5",
"sha256": "0459ccdae778c23183c5cc0ba1626d11ce03380d87438db280dd3c38316dd385"
},
"downloads": -1,
"filename": "polyaenum-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "81b45f84b66bcb66e125647b757588f5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 4919,
"upload_time": "2024-03-13T23:40:05",
"upload_time_iso_8601": "2024-03-13T23:40:05.749367Z",
"url": "https://files.pythonhosted.org/packages/df/3e/64dc20843752583a86be0b56cbf7dd0f5fa39f78957266bf0090cf7b5ff7/polyaenum-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9ed70664ccffceb010214d681f1c9e53a4e9ca052fb4ed11e1dd0eab1b7fffcb",
"md5": "62cc89bc41fbc320dd18ae5e087e33a4",
"sha256": "395f1d3d07c04d125d2bfed30522aeb6e4aba1bb3a8d5701e3b2e5e78fb49520"
},
"downloads": -1,
"filename": "polyaenum-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "62cc89bc41fbc320dd18ae5e087e33a4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4444,
"upload_time": "2024-03-13T23:40:07",
"upload_time_iso_8601": "2024-03-13T23:40:07.335575Z",
"url": "https://files.pythonhosted.org/packages/9e/d7/0664ccffceb010214d681f1c9e53a4e9ca052fb4ed11e1dd0eab1b7fffcb/polyaenum-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-13 23:40:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "killiansheriff",
"github_project": "polya",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "polyaenum"
}