The ACQUA suite

A tool suite containing the firmware and software packages for the operation, control and data acquisition, preprocessing, and transfer onboard a LAGO water Cherenkov detector. It includes all the necessary files for operating peripherals (such as GNSS and atmospheric sensors).

Request Feature · Report Bug · Contact us

ACQUA versioning

ACQUA is currently under continuous development. This version (ACQUA v1) is targeted for the old NEXYS-II-based DAQ. Its usage is now (2023) strongly deprecated and could not work on modern operating systems.

Please consider moving to the new ACQUA adquisition system based on the RedPitaya board (look for branches ACQUA v2 or later in this repository.

ACQUA main reference and citation

When using ACQUA v1, please cite the reference reported below:

Miguel Sofo-Haro and Horacio Arnaldi, "The data acquisition system of the Latin American Giant Observatory (LAGO)". Nuclear Instruments and Methods in Physics Research A, 820, 34--39 (2016), doi:10.1016/j.nima.2016.02.101. (bibtex)

ACQUA main contributors

ACQUA v1 main crontributors are Dr M. Sofo Haro, Dr H. Arnaldi, Dr X. Bertou and Dr H. Asorey, for the LAGO Collaboration.

Installation

1. If you are using git, just clone this repository:

   cd /path/to/acqua/installation
   git clone https://github.com/lagoproject/acqua.git

   Otherwise, you can also directly download ACQUA without using git (in this case, you should reinstall ACQUA for every upgrade):

   cd /path/to/acqua/installation
   wget -c https://github.com/lagoproject/acqua/archive/refs/heads/master.zip
   unzip master.zip
   rm master.zip

2. For compiling and configuring see the corresponding installation guidelines.

ACQUA updates, releases, branchs and tags

ACQUA is continuously used, revised and updated within the LAGO Collaboration.

Unless you are a developer, we recommend to use only the ACQUA version corresponding to your WCD setup.

Clone and install ACQUA from dev or dev-* branches is strongly discouraged, as these branches are used for testing, bug correction and for the development of new features.

If you are using git, you can update ACQUA just by doing:

cd /path/to/ACQUA/installation/
git pull
make

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

ACQUA is distributed under the BSD-3 License. See the LICENCE for more information.

(back to top)

Contact

The ACQUA suite is developed by the LAGO electronics working group. If you need to contact us, please complete our contact form.

ACQUA principal contact: Luis Otiniano (@lotiniano)

Project Link: https://github.com/lagoproject/acqua

(back to top)