Wiki¶

To run PARTONS on the farm we need to do is to create a singularity container, follow these steps

• Set the environment and load the appropriate modules
  source /site/env/syscshrc
  module load singularity/3.9.5

• Build the container:
  singularity build --sandbox partons_singularity docker://partons/partons

• The previous command with create a new folder called "partons_singularity". To run the container do:
  singularity shell --writable partons_singularity

• Now your terminal has changed. You can find PARTONS' folders in /root/workspace/

• For instance, to run an example inside the container you can do:
  cd /root/workspace/partons-example/
  ./bin/PARTONS_example data/examples/gpd/computeSingleKinematicsForGPD.xml

• To run partons using a .xml outside the container (I am using computeSingleKinematicsForGPD.xml), we need to bind the folder on host to a folder on the container.
  1. I create a folder where the xml files are going to be linked on the container.
  mkdir partons_singularity/root/workspace/partons-example/input

  2. Create a script with the commands to run. I call it "order". The content of my file named "order" is:
  cd /root/workspace/partons-example/
  ./bin/PARTONS_example "path_to_xml_file"

  The script will change working directory on the container and will execute PARTONS.
  This script has to be located in your home directory (or any other mounted location) and you need to give permissions using chmod 755 ~/order

  3. Then, execute PARTONS binding the folder containing the .xml file (on host) to the folder you have have just created:
  singularity exec --writable --bind ./input/:/root/workspace/partons-example/input/ partons_singularity/ ./order

  where the "path_to_xml_file" will be "input/computeSingleKinematicsForGPD.xml"

  For completeness, notice that the "order" file contains the following lines:
  cd /root/workspace/partons-example/
  ./bin/PARTONS_example input/computeSingleKinematicsForGPD.xml

If you need to re-build the container and get the error "no space left on device", you just need to delete the folder .apptainer in your home directory

Some important links
https://partons.cea.fr
https://docs.sylabs.io/guides/3.0/user-guide/build_a_container.html
https://docs.sylabs.io/guides/2.6/user-guide/singularity_and_docker.html
https://singularity-tutorial.github.io/02-basic-usage/