Running Cosmolike projects

In this tutorial, we assume the user installed Cocoa via the Conda installation method, and the name of the Conda environment is cocoa. We also presume the user's terminal is in the folder where Cocoa was cloned.

Step 1️⃣: activate the cocoa Conda environment, go to the cocoa/Cocoa/projects folder, and clone the Cosmolike DES-Y3 project:

  conda activate cocoa

and

  cd ./cocoa/Cocoa/projects

and

  ${CONDA_PREFIX}/bin/git clone --depth 1 https://github.com/CosmoLike/cocoa_lsst_y1.git --branch v4.0-beta15 des_y3 

⚠️ Cocoa scripts and YAML files assume the removal of the cocoa_ prefix when cloning the repository.

⁉️ Cocoa developers should drop the shallow clone option --depth 1; they should also authenticate to GitHub via SSH keys:

   git clone git@github.com:CosmoLike/cocoa_des_y3.git des_y3

By convention, the Cosmolike Organization hosts a Cobaya-Cosmolike project named XXX at CosmoLike/cocoa_XXX. However, our scripts and YAML files assume the removal of the cocoa_ prefix when cloning the repository.

Step 2️⃣: Go back to the Cocoa main folder, and activate the private python environment

  cd ../

and

  source start_cocoa.sh

⚠️ Remember to run the start_cocoa.sh shell script only after cloning the project repository (or if you already in the (.local) environment, run start_cocoa.sh again).

Step 3️⃣: compile the project

    source ./projects/des_y3/scripts/compile_des_y3

Step 4️⃣: select the number of OpenMP cores (below, we set it to 4), and run a template YAML file

  export OMP_PROC_BIND=close; export OMP_NUM_THREADS=8

One model evaluation:

    $(cocoa)(.local) mpirun -n 1 --oversubscribe --mca btl vader,tcp,self --bind-to core:overload-allowed --rank-by core --map-by numa:pe=${OMP_NUM_THREADS} cobaya-run ./projects/des_y3/EXAMPLE_EVALUATE1.yaml -f

MCMC:

    $(cocoa)(.local) mpirun -n 4 --oversubscribe --mca btl vader,tcp,self --bind-to core:overload-allowed --rank-by core --map-by numa:pe=${OMP_NUM_THREADS} cobaya-run ./projects/des_y3/EXAMPLE_MCMC1.yaml -f

Deleting Cosmolike projects

Do not delete the lsst_y1 folder from the project folder without first running the shell script stop_cocoa.sh. Otherwise, Cocoa will have ill-defined soft links.

⁉️ Where the ill-defined soft links will be located?

 Cocoa/cobaya/cobaya/likelihoods/
 Cocoa/external_modules/code/
 Cocoa/external_modules/data/ 

⁉️ Why does Cocoa behave like this? The shell script start_cocoa.sh creates symbolic links so Cobaya can see the likelihood and data files. Cocoa also adds the Cobaya-Cosmolike interface of all cosmolike-related projects to the LD_LIBRARY_PATH and PYTHONPATH environmental variables.