This repository contains the minimal example codes for the project: bootstrapping the flatband superconductors. This project is part of a large ongoing project: (Fermionic) Quantum Many-body Bootstrap, which is currently under development. In this small repository, you will be able to use the codes to reproduce part of the results presented in two recent preprints: bootstrapping spinful flatband superconductors 1 and bootstrapping spinless chiral flatband superconductors 2
Quantum many-body problems are notoriously hard because the number of degrees of freedom grows exponentially with system size. Solving such problems, therefore, calls for techniques that can circumvent the resulting exponential complexity, motivating major advances in both theory and numerics, including Hartree–Fock (mean-field), quantum Monte Carlo, and the density-matrix renormalization group (DMRG). However, these methods have intrinsic limitations, often relying on weak correlations or low entanglement. This raises a natural question: How can we make reliable predictions in quantum many-body systems where brute-force simulation is impossible and uncontrolled approximations abound? This project seeks to address this by developing the quantum many-body bootstrap (QMB): a hierarchy of convex relaxations that enforce first principles—unitarity, causality/locality, gauge invariance, positivity, and sum rules—to yield rigorous, systematically improvable bounds on physical observables.
QMB reframes strongly interacting quantum systems as convex optimization over observables rather than a search over exponentially large wavefunctions. Instead of parameterizing
Minimizing the energy (or other figures of merit) over this feasible set yields rigorous lower bounds that improve monotonically as additional constraints are imposed. In the dual picture, the bootstrap produces certificates (extremal functionals) that witness optimality and pinpoint which constraints are saturated, giving mechanistic insight. Because all constraints are linear or convex, the problems are naturally expressed as semidefinite programs (SDPs) that leverage mature numerical infrastructure.
In the recent preprint 1, we showed that for flat-band superconductors, there could be provable lower bounds on the zero-temperature superfluid stiffness
Now, we are going to disclose the two sets of minimal example codes for reproducing part of the essential results presented in those two works. The purpose of this repository is primarily to show how the QMB works.
- MATLAB R2022b or later (licensed)
- SDP solver: MOSEK
- MATLAB interface: YALMIP
- Special-functions package: SpecFunPhys Toolbox
The Special-functions package is only needed when you want to reproduce the data points for the case of the spinless chiral superconductor.
- Install MATLAB R2022b+ on your machine.
- Install MOSEK and ensure a valid license is available (free for academic use).
- Install YALMIP and add it to the MATLAB path.
- Install the SpecFunPhys Toolbox and add it to the MATLAB path.
- Add this repository to the MATLAB path.
Detailed installation instructions can be found on the associated webpages. Or you can use any AI chatbot (ChatGPT, DeepSeek, etc.) to help you with the installation.
Commands for adding the paths (inside MATLAB):
addpath 'path/to/Mosek/toolbox';
addpath(genpath('path/to/this/repo'));
addpath(genpath('path/to/yalmip'));
addpath(genpath('path/to/specfunphys'));Please replace the placeholders with the actual paths on your machine.
There are two sets of codes provided corresponding to the spinful and spinless cases, respectively.
In the example code (main_example_code_spinful.m), we demonstrate the usage of the bootstrap and ED calculations for the following system:
% System size: Nx by Ny, where both Nx and Ny are odd numbers
Nx = 3;
Ny = 5;
% Particle number: N, an even number (from 2 to 2*Nx*Ny) to ensure the
% superconducting ground state.
N = 6;which is a
Simply run the code (inside MATLAB)
>> main_example_code_spinfulyou will see the output:
The stiffness for Nx=3, Ny=5, and N=6 from bootstrap is 0.014456163198, with Elapsed time 14.6910s
The stiffness for Nx=3, Ny=5, and N=6 from ED is 0.014456564315, with Elapsed time 30.9391s
Bootstrapping stiffness for Nx=3, Ny=5, and N=2 Elapsed time: 9.2486s
Bootstrapping stiffness for Nx=3, Ny=5, and N=4 Elapsed time: 13.0479s
Bootstrapping stiffness for Nx=3, Ny=5, and N=6 Elapsed time: 12.9743s
Bootstrapping stiffness for Nx=3, Ny=5, and N=8 Elapsed time: 12.9818s
Bootstrapping stiffness for Nx=3, Ny=5, and N=10 Elapsed time: 13.0428s
Bootstrapping stiffness for Nx=3, Ny=5, and N=12 Elapsed time: 13.6438s
Bootstrapping stiffness for Nx=3, Ny=5, and N=14 Elapsed time: 14.0747s
ED stiffness for Nx=3, Ny=5, and N=2 Elapsed time: 0.0154s
ED stiffness for Nx=3, Ny=5, and N=4 Elapsed time: 0.7906s
ED stiffness for Nx=3, Ny=5, and N=6 Elapsed time: 30.7173s
ED stiffness for Nx=3, Ny=5, and N=8 Elapsed time: 448.1879s
and the plot
From the results, we see clearly that the bootstrap results saturate the upper bounds
For spinless models presented in preprint 2, the implementations are very similar (main_example_code_spinless.m). However, due to the singularity in the flatband, we instead consider an even-by-even grid
% System: Nx by Ny k-grid with an inverse symmetric diamond shape. Nx=Ny and
% both are even.
Nx = 4;
Ny = 4;Simply run the code (inside MATLAB)
>> main_example_code_spinlessyou will see the output:
Running... Step 1/8 Elapsed time is 7.008710 seconds.
Running... Step 2/8 Elapsed time is 11.673105 seconds.
Running... Step 3/8 Elapsed time is 12.248589 seconds.
Running... Step 4/8 Elapsed time is 12.786815 seconds.
Running... Step 5/8 Elapsed time is 13.251433 seconds.
Running... Step 6/8 Elapsed time is 12.784523 seconds.
Running... Step 7/8 Elapsed time is 9.009584 seconds.
Running... Step 8/8 Elapsed time is 5.393113 seconds.
and the plot
We note that the results of the spinless (chiral) case are for the grand canonical ensemble: we first obtain the stiffness
and the average stiffness
where
Footnotes
-
Qiang Gao, Zhaoyu Han, Eslam Khalaf. Bootstrapping Flat-band Superconductors: Rigorous Lower Bounds on Superfluid Stiffness (2025). arXiv:2506.18969. https://arxiv.org/abs/2506.18969 ↩ ↩2 ↩3
-
Zhaoyu Han, Jonah Herzog-Arbeitman, Qiang Gao, Eslam Khalaf. Exact models of chiral flat-band superconductors (2025). arXiv:2508.21127. https://arxiv.org/abs/2508.21127 ↩ ↩2 ↩3

