Skip to main content

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

Project description

manini

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: (link will be presented soon)

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

Screenshot from 2023-11-14 11-57-13

Tutorial video to get started : MANINI Napari Plugin Part 2

Screenshot from 2023-11-14 11-49-40

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

manini-0.0.7.tar.gz (21.5 kB view details)

Uploaded Source

Built Distribution

manini-0.0.7-py3-none-any.whl (17.6 kB view details)

Uploaded Python 3

File details

Details for the file manini-0.0.7.tar.gz.

File metadata

  • Download URL: manini-0.0.7.tar.gz
  • Upload date:
  • Size: 21.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.12

File hashes

Hashes for manini-0.0.7.tar.gz
Algorithm Hash digest
SHA256 0e4140f68016edbef63cfd397bee3c788ac676a06b5b65aec01b72f8126891f9
MD5 431d644d411e4f911b092db77335f7a2
BLAKE2b-256 02b9bfbf6e65ca245ebb1783abc48f955936911ba9de547862256c5a6d615049

See more details on using hashes here.

File details

Details for the file manini-0.0.7-py3-none-any.whl.

File metadata

  • Download URL: manini-0.0.7-py3-none-any.whl
  • Upload date:
  • Size: 17.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.12

File hashes

Hashes for manini-0.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 39a46f4bb8ab2f4869acfb97f152f3ade5c22bfc15582a3d2400780c936f09ea
MD5 d42736869e41045a1c594ed0793f92de
BLAKE2b-256 55b57fe72fe77f1fbebf874729e4ccc8f29e298626cc51a0312076b70e687db4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page