README.md

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:

make

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.78; //(m)
const double STATION_HEIGHT     = 1.54; //(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