This small package is designed to handle uniform matrix product states (uMPS), i.e. matrix product states in the thermodynamic limit composed of a single, repeating unit cell. Specifically, an implementation of the VUMPS algorithm [1] is provided, which can find uMPS approximations for the ground state of Hamiltonians, contract 2D partition functions, etc. Additionally, time-evolution can be performed with the time-dependent variational principle (TDVP) [4], which currently supports only single-site unit cells.
Once you fetched a copy, you want to add the package to your MATLAB path.
The easiest way is running the command addpath(genpath('<path>/umps'))
from your MATLAB terminal and you are good to go.
Alternatively one can run addpath('<path>/umps','<path>/umps/classes','<path>/umps/inc','<path>/umps/lib')
.
This adds the three necessary directories: classes
contains all the class definitions, inc
contains all the core functions, and lib
contains external resources.
The subpackages are algorithms
(main optimization routines), linalg
(linear algebra routines for tensors) and util
(extra functions that can come in handy).
If you want to permanently add these directories to your matlabpath, use the command savepath
.
A good place to get started and test that everything works in in the examples
directory.
Here you will find use cases of VUMPS to find ground states of different types of operators, and to approximately contract
Additional information can be obtained with the command help umps
or help <command>
.
- Contractions optimized for large bond dimensions The complexity should never be more than O(D3) for a fixed bond dimension D.
- Optimal increase of the bond dimension during the VUMPS iterations.
- Support for multi-site unit cells.
The function ncon.m
by R. N. C. Pfeifer [2] is used to perform tensor contractions.
A copy is provided in the lib
folder.
This has been tested up to MATLAB version R2017b. Things might break in future versions, given Mathwork's history of releasing non-backwards-compatible updates.
- V. Zauner-Stauber, L. Vanderstraeten, M.T. Fishman, F. Verstraete, J. Haegeman, Variational optimization algorithms for uniform matrix product states, Physical Review B (2018).
- R. N. C. Pfeifer, G. Evenbly, S. Singh, G. Vidal, NCON: A tensor network contractor for MATLAB, arXiv:1402.0939 (2014).
- C. Hubig, J. Haegeman, U. Schollwöck, Error estimates for extrapolations with matrix-product states, Physical Review B (2018).
- J. Haegeman, C. Lubich, I. Oseledets, B. Vandereycken, F. Verstraete, Unifying time evolution and optimization with matrix product states, Physical Review B (2016).