5.2. Utility tools to generate the input files of DSQSS/DLA

DSQSS/DLA needs several XML-formatted input files: lattice file, algorithm file, structure file, real space temperature Green’s function file, and momentum space temperature Green’s function file. By writing these files, you can simulate any model on any lattice. Since they are a little complicated, DSQSS/DLA prepares utility tools for generating them.

5.2.1. Hypercubic lattice generator lattgene_C

lattgene_C is a utility tool to generate a lattice file describing a \(D\) dimensional hypercubic lattice with the periodic boundary condition.:

$ lattgene_C [-o filename] D L1 L2 ... LD BETA

The meaning of parameters are following:

D
Dimension of lattice
L1 L2 ... LD
Linear length of lattice in each dimension.
BETA
Inversed temperature.
filename
Name of lattice file (default: lattice.xml ).

Example:

## Chain with 8 sites. Inversed temperature is 10.0.
$ lattgene_C 1 8 10.0

## Square lattice with 6x6 sites. Inversed temperature is 10.0
## Name of the generated file is lat.xml
$ lattgene_C -o lat.xml 2 6 6 10.0

5.2.2. Triangular lattice generator lattgene_T

lattgene_T is a utility tool to generate a lattice file describing a triangular lattice with the periodic boundary condition.

$ lattgene_T [-o filename] L1 L2 BETA

The meaning of parameters are following:

L1 L2
Linear length of lattice in each dimension.

BETA

Inversed temperature.
filename
Name of lattice file (default: lattice.xml ).

Example:

## Triangular lattice with 6x6 sites. Inversed temperature is 10.0
$ lattgene_T 1 8 10.0

5.2.3. Heisenberg spin Hamiltonian generator hamgen_H

hamgen_H is a utility tool generating a hamiltonian file describing Heisenberg spin model

$ hamgen_H [-o filename] M J F

The meaning of parameters is following:

M
Twice as the length of the local spin, \(2S\)
J
The exchange interaction. Positive for ferromagnetic and negative for antiferromagnetic.
F
The magnetic field on a site per a bond connected to the site, \(F = h/z\) , where \(z\) is the coordination number, for example, \(z=4\) for the square lattice.
filename
Name of hamiltonian file (default: hamiltonian.xml ).

Example:

## S=1/2 antiferromagnetic Heisenberg model without magnetic field.
$ hamgen_H 1 -1.0 0.0

## S=1 ferromagnetic Heisenberg model with magnetic field.
## Name of the generated file ham.xml
$ hamgen_H -o ham.xml 2 1.0 1.0

5.2.4. Bose-Hubbard model generator hamgen_B

hamgen_B is a utility tool generating a hamiltonian file describing Bose-Hubbard model

$ hamgen_B [-o filename] M t V U F

The meaning of parameters is following:

M
The maximum number of sites on a site
t
The hopping parameter
V
The nearest neighbor interaction. Positive for repulsive potential and negative for attractive.
U
The onsite interaction. Positive for repulsive potential and negative for attractive.
F
The chemical potential on a site per a bond connected to the site, \(F = h/z\) , where \(z\) is the coordination number, for example, \(z=4\) for the square lattice.
filename
Name of the Hamiltonian file (default: hamiltonian.xml ).

5.2.5. Algorithm file generator dla_alg

dla_alg is an utility tool to convert a hamiltonian file to an algorithm file.:

$ dla_alg HFILE AFILE

The meaning of parameters are following:

HFILE
The Hamiltonian file to be loaded (default: hamiltonian.xml ).
AFILE
The algorithm file to be generated (default: algorithm.xml ).

5.2.6. Structure factor file generator sfgene

sfgene is a utility tool generating a structure factor file for a hypercubic lattice:

$ sfgene [-o filename] D L_1 ... L_D Ntau Ntau_cutoff KTYPE

The meaning of parameters are following:

D
Dimension of lattice
L_1 ... L_D
Linear length of lattice in each dimension.
Ntau
The number of discretization of imaginary time
Ntau_cutoff
The maximum number of distance in imaginary time \(d\tau\)
KTYPE

Pattern of wave vectors \(k\)

  • KTYPE==0

    Wave vectors with \(k_x = n\pi/L_x, n = 0, 2, \dots, L\) are calculated (\(k_y\) and \(k_z\) are zero for all wave vectors).

  • KTYPE==1

    \(k/\pi = (0,0,0), (1,0,0), (0,1,0), (1,1,0), \dots, (1,1,1)\) for three dimensional case.

filename
The structure factor file to be generated (default: sf.xml ).

5.2.7. Real space temperature Green’s function file generator cfgene

cfgene is a utility tool generating a real space temperature Green’s function file for a hypercubic lattice:

$ cfgene [-o filename] D L_1 ... L_D Ntau

The meaning of parameters is following:

D
The dimension of lattice
L_1 ... L_D
The linear lengths of lattice in each dimension.
Ntau
The number of discretization of imaginary time
filename
The real space temperature Green’s function file to be generated (default: sf.xml ).