Skip to content
Snippets Groups Projects
Commit 171b747e authored by Sylvester Joosten's avatar Sylvester Joosten
Browse files

Edited quickstart

parent f26716d7
No related branches found
No related tags found
No related merge requests found
Pipeline #10145 passed
...@@ -5,7 +5,7 @@ title: "Quick-start Guide" ...@@ -5,7 +5,7 @@ title: "Quick-start Guide"
## Prerequisites ## Prerequisites
The programmer is assumed to be familiar with We assume that you are somewhat familiar with:
- git and gitlab (https://eicweb.phy.anl.gov) - git and gitlab (https://eicweb.phy.anl.gov)
- working in the terminal over ssh - working in the terminal over ssh
- cmake, C++, python, and shell scripting - cmake, C++, python, and shell scripting
...@@ -15,8 +15,11 @@ This tutorial requires that [singularity](singularity) is installed ...@@ -15,8 +15,11 @@ This tutorial requires that [singularity](singularity) is installed
on the local system. on the local system.
Singularity can be [downloaded here](https://sylabs.io/guides/3.7/user-guide/quick_start.html) -- 3.7 being the Singularity can be [downloaded here](https://sylabs.io/guides/3.7/user-guide/quick_start.html) -- 3.7 being the
most recent version as of January 2021. most recent version as of January 2021.
*For an optimal experience, we strongly recommend you to use singularity 3 or later for this tutorial.
Use (very) old versions of singularity (e.g. 2.6.x) at your own risk!*
## The EIC Software Container ## The EIC Software Container (jug_xl)
### Step 1: Create a local directory that you want to work in, e.g., `~/eic` ### Step 1: Create a local directory that you want to work in, e.g., `~/eic`
```bash ```bash
...@@ -24,9 +27,9 @@ mkdir ~/eic ...@@ -24,9 +27,9 @@ mkdir ~/eic
cd ~/eic cd ~/eic
``` ```
### Step 2: Deploy the containerized environment and launc a shell ### Step 2: Deploy the containerized environment and launch a shell
Execute the following line in your tgerminal to setup your environment in your sandbox Execute the following line in your terminal to setup your environment in your sandbox
directory. This will install the latest stable container and place a script called directory. This will install the latest stable container and place a script called
`eic-shell` in the top-level directory. This script will load the environment for you. `eic-shell` in the top-level directory. This script will load the environment for you.
...@@ -61,12 +64,16 @@ Before moving on to part 1, let's generate the geometry in a root file: ...@@ -61,12 +64,16 @@ Before moving on to part 1, let's generate the geometry in a root file:
```bash ```bash
cd athena cd athena
source /opt/detector/setup.sh
dd_web_display --export athena.xml dd_web_display --export athena.xml
``` ```
This will generate the file `detector_geometry.root`, which you should copy to your local machine. This will generate the file `detector_geometry.root`, which you should copy to your local machine.
Then open the [web viewer](https://eic.phy.anl.gov/geoviewer/), click on the `...` and open the local root file. Then open the [web viewer](https://eic.phy.anl.gov/geoviewer/), click on the `...` and open the local root file.
(Note, the `source /opt/detector/setup.sh` command adds the Athena detector plugins that ship
with the jug_xl container to your environment.)
Or if you want to skip this just Or if you want to skip this just
[click here to view the latest detector](https://eic.phy.anl.gov/geoviewer/index.htm?file=https://eicweb.phy.anl.gov/api/v4/projects/473/jobs/artifacts/master/raw/geo/detector_geo_full.root?job=report&item=default;1&opt=clipxyz;transp30;zoom75;ROTY290;ROTZ350;trz0;trr0;ctrl;all&). [click here to view the latest detector](https://eic.phy.anl.gov/geoviewer/index.htm?file=https://eicweb.phy.anl.gov/api/v4/projects/473/jobs/artifacts/master/raw/geo/detector_geo_full.root?job=report&item=default;1&opt=clipxyz;transp30;zoom75;ROTY290;ROTZ350;trz0;trr0;ctrl;all&).
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment