Quantum-walk-project

This project aims to simulate the ground state of a quantum system within a 1D lattice using random walk.

Build

Dependencies: - python3 - python3-venv

Optional dependencies: - just

To build the project, run either of the following commands:

bash just build

or

bash ./run -b

Run

To run the project, execute the following command:

bash just run{int} [options] or bash ./run -r {int} -- [options]

The options are:

For simulation 1: ``` usage: walkv1 [-h] [-nu NUMWALKERSUPPER] [-nl NUMWALKERSLOWER] [-ns NUMWALKERSSTEP] [-ju J_UPPER] [-jl J_LOWER] [-js J_STEP] [-mu MAXSTEPSUPPER] [-ml MAXSTEPSLOWER] [-ms MAXSTEPSSTEP] [-s SEED] [-t THREADS] [-o OUTPUT] [-r RUNS] [-a] [-ar ANALYSE_RUNS] [-p] [-sd SAVE_DIR] [-pb] [-v]

Quantum Walker Simulation

options: -h, --help show this help message and exit -s, --seed SEED Seed for RNG. If 0, seed is random. NOTE: With seed, process is not multithreaded (default: 0) -t, --threads THREADS Number of threads to use. If 0, use all available threads (default: 0) -o, --output OUTPUT Output file name (default: None) -r, --runs RUNS Number of times to run the simulation (default: 5) -a, --analyse Narrow down parameters automatically (default: False) -ar, --analyseruns ANALYSERUNS Number of runs to analyse (default: 100) -p, --plot Plot the results (default: False) -sd, --savedir SAVEDIR Directory to save plots (default: None) -pb, --progressbar Display progress bar (default: False) -v, --version show program's version number and exit

Walker Parameters: -nu, --numwalkersupper NUMWALKERSUPPER Maximum number of random walks (default: 100) -nl, --numwalkerslower NUMWALKERSLOWER Minimum number of random walks (default: 100) -ns, --numwalkersstep NUMWALKERSSTEP Step size for number of random walks (default: 100)

Lattice Parameters: -ju, --jupper JUPPER Maximum lattice size J (boundary at ±J) (default: 10) -jl, --jlower JLOWER Minimum lattice size J (boundary at ±J) (default: 10) -js, --jstep JSTEP Step size for lattice size (default: 2)

Step Parameters: -mu, --maxstepsupper MAXSTEPSUPPER Maximum number of steps per walk (default: 10000) -ml, --maxstepslower MAXSTEPSLOWER Minimum number of steps per walk (default: 100) -ms, --maxstepsstep MAXSTEPSSTEP Step size for number of steps per walk (default: 100) ```

For simulation 2: ``` usage: walkv2 [-h] [-hx HX] [-nw NUM_WALKERS] [-ms MAX_STEPS] [-p] [-mt MAX_TAU] [-pot POTENTIAL] [-a] [-v]

Quantum Walker Simulation (v2)

options: -h, --help show this help message and exit -hx, --hx HX Step size in x direction (default: 0.25) -nw, --numwalkers NUMWALKERS Number of walkers (default: 10000) -ms, --maxsteps MAXSTEPS Maximum number of steps per walk 80 (default: 96) -p, --plot Plot the results (default: False) -mt, --maxtau MAXTAU Maximum of tau (auto-calculates and overrides maxsteps) (default: None) -pot, --potential POTENTIAL Potential type: 1=0.5x^2, 2=x (default: 1) -a, --auto_analyze Automatically analyze optimal parameters (default: False) -v, --version show program's version number and exit ```

For simulation 3: ``` usage: walkv3 [-h] [-n0 N0] [-ms MAXSTEPS] [-hx HX] [-w0 W0] [-ss SAVESTEPS [SAVE_STEPS ...]] [-p] [-sd SAVE_DIR] [-e EQUILIBRATION]

options: -h, --help show this help message and exit -n0, --n0 N0 Initial number of walkers (default: 50) -ms, --maxsteps MAXSTEPS Number of Monte Carlo steps (default: 50000) -hx, --hx HX Step length (default: 0.1) -w0, --w0 W0 Initial distribution width (default: 1.0) -ss, --savesteps SAVESTEPS [SAVESTEPS ...] Steps at which to save histograms (default: [500, 50000]) -p, --plot Plot results (default: False) -sd, --savedir SAVEDIR Save plots to dir (default: None) -e, --equilibration EQUILIBRATION Number of steps to discard (default: 1000) ```

Clean

To clean the project, deleting the venv and target build directories, run either of the following commands:

bash just clean or bash ./run -c