Installation#
There are several options for installing:
Installing with Windows installer - Simplest method on Windows
Installing with Mamba/Conda- Linux or Windows. Most flexible. Does not need admin access.
Using Mantid Imaging on IDAaaS - For ISIS users
For installation from source see the Developer Guide
Requirements#
- Operating system
Linux. Tested on Ubuntu 18.04, 20.04, 22.04 and Rocky 8
Windows. Tested on Windows 10
- GPU
A CUDA capable GPU is required for some operations. CPU alternatives are provided, so it is possible to perform a tomographic reconstruction on a system without a GPU.
- RAM
A large amount of RAM is needed to hold a dataset in memory. A 2k x 2k resolution with 1k projections held as 32 bit floats uses 16 GB of RAM. To perform safe (undoable) operations the requirement is doubled. Requirements scale with increased resolution, projection counts and bit depth.
Installing with Windows installer#
The installer can be downloaded from the releases page. For example MantidImagingSetup_2.5.0.exe
.
Once downloaded, double click the setup file to run the installer. The installer is not currently signed so you may need to click to allow it to run.
Select a directory to install to e.g. c:Program FilesMantid Imaging
and click Install.
Once Mantid Imaging is installed it will show in the start menu.
Uninstalling#
If Mantid Imaging has been installed using the Windows Installer, then it can be removed by right clicking the entry in the start menu and selecting Uninstall
.
Installing with Mamba/Conda#
Mantid Imaging can be installed using the packages published to Anaconda Cloud, this can be done with an existing Conda or Mamba distribution if you already have one on your machine. However if you have issues you may find it worth installing a fresh Miniforge3.
Download and install CUDA Runtime version 10.2 - https://developer.nvidia.com/cuda-10.2-download-archive before installing the Mantid Imaging environment.
Download and install Miniforge3 (this is the conda distribution that we recommend).
Make sure
mamba
orconda
is available on your PATH. The steps below assume you are using mamba.Create a mantidimaging conda environment:
mamba env create -f https://raw.githubusercontent.com/mantidproject/mantidimaging/stable/environment.yml
(Specific versions can be installed by using the release url, e.g. https://raw.githubusercontent.com/mantidproject/mantidimaging/release-2.2.0/environment.yml)
This creates an environment called
mantidimaging
that you can activate viamamba activate mantidimaging
This step is required for Linux users only. To ensure that MantidImaging can make full use of the memory available on your Linux machine, we need to set the shared memory size to an appropriate value. Please follow the steps below to do this:
Open the etc/fstab file on your computer. You can do this by opening a terminal and running this command (with sudo if needed to allow you to edit the file):
gedit /etc/fstab
In the open fstab file, try to locate a line like this one:
none /dev/shm tmpfs defaults,size=4G 0 0
.If the line exists:
Modify the text after
size=
to replace withsize=90%
. After you have made the change, the line should look like this:none /dev/shm tmpfs defaults,size=90% 0 0
Save your changes and exit the text editor.
In a terminal, run this command (with sudo if needed):
mount -o remount /dev/shm
If the line does NOT exist:
At the end of the file, add this line:
none /dev/shm tmpfs defaults,size=90% 0 0
Save your changes and exit the text editor.
In a terminal, run this command (with sudo if needed):
mount /dev/shm
[Optional] If you wish to run
mantidimaging-ipython
, you will need to haveipython
installed. This can be done with the commandmamba install ipython
.
Running the package#
Activate the environment created in the installation step:
mamba activate mantidimaging
Run using one of the following commands:
GUI:
mantidimaging
IPython:
mantidimaging-ipython
Nightly version#
The latest nightly version can be installed with:
mamba env create -f https://raw.githubusercontent.com/mantidproject/mantidimaging/main/environment.yml
This will make a mantidimaging-nightly environment.
Updating#
To update to the latest version of Mantid Imaging run:
mamba env update -n mantidimaging -f https://raw.githubusercontent.com/mantidproject/mantidimaging/stable/environment.yml
If you see any issues with package compatibility, the fastest solution is reinstalling the environment - see below.
Reinstalling the environment#
To completely delete the Mantid Imaging environment follow these steps:
mamba deactivate
to exit out of the conda Mantid Imaging environment
mamba env list
to see which environments you have installed
mamba env remove -n mantidimaging
and press
y
to confirm. Replace mantidimaging with any other environment you wish to remove
Follow steps 4 and 5 from Installing with Mamba/Conda.
Using Mantid Imaging on IDAaaS#
If you are an ISIS user then you may have access to the ISIS Data Analysis as a Service (IDAaaS) system.
Mantid Imaging is preinstalled in the IMAT Tomography workspaces.
It can be launched from the menu Applications > Software > Manntid Imaging
.