Repository files navigation

This repository contains code, written inR andPython, to reproduce [LINK TO ARTCLE HERE]. If you are using any of the contained code or data, please use the following reference:

Heim, R. HJ., Okole, N., Steppe, K., van Labeke, M.C., Geedicke, I., & Maes, W. H. (2024). An applied framework to unlocking multi‑angular UAV reflectance data: A case study for classification of plant parameters in maize (Zea mays).Precision Agriculture. (accepted)

• Theref directory containing the code that was used to clean and structure the data that was collected for the study XYZ, published here (LINK TBA).
• Themain directory containing the code to re-run the presented method as it was done in the published manuscript.
• Themain_public directory containing the code to run our method as it is intended for a new user.
• Theanalysis directory containing the code that was used to generate the results and visualizations as they were published HERE (LINK TBA).
• TheOptimisation_Changes Directory contains the changes made to optimise the original code

Python: Installing Python 3.X through theAnaconda distribution. Please follow the instructions, based on your operating system,HERE.

Agisoft Metashape: Please downloadAgisoft Metashape Professional and purchase a license to allow full functionality.

Exiftool (by Phil Harvey): Please follow theinstructions to install Exiftool on your operating system and associate the programm with your Python environment.

PyExifTool and other Python libraries: Please use THIS requirements file and the following command to install all necessary Python libraries and your preferred conda environment simultaniously:

conda env create --name my-env-name --file environment.yml

For each ground sampling that was performed in the field, you will need an associated coordinate and provide a csv file containing these coordinates.

NO HEADER
"id_1","lon_1","lat_1"
"id_2","lon_2","lat_2"
"id_i","lon_i","lat_i"

1. Align image dataset
2. Build dense cloud
3. Build DEM
4. Build orthomosaic
5. Export DEM (make sure the DEM matches the extent of the Orthomosaic)
6. Export orthomosaic (make sure the Orthomosaic matches the extent of the DEM)
7. Export orthophotos
8. Export camera positions as omega_phi_kappa.txt

Please save the following files in a single directory:

• DEM (as .tiff)
• Orthophotos (as directory)
• Camera positions (as .txt)
• Sample coordinates (as. csv)
• Original images (as directory)

1. Please download the completerepository and keep the directory structure as it is
2. Open theconfig_file.yaml
3. Change the paths, settings, and output according to your specific setup
4. Execute the01_main_extract_vza_aza_reflectance.py with you IDE of choice (the results will be stored in the directory that was specified underoutput in step 3)
5. Execute the02_filter_sample_location.py with you IDE of choice (the results will be stored in the directory that was specified underoutput in step 3)
6. Execute the03_merging_sample_locations.py with you IDE of choice (the results will be stored in the directory that was specified underoutput in step 3)
7. Execute the04_orthomosaic_pixel_data.py with you IDE of choice (the results will be stored in the directory that was specified underoutput in step 3)

If you have any questions how to use the code, please commit an issue for others to benefit from it. If this is not an option for you, please contact either Nathan Okole (okole@ifz-goettingen.de) or Rene Heim (rheim@uni-bonn.de)