Skip to main content

logo

GitHub DOI ArXiv Documentation Status PyPI version Downloads

This python package offers efficient simulation and data analysis routines for the $SU(2) \times SU(2)$ Principal Chiral model. The key feature offered is the integration of Fourier Acceleration into the Hybrid Monte Carlo algorithm which leads to a significant reduction in the degree of critical slowing down.

The simulation is supported for cubic lattices with even side length in arbitary dimensions.

Installation

To install SU2xSU2 using pip run:

pip install SU2xSU2

Its is recommended to work in a virtual environment. The package comes with a custom style sheet which is used by default.

Documentation

Read the docs here.

Example

A basic example showing how to set up a simulation using Fourier accelerated HMC to measure the wall-to-wall correlation function. Further examples can be found here.

from SU2xSU2.SU2xSU2 import SU2xSU2

# define model and lattice parameters 
model_paras = {'D':2, L':40, 'a':1, 'ell':5, 'eps':1/5, 'beta':0.6}
model = SU2xSU2(**model_paras)
# define simulation parameters and measurements
sim_paras = {'M':500, 'burnin_frac':0.5, 'accel':True, 'measurements':[model.ww_correlation_func], 'chain_paths':['corfunc_chain.npy']}
model.run_HMC(**sim_paras) 

Attribution

Please cite the following paper if you found this code useful in your research:

@article{WackFAHMC2024,
    author = {Roger Horsley and Brian Pendleton and Julian Wack},
    title = {Hybrid Monte Carlo simulation with Fourier acceleration of the N = 2 principal chiral model in two dimensions},
    journal = {Physics Letters B},
    volume = {849},
    pages = {138429},
    year = {2024},
    issn = {0370-2693},
    doi = {https://doi.org/10.1016/j.physletb.2023.138429},
    eprint={2308.14628v2},
    archivePrefix={arXiv},
    primaryClass={hep-lat}
}

Licence

SU2xSU2 is free software made available under the MIT License. For details see the LICENSE file.

To Do

  • Runtime warning in correlations l.64
  • implement weak coupling expansion for all D

Metadata

Release files for SU2xSU2 2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for SU2xSU2 2
File Size Uploaded
SU2xSU2-2.tar.gz 38.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for SU2xSU2 2
File Interpreter ABI Platform
SU2xSU2-2-py3-none-any.whl Python 3 none any Details

Total release size: 74.1 kB

Release files / SU2xSU2-2.tar.gz

Download URL SU2xSU2-2.tar.gz
Size 38.4 kB
Tags Source
SHA-256 checksum
How to use checksums
426341d6e5c7cd88730caf9816bdfa235bce2e1bf8db98b41c5c8745dd2a20fa
BLAKE2b-256 checksum
How to use checksums
5b1473819701e20f2d5c7f39bafdbc21e28d3bc0534e3c745135797a5252e5eb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.12.0

Release files / SU2xSU2-2-py3-none-any.whl

Download URL SU2xSU2-2-py3-none-any.whl
Size 35.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4be397e907fe1bf3bd6c76e446c82ecc4884611b294017741df920cceb01daf9
BLAKE2b-256 checksum
How to use checksums
299d15ab85eaf290ba3b1e729951beca0addd43acf907123848018e916a4de02
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.12.0

Release history Release notifications | RSS feed

This release

2 This release

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3

2 release files

1.2.4

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1

2 release files

1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page