f1b196dba2
|
||
|---|---|---|
| Model | ||
| Translation | ||
| View | ||
| icons | ||
| logos | ||
| virtual_env | ||
| virtualenv | ||
| .editorconfig | ||
| .gitignore | ||
| ABS_calibration_constant_kt.xlsx | ||
| AcouSed_UserManual.pdf | ||
| Acoustic_Inversion_theory.pdf | ||
| LICENSE | ||
| README.md | ||
| Tutorial_AQUAscat_software.pdf | ||
| guix.sh | ||
| main.py | ||
| manifest.scm | ||
| requirements.txt | ||
| settings.py | ||
| tags.sh | ||
README.md
AcouSed
AcouSed for Acoustic Backscattering for Concentration of Suspended Sediments in Rivers is a software developped by INRAE, in collaboation with CNR.
It is divided in six tabs:
- Acoustic data : acoustic raw data are downloaded and visualised
- Signal preprocessing : acoustic raw signal is preprocessed with filters
- Sample data : fine and sand sediments samples data are downloaded and visualised
- Calibration : calibration parameter are computed
- Inversion : inversion method is calculated to provide fine and sand sediments fields
Installation
Standalone software
AcouSed can be launched with python installation. An executable is available on River Hydraulics teams website. The user needs to download the folder "acoused-packaging" including :
- icons and logos folder
- _internal folder (python packages)
- executable file
- calibration constant file
- documentation
Acoused.exe file must be launched from this folder. Test data can be dowloaded from the INRAE nextcloud
Python environment
Acoused is developped for Linux and Windows on Python version 3.8 or greater. By default, Acoused is developped with Pypi package dependencies, but is also possible to use Guix package manager to run Acoused.
Windows
You can use Pypi to get correct software environment and run the program.
python -m venv env
env\Scripts\activate.bat
python -m pip install -U -r ..\virtualenv\requirements.txt
python main.py
Linux
You can use Pypi to get correct software environment and run the program.
python3 -m venv venv
source ./venv/bin/activate
python3 -m pip install -r requirement.txt
python3 main.py
Linux with Guix
To run Acoused within a GNU Guix software
environment, you need Guix installed on your computer and run the
script guix.sh to run the program.
./guix.sh
# If you need sqlitebrowser, use this command
guix shell sqlitebrowser -- ./guix.sh
Support files & References
-
Vergne A., Le Coz J., Berni C., & Pierrefeu G. (2020), Water Resources Research, 56(2)
-
Vergne A., Berni C., Le Coz J., & Tencé F., (2021), Water Resources Research, 57(9)
Authors & Contacts
If you have any questions or suggestions, please contact us to celine.berni@inrae.fr and/or jerome.lecoz@inrae.fr.
Acknowledgment
This study was conducted within the Rhône Sediment Observatory (OSR), a multi-partner research program funded through the Plan Rhône by the European Regional Development Fund (ERDF), Agence de l’Eau RMC, CNR, EDF and three regional councils (Auvergne-Rhône-Alpes, PACA and Occitanie).
Industrial partners
License
AcouSed Copyright (C) 2024-2025 - INRAE
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.