The tutorial will take place in Room A015 (Building 100): in-person only
Pre-requisites for the EIC tutorial session:
-
Be familiar with C++ and root
-
Have root installed on your laptop
-
In advance of the training session, please ensure that you follow the steps below.
Ensure that:
1. You have singularity/apptainer or docker (on Mac) installed and working
-
On your local system:
-
Once installed and started up, you should at a minimum be able to run either of the following commands from a shell:
singularity run docker://alpine
docker run --rm -it alpine
Then type ‘exit’
2. Download eic-shell:
-
The EIC environment eic-shell is a singularity/docker container with a curated selection of software components. The standard EIC environment gives all users access to exactly the same environment that is used for benchmarks, productions, and continuous integration on the github and gitlab servers. The EIC standard environment is accessed with the eic-shell command. That will start an eic-shell session in the standard environment.
-
From the system you use with singularity/apptainer or docker, make a folder called eic
-
From inside this directory:
Install eic-shell by running the command:
curl --location https://get.epic-eic.org | bash
The install script will search for several components that are required depending on which operating system you are running (linux and mac are supported), and whether you have singularity/apptainer or docker installed (see prerequisites).
If you are on a system that requires downloading the full container (up to 13 GB), this may take a while and no progress bar is shown.
The install script will create a new file ./eic-shell which will start the eic-shell environment, i.e. the EIC standard environment.
Once installed, check that all is working but running the eic-shell:
./eic-shell
You should see a jug_dev> prompt, indicating that you are now inside the EIC standard environment.
One more point:
Graphical programs work just as well inside the eic-shell environment as outside, with the exception of docker on Mac where some additional work is needed. On a Mac it is therefore often easier to open ROOT files outside the container.
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 singularity and docker:
-
Software Carpentry Incubator Singularity training (optional)
- HEP Software Foundation Docker training (optional)
Windows:
The process for Windows is a little more complicated but still possible using wsl (The Windows subsystem for Linux). Please follow the instructions here:
Then when on wsl you should be able to load the docker container in the same way as suggested for linux above.
In order to open graphical windows through wsl you will need to run this through a program which handles this for you such as MobaXterm:
MobaXterm free Xserver and tabbed SSH client for Windows
