
Please, read the description below carefully and agree the terms of usage before launching the software!


1. Description

e2e_predict is a demo software tool provided for demonstration of end-to-end approach to automated estimation of plant traits from RGB image of greenhouse-grown plants.


2. How to use?

The exectuable tool should be run from Windows command line using the following syntax:

e2e_predict "network_model_file_name" "image_file_name" "target_trait_name"

The example below demonstrate the application of the e2e_predict tool for computation of the plant "area" trait from the image "arab_top.png" stored in the subfolder "images" using
the pretrained model "area_arab_top.mat" stored in the subfolder "models":

e2e_predict "models\area_arab_top.mat" "images\arab_top.png" "area"

Please, use e2e models that are complementary to the plant images and traits, e.g.,

area_arab_top.mat: for prediction of the "area" trait from arabidopsis top-view images,
green_avg_barley_side.mat: for prediction of the "average green color" trait from barley side-view images,
convex_hull_maize_top.mat: for prediction of the "convex hull area" trait from maize top-view images,

... and so on.

The list of traits:

area: area of the plant region in pixel^2,
convex_hull: area the convex hull of the plant in pixel^2,
height: height (i.e. vertical min/max dimension) of the plant region in pixels,
width: width (i.e. vertical min/max dimension) of the plant region in pixels,
h_99: 99% percentile of the vertical distribution of plant pixels (similar to height but more robust w.r.t. noise),
w_99: 99% percentile of the horizontal distribution of plant pixels (similar to wdith but more robust w.r.t. noise),
red_avg: average red color of the plant region,
green: average green color of the plant region,
blue: average blue color of the plant region.

The repository includes pretrained e2e models for the following five plant types, camera view (re. optical setups):

- arabidopsis top view images
- barley top view images
- barley side view images
- maize top view images
- maize side view images

Files of all pretrained models are stored in the "models" subfolder.
Files of example images are stored in the "images" subfolder.

 
3. Requirement of MATLAB run time libraries (free of charge)

This software requires MATLAB run time libraries (version 2024a) to be installed on your Windows computer.
MATLAB 2024a runtime libraries can be downloaded from https://www.mathworks.com/products/compiler/matlab-runtime.html:

https://ssd.mathworks.com/supportfiles/downloads/R2024a/Release/6/deployment_files/installer/complete/win64/MATLAB_Runtime_R2024a_Update_6_win64.zip


4. Terms of usage

By downloading, installing and using this software the user agrees with all terms of the End-User License Agreement. 
Please, read EULA.txt attached to this repository.


5. References to the research article

[1] Gladilin et al (2024) End-to-end deep learning approach to automated phenotyping of greenhouse-grown plant shoots.

(C) 2024, Image Analysis Group, IPK Gatersleben
http://www.ipk-gatersleben.de/signature/impressum/
