From d70c97869c74697b4866f2fc4b95feba9b7e7987 Mon Sep 17 00:00:00 2001 From: Shivesh Mandalia Date: Sat, 29 Feb 2020 19:08:42 +0000 Subject: add instructions on how to run, and some information about the beam test --- README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 04bd4e5..fc96e1f 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,10 @@ Test Beam Facility](https://ftbf.fnal.gov/) (FTBF). ![G4BeamTest Logo](logo.png) +In this beam test, a tank was filled with distilled water, upon which an Optical Module in a glass housing was floating, observing [Cherenkov light](https://icecube.wisc.edu/science/icecube/detector) inside the tank (see below schematic). The goal was to study and confirm if pulse shape information can be used for particle identification (PID) between pions and electrons in the context of future water or ice Cherenkov [neutrino telescope experiments](https://icecube.wisc.edu/). For more details, see the paper (*Pulse Shape Particle Identification by a Single Large Hemispherical Photo-Multiplier Tube*)[https://arxiv.org/abs/1912.03901] - S. Samani, S. Mandalia, C. Argüelles, S. Axani, Y. Li, M.H. Moulai, B. Ty, Z. Xie, J. Conrad, T. Katori, P. Sandstrom. + +![Beam Test Schematic](beamtest.pdf) + ## Installation G4BeamTest can be installed using `cmake` ``` @@ -51,6 +55,24 @@ Additional dependencies: Be sure to install with `Qt` support for the GUI interface shown in the image above. +## Running G4BeamTest + +To test the installation is working, run the test macro `run1.mac`, which will +generate 10 electrons with an energy of 2 GeV and fire them into the tank. In +the `build` folder, run +``` +./G4BeamTest -m run1.mac -n test_2GeV_e.txt +``` +For each electron, if it manages to pass through the tank and is detected in +the downstream scintillator (SC4), the number of Cherenkov photons that hit the +underside of the Optical Module glass shell is recorded in the output file +specified by the `-n` flag. + +To run with the GUI `Qt` application simply run +``` +./G4BeamTest +``` + ## License [MIT License](LICENSE) -- cgit v1.2.3