Skip to main content

BandUPpy: Python interfaceof the BandUP code

Project description

BandUP: Band Unfolding code for Plane-wave based calculations

BandUPpy - Python version of BandUP (not to be confused with bandupy - the interface and plotting tool of BandUP)

This is a python version to the BandUP code, made in order to restore support of the modern versions of QuantumEspresso and other codes. In order ot read the wavefunctions stored by abiinitio codes, the routines of irrep irrep are used.

If you find BandUPpy useful, but missing any important part of the functionality of the original bandUP code, please let me know.

Author of BandUPpy : Stepan S. Tsirkin, University of Zurich,

Authors of original BandUP :

  • Paulo V. C. Medeiros, Linköping University, (at present: SMHI, the Swedish Meteorological and Hydrological Institute)

  • Jonas Björk, Linköping University

  • Stepan S. Tsirkin, (in 2015: Donostia International Physics Center)

please refer to

BandUPpy is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

BandUPpy is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with BandUP. If not, see

Plane-wave codes currently supported by BandUPpy

At the moment, BandUP can parse wavefunctions generated by:

Plane-wave codes currently supported by original BandUP:

At the moment, BandUP can parse wavefunctions generated by:

  • VASP
  • Quantum ESPRESSO (issues arise with new versions)
  • CASTEP (use the main code of BandUP, not the bandupy) (tested with the academic version; currently only available on request)


If you use BandUPpy in your work, you should:

  • State EXPLICITLY that you've used the BandUP code (or a modified version of it, if this is the case).
  • Read and cite the following papers (and the appropriate references therein):

Paulo V. C. Medeiros, Sven Stafström, and Jonas Björk, Phys. Rev. B 89, 041407(R) (2014)
Paulo V. C. Medeiros, Stepan S. Tsirkin, Sven Stafström, and Jonas Björk, Phys. Rev. B 91, 041116(R) (2015)

if you use BandUPpy, please also cite

Mikel Iraola, Juan L. Mañes, Barry Bradlyn, Titus Neupert, Maia G. Vergniory, Stepan S. Tsirkin "IrRep: symmetry eigenvalues and irreducible representations of ab initio band structures", arXiv:2009.01764

An appropriate way of acknowledging the use of BandUP in your publications would be, for instance, adding a sentence like:

     "The unfolding has been performed using the BandUP code"

followed by the citation to our papers.

Project details

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

banduppy-0.2.0-py3-none-any.whl (18.6 kB view hashes)

Uploaded py3

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