Time evolution algorithms for matrix-product states based on ITensors.jl
Author orialb
27 Stars
Updated Last
1 Year Ago
Started In
September 2019


Build Status codecov

The goal of this package is to provide implementations of time-evolution algorithms for matrix-product states using ITensors.jl.

The package is currently at an initial stage. Contributions and suggestions are very welcome.

Algorithms currently implemented:

  • TEBD (with 2nd and 4th order Trotter decomposition) [1]
  • TDVP (two-site variant) [2]


In order to use this package you will need to have ITensors.jl installed, run the following in the Julia REPL:

] add ITensors

This package is not yet registered, in order to install it run the following in the Julia REPL:

] add https://github.com/orialb/TimeEvoMPS.jl


The following code example shows how to evolve an MPS for a spin-half chain with the transverse-field Ising Hamiltonian, starting from a fully polarized state (functionality to perform measurements during time evolution is still missing, but will be added very soon).

First we setup the initial state

using ITensors, TimeEvoMPS

J = 1.
h = 0.5

# Use ITensors to define initial fully-polarized MPS
sites = siteinds("S=1/2",N)
psi = productMPS(ComplexF64,sites, fill("",N))


Define our Hamiltonian as a BondOperator which is an object that represents an operator composed of a sum of two-site gates H = Σᵢ h_{i,i+1} (calling gates(bo::BondOperator) builds the actual gates).

# Build Hamiltonian
H = BondOperator(sites)
for b in 1:N-1
    #add two-site term at bond b
    #add single-site term at site b

Now we can run TEBD, by default 2nd order Trotter decomposition is used.

# Set maximal bond dimension during evolution.
# Other truncation parmeters supported by ITensors.jl are possible, see 
# documentation of `apply_gate!`
maxdim = 10
#time step and total evolution time 
dt = 0.01
tf =1.
tebd!(psi,H,dt,tf, maxdim=maxdim)

Alternatively we could use 4th order Trotter decomposition

tebd!(psi,H,dt,tf,TEBD4(), maxdim=maxdim)


We could also use TDVP to evolve our state. For this we first need to build an MPO representation of the Hamiltonian. This is easily done using the AutoMPO functionality from ITensors.

ampo = AutoMPO()
for j=1:length(sites)-1
H= MPO(ampo,sites)

Now we can run time-evolution using TDVP.


Callbacks (i.e. performing measurements during time-evolution) (WIP)

Probably you will be interested in measuring some observables at different time points during the evolution. This is possible using the callback mechanism which allows you to access the state of the system at each point of the evolution (including steps in the middle of the TEBD/TDVP sweep). Callbacks can also be used to stop the time-evolution if certain criteria have been met (e.g. convergence of some observables). You could use one of the implemented callbacks or implement a callback of your own (the callback mechanism is still work in progress, so the API might change).

Local measurements callback

Currently a LocalMeasurmentCallback is implemented which allows measuring single-site operators. Here is how you would use it to measure the expectation values of Sz,Sx,Sy, with measurement interval dt=0.2 (time evolving with the MPO H defined in the previous section):

psi = productMPS(sites, fill("",N))
cb = LocalMeasurementCallback(["Sz","Sx","Sy"], sites,0.2)

note that the measurment interval must be commensurate with the time-evolution step (here 0.1).

Now you can extract the measurement results from the callback calling measurements(cb). For example here is how you could plot the measurements, using e.g. PyPlot.jl:

using PyPlot
ts = measurement_ts(cb)
for o in ["x","y","z"]
    S5 = getindex.(measurements(cb)["S$o"],5)

Implementing a custom callback (TODO)


[1] Vidal, G. (2004). Efficient Simulation of One-Dimensional Quantum Many-Body Systems. Physical Review Letters, 93(4), 040502. https://doi.org/10.1103/PhysRevLett.93.040502

[2] Haegeman, J., Lubich, C., Oseledets, I., Vandereycken, B., & Verstraete, F. (2016). Unifying time evolution and optimization with matrix product states. Physical Review B, 94(16). https://doi.org/10.1103/PhysRevB.94.165116