[![Python Package](https://github.com/Anselmoo/TanabeSugano/actions/workflows/python-package.yml/badge.svg)](https://github.com/Anselmoo/TanabeSugano/actions/workflows/python-package.yml)
[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
[![CodeFactor](https://www.codefactor.io/repository/github/anselmoo/tanabesugano/badge)](https://www.codefactor.io/repository/github/anselmoo/tanabesugano)
[![DOI](https://zenodo.org/badge/206847682.svg)](https://zenodo.org/badge/latestdoi/206847682)
[![GitHub](https://img.shields.io/github/license/Anselmoo/TanabeSugano)](https://github.com/Anselmoo/TanabeSugano/blob/master/LICENSE)
[![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/Anselmoo/TanabeSugano?include_prereleases)](https://github.com/Anselmoo/TanabeSugano/releases)
[![PyPI](https://img.shields.io/pypi/v/TanabeSugano?logo=Pypi&logoColor=yellow)](https://pypi.org/project/TanabeSugano/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/TanabeSugano?logo=Python&logoColor=yellow)](https://pypi.org/project/TanabeSugano/)
[![Downloads](https://static.pepy.tech/badge/tanabesugano)](https://pepy.tech/project/tanabesugano)
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Anselmoo/TanabeSugano/blob/master/Tanabe_Sugano.ipynb)
# TanabeSugano
A python-based Eigensolver for Tanabe-Sugano- & Energy-Correlation-Diagrams based on the original three proposed studies of *Yukito Tanabe and Satoru Sugano* for d<sup>2</sup>-d<sup>8</sup> transition metal ions:
1. On the Absorption Spectra of Complex Ions. I
**Yukito Tanabe, Satoru Sugano**
*Journal of the Physical Society of Japan*, 9, 753-766 (1954)
**DOI:** 10.1143/JPSJ.9.753
https://journals.jps.jp/doi/10.1143/JPSJ.9.753
2. On the Absorption Spectra of Complex Ions II
**Yukito Tanabe, Satoru Sugano**
*Journal of the Physical Society of Japan*, 9, 766-779 (1954)
**DOI:** 10.1143/JPSJ.9.766
https://journals.jps.jp/doi/10.1143/JPSJ.9.766
3. On the Absorption Spectra of Complex Ions, III The Calculation of the Crystalline Field Strength
**Yukito Tanabe, Satoru Sugano**
*Journal of the Physical Society of Japan*, 11, 864-877 (1956)
**DOI:** 10.1143/JPSJ.11.864
https://journals.jps.jp/doi/10.1143/JPSJ.11.864
It provides:
- Tanabe-Sugano- & Energy-Correlation-Diagrams plotted via `matplotlib`
- Tanabe-Sugano- & Energy-Correlation-Diagrams exported as `txt`-file
- Atomic-Termsymbols and their **Eigen-Energies** for a given 10Dq and oxidation state as exported table via `prettytable`
- Set-up individually **C/B**-ratios
- Working with Slater-Condon-Parameters **F<sup>2</sup>, F<sup>4</sup>** instead of Racah-Parameters **B, C**
- Export of the **Tanabe-Sugano-Diagram** as a `html`-file via `plotly` for interactive use
The **TanabeSugano**-application can be installed and run:
```console
# via PyPi
pip install TanabeSugano
# via pip+git
pip git+https://github.com/Anselmoo/TanabeSugano.git
# locally
python setup.py install
tanabesugano
# for plotly-export
pip install TanabeSugano[plotly]
```
The options for the **TanabeSugano**-application are:
```console
tanabesugano --help
usage: __main__.py [-h] [-d D] [-Dq DQ] [-cut CUT] [-B B B] [-C C C] [-n N]
[-ndisp] [-ntxt] [-slater]
optional arguments:
-h, --help show this help message and exit
-d D Number of unpaired electrons (default d5)
-Dq DQ 10Dq crystal field splitting (default 10Dq = 8065 cm-)
-cut CUT 10Dq crystal field splitting (default 10Dq = 8065 cm-)
-B B B Racah Parameter B and the corresponding reduction (default B = 860 cm- * 1.)
-C C C Racah Parameter C and the corresponding reduction (default C = 4.477*860 cm- * 1.)
-n N Number of roots (default nroots = 500)
-ndisp Plot TS-diagram (default = on)
-ntxt Save TS-diagram and dd energies (default = on)
-slater Using Slater-Condon F2,F4 parameter instead Racah-Parameter B,C (default = off)
-v, --version Print version number and exit
-html Save TS-diagram and dd energies (default = on)
```
**Reference-Example** for d<sup>6</sup> for *B = 860 cm<sup>-</sup>* and *C = 3850 cm<sup>-</sup>* as regular `matplotlib`-plot:
![placeholder](https://github.com/Anselmoo/TanabeSugano/blob/master/examples/dd-diagram_for_d6.png?raw=true)
**Reference-Example** for d<sup>6</sup> for *F<sup>2</sup> = 1065 cm<sup>-</sup>* and *F<sup>4</sup> = 5120 cm<sup>-</sup>* as interactive `plotly`-plot:
![placeholder](https://github.com/Anselmoo/TanabeSugano/blob/master/examples/d6_ts_interactive.gif?raw=true)
## Test the TS-diagrams interactively in Google Colab
[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Anselmoo/TanabeSugano/blob/master/Tanabe_Sugano.ipynb)
Raw data
{
"_id": null,
"home_page": "https://pypi.org/project/TanabeSugano",
"name": "tanabesugano",
"maintainer": "Anselm Hahn",
"docs_url": null,
"requires_python": ">=3.8.1,<4.0",
"maintainer_email": "anselm.hahn@gmail.com",
"keywords": "terminal,data-visualization,tanabe-sugano,energy-correlation,complex-ions",
"author": "Anselm Hahn",
"author_email": "anselm.hahn@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/32/bb/e25584872d17aa1ac62d3fc1b0a6fe53f684b761bbedcb3f01911918f0ac/tanabesugano-1.4.3.tar.gz",
"platform": null,
"description": "[![Python Package](https://github.com/Anselmoo/TanabeSugano/actions/workflows/python-package.yml/badge.svg)](https://github.com/Anselmoo/TanabeSugano/actions/workflows/python-package.yml)\n[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)\n[![CodeFactor](https://www.codefactor.io/repository/github/anselmoo/tanabesugano/badge)](https://www.codefactor.io/repository/github/anselmoo/tanabesugano)\n[![DOI](https://zenodo.org/badge/206847682.svg)](https://zenodo.org/badge/latestdoi/206847682)\n[![GitHub](https://img.shields.io/github/license/Anselmoo/TanabeSugano)](https://github.com/Anselmoo/TanabeSugano/blob/master/LICENSE)\n[![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/Anselmoo/TanabeSugano?include_prereleases)](https://github.com/Anselmoo/TanabeSugano/releases)\n[![PyPI](https://img.shields.io/pypi/v/TanabeSugano?logo=Pypi&logoColor=yellow)](https://pypi.org/project/TanabeSugano/)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/TanabeSugano?logo=Python&logoColor=yellow)](https://pypi.org/project/TanabeSugano/)\n[![Downloads](https://static.pepy.tech/badge/tanabesugano)](https://pepy.tech/project/tanabesugano)\n[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Anselmoo/TanabeSugano/blob/master/Tanabe_Sugano.ipynb)\n\n\n# TanabeSugano\nA python-based Eigensolver for Tanabe-Sugano- & Energy-Correlation-Diagrams based on the original three proposed studies of *Yukito Tanabe and Satoru Sugano* for d<sup>2</sup>-d<sup>8</sup> transition metal ions:\n\n1. On the Absorption Spectra of Complex Ions. I\n\n **Yukito Tanabe, Satoru Sugano**\n *Journal of the Physical Society of Japan*, 9, 753-766 (1954)\n **DOI:** 10.1143/JPSJ.9.753\n https://journals.jps.jp/doi/10.1143/JPSJ.9.753\n\n2. On the Absorption Spectra of Complex Ions II\n\n **Yukito Tanabe, Satoru Sugano**\n *Journal of the Physical Society of Japan*, 9, 766-779 (1954)\n **DOI:** 10.1143/JPSJ.9.766\n https://journals.jps.jp/doi/10.1143/JPSJ.9.766\n\n3. On the Absorption Spectra of Complex Ions, III The Calculation of the Crystalline Field Strength\n\n **Yukito Tanabe, Satoru Sugano**\n *Journal of the Physical Society of Japan*, 11, 864-877 (1956)\n **DOI:** 10.1143/JPSJ.11.864\n https://journals.jps.jp/doi/10.1143/JPSJ.11.864\n\nIt provides:\n\n- Tanabe-Sugano- & Energy-Correlation-Diagrams plotted via `matplotlib`\n- Tanabe-Sugano- & Energy-Correlation-Diagrams exported as `txt`-file\n- Atomic-Termsymbols and their **Eigen-Energies** for a given 10Dq and oxidation state as exported table via `prettytable`\n- Set-up individually **C/B**-ratios\n- Working with Slater-Condon-Parameters **F<sup>2</sup>, F<sup>4</sup>** instead of Racah-Parameters **B, C**\n- Export of the **Tanabe-Sugano-Diagram** as a `html`-file via `plotly` for interactive use\n\nThe **TanabeSugano**-application can be installed and run:\n\n```console\n # via PyPi\n pip install TanabeSugano\n\n # via pip+git\n pip git+https://github.com/Anselmoo/TanabeSugano.git\n\n # locally\n python setup.py install\n tanabesugano\n\n # for plotly-export\n pip install TanabeSugano[plotly]\n```\n\n\nThe options for the **TanabeSugano**-application are:\n\n```console\n tanabesugano --help\n\n usage: __main__.py [-h] [-d D] [-Dq DQ] [-cut CUT] [-B B B] [-C C C] [-n N]\n [-ndisp] [-ntxt] [-slater]\n\n optional arguments:\n -h, --help show this help message and exit\n -d D Number of unpaired electrons (default d5)\n -Dq DQ 10Dq crystal field splitting (default 10Dq = 8065 cm-)\n -cut CUT 10Dq crystal field splitting (default 10Dq = 8065 cm-)\n -B B B Racah Parameter B and the corresponding reduction (default B = 860 cm- * 1.)\n -C C C Racah Parameter C and the corresponding reduction (default C = 4.477*860 cm- * 1.)\n -n N Number of roots (default nroots = 500)\n -ndisp Plot TS-diagram (default = on)\n -ntxt Save TS-diagram and dd energies (default = on)\n -slater Using Slater-Condon F2,F4 parameter instead Racah-Parameter B,C (default = off)\n -v, --version Print version number and exit\n -html Save TS-diagram and dd energies (default = on)\n```\n\n**Reference-Example** for d<sup>6</sup> for *B = 860 cm<sup>-</sup>* and *C = 3850 cm<sup>-</sup>* as regular `matplotlib`-plot:\n![placeholder](https://github.com/Anselmoo/TanabeSugano/blob/master/examples/dd-diagram_for_d6.png?raw=true)\n\n\n**Reference-Example** for d<sup>6</sup> for *F<sup>2</sup> = 1065 cm<sup>-</sup>* and *F<sup>4</sup> = 5120 cm<sup>-</sup>* as interactive `plotly`-plot:\n\n![placeholder](https://github.com/Anselmoo/TanabeSugano/blob/master/examples/d6_ts_interactive.gif?raw=true)\n\n## Test the TS-diagrams interactively in Google Colab\n\n[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/Anselmoo/TanabeSugano/blob/master/Tanabe_Sugano.ipynb)\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A python-solver for Tanabe-Sugano and Energy-Correlation diagrams",
"version": "1.4.3",
"project_urls": {
"Homepage": "https://pypi.org/project/TanabeSugano",
"Repository": "https://github.com/Anselmoo/TanabeSugano"
},
"split_keywords": [
"terminal",
"data-visualization",
"tanabe-sugano",
"energy-correlation",
"complex-ions"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f06c4cd61ef35f344f4dbf21abde944822a35c53de26062096439d3af179b83c",
"md5": "493ed849467956100055f6bf022255d5",
"sha256": "9c2ebb8f07fdc19d813debabb4c5ddabfbc7dc60baa487ce072e92be0ff9e9cc"
},
"downloads": -1,
"filename": "tanabesugano-1.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "493ed849467956100055f6bf022255d5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1,<4.0",
"size": 16705,
"upload_time": "2023-12-20T12:21:46",
"upload_time_iso_8601": "2023-12-20T12:21:46.152924Z",
"url": "https://files.pythonhosted.org/packages/f0/6c/4cd61ef35f344f4dbf21abde944822a35c53de26062096439d3af179b83c/tanabesugano-1.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "32bbe25584872d17aa1ac62d3fc1b0a6fe53f684b761bbedcb3f01911918f0ac",
"md5": "2c582003be4678e4f4c7f13b61fcfa38",
"sha256": "4f99206e8aea9bb81efeb73721dd949f981f4e71ef98d9afe77332b971661665"
},
"downloads": -1,
"filename": "tanabesugano-1.4.3.tar.gz",
"has_sig": false,
"md5_digest": "2c582003be4678e4f4c7f13b61fcfa38",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1,<4.0",
"size": 15147,
"upload_time": "2023-12-20T12:21:47",
"upload_time_iso_8601": "2023-12-20T12:21:47.519858Z",
"url": "https://files.pythonhosted.org/packages/32/bb/e25584872d17aa1ac62d3fc1b0a6fe53f684b761bbedcb3f01911918f0ac/tanabesugano-1.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-20 12:21:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Anselmoo",
"github_project": "TanabeSugano",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "tanabesugano"
}