A collection of code related to the Massimal research project on UAV hyperspectral imaging of underwater vegetation.
This code is still in development and has not been organized and prepared for widespread distribution. However, if you do want to run parts of this code, you can find requirements in the requirements_python.txt and requirements_other files.
The requirements are quite loosely defined, with few limits on version numbers, as no obvious version conflicts have been detected yet. If you come across problems regarding package versions, please submit an issue describing it.
We recommend creating a virtual environment to install the required packages. If using conda, this can be done with e.g.
conda create --name massimal pip
conda activate massimal
If you prefer a specific Python version, specify this when creating the environment, e.g.
conda create --name massimal python==3.11.7 pip
conda activate massimal
Note that pip is installed when the environment is created. Some of the python packages are available through conda, but not all. We have found that it's generally easiest to install all python packages with pip:
pip install -r requirements_python.txt
The requirements listed in requirements_other must be installed manually.
When managing conda environments, the following commands for listing, renaming and removing environments, and cleaning out unused packages, may also be useful:
conda env list
conda rename -n old_name new_name
conda env remove --name env_name
conda clean --all
The Massimal project is mainly a data science project, and much of the development is done in Jupyter notebooks. When "repeated tasks" are discovered, the code is generalized and placed in the python module (under src/massimal). Ideally, all the code should have unit tests, but it's hard to write tests for some of the data science-relatated code, and unit tests have not been prioritized yet. For now, a selection of Jupyter notebooks are included in the folder "test", as a form of more "manual" testing.
The Massimal website has information about the project, it's members, publications etc.
The Massimal project is a collaboration between
- UiT - the Arctic University of Norway
- NIVA - the Norwegian Institute for Water and the Environment
- Nord University
The Massimal project is funded by
- The Norwegian Research Council (grant number 301317)
- UiT the Arctic University of Norway (internal funding)