Annotator: ImageJ plugin for multi-class annotations of color images

(c) 2019 P. Borianne / CIRAD
Version 1.0 - March 2019

For more details, see the project home page (upcomming).
Annotator is based on ImageJ developed by Wayne Rasband and is distributed under CeCILL-B License.

Thanks to Wayne Rasband and everyone who wrote and shared ImageJ plugins.
Thanks so to the different developers and the students working with our team.

User guide

Annotator is like a Java plugin of the ImageJ application developed as part of the Agro'Deep project to facilitate multi-class annotations of colour images. It is distributed under Cecill-B license.


Annotation consists in defining rectangular areas on colour images that include objects of interest. Each of these annotations is defined by the coordinates of the lower left point, the width, the height of its rectangle and a class name. The annotations of the image toto.jpg are grouped in the file toto.txt which will be archived in a specific folder.

The inputs / outputs block

Here are specified the files and folders for setting up the plugin, in particular

  • The classification model to use: this is a TXT file that specifies the name and colour of the classes to use. Its nomenclature is as follows:
  • The folder where the annotation files are stored. This folder must be specified before the next one.
  • The folder where the images to be annotated are stored.

The annotations block

These are the functions related to the management (add, delete, resize) of annotations. The first thing is to choose the class to use. The choice of the function is made by radio button.

In orange the hornets, in pink the captures. The pink rectangle shows the Resize mode.

The Images block

The icons represent the tools that can be applied to the current image: the hand represents the selection / movement of a remarkable point of the selected annotation, the cross the movement of the image in the view window, and the magnifying glass the zoom of the image. These tools take precedence over ImageJ's tools.
There are also functions related to image management: select a specific image, go to the previous or the next one. Any change of image will save the annotations of the current image and load the annotations of the new image.

Downloading / Installation of the plugin

Once downloaded, the Annotator_.jar plugin must be copied to the plugins subfolder (in the location) or installed by the "Plugins / Install" function of ImageJ or Fiji. In both cases, the applications must be restarted.


Borianne, P., 2019.

French user guide - English user guide