Skip to content


Repository files navigation

WannierTools Build Status codecov


The homepage of the WannierTools code is

Full documentation of WannierTools is on website

QQ group number : 709225749

Authors and contributors

WannierTools was initialized by QuanSheng Wu (IOP CAS) and Shengnan Zhang (IOP CAS) at IOP CAS Beijing in 2012. Now, it's an open-source software, there are serveral contributors including

  • Changming Yue (SusTech) : symmetrization of Wannier tight-binding Hamiltonian and obtain phonon tight-binding Hamiltonian.
  • Yifei Guan (EPFL CH) : Landau level calculation.
  • Tiantian Zhang (Tokyo Institute of Technology ): LOTO correction in phonon systems.
  • Yi Liu (BNU Beijing) : Ruge-Kutta integration.
  • Jianzhou Zhao (SWUST): QPI in kpath mode.
  • Hanqi Pi (IOP CAS) : Anomalous Nerest Effects.

Pull down the package

The developing branch can be fetched by

git clone

The stable branch can be downloaded in

Brief introductions

We present an open-source software package WannierTools, a software for investigation of novel topological materials. This code works in the tight-binding framework, which can be generated by another software package Wannier90. It can help to classify the topological phase of a given materials by calculating the Wilson loop, and can get the surface state spectrum which is detected by angle resolved photoemission (ARPES) and in scanning tunneling microscopy (STM) experiments . It also identifies positions of Weyl/Dirac points and nodal line structures, calculates the Berry phase around a closed momentum loop and Berry curvature in a part of the Brillouin zone(BZ). Besides, WannierTools also can calculate ordinary magnetoresistance for non-magnetic metal and semimetal using Boltzmann transport theory, calculate Landau level spectrum with given magnetic field direction and strength, and get unfolded energy spectrum from a supercell calculation.

License and Citation

WannierTools was released under GPL V3. If you use our code for your research, please cite it properly, like “ The surface spectrums or Berry curvature, Wilson loop, Weyl/Dirac points, Nodal line, Chirality et al. are calculated by the software package WannierTools~\cite{Wu2018}. "

Please use WannierTools instead of "wannier_tools" , "wannier-tools" or WannierTool" when you cite our software.

For the surface state calculation, please also cite {Sancho1985}.

For the Wilson loop calculation, please also cite PhysRevB.84.075119 and PhysRevB.83.035108.

For magnetoresistance calculation, please also cite Magnetoresistance from Fermi surface topology, ShengNan Zhang, QuanSheng Wu, Yi Liu, and Oleg V. Yazyev, Phys. Rev. B 99, 035142 (2019)

For non-magnetic symmetrization processing, please cite "wannhr_symm: A tool for symmetrization of non-magnetic WannierTB,\_tools/tree/master/utility/wannhr_symm/, Changming Yue".

For magnetic symmetrization processing, please cite "wannhr_symm_Mag: A tool for symmetrization of magnetic WannierTB,\_tools/tree/master/utility/wannhr_symm_Mag, Changming Yue".

For phonon system calculation, please cite "PhononTB: a tool to construct tight-binding model for phonon systems,\_tools/tree/master/utility/phonopyTB, Changming Yue".


title = "WannierTools : An open-source software package for novel topological materials",
journal = "Computer Physics Communications",
volume = "224",
pages = "405 - 416",
year = "2018",
doi = "",
url = "",
issn = "0010-4655",
preprint = "arXiv:1703.07789",
author = "QuanSheng Wu and ShengNan Zhang and Hai-Feng Song and Matthias Troyer and Alexey A. Soluyanov",
keywords = "Novel topological materials, Topological number, Surface state, Tight-binding model"

Sancho1985: Highly convergent schemes for the calculation of bulk and surface Green functions, M P Lopez Sancho, J M Lopez Sancho, J M L Sancho and J Rubio, J.Phys.F.Met.Phys.15(1985)851-858


Full list of citations from the ADS Databases

  • Non-Abelian band topology in noninteracting metals, QuanSheng Wu, Alexey A. Soluyanov, and Tomas Bzdusek, Science 365, 1273 (2019)

  • Phonon-Induced Topological Transition to a Type-II Weyl Semimetal, Lin-Lin Wang, Na Hyun Jo, Yun Wu, QuanSheng Wu, Adam Kaminski, Paul C. Canfield, Duane D. Johnson, [arXiv:1703.07292] (

  • Unique topological surface states of full-Heusler topological crystalline insulators, Anh Pham and Sean Li, Phys. Rev. B 95, 115124 (2017)

  • Saddle-like topological surface states on the TT'X family of compounds (T, T' = Transition metal, X= Si, Ge) Bahadur Singh, Xiaoting Zhou, Hsin Lin, Arun Bansil, [arXiv:1703.04048] (

  • Hidden Weyl points in centrosymmetric paramagnetic metals, Dominik Gresch, QuanSheng Wu, Georg W Winkler and Alexey A Soluyanov, New J. Phys. 19 (2017) 035001

  • Topological semimetal to insulator quantum phase transition in the Zintl compounds Ba2X(X=Si,Ge), Ziming Zhu, Mingda Li, and Ju Li, Phys. Rev. B 94, 155121, (2016)

  • Heavy Weyl fermion state in CeRu4Sn6, Yuanfeng Xu, Changming Yue, Hongming Weng, Xi Dai, arXiv:1608.04602,Phys. Rev. X 7, 011027 (2017)

  • Triple Point Topological Metals Ziming Zhu, Georg W. Winkler, QuanSheng Wu, Ju Li, Alexey A. Soluyanov arXiv:1605.04653 Phys. Rev. X 6, 031003 – Published 7 July 2016.

  • Fermi arcs and their topological character in the candidate type-II Weyl semimetal MoTe2, A. Tamai, Q. S. Wu, I. Cucchi, F. Y. Bruno, S. Ricco, T.K. Kim, M. Hoesch, C. Barreteau, E. Giannini, C. Bernard, A. A. Soluyanov, F. Baumberger arXiv:1604.08228 Phys. Rev. X 6, 031021 (2016)

  • Nodal-chain metals, Tomáš Bzdušek, QuanSheng Wu, Andreas Rüegg, Manfred Sigrist, Alexey A. Soluyanov arXiv:1604.03112, 2016 Nature (2016) doi:10.1038/nature19099.

  • Surface states and bulk electronic structure in the candidate type-II Weyl semimetal WTe2, F. Y. Bruno, A. Tamai, Q. S. Wu, I. Cucchi, C. Barreteau, A. de la Torre, S. McKeown Walker, S. Riccò, Z. Wang, T. K. Kim, M. Hoesch, M. Shi, N. C. Plumb, E. Giannini, A. A. Soluyanov, F. Baumberger arXiv:1604.02411, 2016

  • Topological Phases in InAs1−xSbx: From Novel Topological Semimetal to Majorana Wire, Georg W. Winkler, QuanSheng Wu, Matthias Troyer, Peter Krogstrup, Alexey A. Soluyanov arxiv:1602.07001, 2016

  • Type-II Weyl semimetals, Alexey A. Soluyanov, Dominik Gresch, Zhijun Wang, QuanSheng Wu, Matthias Troyer, Xi Dai & B. Andrei Bernevig, Nature 527, 495–498 (26 November 2015)

  • Topologically nontrivial electronic states in CaSn3 Sunny Gupta, Rinkle Juneja, Ravindra Shinde, and Abhishek K. Singha) Journal of Applied Physics 121, 214901 (2017);

  • Transition between strong and weak topological insulator in ZrTe5 and HfTe5 Zongjian Fan , Qi-Feng Liang , Y. B. Chen, Shu-Hua Yao & Jian Zhou

  • Hidden Weyl points in centrosymmetric paramagnetic metals Dominik Gresch1,3, QuanSheng Wu1, Georg W Winkler1 and Alexey A Soluyanov1,2

  • New Group V Elemental Bilayers: A Tunable Structure Model with 4,6,8-atom Rings Xiangru Kong, Linyang Li, Ortwin Leenaerts, Xiong-jun Liu, François M. Peeters

  • Hybrid Dirac Semimetal in CaAgBi Materials Family Cong Chen, Shan-Shan Wang, Lei Liu, Zhi-Ming Yu, Xian-Lei Sheng, Ziyu Chen, Shengyuan A. Yang

  • Multiple types of topological fermions in transition metal silicides Peizhe Tang, Quan Zhou, Shou-Cheng Zhang

  • Novel Spin-Orbit Dirac Point in Monolayer HfGeTe
    Shan Guan, Ying Liu, Zhi-Ming Yu, Shan-Shan Wang, Yugui Yao, Shengyuan A. Yang

  • Quantum anomalous Hall effect in stable 1T-YN2 monolayer with a large nontrivial band gap and high Chern number Xiangru Kong, Linyang Li, Ortwin Leenaerts, Weiyang Wang, Xiong-Jun Liu, François M. Peeters

  • Extremely large magnetoresistance and Kohler's rule in PdSn4: a complete study of thermodynamic, transport and band structure properties Na Hyun Jo, Yun Wu, Lin-Lin Wang, Peter P. Orth, Savannah S. Downing, Soham Manni, Dixiang Mou, Duane D. Johnson, Adam Kaminski, Sergey L. Bud'ko, Paul C. Canfield

  • Ternary Weyl semimetal NbIrTe4 proposed from first-principles calculation Lei Li, Huan-Huan Xie, Jing-Sheng Zhao, Xiao-Xiong Liu, Jian-Bo Deng, Xian-Ru Hu, and Xiao-Ma TaoPhys. Rev. B 96, 024106 – Published 18 July 2017

  • A new strongly topological node-line semimetal β-PbO2 Zhenwei Wang and Guangtao Wang

  • Robust Large Gap Quantum Spin Hall Insulators in Methyl-functionalized III-Bi Buckled Honeycombs Qing Lu, Busheng Wang, Xiang-Rong Chen, Wu-Ming Liu

  • Ferromagnetic Type-II Weyl Semimetal in Pyrite Chromium Dioxide R. Wang, Y. J. Jin, J. Z. Zhao, Z. J. Chen, Y. J. Zhao, H. Xu

  • Robustness of topological states with respect to lattice instability in the nonsymmorphic topological insulator KHgSb

  • Chen, T.-T. Zhang, C.-J. Yi, Z.-D. Song, W.-L. Zhang, T. Zhang, Y.-G. Shi, H.-M. Weng, Z. Fang, P. Richard, and H. Ding Phys. Rev. B 96, 064102 – Published 4 August 2017

  • Two-dimensional Hexagonal M3C2 (M = Zn, Cd, Hg) Monolayer: Novel Quantum Spin Hall Insulators and Dirac Cone Materials Peng-Fei Liu , Liujiang Zhou , Sergei Tretiak and Li-Ming Wu DOI: 10.1039/C7TC02739G (Paper) J. Mater. Chem. C, 2017, Accepted Manuscript

  • Topological Type-II Nodal Line Semimetal and Dirac Semimetal Statein Stable Kagome Compound Mg3Bi2 Xiaoming Zhang, Lei Jin, Xuefang Dai, and Guodong Liu, School of Materials Science and Engineering, Hebei University of Technology, Tianjin 300130, China

  • A nonmagnetic topological Weyl semimetal in quaternary Heusler compound CrAlTiV Xiaoxiong Liu, Lei Li, Yvgui Cui, Jianbo Deng, and Xiaoma Tao Appl. Phys. Lett. 111, 122104 (2017)