Skip to content
/ qex Public
forked from jcosborn/qex

Fork of the Quantum EXpressions framework with full staggered hybrid Monte Carlo and gradient flow suite

License

Notifications You must be signed in to change notification settings

ctpeterson/qex

 
 

Repository files navigation

QEX: Quantum EXpressions lattice field theory framework

Description of QEX fork:

Modular code for fast deployment of Hybrid Monte Carlo (HMC) with many options for simulating with/without nHYP smeared (or unsmeared) staggered fermions and Pauli-Villars (PV) bosons. Most options (gauge action, boundary conditions, nHYP smearing parameters, and much more) are provided in an XML file, such that the action being simulated can be quickly/easily modified without needing to modify the source code and/or recompile. Source code can be found here. See input_hmc.xml for a complete list of tunable parameters for the gauge-fermion-PV action, HMC specifications, etc.

For deployment, make sure that you 1.) follow the installation instructions given in the base QEX respository and 2.) install MDevolve using Nimble. Once you've done this, simply run "make staghmc_spv" in your build directory and you're done. If you're confused because the whole process seemed far too easy, I assure you that it really was that easy and encourage you to thank James Osborn and Xiao-Yong Jin for the time & effort that they've put into QEX. Instructions for running the code can be found at the top of staghmc_spv.nim.

This fork of QEX also ships with a modular gauge flow code, allowing for Wilson, adjoint-plaquette, and any variation of rectangular action for the flow. The gauge flow code can be found here.

There is also an XY model code with Wolff cluster updates that can be found here. The XY model simulation code also comes with options for performing U(1) gradient flow with the XY model action as the flow action, which is equivalent to a gradient flow of the XY model action with an explicit constraint that preserves the unit norm of the spins on the lattice.

For the U(1) gradient flow of the XY model action, I use Arraymancer for vectorization. The latter gradient flow code is not as efficient as the gauge flow code that is native to QEX, and it would be desireable to have a version of the U(1) gradient flow code that is build within the QEX framework. One option is simply to compile the gauge flow code in this repository with --nc=1 and to modify the action to be the XY model action; this may come in a future version of this repository, but it is unlikely.

Description of QEX:

QEX is a high-level framework for lattice field operations written in the language Nim.

It provides optimized lattice field operations, including SIMD support, for CPU architectures (native GPU support is currently experimental). Since Nim compiles to native C/C++, directly calling any C/C++ lattice code or library from QEX is relatively easy to do.

Some simple code examples are here ex0.nim ex1.nim.

It currently supports

  • U(1), SU(2..4) gauge fields in any dimension
  • SciDAC I/O
  • Gauge fixing
  • Staggered solver and forces (Asqtad, HISQ, nHYP)
  • Wilson solver (no clover yet)
  • Interface for Chroma, Grid, QUDA interoperability

Installation guide: INSTALL.md

Build guide: BUILD.md

Further examples:

About

Fork of the Quantum EXpressions framework with full staggered hybrid Monte Carlo and gradient flow suite

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Nim 97.1%
  • C 1.3%
  • Other 1.6%