Mac Installation

This page will provide a walkthrough on installing MILK, MAUD, CINEMA, MYSTIC, and SPOTLIGHT on a MacOS machine.

Steps:

1. Download anaconda3 for MacOS and run package to install

2. Download MAUD for MacOS:

   • Go to https://github.com/luttero/maud/releases/tag/v2.999
   • Download MAUD for your system (intel or AMD) and decompress the .gz file into Maud.dmg
   • Copy Maud.dmg into /Applications (requires admin access)
   • Verify by running Maud, 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_mac.yml
   • The current environment includes all dependencies required by related packages such as Spotlight
   • By editing environment.yml, the name of the conda environment can be changed from the default "rietveld" to any other name.
   • Activate the environment: conda activate rietveld

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 /Applications/Maud.app -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, 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.

Troubleshooting:

1. If when attempting to launch Maud, it returns error "Unable to load Java Runtime Environment", download Maud 10.15 version instead.