RadiometryTrios package (v 0.0.1 released)

The RadiometryTrios package has been released for testing. This package allows the manipulation of hyperspectral radiometry measurements from field campaigns, using the TRIOS equipment.

The manipulation involves:

Extracting radiometry measurements from .MDB files in the MSDA/TRIOS format.
Analysis of the radiometry, data cleaning, and graph plotting
Wavelenghts Interpolation
Reflectance generation (from radiance and irradiance measurements)
Input/Output in different formats

Installation

To install the RadiometryTrios package, you should first clone the WaterClassification repository, and then command pip install, through the following commands.

git clone https://github.com/cordmaur/RadiometryTrios.git
cd RadiometryTrios
pip install -e .

Note Do not try to install through PyPI index pip install RadiometryTrios as the package is not there yet!

Requirements

Requirements was generated using pipreqs package. The pip command should install automatically the following requirements:

pyodbc==4.0.30
pandas==1.3.2
numpy>=1.17
pandas>=0.24
pyodbc>=4.0
jupyterlab
matplotlib>=3
kaleido
Pillow

ODBC Driver

To open the .mdb files, it is necessary to have a Microsoft Access ODBC driver installed (the pyodbc package will use this driver). To install, the driver can be downloaded from the Microsoft site: https://www.microsoft.com/en-us/download/details.aspx?id=13255

Note: The Python and the ODBC driver must match bit version (32 vs 64), according to the pyodbc documentation. It is important to check the ODBC data source before continuing.

Documentation

An introduction can be found at the following medium story:
https://towardsdatascience.com/a-python-framework-to-retrieve-and-process-hyperspectral-field-measurements-from-trios-sensors-5e900158648e

Additionally, the basic usage of the RadiometryTrios package is documented in the notebooks:

nbs/00_TriosMDB.ipynb
nbs/01_Radiometry.ipynb

Institutions

ANA - Agência Nacional de Águas (https://www.gov.br/ana/en/)
GET - Géosciences Environnement Toulouse (https://www.get.omp.eu/)
IRD - Institut de Recherche pour le Développement (https://en.ird.fr/)

License

This code is licensed under the GNU General Public License v3.0 license. Please, refer to GNU's webpage (https://www.gnu.org/licenses/gpl-3.0.en.html) for details.

cordmaur / RadiometryTrios