see

seekpath

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

Showing:

Popularity

Downloads/wk

0

GitHub Stars

74

Maintenance

Last Commit

1yr ago

Contributors

5

Package

Dependencies

8

License

The MIT license

Categories

Readme

######### SeeK-path #########

Test status: branch master: |travismaster|; branch develop: |travisdevelop|

.. |travismaster| image:: https://travis-ci.org/giovannipizzi/seekpath.svg?branch=master :target: https://travis-ci.org/giovannipizzi/seekpath

.. |travisdevelop| image:: https://travis-ci.org/giovannipizzi/seekpath.svg?branch=develop :target: https://travis-ci.org/giovannipizzi/seekpath

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::

.. section-numbering::

===========

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

=======

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 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:

.. image:: https://raw.githubusercontent.com/materialscloud-org/tools-seekpath/master/misc/screenshots/selector.png :alt: SeeK-path web service selection window :width: 50% :align: center

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.

.. image:: https://raw.githubusercontent.com/materialscloud-org/tools-seekpath/master/misc/screenshots/mainwindow.png :alt: SeeK-path web service main output :width: 50% :align: center

.. _HPKOT paper: http://dx.doi.org/10.1016/j.commatsci.2016.10.015 .. _JOURNAL LINK: http://dx.doi.org/10.1016/j.commatsci.2016.10.015 .. _arXiv link: https://arxiv.org/abs/1602.06402 .. _spglib: http://atztogo.github.io/spglib/ .. _Materials Cloud: http://www.materialscloud.org/tools/seekpath/ .. _docker hub: https://hub.docker.com/r/giovannipizzi/seekpath/ .. _user guide on ReadTheDocs: http://seekpath.readthedocs.io .. _spglib arXiv link: https://arxiv.org/abs/1808.01590 .. _tools-seekpath: http://www.github.com/materialscloud-org/tools-seekpath/

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial