Manini

manini

An user-friendly plugin that enables to annotate images from a pre-trained model (segmentation, classification, detection) given by an user.

License BSD-3 PyPI Python Version tests codecov napari hub

Manini (MAchiNe INference & CorrectIon) is thought as a tool to boost the collaborative contribution of end-users to the assessment of deep learning model during their testing phase. It is a user-Friendly plugin that enables to manually correct the result of an inference of deep learning model by an end-user. The plugin covers the following informational tasks: segmentation, classification and object detection.

White paper

Herearii Metuarea, David Rousseau. Toward more collaborative deep learning project management in plant phenotyping.

ESS Open Archive . October 31, 2023. DOI: 10.22541/essoar.169876925.51005273/v1


This plugin was written by Herearii Metuarea, PHENET engineer at LARIS (French laboratory located in Angers, France) in Imhorphen team (bioimaging research group lead) under the supervision by David Rousseau (Full professor). This plugin was designed in the context of the european project INVITE and PHENET.

Screenshot from 2023-11-13 00-13-13


This napari plugin was generated with Cookiecutter using @napari's cookiecutter-napari-plugin template.

Installation

You can install manini via pip:

pip install manini

To install latest development version :

pip install git+https://github.com/hereariim/manini.git

Description

This plugin is a tool to perform image inference. The inference is open to the model for image segmentation (binary or multiclass), image classification and object detection. The dimension of image should be the same size with the input of model. Currently compatible with tensorflow h5 models. In this format, the h5 file must contain all the elements of the model (architecture, weights, etc). Several ongoing developments, feel free to contact us if you have some request.

Contact

Imhorphen team, bioimaging research group

42 rue George Morel, Angers, France

Scheme

manini

Input

The user must deposit two items (+1 optional item).

  • A compressed file (.zip) containing the images in RGB
.
└── input.zip
    ├── im_1.JPG
    ├── im_2.JPG 
    ├── im_3.JPG
    ...
    └── im_n.JPG
  • A tensorflow h5 file (.h5) which is the segmentation model
  • A text file (.txt) containing the names of the classes (optional)

The Ok button is used to validate the imported elements. The Run button is used to launch the segmentation.

Process

Correction is made by selecting some classes displayed in a widget :

  • Paint panel for image segmentation

  • Table for image classification

  • Bounding box panel for object detection

Output

Segmentation + Detection

The plugin suggest 'Export' widget. When user select image and mask, the Save button allows you to obtain data in a compressed file. This file contains folders containing the images and their mask.

Classification

The Save button allows you to obtain a csv file. This file is the table on which the user had made his modifications.

Tutorial

Please, you can learn better if you watch a video tutorial below.

Presentation video of the context where the plugin was developped : MANINI Napari Plugin Part 1

Tutorial video to get started : MANINI Napari Plugin Part 2

License

Distributed under the terms of the BSD-3 license, "manini" is free and open source software

Issues

If you encounter any problems, please file an issue along with a detailed description.

Version:

  • 0.0.10

Last updated:

  • 15 November 2023

First released:

  • 04 November 2023

License:

Supported data:

  • Information not submitted

Plugin type:

GitHub activity:

  • Stars: 0
  • Forks: 0
  • Issues + PRs: 0

Python versions supported:

Operating system:

Requirements:

  • numpy
  • magicgui
  • qtpy
  • napari
  • scikit-image
  • pandas
  • opencv-python-headless
  • tensorflow
  • PyQt5

Sign up to receive updates