Experimental API#

In this page we present some experimental interfaces of NetKet. Those are not guaranteed to be API-stable, and might change without notice (other than the changelog) among minor releases. The netket.experimental module mirrors the standard netket module structure, and we suggest to use it as follows:

import netket as nk
import netket.experimental as nkx

Drivers#

Currently NetKet offers an experimental driver implementing Stochastic Reconfiguration with the kernel trick (originally introduced under the name of minSR by Ao Chen and Markus Heyl). This is slightly more limited in features than the standard Stochastic Reconfiguration implementation of netket.drivers.VMC, but can scale to millions of parameters

driver.VMC_SRt

Energy minimization using Variational Monte Carlo (VMC) and the kernel formulation of Stochastic Reconfiguration (SR).

Quantum State Reconstruction#

The Quantum State Reconstruction algorithm performs an approximate tomographic reconstruction of measurement data coming from a quantum computer (or similar device) using a Pure or Mixed quantum state.

QSR

Quantum state reconstruction driver minimizing KL divergence.

Samplers#

They are experimental, meaning that we could change them at some point, and we actively seeking for feedback and opinions on their usage and APIs.

Fermions and PyScf#

This modules contains operators for particle-number conserving fermionic operators as well as utility functions that are used to create hamiltonians directly from PyScf molecules.

Previously we also had the remaining Fermionic functionality in the experimental namespace, but in May 2024 it was stabilised and moved to the main netket namespace.

operator.ParticleNumberConservingFermioperator2nd

Particle-number conserving fermionc operator

operator.ParticleNumberAndSpinConservingFermioperator2nd

Particle-number conserving and spin-Z-conserving fermionc operator

operator.FermiHubbardJax

Fermi-Hubbard Hamiltonian based on the generic ParticleNumberAndSpinConservingFermioperator2nd

operator.from_pyscf_molecule

Construct a netket operator encoding the electronic hamiltonian of a pyscf molecule in a chosen orbital basis.

operator.pyscf.TV_from_pyscf_molecule

Computes the nuclear repulsion energy \(E_{nuc}\), and the T and V tensors encoding the 1-body and 2-body terms in the electronic hamiltonian of a pyscf molecule using the specified molecular orbitals.

Logging#

This module contains experimental loggers that can be used with the optimization drivers.

logging.HDF5Log

HDF5 Logger, that can be passed with keyword argument logger to Monte Carlo drivers in order to serialize the output data of the simulation.

Variational State Interface#

vqs.variables_from_file

Loads the variables of a variational state from a .mpack file.

vqs.variables_from_tar

Loads the variables of a variational state from the i-th element of a .tar archive.

Time Evolution Driver#

TDVP

Variational time evolution based on the time-dependent variational principle which, when used with Monte Carlo sampling via netket.vqs.MCState, is the time-dependent VMC (t-VMC) method.

driver.TDVPSchmitt

Variational time evolution based on the time-dependent variational principle which, when used with Monte Carlo sampling via netket.vqs.MCState, is the time-dependent VMC (t-VMC) method.

ODE Integrators#

Concrete solvers#

This is a collection of ODE solvers that can be used with the TDVP driver above.

dynamics.Euler

The canonical first-order forward Euler method.

dynamics.Heun

The second order Heun's method.

dynamics.Midpoint

The second order midpoint method.

dynamics.RK12

The second order Heun's method.

dynamics.RK23

2nd order adaptive solver with 3rd order error control, using the Bogacki–Shampine coefficients

dynamics.RK4

The canonical Runge-Kutta Order 4 method.

dynamics.RK45

Dormand-Prince's 5/4 Runge-Kutta method.

The corresponding integrator is then automatically constructed within the TDVP driver.

Abstract classes#

Those are the abstract classes you can inherit from to implement your own solver

dynamics.AbstractSolver

Abstract base class for ODE solvers.

dynamics.AbstractSolverState

Base class holding the state of a solver.

Observables#

This module contains various observables that can be computed starting from various variational states.

observable.Renyi2EntanglementEntropy

Rényi2 bipartite entanglement entropy of a state \(| \Psi \rangle\) between partitions A and B.

observable.VarianceObservable

Observable computing the variance of a quantum operator \(O\).