Next: System Overview Up: GiDoc 1.0 Manual Previous: What is GiDoc ?
In order to install GiDoc you need:
Optionally, to use a different train/recognize software you will need:
Please see the next section for details on to install these packages.GiDoc uses autotools, so you only have to execute " ./configure", "make", "make install" and the tools will be compiled and installed as gimp plugins, tipically in the "/usr/lib/gimp/2.0/plug-ins" directory. This package has been tested on Linux and MacosX. Windows is not supported for now.
This example shows an installation of giDoc on a Linux system (user commands are preceded by "> "):
> tar xvzf giDoc-plugins-1.0.2.tar.gz giDoc-plugins-1.0.2/ giDoc-plugins-1.0.2/autogen.sh giDoc-plugins-1.0.2/aclocal.m4 giDoc-plugins-1.0.2/ChangeLog giDoc-plugins-1.0.2/missing giDoc-plugins-1.0.2/README giDoc-plugins-1.0.2/intltool-merge.in giDoc-plugins-1.0.2/install-sh giDoc-plugins-1.0.2/po/ giDoc-plugins-1.0.2/po/POTFILES.in [...] giDoc-plugins-1.0.2/help/images/wilber.png giDoc-plugins-1.0.2/help/images/Makefile.in giDoc-plugins-1.0.2/help/images/Makefile.am giDoc-plugins-1.0.2/help/en/ giDoc-plugins-1.0.2/help/en/Makefile.in giDoc-plugins-1.0.2/help/en/gimp-help.xml giDoc-plugins-1.0.2/help/en/index.html giDoc-plugins-1.0.2/help/en/Makefile.am giDoc-plugins-1.0.2/help/Makefile.in giDoc-plugins-1.0.2/help/Makefile.am > cd giDoc-plugin-1.0.2 > ./configure checking for a BSD-compatible install... /usr/bin/install -c checking whether build environment is sane... yes checking for a thread-safe mkdir -p... /bin/mkdir -p checking for gawk... gawk checking whether make sets $(MAKE)... yes checking for style of include used by make... GNU checking for gcc... gcc checking for C compiler default output file name... a.out checking whether the C compiler works... yes checking whether we are cross compiling... no [...] config.status: creating src/scripts/Makefile config.status: creating po/Makefile.in config.status: creating help/Makefile config.status: creating help/en/Makefile config.status: creating help/images/Makefile config.status: creating config.h config.status: executing depfiles commands config.status: executing intltool commands config.status: executing default-1 commands config.status: executing po/stamp-it commands > make make all-recursive make[1]: Entering directory `/home/nserrano/giDoc-plugins-1.0.2' Making all in po make[2]: Entering directory `/home/nserrano/giDoc-plugins-1.0.2/po' file=`echo ca | sed 's,.*/,,'`.gmo \ && rm -f $file && /usr/bin/msgfmt -o $file ca.po make[2]: Leaving directory `/home/nserrano/giDoc-plugins-1.0.2/po' Making all in src make[2]: Entering directory `/home/nserrano/giDoc-plugins-1.0.2/src' Making all in preprocess make[3]: Entering directory `/home/nserrano/giDoc-plugins-1.0.2/src/preprocess' Making all in data_sets make[4]: Entering directory `/home/nserrano/giDoc-plugins-1.0.2/src/preprocess/data_sets' /bin/bash ../../../libtool --tag=CC --mode=compile gcc -DHAVE_CONFIG_H -I. -I../../.. -g -O2 -Wall -MT libpgm.lo -MD -MP -MF .deps/libpgm.Tpo -c -o libpgm.lo libpgm.c gcc -DHAVE_CONFIG_H -I. -I../../.. -g -O2 -Wall -MT libpgm.lo -MD -MP -MF .deps/libpgm.Tpo -c libpgm.c -fPIC -DPIC -o .libs/libpgm.o libpgm.c: In function 'pgm_allocarray': libpgm.c:95: warning: format '%u' expects type 'unsigned int', but argument 5 has type 'long unsigned int' gcc -DHAVE_CONFIG_H -I. -I../../.. -g -O2 -Wall -MT libpgm.lo -MD -MP -MF .deps/libpgm.Tpo -c libpgm.c -o libpgm.o >/dev/null 2>&1 mv -f .deps/libpgm.Tpo .deps/libpgm.Plo > sudo make install [...] /usr/bin/install -c plugin_gidoc_slant /usr/lib/gimp/2.0/plug-ins/plugin_gidoc_slant /bin/bash ../libtool --mode=install /usr/bin/install -c 'plugin_gidoc_prhltextfea' '/usr/lib/gimp/2.0/plug-ins/plugin_gidoc_prhltextfea' /usr/bin/install -c plugin_gidoc_prhltextfea /usr/lib/gimp/2.0/plug-ins/plugin_gidoc_prhltextfea /bin/bash ../libtool --mode=install /usr/bin/install -c 'plugin_gidoc_fkiextfea' '/usr/lib/gimp/2.0/plug-ins/plugin_gidoc_fkiextfea' /usr/bin/install -c plugin_gidoc_fkiextfea /usr/lib/gimp/2.0/plug-ins/plugin_gidoc_fkiextfea /bin/bash ../libtool --mode=install /usr/bin/install -c 'plugin_gidoc_resta' '/usr/lib/gimp/2.0/plug-ins/plugin_gidoc_resta' /usr/bin/install -c plugin_gidoc_resta /usr/lib/gimp/2.0/plug-ins/plugin_gidoc_resta /bin/bash ../libtool --mode=install /usr/bin/install -c 'plugin_gidoc_RLSA' '/usr/lib/gimp/2.0/plug-ins/plugin_gidoc_RLSA' /usr/bin/install -c plugin_gidoc_RLSA /usr/lib/gimp/2.0/plug-ins/plugin_gidoc_RLSA /bin/bash ../libtool --mode=install /usr/bin/install -c 'plugin_gidoc_clean' '/usr/lib/gimp/2.0/plug-ins/plugin_gidoc_clean' [...] > ls /usr/lib/gimp/2.0/plug-ins/ | grep gidoc plugin_gidoc_autocrop plugin_gidoc_clean plugin_gidoc_cm-extract plugin_gidoc_connect_cc plugin_gidoc_extract plugin_gidoc_fkiextfea plugin_gidoc_histogram plugin_gidoc_import_layout plugin_gidoc_layout plugin_gidoc_linedetection plugin_gidoc_median plugin_gidoc_normsize plugin_gidoc_preferences plugin_gidoc_prhltextfea plugin_gidoc_recognition plugin_gidoc_resta plugin_gidoc_result_analysis plugin_gidoc_RLSA plugin_gidoc_skew plugin_gidoc_slant plugin_gidoc_slope plugin_gidoc_substract plugin_gidoc_template_linedetection plugin_gidoc_thinning plugin_gidoc_train plugin_gidoc_transcription plugin_gidoc_widthscale
GiDoc installs multiple tools which are not visible in the Gimp menu by default. In order to show them use "./configure -enable-developer", "make" and "make install".
Correct installation of GiDoc can be checked by looking for giDoc procedures in the procedure browser or in the "/usr/lib/gimp/2.0/plug-ins" directory. Most giDoc procedure names start with the string "gidoc-" though there also many in which this string occurs after a different prefix.
HTK download requires registration but it is free of use for academic purposes. To install it, you will need the 32bit version of the standard C library (named as libc6-i386 packages in ubuntu 64bit distribution). After unpacking the sources, cd to the htk directory, and enter the commands: "./configure -disable-hslab", " make", and "sudo make install". HTK binaries will be installed in your "/usr/bin" directory.
As HTK , SRILM download requires registration but it is free of use for non-profit purposes. Once you extract the tarball, you may install the "csh" bash interpreter or choose an appropriate configuration suit from the "common" directory. In the first case, just enter the command "SRILM=`pwd` make". If this command fails, and also in the second case, you will have to set your machine type. For instance, in ubuntu amd64 7.10, the correct machine type is i686-m64, and it can be set by entering SRILM=`pwd` make MACHINE_TYPE=i686-m64".
giDoc Team