On 6 Oct 2009 released SUMO 0.5.0. General improvements: - Network module rewritten for better scalability. More coherence on the user interface. Now 100% compatible with Firefox, Internet Explorer and Safari. Opera will be available soon. Start migration to PHP 5.3/6.0: the function ereg/eregi will be no longer used in favour of pregmatch. Start Menu 8 5.3.0.1. IObit - 11.62 MB Freeware. Start Menu 8 is specially designed for Windows 8. It offers a perfect solution for users who work with.
sumo-kgen
is a program for generating input files containing k-points along high-symmetryk-point paths, for electronic band structure calculations (e.g. KPOINTS
file for VASP).The path is unique for each of the 14 Bravais lattice types and, as such, will dependon the symmetry of the unitcell. As there are several definitions and nomenclatures used in theliterature, sumo-kgen
simplifies this process, allowing for multiple high-symmetry k-point schemes.Table of Contents
Usage¶
SUMO file: Sumo Paint Image. Read here what the SUMO file is, and what application you need to open or convert it.
For simplicity, this tutorial will initially assume you are using VASP. Details for other codes are provided at the end.
The full range of options supported by
sumo-kgen
are detailed in the Command-Line Interface section,and be can be accessed using the command:To generate a set of k-points, simply run the following in a folder containing a VASP
POSCAR
file:For example, if we run this command in the
sumo/tests/data/ZnO
directory, the k-points will be written toa file called KPOINTS_band
, with the terminal showing the following information:Basic Options¶
As the path depends on the symmetry of the lattice, it is important that the symmetry is determinedcorrectly. The tolerance used for symmetry detection can be controlled using the
--symprec
Fundy designer 1 6 11 – professional album design software. option.The default is 0.01 Angstrom.By default, the paths used are those from Bradley and Cracknell [brad]. To use the k-point paths providedSeeK-path [seek] or pymatgen [curt]. The options
--seekpath
or --pymatgen
can be used.sumo-kgen
automatically looks for a POSCAR
file in the current directory. A different structurefile can be specified using the --poscar
option.The density of the k-points along the path can be controlled using the
--density
option. The default is60.Hybrid Band Structures¶
By default,
sumo-kgen
generates KPOINTS
files for use in non-self-consistent band structure calculations(e.g. for use with generalised-gradient approximation functionals). To perform hybrid band structures, thezero-weighted k-point scheme should be used. To generate KPOINTS
files for use in hybrid band structures, anIBZKPT
file must be located in the current directory (the generated k-points will be appended to those inthis file). Then simply run the following:When generating hybrid k-points, the script will ask if you wish to split the k-points among multiple files,due to the cost of hybrid band structures which often cannot finish under standard cluster walltimes.Bear in mind that the total number of k-points per file you choose will not include the addition k-pointsincluded in the
IBZKPT
file. To skip this prompt, the number of k-points per file can be specifiedvia the --split
option.Folder Generation¶
Often it is desirable to generate a new folder in which to run the band structure.
sumo-kgen
can automatethis procedure using the --folders
(or -f
) option. The script will also copy in the required VASPfiles from the current directory. Which files are copied depends on the mode of k-point generation.For example, for non-self-consistent band structures, POSCAR
, INCAR
, POTCAR
, and CHGCAR
will be copied. For hybrid band structures, only the POSCAR
, INCAR
, and POTCAR
files will be copied.If you choose to split the hybrid k-points among a number of
KPOINTS
files, a separate folder will begenerated for each file. These will be named split-01
, split-02
, etc…The
sumo-bandplot
command can automatically detect the presence of these folders and willreconstruct the full band structure from the individual splits.Custom k-Point Paths¶
sumo-kgen
also supports generating k-points along custom k-point paths. This is controlled using the--kpoints
option. The custom k-point path is specified as a string with commas separating the k-points.For example, to generate the k-points along 0.0.0.->0.50.50.5
, the usage is:Breaks in the band structure can be indicated using the pipe character.For example, the path
0.0.0.->0.50.50.5|0.0.0.->0.50.0.
, is specified as:Custom labels can also be provided using the
--labels
option. The syntax is the same as for the--kpoints
option. For example, the labels for the above path are written as:Note: in all cases the arguments are surrounded in parentheses.
Other codes¶
CASTEP¶
In CASTEP, band structure calculations also include SCF convergence sotwo sets of k-points are set: a mesh for the SCF and a path for theband structure. It is safe to provide kgen with a .cell file thatalready contains e.g. a KPOINTS_MP_GRID tag:
This will write a copy of the cell file to band.cell, including aBS_KPOINT_LIST block with the high-symmetry path and with thespecial-point labels included as comments. (These comments will helpbandplot prettify the x-axis).
Most kgen features will work as expected for CASTEP, but the
--hybrid
and --cartesian
options are not relevant.An extra feature is provided to aid phonon calculations with CASTEP: the--phonon
option will write a PHONON_FINE_KPOINT_LIST block instead.Questaal¶
To perform LMTO band structure calculations the
lmf
program can begiven a file defining the band structure path. The crystal structureis defined with an init.ext file (where ext is an identifier foryour system) or a site.ext file.Questaal band structures will use the scale factor ALAT set insite.ext which may have been modified from the initial setting,so it is usually best to read from site.ext.To read the crystal structure and create a band path:will write a file named syml.ext (“symmetry lines”); by default thiswill use lattice coordinates. To perform the band structurecalculation, specify this file with e.g.:
where the
~mq
switch indicates that syml.ext is in fractionalcoordinates. We recommend avoiding Cartesian coordinates for Questaalband structures; it is tested and should work but between ALAT scalingand Bohr units it can get a bit confusing.Command-Line Interface¶
kgen generates KPOINTS files for running band structure calculations inVASP
Named Arguments¶
![Filesumo 1 0 3 Filesumo 1 0 3](https://images6.tanganetwork.com/prod?bucket=tanga-images&filename=6903e37e5cbb.jpeg&width=1270&height=1270&quality=90)
input structure file (default: POSCAR)
Default: “POSCAR”
Electronic structure code (default: vasp).”questaal” also supported.
Default: “vasp”
![Filesumo Filesumo](https://upload.wikimedia.org/wikipedia/en/thumb/7/78/Sumo_wrestling%2C_Nagoya_2005.jpg/1280px-Sumo_wrestling%2C_Nagoya_2005.jpg)
output directory for files
number of k-points to include per file
create folders and copy in necessary files
Filesumo 1 00
Default: False
append k-points to IBZKPT file with zero weight
Default: False
tolerance for finding symmetry (default: 0.01)
Default: 0.01
space group number or symbol
Filesumo 1 0 2
k-point density along high-symmetry path
Default: 60
use seekpath to generate the high-symmetry path
Default: False
use pymatgen to generate the high-symmetry path
Default: False
use cartesian k-point coordinates
Default: False
specify a list of kpoints (e.g. “0 0 0, 0.5 0 0”)
specify the labels for kpoints (e.g. “Gamma,X”)
Filesumo 1 0 1
Write k-points as phonon band structure path
Default: False
Gpqc07-1/0
Author: Alex GanoseVersion: 1.0Last updated: July 6, 2017