aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorShivesh Mandalia <shivesh.mandalia@outlook.com>2020-02-29 19:08:42 +0000
committerShivesh Mandalia <shivesh.mandalia@outlook.com>2020-02-29 19:08:42 +0000
commitd70c97869c74697b4866f2fc4b95feba9b7e7987 (patch)
tree53f58eb7f8911bb195c6dfd559208b288bb81df8
parent3526d6c238f8c765883f7392b82aa0948f9a0f51 (diff)
downloadG4BeamTest-d70c97869c74697b4866f2fc4b95feba9b7e7987.tar.gz
G4BeamTest-d70c97869c74697b4866f2fc4b95feba9b7e7987.zip
add instructions on how to run, and some information about the beam test
-rw-r--r--README.md22
-rw-r--r--beamtest.pdfbin0 -> 21320 bytes
2 files changed, 22 insertions, 0 deletions
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)
diff --git a/beamtest.pdf b/beamtest.pdf
new file mode 100644
index 0000000..719aa0c
--- /dev/null
+++ b/beamtest.pdf
Binary files differ