Phenomenal: An automatic open source library for 3D shoot architecture reconstruction and analysis for image-based plant phenotyping
Introduction
This work is based on our biorxiv report
Citation
If you find our work useful in your research, please consider citing:
@article {Artzet805739,
author = {Artzet, Simon and Chen, Tsu-Wei and Chopard, J{\'e}r{\^o}me and Brichet, Nicolas and Mielewczik, Michael and Cohen-Boulakia, Sarah and Cabrera-Bosquet, Lloren{\c c} and Tardieu, Fran{\c c}ois and Fournier, Christian and Pradal, Christophe},
title = {Phenomenal: An automatic open source library for 3D shoot architecture reconstruction and analysis for image-based plant phenotyping},
elocation-id = {805739},
year = {2019},
doi = {10.1101/805739},
publisher = {Cold Spring Harbor Laboratory},
abstract = {In the era of high-throughput visual plant phenotyping, it is crucial to design fully automated and flexible workflows able to derive quantitative traits from plant images. Over the last years, several software supports the extraction of architectural features of shoot systems. Yet currently no end-to-end systems are able to extract both 3D shoot topology and geometry of plants automatically from images on large datasets and a large range of species. In particular, these software essentially deal with dicotyledons, whose architecture is comparatively easier to analyze than monocotyledons. To tackle these challenges, we designed the Phenomenal software featured with: (i) a completely automatic workflow system including data import, reconstruction of 3D plant architecture for a range of species and quantitative measurements on the reconstructed plants; (ii) an open source library for the development and comparison of new algorithms to perform 3D shoot reconstruction and (iii) an integration framework to couple workflow outputs with existing models towards model-assisted phenotyping. Phenomenal analyzes a large variety of data sets and species from images of high-throughput phenotyping platform experiments to published data obtained in different conditions and provided in a different format. Phenomenal has been validated both on manual measurements and synthetic data simulated by 3D models. It has been also tested on other published datasets to reproduce a published semi-automatic reconstruction workflow in an automatic way. Phenomenal is available as an open-source software on a public repository.},
URL = {https://www.biorxiv.org/content/early/2019/10/21/805739},
eprint = {https://www.biorxiv.org/content/early/2019/10/21/805739.full.pdf},
journal = {bioRxiv}
}
Installation
Conda environement : https://docs.conda.io/en/latest/index.html
User
Create a new environment with phenomenal installed in there :
conda create -n phm -c conda-forge -c openalea openalea.phenomenal
conda activate phm
In a existing environment :
conda install -c conda-forge -c openalea openalea.phenomenal
(Optional) Test your installation :
conda install -c conda-forge pytest
git clone https://github.com/openalea/phenomenal.git
cd phenomenal/test; pytest
From source
# Install dependency with conda
conda create -n phm -c conda-forge python=3
conda activate phm
conda install -c conda-forge -c openalea cython numpy numba scipy scikit-image scikit-learn networkx=2.3 opencv matplotlib vtk pytest
# Load phenomenal and install
git clone https://github.com/openalea/phenomenal.git
cd phenomenal
python setup.py develop
# (Optional) Test your installation
cd test; pytest
Usage :
Complete documentation is available at https://phenomenal.readthedocs.io
Tutorials are available in the example folder as a Jupyter Notebook.
You can try online with binder: https://mybinder.org/v2/gh/openalea/phenomenal/master?filepath=examples
Maintainers
- Artzet Simon
- Fournier Christian
- Pradal Christophe
License
Our code is released under Cecill-C (https://cecill.info/licences/Licence_CeCILL_V1.1-US.txt) licence. (see LICENSE file for details).