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