Welcome to drone2report documentation!

Documentation Status CI

drone2report is a CLI tool to analyze orthophoto and easily extract summary statistics, indexes, and more.

Usage

Clone the repository:

git clone https://github.com/ne1s0n/drone2report.git

Install conda (if you don't have it already) and create the conda enviroment with:

cd drone2report
conda env create --file environment.yml

Activate the environment:

conda activate drone2report

then fill a custom .ini file and run:

python3 drone2report.py <your config .ini file>

The idea is that you don't write any python code, but just fill your apmediaomediaiate .ini file.

Then, if you really really want, you can write some python code (i.e. you can easily expand the pipeline with your own custom analyses).

The sample_config.ini file is self documented and should be easy enough to understand to let you start.

The steps

The pipeline runs through three steps

  • data load: one data block per image. All active images are loaded (with their accompanying shapefile). Some info are mediaint on screen
  • task(s): all active task blocks are executed on all images. Their results are saved on disk
  • render(s): all renders are executed to collect and consolidate the tasks results. The results are again saved on disk. A special render is called [RENDER report] and allows to generate an output .html report. In the default configuration it is possible to collect the output of the various log data and to plot the results of [TASK indexes]

Example configuration files

Here some example .ini files to run common tasks with drone2report:

  • calculate one vegetation index
  • use DEM file to obtain the average height of plots
  • etc.

Credits

This is a joint effort between:

The development has also been sponsored by the Polyploidbreeding project (PRIN 2022, Settore LS2)