Quickstart

Pre-requisites:

  • A Linux/Unix based OS

  • A Fortran compiler (preferably gfortran),

  • A Fortran-OpenMP installation

  • A HDF5 serial installation

  • A Python installation (if you want to use the pre-written post-processing scripts)

Now one can clone the GitHub repository to use the code.

git clone https://github.com/vicky1997/mcdust.git

First run

  1. Make the /setups/default setup. The make should be run in the main mcdust directory.

    make SETUP_FILE=default

  2. Set the number of threads for OpenMP parallelisation.

    export OMP_NUM_THREADS=$OMP_NUM_THREADS

  3. Run the code
    ./default setups/default/setup.par
  4. To clear and start afresh

    make clean SETUP_FILE=default

Restart

To (re)start the simulation from a specific snapshot, follow the steps.

  1. Copy the snapshot of your choice to the setup directory from where you want to restart

    cp your/data/directory/foo.h5 setups/restartrun/

  2. Rename the file to restart.h5

    mv foo.h5 restart.h5

  3. Uncomment the CFLAGS+=-D RESTART``flag by removing the `# in front of it.

Unit tests

  1. To run the unit tests module which is in unit_tests/testsuite.F90

    make test SETUP_FILE=tests

    ./test1 setups/tests/setup.par

  2. To clear the run

    make cleantest SETUP_FILE=tests