Warning, /snippets/FullChainBnlFarmScript/README.md is written in an unsupported language. File is not indexed.
0001 # Instructions to use for BNL HTCondor farm:
0002
0003 1. Login to eic node
0004 2. Run this command with different parameters (it will use default if not specified)
0005 ```bash
0006 MOMENTUM=3 ./run_submit.sh
0007 ```
0008 3. You could modify DEFAULT parameters inside the script.
0009 4. Example in loop:
0010 ``` bash
0011 momenta=(1 2 5)
0012 for mom in "${momenta[@]}"; do
0013 export MOMENTUM=$mom
0014 ./run.sh
0015 done
0016 ```
0017 5. This will set everything for you, including `eic-shell`, `epic` repository and `eicrecon`.
0018 And run in batch mode full chain:
0019 ```bash
0020 ddsim SIMFILE
0021 eicrecon RECOFILE
0022 root -l -n yourMacro.C (RECOFILE, ANAFILE)
0023 ```
0024 6. There is a possibility to wait for jobs using another script `condor_control.sh` which monitors your batch jobs and continues when everything is finished( e.g. you could merge output root analized files which contain your own trees/histograms)
0025
0026 7. The script is a bit long (~400 lines) yet it does fully automated procedure in single file.
0027
0028
0029
0030 * * *
0031 EPIC Analysis Workflow: Simulation → Reconstruction → Analysis
0032 ================================================================
0033 Overview
0034 -----------
0035
0036 Three-step workflow for EPIC analysis:
0037
0038 1. **Simulate**: Use `ddsim` or `npsim` to generate simulated events.
0039
0040 2. **Reconstruct**: Process simulated data with `EICRecon`.
0041
0042 3. **Analyze**: Run your custom **ROOT macros** for physics analysis.
0043
0044 * * *
0045 Getting Started
0046 ------------------
0047
0048 * [EPIC Get Started](https://eic.github.io/documentation/getstarted.html)
0049
0050 * [EIC Tutorials Overview](https://eic.github.io/documentation/tutorials.html)
0051
0052 * [SSH Guide for STAR/EIC - password-less authorization](https://star-juniors.github.io/software/ssh/)
0053
0054 * * *
0055
0056 Step 1: **Simulation**
0057 -------------------------
0058
0059 * [eic/epic](https://github.com/eic/epic) — detector geometry, compact files, configurations
0060 ### Tools: `ddsim` / `npsim` with Geant4
0061
0062 * [Single Particle Simulation Tutorial](https://eic.github.io/tutorial-simulations-using-ddsim-and-geant4/01-single-particle-simulations/index.html)
0063
0064 * [DD4hep Manual](https://dd4hep.web.cern.ch/dd4hep/usermanuals/DD4hepManual/DD4hepManual.pdf)
0065
0066 * * *
0067
0068 Step 2: **Reconstruction**
0069 -----------------------------
0070
0071 ### Tool: `EICRecon`
0072
0073 * [EICRecon GitHub Repository](https://github.com/eic/EICrecon)
0074
0075
0076 ### Parameter Configuration (nHcal example file)
0077
0078 * [`EICRecon/src/detectors/EHCAL/EHCAL.cc`](https://github.com/eic/EICrecon/blob/main/src/detectors/EHCAL/EHCAL.cc) — example of parameter tuning for reconstruction (clustering parameters)
0079
0080 * * *
0081
0082 Step 3: **Analysis**
0083 -----------------------
0084
0085 ### Tool: Custom ROOT Macros
0086
0087 Once you have reconstructed output, analyze it using your own ROOT-based analysis scripts.
0088
0089 * * *
0090
0091 My Workflow at BNL SDCC ssh:
0092 -----------------------
0093
0094 I use SSH connection via [`VS Code`](https://star-juniors.github.io/software/vscode.html) which setups the whole environment as you are working on your own laptop. See the picture.
0095
0096 - [SSH Guide for STAR/EIC - password-less authorization](https://star-juniors.github.io/software/ssh/)
0097 - [Tunnel guide](https://star-juniors.github.io/software/vs-code-tunnel.html)
0098 - And one can you use [`tmux`](https://pragmaticpineapple.com/gentle-guide-to-get-started-with-tmux/) for detaching process from SSH connection to be run in background while you are disconnected from SSH.
0099
0100 
