RecoDossard recognize number of bibs on pictures. This application is composed of 2 interfaces : one in command line and one graphic. This document is for people who want to use RecoDossard application. It explains how to use the software.

The goal of RecoDossard is to recognize number of bibs in a picture and to display it.

RecoDossard works on Mac OS, Microsoft Windows and Linux.

RecoDossard can be download, use and update freely. It is an open source software published under CECILL licence.

• Apache Commons CLI 1.3.1 -- Apache Licence, Version 2.0
• Apache POI 3.13 -- Apache Licence, Version 2.0
• Tess4J 2.0 -- Apache Licence, Version 2.0
• Tesseract 3.04 -- Apache Version, Licence 2.0
• metadata-extractor 2.8.1 -- Apache Licence, Version 2.0
• OpenCV 3.0 -- BSD Licence

RecoDossard is built with OpenCV 3.0. You can grab the latest version for your operating system on this page.

You can build OpenCV Java library from the source or download it from this page.

RecoDossard has been tested with the 3.04 version of Tesseract. A lower version can work but nothing sure! You can find some help on this page to install it according to your operating system.

1. Download Tess4J 2.0
2. Unzip file.
3. Copy/paste jar files in the RecoDossard executable directory.

1. Download the Apache Commons CLI 1.3.1.
2. Unzip file.
3. Copy/paste the commons-cli-1.3.1.jar file in the RecoDossard executable directory.

1. Download Apache POI 3.13
2. Unzip file.
3. Copy/paste jar files in the RecoDossatable executable directory.

Download JSON library and put it in the RecoDossard executable directory.

1. Download metadata-extractor 2.8.1.
2. Unzip file.
3. Copy/Paste metadata-extractor-2.8.1.jar and xmpcore-5.1.2.jar files in the RecoDossard executable directory.

Standard mode consist to enter in command line : java Main <image file> <image file> is a file or directory to analyze. To save the result in a file, enter in command line : java Main <image file> <output file>

Options [-h] and [--help] give in details how to use the application and the different options. To use these options, enter in command line : java Main -h or java Main --help

-v option is useful to have the detail of the recognition of bibs. To use it, enter in command line : java Main -v <image file> [<outputfile>] Output file is optional, it depends if the OCR has to save the result in a file or not.

-d option save all the files generated by the OCR to identity a bib in a picture. To use it, enter in command line : java Main -d [-v] <image file> [<output file>] Output file is optional, it depends if the OCR has to save the result in a file or not.

-e option consist to specify to the OCR that it can use the EXIF data of the picture to have a better result. To use it, enter in command line : java Main -e [-d] [-v] <image file> [<output file>] Output file is optional, it depends if the OCR has to save the result in a file or not.

-rd option consist to add the ranking file to have a better recognition. To use it, enter in command line : java Main -rd [-e] [-d] [-v] <image file> [<output file>] Output file is optional, it depends if the OCR has to save the result in a file or not.

When starting the application, there is no gallery. For adding a gallery, click on button "Add gallery" and select the directory wanted.

Once we are in a gallery, we can add a picture at the gallery. To do that, we have to click on the button Add Picture. A window appear to select the files that we want to add in the gallery. We can see the pictures added in the gallery.

We can delete a picture once we have select one or several picture(s) in the gallery. After that, we have to click on the Delete Button. Then pictures selected are delete of the gallery.

When we select a picture in the gallery, we have at the bottom of the window the detail of the picture selected.

We can find the location in the computer of the picture and the bibs founded if the picture was already analyzed.

There are two different possibilities of analysis : analysis of all the gallery or analysis of the pictures selected. If we want to analyze all the gallery, we have to click on the button . If we want to analyze only some pictures, we have to select it and click on the button . Once we clicked on these button, a new window appear to select the options of the analysis. In this window, we can add a ranking file, specify where the picture was taken and set the luminance of the picture. These options can improve the recognition of bibs.

At the left top, there is a button to add a new gallery named Add gallery.

When we click on this button, a window appear to select the directory of the new gallery.

After that, new gallery is added and if there was pictures in the directory, we can see pictures in the gallery at the center of the application.

To delete a gallery, select a gallery on the left side, then click on the Delete Gallery button.