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: branch master: travismaster; branch develop: travisdevelop

SeeK-path is a python module to obtain and visualize 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 Contributors

  • Tiziano Müller (UZH, Switzerland) for the CP2K input file generator and added a number of new input formats (XYZ, PDB, …)

  • Hung Pham (University of Minnesota, USA) for the CRYSTAL and VASP input file generators

3 How to install and how to use

Please visit the SeeK-path user guide is on Read the docs.

4 License

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

5 Online service/tool

In this 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 demo is currently 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-1.9.7.tar.gz (51.6 kB view details)

Uploaded Source

Built Distribution

seekpath-1.9.7-py2.py3-none-any.whl (86.9 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

  • Download URL: seekpath-1.9.7.tar.gz
  • Upload date:
  • Size: 51.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/41.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.5

File hashes

Hashes for seekpath-1.9.7.tar.gz
Algorithm Hash digest
SHA256 b83ea23b54209b7f34f3fcabe7248cebbcc3cc164c394f1659b35942edaedb1c
MD5 4f027bc4cb21f17d8e7f84f9c53ff4e1
BLAKE2b-256 e0437c480a2bedff1496b1523506775e5f53289f52f1379de7ee9dc55cb1a13e

See more details on using hashes here.

File details

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

File metadata

  • Download URL: seekpath-1.9.7-py2.py3-none-any.whl
  • Upload date:
  • Size: 86.9 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/41.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.5

File hashes

Hashes for seekpath-1.9.7-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 b080ecba79cad3a64b89035c042090d248e1eb36a1e260648a325f7f8099e214
MD5 630d515d234aed02da4a5db5969eca5b
BLAKE2b-256 df004b7808aa02e407a5ff59e913b2dd4b36c9f215e2a41b00c09a464c72f54e

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