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

SeeK-path

Test status for default branch: Test status

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.

Contents

  1. How to cite
  2. How to install and how to use
  3. Acknowledgements
  4. License
  5. Online service/tool

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).

How to install and how to use

Please check the SeeK-path user guide on ReadTheDocs.

Acknowledgements

The SeeK-path package was mainly developed by Giovanni Pizzi and is now maintained by Timo Reents.

Further 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

License

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

Online service/tool

In the tools-seekpath repository we also provide the code to deploy an 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.2.1.tar.gz (44.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

seekpath-2.2.1-py3-none-any.whl (78.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: seekpath-2.2.1.tar.gz
  • Upload date:
  • Size: 44.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.12

File hashes

Hashes for seekpath-2.2.1.tar.gz
Algorithm Hash digest
SHA256 10906f13e3db5ed511b85ada2c0eba9f90ae764078a21809035561b0116a66a3
MD5 3f1d20b051780f06f8d05243806e1e62
BLAKE2b-256 ee17e02d23a1d6806258e0543a2e738808faa2487ac5750c0771224202ca2011

See more details on using hashes here.

File details

Details for the file seekpath-2.2.1-py3-none-any.whl.

File metadata

  • Download URL: seekpath-2.2.1-py3-none-any.whl
  • Upload date:
  • Size: 78.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.12

File hashes

Hashes for seekpath-2.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6351c89dd0f58d5d85dba2d63134cd036d57c777baf2bfb9b5b70ff84fa9b8c1
MD5 d62a10fa9e98c87c1897e00c57e0457e
BLAKE2b-256 73240c2ade7551649491b775030799d3cb1283e96699d74704686dd4d4ab5ae2

See more details on using hashes here.

Supported by

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