\( \usepackage{euler} % must be loaded before fontspec for the whole doc (below); this must be kept for pngmath, however \usepackage{hyperref} \usepackage{amsmath} \usepackage{amsbsy} %\usepackage{mathabx} \usepackage{underscore} \usepackage[all]{xy} % Metadata of the pdf output \hypersetup{pdftitle={Yade Documentation}} \hypersetup{pdfauthor={Smilauer, V., et al.}} \hypersetup{pdfkeywords={Discrete element method, granular materials, contact law, hydromechanical coupling}} % symbols \renewcommand{\mat}{\boldsymbol} \renewcommand{\vec}{\boldsymbol} \renewcommand{\tens}{\boldsymbol} %normalized and locfram here \def\normalized#1{\widehat{#1}} \def\locframe#1{\widetilde{#1}} % timestep \def\Dt{\Delta t} \def\Dtcr{\Dt_{\rm cr}} % algorithm complexity \def\bigO#1{{\mathcal{O}(#1)}} % variants for greek symbols \let\epsilon\varepsilon \let\theta\vartheta \let\phi\varphi % shorthands \let\sig\sigma \let\eps\epsilon % variables at different points of time \def\prev#1{#1^-} \def\pprev#1{#1^\ominus} \def\curr#1{#1^{\circ}} \def\nnext#1{#1^\oplus} \def\next#1{#1^+} % shorthands for geometry \def\currn{\curr{\vec{n}}} \def\currC{\curr{\vec{C}}} \def\uT{\vec{u}_T} \def\curruT{\curr{\vec{u}}_T} \def\prevuT{\prev{\vec{u}}_T} \def\currn{\curr{\vec{n}}} \def\prevn{\prev{\vec{n}}} % motion \def\pprevvel{\pprev{\dot{\vec{u}}}} \def\nnextvel{\nnext{\dot{\vec{u}}}} \def\curraccel{\curr{\ddot{\vec{u}}}} \def\prevpos{\prev{\vec{u}}} \def\currpos{\curr{\vec{u}}} \def\nextpos{\next{\vec{u}}} \def\curraaccel{\curr{\dot{\vec{\omega}}}} \def\pprevangvel{\pprev{\vec{\omega}}} \def\nnextangvel{\nnext{\vec{\omega}}} \def\loccurr#1{\curr{\locframe{#1}}} \def\numCPU{n_{\rm cpu}} \DeclareMathOperator{\Align}{Align} \DeclareMathOperator{\sign}{sgn} % sorting algorithms \def\isleq#1{\currelem{#1}\ar@/^/[ll]^{\leq}} \def\isnleq#1{\currelem{#1}\ar@/^/[ll]^{\not\leq}} \def\currelem#1{\fbox{$#1$}} \def\sortSep{||} \def\sortInv{\hbox{\phantom{||}}} \def\sortlines#1{\xymatrix@=3pt{#1}} \def\crossBound{||\mkern-18mu<} \)

# Installing Yade (for Windows and Mac users)

In preparation for the THM short-course, we ask the participants to have a Linux Debian distribution installed on their laptop prior to arrival.

If you already have a debian distribution on your laptop, please follow the installation instructions on our website.

If you do not have a debian distribution on your laptop, you have three ways to get one:

## Easiest way - Use our premade Virtual Machine (Windows)

We created a full debian machine preloaded with Yade + Paraview + Kate. You can install this easily with the following steps:

1. Download and install VirtualBox for your OS.

2. Download this yade_machine.ova file (this step may take a few minutes, so please be patient. The file is 6 gb.)

3. Open VirtualBox and click “Tools>Import”

4. Locate the ‘yade_machine.ova’ file that you downloaded, and click “Next”

5. Edit the system properties to suit your needs. Set the CPU count to half of your laptop CPUs and the RAM to half of your total laptop RAM.

6. Click “Import” on bottom right.

7. Start the machine and it should bring you into the Ubuntu desktop where you can open a new terminal (Ctrl-alt-T) and type

    yadedaily --version

To test that yade is already installed and ready to go.

Login details (feel free to change these as soon as you are into your new VM): user: yadeuser password: yadeuser

## Less easy way - Create your own Virtual Machine (MacOS)

This is if the direction above do not work for you. The end result is the same.

1. Download and install VirtualBox for your OS

2. Download the Ubuntu 20.04 image

3. Open VirtualBox and select “Machine>New…”

4. Select “Type” as “Linux” and “Version” as “Ubuntu (64-bit)” (If you do not see Ubuntu 64-bit, contact me directly for assistance).

5. Select at least 4gb of ram (preferably 8gb), Select “Create a virtual hard disk now”

6. Name the machine and then click “Create”

7. Choose 20-30gb of storage, leave the remaining options as default.

8. Click “create”

9. Click “Start” and then find the Ubuntu 20.04 .iso that you downloaded from Step 2.

10. Follow the installation instructions (this will take some time depending on your HDD speed)

11. Once Ubuntu is fully installed and you are inside the machine, go ahead and install yade by opening a terminal (Ctrl-alt-T to open a new terminal).

    sudo bash -c 'echo "deb http://www.yade-dem.org/packages/ focal main" >> /etc/apt/sources.list.d/yadedaily.list'
    wget -O - http://www.yade-dem.org/packages/yadedev_pub.gpg | sudo tee /etc/apt/trusted.gpg.d/yadedaily.asc
    sudo apt-get update
    sudo apt-get install yadedaily

1. Download and install Paraview.

You are all set!

## Hard way - Dual Boot (MacOS or Windows)

Find instructions here