Linux Installation

This page will provide a walkthrough on installing MILK, MAUD, CINEMA, MYSTIC, and SPOTLIGHT on a Linux Ubuntu 22.04 jammy AMD machine.

Steps:

1. Download anaconda3 for Linux and run package to install

2. Download MAUD for Linux:

   • Go to https://github.com/luttero/maud/releases/tag/v2.999
   • Download MAUD for Linux, "Maud.tar.gz" and decompress the .gz file
   • Verify by running Maud.sh, it might take a short time to launch.

3. Download MILK from repository

   • Clone the repository: git clone https://github.com/lanl/MILK.git
   • Navigate to the local repository folder using terminal and run conda env create -f environments/environment_linux.yml
   • The current environment includes all dependencies required by related packages such as Spotlight
   • By editing environment_linux.yml, the name of the conda environment can be changed from the default "rietveld" to any other name.
   • Activate the environment: conda activate rietveld

Note: There have been issues with the conda solver hanging on linux. The solution is to use the provided lock file or mamba. We recommend mamba and to use it navigate to the base conda environment and run:

conda install -c conda-forge mamba
mamba env create -f environments/environment_linux.yml

4. Download Cinema-Debye_Scherrer from repository

   • Clone the repository: https://github.com/cinemascience/cinema_debye_scherrer

5. Link MAUD and Cinema to MILK

   • Use command milk-config /path/to/Maud -c /path/to/cinema
   • Cinema arguments -c /path/to/cinema are optional if it is not installed yet. When cinema is downloaded later, run the above full command again since MAUD path is required.
   • After running milk-config.py, run conda deactivate and then conda activate rietveld to allow config to take effect. Now typing $MAUD_PATH or $CINEMA_PATH should print out the correct path.