Welcome to Document-Creator web page Presentation


Document-Creator is an Application to generate synthetic document images

Created by public researchers from the LaBRI and the L3I

LaBRI logo l3I logo

univ Bordeaux logo CNRS logo univ Bordeaux logo univ la rochelle logo

About Document-creator

Document-creator is able to create a large amount of synthetic document images

The way Document-creator works is fully described in [ICPR2012], [ICDAR2013], [HIP2013], [LNCS2014].

Document-creator (desktop and online version) have been developed by J. Albouys- Perrois, M. Bazalgette, P. Beziau, A. Borde, F. Bruneau, J.P. Domenger, J Gouraud, N. Journet, M. Kébé, V.C. Kieu, B. Mansencal, R. Mullot, V. Rabeux, J. Sillini, R. Tlili, Zakia Taoufik, J. Ukundwa, N. Vidal, M. Visani

If you use our work, please cite [ICDAR2013]

Document-creator is useful for performance evaluations tasks

performance evaluation

Like [BUI2014] and [MEH2014], document-creator is useful to know precisely whether your alogirthm is robust. Whant to know if your algorithm (ocr, line segmentation, wordspotting, binarization, ...) works in all configurations? With Document-Creator, you can add various realistic degradations (bleed-through, light defect, paper deformation, ink degradation, ...) on your original image

Document-creator is useful for retrainning tasks

network neurone

Like [Mont2014] and [FIS2013], you can use Document-creator to complete your trainning dataset and finally improve your recognition rate.

2D defects

Add bleed-through, ink , adaptive blur, holes and other defects on your document images and use them for performance evaluation or retraining

Among all the defects available in document-creator, bleed-through defect is an adaptation of Moghaddam paper. The Shadow defect is an adptation of Kanungo degradation model

Some document images have been graciously given by the CESR and the BNF

3D defects

We can generate documents with realistic 3D distortions

XML groundtruth

Document-creator is able to create a synthetic document using only a text file

Use native document-creator fonts

Export the document as PNG and XML groundtruth

Import new fonts from real document images (image graciously provided by Gestform)

Use this new font to create similar document images

Create in 3 minutes thousands of synthetic document images

Download DOCUMENT-CREATOR

If you use our work, please cite [ICDAR2013]

DownloadDocument-Creator DMG (300 MO)

Download Document-Creator Source-Code (200 MO)

             This program should compile under linux (with gcc & clang) and Mac OS (with clang). 
             It has been tested on Fedora (19->23), Ubuntu (14.04) and Mac OS (10.9->10.11).
            
             Dependencies
             ============

             The program uses the following libraries:
              -OpenCV (2.4.x or 3.x)
              - Qt 5
              -Tesseract is optional. If it is not found on the system, it will be compiled from (provided) sources. 
              However, you will need to have network access during the configuration step to download tessdata, tesseract languages data.
              -CMake is used for compilation.
              

              On Ubuntu (14.04 and above), 
              you can install the required binary packages with the following command:
              sudo apt-get install libopencv-dev qtbase5-dev qtdeclarative5-dev libqt5xmlpatterns5-dev cmake
              You can install tesseract with the following command:
              sudo apt-get install tesseract-ocr tesseract-ocr-fra libtesseract-dev libleptonica-dev

              On Fedora (21 or 22), you can install the required binary packages with the following command:
              yum install opencv-devel qt5-qtbase-devel qt5-qtxmlpatterns-devel cmake 
              On Fedora (23 and above), you can install the required binary packages with the following command:
              dnf install opencv-devel qt5-qtbase-devel qt5-qtxmlpatterns-devel cmake 
              You can install tesseract with the following command as root:
              dnf install tesseract tesseract-devel tesseract-langpack-fra leptonica leptonica-devel libpng-devel


              To compile with clang on linux:
              - you need to have libc++
              On Ubuntu, you can install libc++ with the following command:
              sudo apt-get install libc++-dev libc++abi-dev
              - you need to have OpenCV 3.1 or above.
              See below how to build OpenCV form sources.
            
              
              #OpenCV from sources

              You can also install OpenCV from sources (if it is not provided by your distribution or if you want a newer version for example).

              OpenCV is also built with CMake.
              You can use the following command to build a minimal OpenCV version compatable with Document Creator:

              cmake  -DCMAKE_INSTALL_PREFIX=

              -DBUILD_opencv_highgui=ON -DENABLE_FAST_MATH=ON -DBUILD_DOCS=OFF -DBUILD_PERF_TESTS=OFF 

              -DBUILD_TESTS=OFF -DWITH_CUDA=OFF -DWITH_CUFFT=OFF -DWITH_FFMPEG=OFF -DWITH_GIGEAPI=OFF 

              -DWITH_JASPER=OFF -DWITH_LIBV4L=OFF  -DWITH_MATLAB=OFF -DWITH_OPENCL=OFF 

              -DWITH_OPENCLAMDBLAS=OFF -DWITH_OPENCLAMDFFT=OFF -DWITH_OPENEXR=OFF -DWITH_PVAPI=OFF 

              -DWITH_V4L=OFF -DWITH_VTK=OFF -DWITH_WEBP=OFF -DWITH_1394=OFF -DBUILD_opencv_apps=OFF 

              -DBUILD_opencv_calib3d=OFF -DBUILD_opencv_features2d=OFF -DBUILD_opencv_flann=OFF 

              -DBUILD_opencv_ml=OFF -DBUILD_opencv_objdetect=OFF -DBUILD_opencv_shape=OFF 

              -DBUILD_opencv_stitching=OFF -DBUILD_opencv_superres=OFF  -DBUILD_opencv_ts=OFF 

              -DBUILD_opencv_video=OFF -DBUILD_opencv_videoio=ON -DBUILD_opencv_videostab=OFF 

              -DBUILD_opencv_world=OFF -DBUILD_opencv_highgui=ON -DPYTHON2_EXECUTABLE="" 

              -DPYTHON3_EXECUTABLE="" -DBUILD_opencv_python2=OFF -DBUILD_opencv_python3=OFF 

              -DWITH_QUICKTIME=OFF -DHAVE_QTKIT=FALSE

              with corrected "PATH_TO_CMakeLists.txt" and "INSTALL_PREFIX".



 

              Compilation
              ------------
              CMake is used for configuration & compilation.
              The following commands allow to build DocumentCreator

              mkdir build
              cd build
              cmake ..
              make
              make install 

              You can specify the installation prefix to use with:
              cmake .. -DCMAKE_INSTALL_PREFIX="MyInstallationPrefix"
              You can then launch the executable:
              "MyInstallationPrefix"/bin/DocumentCreator


              #Download Document-Creator Source-Code  (200 MO)
              unzip DocumentCreator.zip
              cd DocumentCreator
              mkdir build
              cd build
              cmake ..
              make
              Run
              ------------
              #Launch DocumentCreator executable
              software/DocumentCreator/DocumentCreator
            
                #MAC distribution (with Homebrew)
                #Need OpenCV and QT packages
                brew install qt5
                brew linkapps qt5
                brew link --force qt5
                brew tap homebrew/science
                brew install opencv

                #Download Document-Creator Source-Code  (200 MO)
                unzip DocumentCreator.zip
                cd DocumentCreator
                mkdir build
                cd build
                cmake ..
                make

                #Launch DocumentCreator executable
                software/DocumentCreator/DocumentCreator
              
                TROUBLESHOOTING
                #if you encounter a problem with Qt during the cmake process it might comes from your PATH
                export PATH=/Users/XXX/Qt/5.4/clang_64/bin:$PATH
                #or (according to your system version)
                export PATH=/usr/local/opt/qt5/bin/:$PATH

                 
                  #if CMake does not find OpenCV, you may try to specify the directory containing OpenCVConfig.cmake            
                  OpenCV_DIR=/Users/XXX/tools/share/OpenCV
                  cmake ..

                  #if you encounter a problem during the make process it might be related to your C++11 configuration
                  #edit CMakeLists.txt.txt, and add (or remove) the following line before the first "ADD_SUBDIRECTORY" line
                  SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
                  #then restart the construction process
                  rm -rf CMakeCache.txt CMakeFiles
                  cmake ..
                  make
                  cd ../documentcreator-build/software/AncientDocumentEditor/
                  ./AncientDocumentEditor




                

Download Databases

DOCUMENT CREATOR ONLINE


Upload an image and extract the font
(Works only on Firefox and Chrome.)

GO !


Upload an image and degrade it
(Works only on Firefox and Chrome.)

GO !


Create your own document
(Works only on Firefox and Chrome.)

GO !


3D deformation
(Works only on Firefox and Chrome.)

GO !

Contact us

Any Question?
Please Contact Journet Nicholas (journet[]labri.fr) or Boris Mansencal (boris.mansencal[]labri.fr)