Windows Instructions

(Tested on Windows 11)

Install Windows Subsystem for Linux (WSL)

  • Follow this guide to setup Ubuntu 22.04: LINK
  • If you run into issues, try the following:
    • Enable bash for Windows LINK
    • Enable virtualization LINK. For instance, here are instructions specific for a Dell Precision 7760: LINK1 LINK2 (make sure to check "Hyper-V")

To launch WSL, we recommend launching it from the Microsoft Store as opposed to the Programs Menu or the terminal, otherwise Windows' PATH will not be passed onto WSL.

Set up Environment

Once inside WSL, do the following

  • Install system-level packages:
    sudo apt-get update
    sudo apt-get install cmake g++ mpich
  • Install python packages:
    sudo apt-get install python3-pip python3-tk
    pip3 install matplotlib mpmath scipy --user
  • Create a folder where to install programs
    mkdir ~/Programs
    cd ~/Programs

Install Julia

Still inside WSL,

  • Download Julia:
    wget -O julia.tar.gz "https://julialang-s3.julialang.org/bin/linux/x64/1.10/julia-1.10.2-linux-x86_64.tar.gz"
  • Decompress Julia:
    tar -xvf julia.tar.gz -C ~/Programs/
  • Add Julia to user-level path:
    sudo ln -s ~/Programs/julia-1.10.2/bin/julia /usr/local/bin/

Install ParaView

  • Donwload and install ParaView v5.9.1
  • Identify the location of paraview.exe (most likely, this is C:\Program Files\ParaView 5.9.1\bin\)
  • Add the path of ParaView (e.g., C:\Program Files\ParaView 5.9.1\bin\) to the system-level PATH: LINK
  • Create a paraview alias inside WSL typing this in the WSL terminal:
    which paraview.exe | xargs -I{} sudo ln -s {} /usr/local/bin/paraview
ParaView 5.10+ on Windows

ParaView versions 5.10 and newer on Windows cannot open XDMF files (like the particle field) from the WSL file system. Please copy them to a Windows file system or use Paraview 5.9.1.


Now you can proceed with the general instructions (you can skip the Julia and ParaView instructions since we already took care of that)