Skip to content

kbarni/Annotation

Repository files navigation

Annotation

Advanced annotation tool for agricultural field work.

[image]

Features

  • Cross platform
    • Full support for Android, iOS, Windows, Linux, MacOS
    • Provided executables for Android, Windows and Linux in the Releases page.
  • Fully configurable user interface (see Creating forms for details)
  • Project-specific form
  • Multi-language (English and French currently)
  • Dark theme (for reduced power consumption on oled screens)
  • Easy access to the database (CSV format)
  • Georeferenced data
  • Free and open source (see License for details)

Useage

Please read the instructions below before using the application!

The app has a fully configurable interface, that can be adapted for your project.

  1. Before using the app, you must create a form adapted for your needs. See the Creating forms document or the provided example files. Copy the created .ui file to the Documents/annotation_forms folder on your device (your computer or tablet). You might need to create this folder.

  2. On startup, create a new project by specifying the file name, project and selecting the desired form from the dropdown list.

    You can also select an existing file to continue with the same project.

  3. Now, the selected form appears, and you can start to add data to the file.

    UI

The file can be found in the Documents/annotation folder of your device as .ant files; the images are in the Pictures or DCIM folder (using filename format annot_[date]_[time].jpg).

The data is stored as TAB delimited text, so it can be imported to Excel, QGis or a Python script.

Build instructions

These are the instructions if you want to build the application for yourself.

Prerequisites

  • Build tools 1
  • Qt development libraries (5.12+) 2
  • QtQuick2 development libraries 2
  • [Optional] Qt Creator 2
  • [Optional] Android or iOS Development Kit 3

Building

git clone ...
cd Annotation
mkdir build
cd build
qmake ../Annotation.pro
make

...or open the Annotation.pro project in QtCreator and press "Build".

Footnotes

  1. mingw for Windows, build-essential package for Linux/MacOS. MinGW can be installed using the QT online installer (see below).

  2. easiest way to install is through the Qt online installer 2 3

  3. see configuring Qt for Android or iOS