Installation on MacOs

This page provides instructions to install the DRAGON/DONJON distribution on a brand new Mac computer. All proposed downloads are free, althought some packages are Apple proprietary. This tutorial is released under the GNU Lesser General Public License.

Both Version4 and Version5 distributions can be installed using these instructions. However, OSX 10.15 (Catalina) and beyong are pure 64-bit operating systems. Consequently, only the Version5 distribution can be installed on these systems.

Installation steps:

• Perform a Software Update check (from the apple menu).

• Start the App Store application and downloads the Xcode package.

• Go to the "Open Developer Tool/More Developer Tools..." pane of Xcode menu, log in your Apple Developer account and install the command line tools.

  

  As an alternative, you may install the command line tools using the Terminal application by running the following command:

  xcode-select --install

• Install the X11 package from XQuartz website. X11 is useful to communicate with other Linux or Unix workstations on your network or at remote locations.

• Install the gfortran compiler using Homebrew:

  brew install gfortran

• Install optional packages using Homebrew. These packages are not required if you plan to simply execute Version4 or Version5 components on your Mac, but may be useful for doing professional work.

  brew install hdf5 brew install ghostscript brew install libomp brew install python-matplotlib

• Install an optional editor. One recommendation is the nedit editor from Fink website. nedit is a basic editor that exist on most Linux or Unix workstations. It can be used remotely without requiring high bandwidth. Another option is the Sublime Text editor from this website. Its basic configuration is explained in this tutorial.

• Install MacOS application TexShop from this website. This application is now mandatory to display PostScript (ps or eps) information or to typeset the documentation. Package ghostscript should be installed before TeXShop.

• Download the Version4 or Version5 package from Merlin website. Read carefully the readme file and follow the instructions.

• Add environment variables in the .profile or .zprofile script. If you don't activate HDF5 file support and/or python3 bindings, you don't need to make these modifications. Double check the version numbers in these lines. For example, on the Catalina OS, include the following lines:

  # Support for HDF5 export HDF5_INC="/usr/local/Cellar/hdf5/1.12.2_2/include" # HDF5 include directory export HDF5_API="/usr/local/Cellar/hdf5/1.12.2_2/lib" # HDF5 C API # Support for Python3 export FORTRANPATH=/usr/local/lib/gcc/12/ # directory with libgfortran.a

DRAGON/DONJON software is owned by: École Polytechnique de Montréal
For more information contact: Alain Hébert