The LAGO EASY suite
CODENAME | EASY |
---|---|
COPYRIGHT | (C) 2012-Today, The LAGO Project, lagoproject.org |
LICENSE | BSD-3-Clause |
REPOSITORY | https://github.com/lagoproject |
CONTACT | lago@lagoproject.org |
DESCRIPTION | The LAGO project deploys and operates a network of water Cherenkov detectors (WCD) with a unified data structure. Here you will find the latest stable (prod) version of the detector simulation tools of the LAGO project |
CONTRIBUTORS | If you want to contribute to this project please send us an email |
CODE GUIDELINES | |
---|---|
FILE ENCODING | UTF8 (please use iconv -f YOUR_ENCODING -t UTF-8 file_to_convert > converted_file before to push) |
LANGUAGE | English (preferred) |
INDENT STYLE | Stroustrup using 1 tab for 4 columns wide. check here for vim setup |
If you prefer, please use: astyle -t4 -A4 -y file_to_convert before to push | |
VERSIONING | Sequence-based identifiers, vr. First public release: v1r0 |
INSTALL | After installing dependences (see INSTALL), just make |
USAGE | Please visit our wikipage (internal use only) |
The Latin American Giant Observatory (LAGO) is an extended Astroparticle Observatory at global scale. It is mainly oriented to basic research on three branches of Astroparticle physics: the Extreme Universe, Space Weather phenomena, and Atmospheric Radiation at ground level.
INSTALL
Please follow this simple instructions.
Requirements
You just need a working ROOT installation (ROOT v 5.34.36 or higher is the recommended version). Then you just execute make at the main directory. It will create the {LAGO_EASY}</kbd> environment variable and modify the <kbd>HOME/.bashrc file. Please source it again before to continue.
Please report any installation problems please email us.
Usage
Modifying geometry
The detector geometry is defined in the src/Constants.h file. A symbolink link named configs.h is provided. To modify just edit this file:
vim configs.h
and modify it by changing the values of STATION_RADIUS, STATION_HEIGHT and the number and position of PMTs (NPM X_PM and Y_PM). For example, for one of our detectors deployed at the LAGO Bariloche site, the configuring block is:
//DETECTOR CONSTANTS
const double STATION_RADIUS = 0.70; //(m)
const double STATION_HEIGHT = 1.46; //(m)
const int NPM = 1;
const double X_PM[NPM] = {0.}; // (0,0) is the center of the tank roof
const double Y_PM[NPM] = {0.}; // (0,0) is the center of the tank roof
const double RAD_PM = .1477;//(m)
const double HC_PM = .0776;//(m)
const double TOP_FACT = 1.; //white top
If you change detector geometry, you will need to recompile the whole package. Just execute make at the parent directory:
cd ${LAGO_EASY}/src
make
Running
The simulation execution is governed by the default.inp file. Just edit if following the examples given in that file. It is straightforward. Please be sure to be in CALIB mode (SHOWER mode is deactivated in LAGO code). Then, for run the simulation just use
make run
in the parent directory. It will provide a .root file with a specific name depending on the parameters defined in the default.inp file. It is then converted into ASCII, extracting the FADC traces, producing a .dat ASCII file.