-
Notifications
You must be signed in to change notification settings - Fork 29
SIRF SuperBuild on Bash on Ubuntu on Windows 10
This manual explains how to install the SIRF-SuperBuild and its dependencies using a clean install of "Bash on Ubuntu on Windows" and run a simple MR and PET image reconstruction using Python.
These instructions refer to the manuel "SIRF SuperBuild Ubuntu 16.04", showing the additional steps, specific to Bash on Ubuntu on Windows.
If you use Windows 10 and do not want the hassle of running a virtual machine, "Bash on Ubuntu on Windows" or simply "Bash" could be a good option for you. It provides you a bash shell and a Linux environment and most Linux tools can be used, directly on Windows.
Nota bene: You could also run Windows executables directly on Bash.
You need to have at least the Windows 10 Anniversary Update (released in August 2016) and a 64-bit build of Windows.
Please follow the installation steps here.
Even though graphical applications are not natively supported on Bash, you can use an X server to tweak it.
Recommended one: https://sourceforge.net/projects/xming/.
Download and install. Default parameters are fine.
Run the following command in Bash:
export DISPLAY=:0
Basic GUI applications (ccmake-gui, gedit, ...) should work fine.
sudo apt-get update
sudo apt-get upgrade
Now you should be all set to install and run SIRF!
The installation steps are basically the same as on Ubuntu 16.04: See instructions here.
However, I strongly suggest you to use a Windows folder as the installation folder. To do so:
- Create an empty folder "devel" in a Windows emplacement, e.g. "Documents".
- Create "Documents" folder in Bash if it does not exist already.
mkdir ~/Documents
- Add a symbolic link in Bash
If your folder "devel" is located at "C:\Users<YourUsername>\Documents":
ln -s /mnt/c/Users/<YourUsername>/Documents/devel ~/Documents/devel
cd ~/Documents/devel
- Tadaa! It's ready!
You can continue the installation starting 1. Install Dependencies for SIRF.
- DO NOT attempt to modify Linux files in a Windows editor!
Do not try to access, modify or remove a file located on the Subsystem from Windows. If you attempts to do so you will leave your whole installation of Bash. You can access Windows files from the Subsystem only!
- Create your bash scripts directly on Windows!
You can download an text editor on Windows to create your bash files. I recommend using Notepad++ as it is very easy to use. You will have to use Unix line endings to be able to run a bash script, so modify the default format to Unix: Settings -> Preferences -> New Document -> Format (Line ending) -> Unix (You can also convert a file to Unix End Of Lines with Edit -> EOL Conversion -> Unix)
- Use files located in regular Windows folders and symbolic links in Bash
As it is very easy to access Windows folders and files from Bash (e.g. "C:\Users\Username\Desktop" is located at "/mnt/c/Users/Username/Desktop"), good practice would be to store as many files as you can in regular Windows emplacements and either run the commands in "/mnt/c/Where/Your/Files/Are" or, even easier, use symbolic links. In this way, you have all the data (input and output images/sinograms) directly accessible in Windows, so you can reprocess/visualise the data with your regular tools: ImageJ, Amide, Matlab etc.