Warning, /epic-lfhcal-tbana/examples/yall/SETUP_TLDR.md is written in an unsupported language. File is not indexed.
0001 # BNL setup — TL;DR
0002
0003 ## New installation: start here
0004
0005 The easiest path is the installer below. It installs **yall-run**, gets the
0006 LFHCal review branch, installs `eic-shell`, builds LFHCal, and writes the small
0007 activation files used by the examples. It submits no jobs.
0008
0009 Run from the normal BNL **tcsh** login/submit shell:
0010
0011 ```tcsh
0012 mkdir -p "$HOME/lfhcal-yall-review"
0013 cd "$HOME/lfhcal-yall-review"
0014
0015 curl -fL https://raw.githubusercontent.com/paulnord/epic-lfhcal-tbana/yall-integration-upstream/tools/bootstrap-yall-integration.sh \
0016 -o bootstrap-yall-integration.sh
0017
0018 less bootstrap-yall-integration.sh
0019
0020 env LFHCAL_REPO_URL=https://github.com/paulnord/epic-lfhcal-tbana.git \
0021 LFHCAL_BRANCH=yall-integration-upstream \
0022 bash bootstrap-yall-integration.sh
0023 ```
0024
0025 Then:
0026
0027 ```tcsh
0028 source ./activate.tcsh
0029 ```
0030
0031 Raw input defaults to:
0032
0033 ```text
0034 /gpfs01/star/pwg/pnord/eic/2026TBdata/raw
0035 ```
0036
0037 and output goes under your personal scratch area.
0038
0039 Already have LFHCal installed using Fredi's instructions? **Do not install it
0040 again.** Use the separate [existing-installation instructions](EXISTING_INSTALL.md).
0041
0042 ## Small local test
0043
0044 From host tcsh:
0045
0046 ```tcsh
0047 cd "$LFHCAL_REPO/examples/yall/lfhcal-simple"
0048 source env.tcsh
0049
0050 foreach r (296 298 299 300 303 304)
0051 ls -lh "$LFHCAL_DATA/Run${r}.h2g"
0052 end
0053
0054 $EIC_SHELL
0055 ```
0056
0057 Inside **eic-shell (bash)**:
0058
0059 ```bash
0060 source ./env-eic.sh
0061 yall-run validate
0062 yall-run plan
0063
0064 C=$(yall-run create --campaigns-dir "$LFHCAL_WORK/campaigns" -j 1)
0065 yall-run start "$C"
0066 yall-run status "$C"
0067 exit
0068 ```
0069
0070 Expect **9 completed tasks**: six conversions and three pedestal extractions.
0071 Directory creation runs as a `%preflight` during `create`, so it does not consume
0072 a scheduler task. The test uses 1,000 events and does no MIP fitting.
0073
0074 ## Small Condor test
0075
0076 Back on the host:
0077
0078 ```tcsh
0079 cd "$YALL_RUN_REPO/examples/eic-shell"
0080 yall-run validate
0081 yall-run plan
0082
0083 set C = `yall-run create --campaigns-dir "$LFHCAL_WORK/campaigns"`
0084 yall-run start "$C"
0085 yall-run status "$C" -vv
0086 ```
0087
0088 When that succeeds, continue with `examples/yall/scan-set-1`.
0089
0090 Full explanations: [SETUP.md](SETUP.md).
