Skip to content

User Installation and Uninstallation

There are essentially 3 components required for ASL Analysis using this software:

  • The graphical user interface (GUI) software itself (this program)
  • An ExploreASL version (compiled or from GitHub)
  • A MATLAB version (regular or MATLAB Runtime)

ℹ If there is considerable interest/requests for supporting the Dockerized version of ExploreASL, the feature can be added in the future.

GUI

Simple enough, head on over to the Releases page on the GitHub repository of this GUI and download the version of your preference. The latest version is recommended.

Windows

Installing on Windows

Windows user can simply run the ExploreASL-GUI-x.x.x Setup.exe installer. The application will automatically be installated in your AppData folder, a shortcut will be created on your desktop, and the application itself will auto-launch at the end.

Uninstalling on Windows

You can uninstall the application by going to Control Panel ➡ Programs ➡ Programs and Features and selecting ExploreASL-GUI from the list of installed programs. Click Uninstall and follow the prompts.

MacOS

Installing on MacOS

MacOS users can simply double click the ExploreASL-GUI-x.x.x.dmg file. They will be prompted with a small window showcasing a drag operation of the software into their Applications folder. Once this is done, the application should be lauchable from the Applications folder.

⚠ You may be prompted with a warning message:

"ExploreASL-GUI" cannot be oppened because the developer cannot be verified.

There will be no option to open the application. Cancel for now.

To clarify, this message appears because the software has not [yet] undergone the signing process for being able to host on the MacOS App Store. To allow the program to run, you will need to go to System Preferences ➡ Security & Privacy ➡ click on the General tab ➡ click the Open Anyway button that should be featured near the bottom right of the window panel.

The next time you launch the application and receive the same note as above, you should also see an Open option this time. When you click this, the application will launch.

Uninstalling on MacOS

You can simply drag the application from the Applications folder to the trash.

Linux

Installing on Linux

After downloading the exploreasl-gui-x.x.x.deb file, open a terminal, navigate to the directory where the file is located, and run the following command:

sudo apt install ./exploreasl-gui-x.x.x.deb

Where x.x.x is the version number of the software.

Wait for a second or two. The application should now be installed and lauchable by pressing the Super key (Windows key) and typing the start of the software's name.

ExploreASL-GUI_SuperKey You can also add the application to your dock by right clicking on the application icon and selecting Add to Favorites.

Uninstalling on Linux

You can uninstall the application by running the following command in a terminal:

sudo apt remove exploreasl-gui

ExploreASL

There are 2 versions of ExploreASL available:

  • From GitHub
  • Compiled

These will be referenced regularly within the GUI itself, so be sure to know which one you're using.

From GitHub

Getting the GitHub one is straight forward. Head on over to the ExploreASL repository and either use the git command line tool to clone the repository via command:

git clone https://github.com/ExploreASL/ExploreASL.git

Or download the repository as a ZIP file by clicking the green Code button and selecting Download ZIP.

ExploreASLGithub_WebPage

Compiled

Getting the compiled version is not as straight forward. You will need to contact the ExploreASL team and request a copy of the compiled version. Be sure to take note which MATLAB version was used to create this compiled package.

MATLAB

There are 2 versions of MATLAB available:

  • Regular
  • MATLAB Runtime

Regular MATLAB

This is a requirement if you are using the GitHub version of ExploreASL. You can download the latest version of MATLAB from the MathWorks website.

MATLAB Runtime

This is a requirement if you are using the compiled version of ExploreASL. You can download MATLAB Runtime from the MathWorks website. Be sure to download the version that matches the version of MATLAB that was used to compile the ExploreASL package.