mxmaxi007 / simple_image_annotator

Simple Image Annotator

Description

All image annotators I found either didn't work or had some overhead in the setup. So, I tried to make this one simple to run and simple to use.

Install

• Install Flask

$ pip install Flask

Getting started

• cd into this directory after cloning the repo
• start the app

$ python app.py /images/directory

• you can also specify the file you would like the annotations output to (out.csv is the default)

$ python app.py /images/directory --out test.csv

• open http://127.0.0.1:5000/tagger in your browser
  • only tested on Chrome

Output

• in keeping with simplicity, the output is to a csv file with the following fields
  • id - id of the bounding box within the image
  • name - name of the bounding box within the image
  • image - image the bounding box is associated with
  • xMin - min x value of the bounding box
  • xMax - max x value of the bounding box
  • yMin - min y value of the bounding box
  • yMax - max y value of the bounding box

HOWTOs

• draw a bounding box
  • click on the image in the location of the first corner of the bounding box you would like to add
  • click again for the second corner and the box will be drawn
• add a label for a box
  • for the box you would like to give a label, find its id (noted in the top left corner of the box)
  • find the label with the corresponding number
  • enter the name you want in the input field
  • press enter
• move to next image
  • click the blue arrow button at the bottom of the page (depending on the size of the image you may have to scroll down)
• remove label click the red button on the label you would like to remove
• check generated data
  • at the top level of the directory where the program was run, there should be a file called out.csv that contains the generate data