StdFace

An input file generator for quantum lattice model solvers developed at ISSP, University of Tokyo.

Overview

StdFace reads a simple configuration file specifying the physical model and lattice geometry, then generates solver-specific input files for:

• HPhi - Exact Diagonalization
• mVMC - Variational Monte Carlo
• UHF - Unrestricted Hartree-Fock
• H-wave - Mean-field solver

Features

• Simple key = value input format
• Support for various lattice geometries and physical models
• Wannier90 format support for ab-initio calculations
• Single codebase for multiple solver backends

Supported Lattices

| Lattice Type | Description | |--------------|-------------| | chain | 1D chain | | ladder | 2-leg ladder | | square | 2D square lattice | | triangular | 2D triangular lattice | | honeycomb | 2D honeycomb lattice | | kagome | 2D kagome lattice | | tetragonal | 3D tetragonal lattice | | orthorhombic | 3D orthorhombic lattice | | fcortho | Face-centered orthorhombic | | pyrochlore | 3D pyrochlore lattice | | wannier90 | Import from Wannier90 files |

Supported Models

• Hubbard model
• Spin models
• Kondo lattice model

Requirements

• CMake 2.8.12 or later
• C99-compatible compiler (GCC, Clang, Intel, Fujitsu, etc.)

Installation

git clone https://github.com/issp-center-dev/StdFace
cd StdFace
cmake -B build -DHPHI=ON   # Enable HPhi mode
cmake --build build
cmake --install build --prefix /path/to/install

Build Options

Enable one or more solver modes:

| Option | Executable | Target Solver | |--------|------------|---------------| | -DHPHI=ON | hphi_dry.out | HPhi (Exact Diagonalization) | | -DMVMC=ON | mvmc_dry.out | mVMC (Variational Monte Carlo) | | -DUHF=ON | uhf_dry.out | UHF (Unrestricted Hartree-Fock) | | -DHWAVE=ON | hwave_dry.out | H-wave |

Build all solvers:

cmake -B build -DHPHI=ON -DMVMC=ON -DUHF=ON -DHWAVE=ON
cmake --build build

Quick Start

1. Create an input file stan.in:

model = "Hubbard"
lattice = square
W = 2
L = 2
t = 1.0
U = 4.0
nelec = 4
2Sz = 0

2. Run StdFace:

./hphi_dry.out stan.in

3. Input files for the target solver are generated in the current directory.

Documentation

Full documentation is available at: https://issp-center-dev.github.io/StdFace/

• Quickstart Guide
• Input/Output Reference
• Examples

License

StdFace is distributed under the GNU General Public License version 3 (GPL v3).

Authors

Kazuyoshi Yoshimi, Mitsuaki Kawamura, Kota Ido, Yuichi Motoyama, and Tatsumi Aoyama.

Related Projects

• HPhi - Exact Diagonalization package
• mVMC - Variational Monte Carlo package
• UHF - Unrestricted Hartree-Fock package
• H-wave - Mean-field solver