EIC Tutorial: Geometry Development with DD4hep: Setup

In advance of the training session, please ensure that

1. You have a GitHub account (sign up here)
2. Your GitHub account is a member of the EIC organization on GitHub
   • Email the EIC software conveners with your GitHub account to be added
3. You have singularity/apptainer or docker (on Mac) installed and working
   • module load singularity (on most JLab or BNL systems) (preferred option)
   • Local system options:
     • systems that use cvmfs or download images can install singularity or apptainer (see here)
     • systems that download images can install docker (see here)
   • you should at a minimum be able to run either of the following commands and open a shell:
     • singularity run docker://alpine
     • docker run --rm -it alpine
4. Download eic-shell:
   • Due to time and bandwidth limitations, this should be downloaded to your desired system before the live tutorial
   • From the system you use with singularity/apptainer or docker, make a folder called eic
   • From inside this directory:
     • Install by running the command:

       curl --location https://get.epic-eic.org | bash
       

     • or you can save the file at https://get.epic-eic.org as install.sh and run this script by hand:

       wget --output-document install.sh https://get.epic-eic.org
       bash install.sh
       

If you have completed the numbered steps above, then you are ready for the tutorial. Additional information and training links are below:

• Basic familiarity with Unix shell and Git
  • Software Carpentry Unix Shell training (recommended)
  • Software Carpentry Basic Git training (recommended)
• Basic familiarity with singularity and docker:
  • Software Carpentry Incubator Singularity training (optional)
  • HEP Software Foundation Docker training (optional)

title: Setup — In advance of the training session, please ensure that

• You have a GitHub account (sign up here)
• Your GitHub account is a member of the EIC organization on GitHub
  • Email the EICUG SWG conveners with your GitHub account to be added
• You have some basic familiarity with Unix shell and Git
  • Software Carpentry Unix Shell training (required)
  • Software Carpentry Basic Git training (recommended)
• You have singularity, apptainer, or docker (on Mac) installed and working
  • module load singularity (on most JLab or BNL systems)
  • you should at a minimum be able to run either of the following commands and open a shell:
    • singularity run docker://alpine
    • docker run --rm -it alpine
  • Software Carpentry Incubator Singularity training (optional)
  • HEP Software Foundation Docker training (optional)