iSALE on Windows (using WSL and Ubuntu) - isale-code/isale-wiki GitHub Wiki
Installation instructions for Windows Subsystem for Linux
First, install Windows Subsystem for Linux (WSL). This can be done from the Microsoft Store (recommended), or in Powershell:
wsl --install
For further details, see: https://ubuntu.com/tutorials/install-ubuntu-on-wsl2-on-windows-11-with-gui-support#1-overview
Installation instructions for Ubuntu on WSL
WSL supports a variety of Linux distributions. In the Microsoft Store, a variety of Ubuntu versions are available. The version labelled "Ubuntu" is the latest stable version (at time of writing Ubuntu 22.04.2 - this version was tested). Download and install Ubuntu.
Ubuntu can also be installed from Powershell, see: https://ubuntu.com/tutorials/install-ubuntu-on-wsl2-on-windows-11-with-gui-support#3-download-ubuntu
Troubleshooting WSL and Ubuntu installation
WslRegisterDistribution Failed With Error: 0x80070032?
First, Check that WSL is enabled using Turn Windows features on or off.
- Press Windows Key.
- Type “Turn Windows Features on or off”.
- Now click the application to open it.
- In the “Windows Features” windows, locate “Windows Subsystem for Linux” and check the box next to it to enable it.
Second, check that Virtual Machine is enabled using Turn Windows features on or off.
- Press the Windows Start button.
- Type “Turn Windows Features”.
- Click on the “Turn Windows Features” on or off application to open it.
- Now, locate “Virtual Machine Platform” and check the box next to it. This will enable it.
- Click Ok.
Installing iSALE
First, install pre-requisites for iSALE (this installation guide is for the Python 3 version of iSALE-Dellen):
sudo apt-get install build-essential gfortran g++
Second, install pre-requisites for pySALEPlot visualisation software. You can either install these with apt-get
:
sudo apt-get install libpng-dev python3 python3-numpy python3-scipy python3-matplotlib python3-future
Or, you can create a conda
environment, and install them in there using conda
or pip
. For example:
conda create -n iSALE python=3.11
conda activate iSALE
pip install -r requirements.txt
Note you will need to configure --with-pysaleplot
to use pySALEPlot.
After installing these packages you are ready to download and install iSALE-Dellen
Troubleshooting iSALE installation
In the majority of instances, I have found that installation fails during:
make
while configuring the gnuTzip library. This is due to missing libraries rpc/rpc.h and others.
However, the required libraries are available within ntirpc. First install ntirpc:
sudo apt-get install libntirpc-dev
Then, specify the location of ntirpc in your C-path in the "make" command, i.e.:
C_INCLUDE_PATH=/usr/include/ntirpc:$C_INCLUDE_PATH make
Then complete the install with:
make install