[Olena-patches] last-svn-commit-47-gb6f3691 Define documentation files.

* README.green: New index for source files in scribo/sandbox/green. * README.img: New index for image database. * README.result: New index for histogram database. --- scribo/sandbox/green/ChangeLog | 11 ++- scribo/sandbox/green/{README => README.green} | 58 ++++++++-- scribo/sandbox/green/README.img | 124 +++++++++++++++++++++ scribo/sandbox/green/README.result | 143 +++++++++++++++++++++++++ 4 files changed, 324 insertions(+), 12 deletions(-) rename scribo/sandbox/green/{README => README.green} (89%) create mode 100644 scribo/sandbox/green/README.img create mode 100644 scribo/sandbox/green/README.result diff --git a/scribo/sandbox/green/ChangeLog b/scribo/sandbox/green/ChangeLog index dc5284e..7e5b4bb 100644 --- a/scribo/sandbox/green/ChangeLog +++ b/scribo/sandbox/green/ChangeLog @@ -1,4 +1,13 @@ -2010-06-23 green <jacquelet(a)lrde.epita.fr> +2010-06-24 Yann Jacquelet <jacquelet(a)lrde.epita.fr> + + Define documentation files. + + * README: Delete this file and replace it by README.green. + * README.green: New index for source files in scribo/sandbox/green. + * README.img: New index for image database. + * README.result: New index for histogram database. + +2010-06-23 Yann Jacquelet <jacquelet(a)lrde.epita.fr> Define gnuplot shell export format. diff --git a/scribo/sandbox/green/README b/scribo/sandbox/green/README.green similarity index 89% rename from scribo/sandbox/green/README rename to scribo/sandbox/green/README.green index 03106d3..3f3c9a9 100644 --- a/scribo/sandbox/green/README +++ b/scribo/sandbox/green/README.green @@ -227,26 +227,62 @@ n'importe quel algorithme type huffman (tous les archiveurs en possède un). -VI MLN ------ +VIII VISUALISATION HISTOGRAMMES 3D +---------------------------------- -a) La sauvegarde des images au format gnuplot shell +==> to do -* mln/io/plot/save_image_sh.hh: Librairie sauvegarde format gnuplot shell. -to do ... +* demo/accu/stat/histo2d +* mln/display/dispay_histo.hh +* mln/display/project_histo.hh +IX KMEANS +--------- + +Ce travail m'avait été demandé par théo. Je le laisse inachevé, quelque part +perdu pendant l'optimisation du code et sa transformation en canevas. + +* mln/clustering/k_mean.hh: Première implémentation avec matrices et vecteurs. +* mln/clustering/kmean1d.hh: Implémentation 1d avec des images. +* mln/clustering/kmean2d.hh: Implémentation 2d avec des images. +* mln/clustering/kmean3d.hh: Implémentation 3d avec des images. +* mln/clustering/kmean_rgb.hh: Impl. 3d aplatie et en cours de mise en canevas. + +* tests/clustering/k_mean: Tests unitaires sur la permière version. +* tests/clustering/kmean1d: Tests unitaire sur la version 1d. + +* demo/clustering/kmean1d: Utilisation de la version 1d. +* demo/clustering/kmean2d: Utilisation de la version 2d. +* demo/clustering/kmean3d: Utilisation de la version 3d. +* demo/clustering/kmean_rgb: Utilisation de la version aplatie. + +* bench/clustering/distance: Comparaison algorithmes d'évaluation des distances. + +==> to do + +X REGIONAL MAXIMA +----------------- + +==> to do + + +XI ANNOTATING +------------- + +==> to do + + +a) La sauvegarde des images au format gnuplot shell + +* mln/io/plot/save_image_sh.hh: Librairie sauvegarde format gnuplot shell. + +to do ... -VII VISUALISATION HISTOGRAMMES 3D ---------------------------------- -c) La visualisation des histogrammes 3d -* demo/accu/stat/histo2d -* mln/display/dispay_histo.hh -* mln/displayproject_histo.hh diff --git a/scribo/sandbox/green/README.img b/scribo/sandbox/green/README.img new file mode 100644 index 0000000..c606a93 --- /dev/null +++ b/scribo/sandbox/green/README.img @@ -0,0 +1,124 @@ +I DESCRIPTION DES BASES D'IMAGES +-------------------------------- + +img ==> Répertoire des bases d'images +img/afp ==> Extrait de la base AFP (50 photos avec texte) +img/annotating-1 ==> Base diversifiée internet trop faible qualité +img/annotating-2 ==> Base diversifiée internet meilleur qualité +img/icdar ==> Base ICDAR en 20p/50p/100p (+quelques ajouts) +img/inim ==> Base complète du cours inim +img/olena ==> Images de tests d'olena (+quelques ajouts) + + +II DESCRIPTION DE CHAQUE BASE +----------------------------- + +A) BASE AFP + +img/afp/magick-pal-30-gen.sh ==> Génération base AFP 30 couleurs (imageMagick) +img/afp/magick-pal-20-gen.sh ==> Génération base AFP 20 couleurs (imageMagick) +img/afp/magick-pal-10-gen.sh ==> Génération base AFP 10 couleurs (imageMagick) + +img/afp/gimp-pal-30-gen.sh ==> Génération base AFP 30 couleurs (Gimp) +img/afp/gimp-pal-20-gen.sh ==> Génération base AFP 20 couleurs (Gimp) +img/afp/gimp-pal-10-gen.sh ==> Génération base AFP 10 couleurs (Gimp) + +Ne pas oublier le script de réduction des couleurs pour Gimp. + +$ more ~/.gimp-2.6/scripts/reduce-color.scm +(define (reduce-color filein fileout nbcol) + (let* ((image (car (gimp-file-load RUN-NONINTERACTIVE filein filein))) + (drawable (car (gimp-image-get-active-layer image))) + ) + (gimp-image-convert-indexed image NO-DITHER MAKE-PALETTE nbcol FALSE FALSE "") + (gimp-image-convert-rgb image) + (gimp-file-save RUN-NONINTERACTIVE image drawable fileout fileout) + (gimp-image-delete image) + )) + +img/afp/magick-pal-30 ==> Base AFP 30 couleurs (imageMagick) +img/afp/magick-pal-20 ==> Base AFP 20 couleurs (imageMagick) +img/afp/magick-pal-10 ==> Base AFP 10 couleurs (imageMagick) + +img/afp/gimp-pal-30 ==> Base AFP 30 couleurs (Gimp) +img/afp/gimp-pal-20 ==> Base AFP 20 couleurs (Gimp) +img/afp/gimp-pal-10 ==> Base AFP 10 couleurs (Gimp) + +img/afp/ppm ==> Base AFP originale convertie en ppm +img/afp/jpg ==> Base AFP originale + + +B) BASE ANNOTATING-1 + +img/annotating-1/screenshot ==> Fond d'écran, capture d'écran +img/annotating-1/slide ==> Transparents commerciaux ou conférences +img/annotating-1/handwritten ==> Ecritures manuscrites +img/annotating-1/map ==> Cartes marines, de régions, de villes +img/annotating-1/photo ==> Photo AFP +img/annotating-1/logo ==> Logos de toute sorte, de toute taille +img/annotating-1/typed ==> Documents textuels impimés +img/annotating-1/fax ==> Faxs +img/annotating-1/bill ==> Factures téléphones, eau ... + + +C) BASE ANNOTATING-2 + +img/annotating-2/slide ==> Transparents commerciaux ou conférences +img/annotating-2/handwritten ==> Ecritures manuscrites +img/annotating-2/logo ==> Logos de toute sorte, de toute taille +img/annotating-2/typed ==> Documents textuels impimés +img/annotating-1/bill ==> Factures téléphones, eau ... + + +D) BASE ICDAR + +img/icdar/100p/pbm ==> Base ICDAR 100% en noir & blanc +img/icdar/100p/pgm ==> Base ICDAR 100% en niveaux de gris +img/icdar/100p/ppm ==> Base ICDAR 100% en couleur +img/icdar/100p/gradient-thin ==> Masques de gradient thin sur base ICDAR 100% +img/icdar/100p/gradient-thick ==> Masques de gradient thick sur base ICDAR 100% + +img/icdar/50p/pbm ==> Base ICDAR 50% en noir & blanc +img/icdar/50p/pgm ==> Base ICDAR 50% en niveaux de gris +img/icdar/50p/ppm ==> Base ICDAR 50% en couleur + +img/icdar/20p/pbm ==> Base ICDAR 20% en noir & blanc +img/icdar/20p/pgm ==> Base ICDAR 20% en niveaux de gris +img/icdar/20p/ppm ==> Base ICDAR 20% en couleur + +img/icdar/20p/crop ==> Plein de crops sur la base ICDAR 20% (couleur) + +img/icdar/magick-pal-30-gen.sh => Génération base ICDAR 30 couleurs(imageMagick) +img/icdar/magick-pal-20-gen.sh => Génération base ICDAR 20 couleurs(imageMagick) +img/icdar/magick-pal-10-gen.sh => Génération base ICDAR 10 couleurs(imageMagick) + +img/icdar/gimp-pal-30-gen.sh ==> Génération base ICDAR 30 couleurs (Gimp) +img/icdar/gimp-pal-20-gen.sh ==> Génération base ICDAR 20 couleurs (Gimp) +img/icdar/gimp-pal-10-gen.sh ==> Génération base ICDAR 10 couleurs (Gimp) + +img/icdar/20p/magick-pal-30 ==> Base ICDAR 20% en noir & blanc +img/icdar/20p/magick-pal-20 ==> Base ICDAR 20% en niveaux de gris +img/icdar/20p/magick-pal-10 ==> Base ICDAR 20% en couleur + +img/icdar/20p/gimp-pal-30 ==> Base ICDAR 20% en noir & blanc +img/icdar/20p/gimp-pal-20 ==> Base ICDAR 20% en niveaux de gris +img/icdar/20p/gimp-pal-10 ==> Base ICDAR 20% en couleur + +img/icdar/20p/text-only ==> Images ICDAR avec textes uniquement +img/icdar/20p/text-color ==> Images ICDAR avec textes et couleurs +img/icdar/20p/text-photo ==> Images ICDAR avec textes et photos + + +E) BASE INIM + +img/inim/bg ==> Arrière plan (ppm) +img/inim/fg ==> Avant plan (ppm) +img/inim/in ==> Images d'entrées (ppm) + + +F) BASE OLENA + +Des images générales provenant d'Olena et d'autres pour tester, pour debugger +dans différents formats. + + diff --git a/scribo/sandbox/green/README.result b/scribo/sandbox/green/README.result new file mode 100644 index 0000000..4038a5b --- /dev/null +++ b/scribo/sandbox/green/README.result @@ -0,0 +1,143 @@ +I DESCRIPTION DES BASES D'IMAGES +-------------------------------- + +result ==> Répertoire des bases d'images +result/annotating/afp ==> Analyse de la base AFP +result/annotating/icdar ==> Analyse de la base ICDAR + + +II DESCRIPTION DES TYPES D'IMAGES +--------------------------------- + +Les deux bases d'images contiennent toutes les deux la même +structure. Les résultats sont donc générés sur les images d'origine +(input) et les images dont on a réduit le nombre de couleurs à +30/20/10 soit par gimp, soit par imageMagick. + +result/annotating/afp/input ==> Résultats base originale AFP +result/annotating/afp/magick-pal-30 ==> Résultats AFP 30 couleurs (imageMagick) +result/annotating/afp/magick-pal-20 ==> Résultats AFP 20 couleurs (imageMagick) +result/annotating/afp/magick-pal-10 ==> Résultats AFP 10 couleurs (imageMagick) +result/annotating/afp/gimp-pal-30 ==> Résultats AFP 30 couleurs (Gimp) +result/annotating/afp/gimp-pal-20 ==> Résultats AFP 20 couleurs (Gimp) +result/annotating/afp/gimp-pal-10 ==> Résultats AFP 10 couleurs (Gimp) + +result/annotating/icdar/input ==> Résultats base originale ICDAR +result/annotating/icdar/magick-pal-30 => Résultats ICDAR 30 clrs (imageMagick) +result/annotating/icdar/magick-pal-20 => Résultats ICDAR 20 clrs (imageMagick) +result/annotating/icdar/magick-pal-10 => Résultats ICDAR 10 clrs (imageMagick) +result/annotating/icdar/gimp-pal-30 ==> Résultats ICDAR 30 couleurs (Gimp) +result/annotating/icdar/gimp-pal-20 ==> Résultats ICDAR 20 couleurs (Gimp) +result/annotating/icdar/gimp-pal-10 ==> Résultats ICDAR 10 couleurs (Gimp) + + +II DESCRIPTION DES COMPOSANTES COULEURS +--------------------------------------- + +Pour chaque type d'image, on extraira ensuite les différents composantes +rouge (r), verte (v), bleue (b), teinte (h), saturation (s) et valeur (v). + +result/annotating/afp/input/r ==> comp. rouge base AFP +result/annotating/afp/input/g ==> comp. verte base AFP +result/annotating/afp/input/b ==> comp. bleue base AFP +result/annotating/afp/input/h ==> comp. teinte base AFP +result/annotating/afp/input/s ==> comp. saturation base AFP +result/annotating/afp/input/v ==> comp. valeur base AFP + +result/annotating/afp/magick-pal-30/r ==> comp. rouge AFP 30 clr.(imageMagick) +result/annotating/afp/magick-pal-30/g ==> comp. verte AFP 30 clr.(imageMagick) +result/annotating/afp/magick-pal-30/b ==> comp. bleue AFP 30 clr.(imageMagick) +result/annotating/afp/magick-pal-30/h ==> comp. teinte AFP 30 c.(imageMagick) +result/annotating/afp/magick-pal-30/s ==> comp. sat. AFP 30 clr.(imageMagick) +result/annotating/afp/magick-pal-30/v ==> comp. val. AFP 30 clr.(imageMagick) + +result/annotating/afp/magick-pal-20/r ==> comp. rouge AFP 20 clr.(imageMagick) +result/annotating/afp/magick-pal-20/g ==> comp. verte AFP 20 clr.(imageMagick) +result/annotating/afp/magick-pal-20/b ==> comp. bleue AFP 20 clr.(imageMagick) +result/annotating/afp/magick-pal-20/h ==> comp. teinte AFP 20 c.(imageMagick) +result/annotating/afp/magick-pal-20/s ==> comp. sat. AFP 20 clr.(imageMagick) +result/annotating/afp/magick-pal-20/v ==> comp. val. AFP 20 clr.(imageMagick) + +result/annotating/afp/magick-pal-10/r ==> comp. rouge AFP 10 clr.(imageMagick) +result/annotating/afp/magick-pal-10/g ==> comp. verte AFP 10 clr.(imageMagick) +result/annotating/afp/magick-pal-10/b ==> comp. bleue AFP 10 clr.(imageMagick) +result/annotating/afp/magick-pal-10/h ==> comp. teinte AFP 10 c.(imageMagick) +result/annotating/afp/magick-pal-10/s ==> comp. sat. AFP 10 clr.(imageMagick) +result/annotating/afp/magick-pal-10/v ==> comp. val. AFP 10 clr.(imageMagick) + +result/annotating/afp/gimp-pal-30/r ==> comp. rouge AFP 30 clr.(Gimp) +result/annotating/afp/gimp-pal-30/g ==> comp. verte AFP 30 clr.(Gimp) +result/annotating/afp/gimp-pal-30/b ==> comp. bleue AFP 30 clr.(Gimp) +result/annotating/afp/gimp-pal-30/h ==> comp. teinte AFP 30 clr.(Gimp) +result/annotating/afp/gimp-pal-30/s ==> comp. saturation AFP 30 clr.(Gimp) +result/annotating/afp/gimp-pal-30/v ==> comp. valeur AFP 30 clr.(Gimp) + +result/annotating/afp/gimp-pal-20/r ==> comp. rouge AFP 20 clr.(Gimp) +result/annotating/afp/gimp-pal-20/g ==> comp. verte AFP 20 clr.(Gimp) +result/annotating/afp/gimp-pal-20/b ==> comp. bleue AFP 20 clr.(Gimp) +result/annotating/afp/gimp-pal-20/h ==> comp. teinte AFP 20 clr.(Gimp) +result/annotating/afp/gimp-pal-20/s ==> comp. saturation AFP 20 clr.(Gimp) +result/annotating/afp/gimp-pal-20/v ==> comp. valeur AFP 20 clr.(Gimp) + +result/annotating/icdar/input/r ==> comp. rouge base ICDAR +result/annotating/icdar/input/g ==> comp. verte base ICDAR +result/annotating/icdar/input/b ==> comp. bleue base ICDAR +result/annotating/icdar/input/h ==> comp. teinte base ICDAR +result/annotating/icdar/input/s ==> comp. saturation base ICDAR +result/annotating/icdar/input/v ==> comp. valeur base ICDAR + +result/annotating/icdar/magick-pal-30/r => comp. rouge ICDAR 30 c.(imageMagick) +result/annotating/icdar/magick-pal-30/g => comp. verte ICDAR 30 c.(imageMagick) +result/annotating/icdar/magick-pal-30/b => comp. bleue ICDAR 30 c.(imageMagick) +result/annotating/icdar/magick-pal-30/h => comp. teinte ICDAR 30 c.(imageMagick) +result/annotating/icdar/magick-pal-30/s => comp. sat. ICDAR 30 c.(imageMagick) +result/annotating/icdar/magick-pal-30/v => comp. val. ICDAR 30 c.(imageMagick) + +result/annotating/icdar/magick-pal-20/r => comp. rouge ICDAR 20 c.(imageMagick) +result/annotating/icdar/magick-pal-20/g => comp. verte ICDAR 20 c.(imageMagick) +result/annotating/icdar/magick-pal-20/b => comp. bleue ICDAR 20 c.(imageMagick) +result/annotating/icdar/magick-pal-20/h => comp. teinte ICDAR 20 c.(imageMagick) +result/annotating/icdar/magick-pal-20/s => comp. sat. ICDAR 20 c.(imageMagick) +result/annotating/icdar/magick-pal-20/v => comp. val. ICDAR 20 c.(imageMagick) + +result/annotating/icdar/magick-pal-10/r => comp. rouge ICDAR 10 c.(imageMagick) +result/annotating/icdar/magick-pal-10/g => comp. verte ICDAR 10 c.(imageMagick) +result/annotating/icdar/magick-pal-10/b => comp. bleue ICDAR 10 c.(imageMagick) +result/annotating/icdar/magick-pal-10/h => comp. teinte ICDAR 10 c.(imageMagick) +result/annotating/icdar/magick-pal-10/s => comp. sat. ICDAR 10 c.(imageMagick) +result/annotating/icdar/magick-pal-10/v => comp. val. ICDAR 10 c.(imageMagick) + +result/annotating/icdar/gimp-pal-30/r => comp. rouge ICDAR 30 c.(Gimp) +result/annotating/icdar/gimp-pal-30/g => comp. verte ICDAR 30 c.(Gimp) +result/annotating/icdar/gimp-pal-30/b => comp. bleue ICDAR 30 c.(Gimp) +result/annotating/icdar/gimp-pal-30/h => comp. teinte ICDAR 30 c.(Gimp) +result/annotating/icdar/gimp-pal-30/s => comp. saturation ICDAR 30 c.(Gimp) +result/annotating/icdar/gimp-pal-30/v => comp. valeur ICDAR 30 c.(Gimp) + +result/annotating/icdar/gimp-pal-20/r => comp. rouge ICDAR 20 c.(Gimp) +result/annotating/icdar/gimp-pal-20/g => comp. verte ICDAR 20 c.(Gimp) +result/annotating/icdar/gimp-pal-20/b => comp. bleue ICDAR 20 c.(Gimp) +result/annotating/icdar/gimp-pal-20/h => comp. teinte ICDAR 20 c.(Gimp) +result/annotating/icdar/gimp-pal-20/s => comp. saturation ICDAR 20 c.(Gimp) +result/annotating/icdar/gimp-pal-20/v => comp. valeur ICDAR 20 c.(Gimp) + +result/annotating/icdar/gimp-pal-10/r => comp. rouge ICDAR 10 c.(Gimp) +result/annotating/icdar/gimp-pal-10/g => comp. verte ICDAR 10 c.(Gimp) +result/annotating/icdar/gimp-pal-10/b => comp. bleue ICDAR 10 c.(Gimp) +result/annotating/icdar/gimp-pal-10/h => comp. teinte ICDAR 10 c.(Gimp) +result/annotating/icdar/gimp-pal-10/s => comp. saturation ICDAR 10 c.(Gimp) +result/annotating/icdar/gimp-pal-10/v => comp. valeur ICDAR 10 c.(Gimp) + + +III DESCRIPTION DES TYPES DE RESULTAT +------------------------------------- + +Pour chaque composante et pour chaque image de la base, on obtient une +image en niveau de gris correspondant à la composante (pgm) et son +histogramme normalisé (gnuplot shell). L'histogramme normalisé est un +histogramme dont l'aire vaut 1 (c'est une densité en fait, autrement +dit chaque fréquence a été divisée par la somme des fréquences). Un +script add_range.sh, a permis de rajouter les bornes des axes pour la +visualisation pour chacun des histogrammes générés. Cette +représentation des histogrammes des composantes sous forme de densité +permet de comparer visuellement les images des différentes classes. -- 1.5.6.5