Skip to main content

A module to obtain and visualize k-vector coefficients and obtain band paths in the Brillouin zone of crystal structures

Project description

Test status for default branch: continuousintegration

SeeK-path is a python module to obtain band paths in the Brillouin zone of crystal structures.

The definition of k-point labels follows crystallographic convention, as defined and discussed in the HPKOT paper. Moreover, the Bravais lattice is detected properly using the spacegroup symmetry. Also the suggested band path provided in the HPKOT paper is returned. Systems without time-reversal and inversion-symmetry are also properly taken into account.

1 How to cite

If you use this tool, please cite the following work:

  • Y. Hinuma, G. Pizzi, Y. Kumagai, F. Oba, I. Tanaka, Band structure diagram paths based on crystallography, Comp. Mat. Sci. 128, 140 (2017) (JOURNAL LINK, arXiv link).

  • You should also cite spglib that is an essential library used in the implementation: A. Togo, I. Tanaka, “Spglib: a software library for crystal symmetry search”, arXiv:1808.01590 (2018) (spglib arXiv link).

2 How to install and how to use

Please check the SeeK-path user guide on ReadTheDocs.

3 Acknowledgements

  • Jae-Mo Lihm: k-point paths for the original unit cell (i.e., the one provided in input by the user) without standardization or symmetrization

4 License

The code is open-source (licensed with a MIT license, see LICENSE.txt).

5 Online service/tool

In the tools-seekpath repository we also provide the code to deploy a online service for the visualization of the band paths and primitive cells of the crystal structures. A live version is hosted on the Materials Cloud web portal.

The following is a screenshot of the selection window:

SeeK-path web service selection window

And the following is a screenshot of the main output window, showing the Brillouin zone, the primitive crystal structure, the coordinates of the k-points and the suggested band path.

SeeK-path web service main output

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seekpath-2.1.0.tar.gz (62.3 kB view details)

Uploaded Source

Built Distribution

seekpath-2.1.0-py2.py3-none-any.whl (77.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file seekpath-2.1.0.tar.gz.

File metadata

  • Download URL: seekpath-2.1.0.tar.gz
  • Upload date:
  • Size: 62.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.1 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.64.0 CPython/3.8.11

File hashes

Hashes for seekpath-2.1.0.tar.gz
Algorithm Hash digest
SHA256 31cec579628262e6d4a4c3693fefa70d6ccae1ceeef7c9d10ea3cd48988452c4
MD5 46e7c9f604e1ca1f1305dda21f2dab6d
BLAKE2b-256 556c0a0525f78062d126f29930042d26478824d56fb7dca754373368309a02d2

See more details on using hashes here.

File details

Details for the file seekpath-2.1.0-py2.py3-none-any.whl.

File metadata

  • Download URL: seekpath-2.1.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 77.5 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.25.1 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.64.0 CPython/3.8.11

File hashes

Hashes for seekpath-2.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 e825d0b17e3fcca4aa27e979888665e72209faa3215687db47dbf0e075551bb3
MD5 cb1e1abd0574278b3805b1a3fe68153a
BLAKE2b-256 302cfcb31e185a3a74d4098d9c44ac108ddcf1a4c88d7d3cea5a569dd812c62b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page