Olena-patches
Threads by month
- ----- 2025 -----
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2024 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2023 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2022 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2021 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2020 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2019 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2018 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2017 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2016 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2015 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2014 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2013 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2012 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2011 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2010 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2009 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2008 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2007 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2006 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2005 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2004 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- 9625 discussions
01 Oct '09
---
milena/ChangeLog | 4 ++++
milena/doc/Doxyfile.in | 8 ++++----
2 files changed, 8 insertions(+), 4 deletions(-)
diff --git a/milena/ChangeLog b/milena/ChangeLog
index 8548398..7572dec 100644
--- a/milena/ChangeLog
+++ b/milena/ChangeLog
@@ -1,5 +1,9 @@
2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+ * doc/Doxyfile.in Add missing include paths for doc generation.
+
+2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+
Introduce a technical documentation.
* doc/Makefile.am: Add technical as subdir.
diff --git a/milena/doc/Doxyfile.in b/milena/doc/Doxyfile.in
index 94c0c9b..250a585 100644
--- a/milena/doc/Doxyfile.in
+++ b/milena/doc/Doxyfile.in
@@ -102,8 +102,7 @@ RECURSIVE = YES
EXCLUDE = @top_srcdir@/milena/sandbox \
@top_srcdir@/milena/mln/core/concept/proxy.hxx \
@top_srcdir@/milena/trash \
- @top_srcdir@/milena/doc/examples/trash \
- @top_srcdir@/milena/doc/examples/split
+ @top_srcdir@/milena/doc/examples/trash
EXCLUDE_SYMLINKS = YES
EXCLUDE_PATTERNS = *spe.hh
EXCLUDE_SYMBOLS =
@@ -114,8 +113,9 @@ EXAMPLE_PATH = @top_srcdir@/milena/doc/examples \
EXAMPLE_PATTERNS = *.cc \
*.cc.raw
EXAMPLE_RECURSIVE = NO
-IMAGE_PATH = @top_srcdir@/milena/doc/img \
- @top_srcdir@/milena/doc/figures \
+IMAGE_PATH = @top_srcdir@/milena/doc/devel/figures \
+ @top_srcdir@/milena/doc/img \
+ @top_srcdir@/milena/doc/figures \
@top_builddir@/milena/doc/figures
INPUT_FILTER =
FILTER_PATTERNS =
--
1.5.6.5
1
0
01 Oct '09
---
scribo/ChangeLog | 4 ++++
scribo/table/extract.hh | 4 ++--
2 files changed, 6 insertions(+), 2 deletions(-)
diff --git a/scribo/ChangeLog b/scribo/ChangeLog
index 2668fd4..3eded52 100644
--- a/scribo/ChangeLog
+++ b/scribo/ChangeLog
@@ -1,5 +1,9 @@
2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+ * table/extract.hh: Fix invalid calls to lines_*_pattern.
+
+2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+
New debugging tools for Scribo.
* src/Makefile.am: Add debug as subdir.
diff --git a/scribo/table/extract.hh b/scribo/table/extract.hh
index 2e652d2..efd030c 100644
--- a/scribo/table/extract.hh
+++ b/scribo/table/extract.hh
@@ -87,8 +87,8 @@ namespace scribo
mlc_equal(mln_value(I), bool)::check();
image2d<bool>
- bhlines = scribo::primitive::extract::lines_h_pattern(input, 51),
- bvlines = scribo::primitive::extract::lines_v_pattern(input, 51);
+ bhlines = scribo::primitive::extract::lines_h_pattern(input, 51, 3),
+ bvlines = scribo::primitive::extract::lines_v_pattern(input, 51, 3);
V nhlines, nvlines;
object_image(mln_ch_value(I,V))
--
1.5.6.5
1
0
* doc/Makefile.am: Add technical as subdir.
* doc/doxyfuns.sty: Do not force the use of png images.
* doc/examples/devel/dispatch.cc.raw,
* doc/examples/devel/facade.cc.raw,
* doc/examples/devel/impl.cc.raw: New. Examples used in the
developer documentation.
* doc/technical/Makefile.am,
* doc/technical/figures/file_layout.pdf,
* doc/technical/figures/file_layout.png,
* doc/technical/technical.tex: New.
---
milena/ChangeLog | 18 ++
milena/doc/Makefile.am | 1 +
milena/doc/doxyfuns.sty | 2 +-
milena/doc/examples/devel/dispatch.cc.raw | 49 ++++++
milena/doc/examples/devel/facade.cc.raw | 18 ++
milena/doc/examples/devel/impl.cc.raw | 40 +++++
milena/doc/technical/Makefile.am | 112 ++++++++++++
milena/doc/technical/figures/file_layout.pdf | Bin 0 -> 26680 bytes
milena/doc/technical/figures/file_layout.png | Bin 0 -> 117801 bytes
milena/doc/technical/technical.tex | 234 ++++++++++++++++++++++++++
10 files changed, 473 insertions(+), 1 deletions(-)
create mode 100644 milena/doc/examples/devel/dispatch.cc.raw
create mode 100644 milena/doc/examples/devel/facade.cc.raw
create mode 100644 milena/doc/examples/devel/impl.cc.raw
create mode 100644 milena/doc/technical/Makefile.am
create mode 100644 milena/doc/technical/figures/file_layout.pdf
create mode 100644 milena/doc/technical/figures/file_layout.png
create mode 100644 milena/doc/technical/technical.tex
diff --git a/milena/ChangeLog b/milena/ChangeLog
index 351dd4c..8548398 100644
--- a/milena/ChangeLog
+++ b/milena/ChangeLog
@@ -1,5 +1,23 @@
2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+ Introduce a technical documentation.
+
+ * doc/Makefile.am: Add technical as subdir.
+
+ * doc/doxyfuns.sty: Do not force the use of png images.
+
+ * doc/examples/devel/dispatch.cc.raw,
+ * doc/examples/devel/facade.cc.raw,
+ * doc/examples/devel/impl.cc.raw: New. Examples used in the
+ developer documentation.
+
+ * doc/technical/Makefile.am,
+ * doc/technical/figures/file_layout.pdf,
+ * doc/technical/figures/file_layout.png,
+ * doc/technical/technical.tex: New.
+
+2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+
* doc/ref_guide/ref_guide.tex: Add a new section about common compilation errors.
2009-10-01 Roland Levillain <roland(a)lrde.epita.fr>
diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am
index 61b949f..de65f3e 100644
--- a/milena/doc/Makefile.am
+++ b/milena/doc/Makefile.am
@@ -23,6 +23,7 @@ include $(top_srcdir)/milena/doc/doc.mk
SUBDIRS = \
examples \
ref_guide \
+ technical \
tutorial \
white_paper
diff --git a/milena/doc/doxyfuns.sty b/milena/doc/doxyfuns.sty
index e99bff0..cd8d8bf 100644
--- a/milena/doc/doxyfuns.sty
+++ b/milena/doc/doxyfuns.sty
@@ -176,7 +176,7 @@ $$
\label{#1}%
}
\renewcommand{\doxyimg}[2]{%
-\pgfimage[width=#2]{#1.png}%
+\pgfimage[width=#2]{#1}%
\label{#1}%
}
\renewcommand{\doxyref}[1]{\ref{#1}}
diff --git a/milena/doc/examples/devel/dispatch.cc.raw b/milena/doc/examples/devel/dispatch.cc.raw
new file mode 100644
index 0000000..c999411
--- /dev/null
+++ b/milena/doc/examples/devel/dispatch.cc.raw
@@ -0,0 +1,49 @@
+namespace internal
+{
+
+ // Generic case, whatever the image value and domain
+ // types.
+ template <typename I, typename N>
+ mln_concrete(I)
+ erosion_tolerant_dispatch(trait::image::kind::any,
+ trait::image::speed::any,
+ const I& input, const N& nbh,
+ unsigned rank)
+ {
+ return impl::generic::erosion_tolerant(input,
+ nbh,
+ rank);
+ }
+
+ // The image has bool values and is defined on a box.
+ template <typename I, typename N>
+ mln_concrete(I)
+ erosion_tolerant_dispatch(trait::image::kind::logic,
+ trait::image::speed::fastest,
+ const I& input, const N& nbh,
+ unsigned rank)
+ {
+ return
+ impl::erosion_tolerant_on_set_fastest(input,
+ nbh,
+ rank);
+ }
+
+
+ // Dispatch entry point.
+ template <typename I, typename N>
+ inline
+ mln_concrete(I)
+ erosion_tolerant_dispatch(const Image<I>& input,
+ const Neighborhood<N>& nbh,
+ unsigned rank)
+ {
+ return
+ erosion_tolerant_dispatch(mln_trait_image_kind(I)(),
+ mln_trait_image_speed(I)(),
+ exact(input),
+ exact(nbh),
+ rank);
+ }
+
+} // end of namespace mln::internal
diff --git a/milena/doc/examples/devel/facade.cc.raw b/milena/doc/examples/devel/facade.cc.raw
new file mode 100644
index 0000000..0ef0196
--- /dev/null
+++ b/milena/doc/examples/devel/facade.cc.raw
@@ -0,0 +1,18 @@
+template <typename I, typename N>
+inline
+mln_concrete(I)
+erosion_tolerant(const Image<I>& input, const Neighborhood<N>& nbh,
+ unsigned rank)
+{
+ trace::entering("morpho::erosion_tolerant");
+ mln_precondition(exact(input).is_valid());
+ mln_precondition(exact(nbh).is_valid());
+
+ mln_concrete(I) output
+ = internal::erosion_tolerant_dispatch(input,
+ nbh,
+ rank);
+
+ trace::exiting("morpho::erosion_tolerant");
+ return output;
+}
diff --git a/milena/doc/examples/devel/impl.cc.raw b/milena/doc/examples/devel/impl.cc.raw
new file mode 100644
index 0000000..eb9ea05
--- /dev/null
+++ b/milena/doc/examples/devel/impl.cc.raw
@@ -0,0 +1,40 @@
+namespace impl
+{
+
+ namespace generic
+ {
+
+ template <typename I, typename N>
+ mln_concrete(I)
+ erosion_tolerant_on_set(const Image<I>& input_,
+ const Neighborhood<N>& nbh_,
+ unsigned rank)
+ {
+ trace::entering("impl::generic::erosion_tolerant");
+
+ // Do it...
+
+ trace::exiting("impl::generic::erosion_tolerant");
+ return output;
+ }
+
+ }
+
+
+ template <typename I, typename N>
+ mln_concrete(I)
+ erosion_tolerant_on_set_fastest(const Image<I>& input_,
+ const Neighborhood<N>& nbh_,
+ unsigned rank)
+ {
+ trace::entering("impl::erosion_tolerant_on_set_fastest");
+
+
+ // Do it...
+
+ trace::exiting("impl::erosion_tolerant_on_set_fastest");
+ return output;
+ }
+
+
+} // end of namespace impl
diff --git a/milena/doc/technical/Makefile.am b/milena/doc/technical/Makefile.am
new file mode 100644
index 0000000..14cdeb3
--- /dev/null
+++ b/milena/doc/technical/Makefile.am
@@ -0,0 +1,112 @@
+# Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE).
+#
+# This file is part of Olena.
+#
+# Olena is free software: you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free
+# Software Foundation, version 2 of the License.
+#
+# Olena is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Olena. If not, see <http://www.gnu.org/licenses/>.
+#
+
+.PHONY: technical technical-html
+
+include $(top_srcdir)/milena/doc/doc.mk
+
+TEXINPUTS ="$(DOC_SRCDIR):$(OUTPUTS_SRCDIR):$(srcdir):\
+$(SPLIT_OUTPUTS_SRCDIR):$(IMG_SRCDIR):$(SPLIT_EXAMPLES_SRCDIR):"
+
+
+technical: technical-html technical-pdf
+
+# FIXME: As in milena/doc/Makefile.am, we should probably strip
+# $(srcdir) prefixes from target variables, e.g. instead of:
+#
+# FOO = $(srcdir)/foo.pdf
+# $(FOO): foo.tex bar.tex
+# dist_doc_DATA = $(FOO)
+#
+# we should use:
+#
+# FOO = foo.pdf
+# $(srcdir)/$(FOO): foo.tex bar.tex
+# dist_doc_DATA = $(FOO)
+#
+# since it minimizes installation issues (see milena/doc/Makefile.am
+# and Vaucanson's doc/Makefile.am).
+
+# FIXME: Distributed products should be generated in the source dir.
+# That's actually the case, *but* the current solution is not clean
+# and might break sometimes. The clean approach is to create a
+# temporary directory, try to generate the documentation there, and
+# move its contents to the source dir in case of success. If the
+# product is a directory, also refresh a timestamp (in the source
+# dir).
+
+# Intermediate product for the various doc targets of the parent
+# directory.
+#
+# This is not a bug: TECHNICAL_HH is meant to have a `.hh'
+# extension, since it is later parsed by Doxygen, which complains
+# about `.html' files.
+TECHNICAL_HH = $(srcdir)/technical.hh
+technical-html: $(TECHNICAL_HH)
+$(TECHNICAL_HH): technical.tex $(srcdir)/../figures.stamp
+ $(DOC_SRCDIR)/tools/todoxygen.sh \
+ $< $(DOC_SRCDIR)/technical $(DOC_SRCDIR)
+
+
+# Final product.
+TECHNICAL_PDF = $(srcdir)/technical.pdf
+technical-pdf: $(TECHNICAL_PDF)
+$(TECHNICAL_PDF): technical.tex $(srcdir)/../figures.stamp
+ TEXINPUTS=$(TEXINPUTS) pdflatex $<
+ TEXINPUTS=$(TEXINPUTS) pdflatex $<
+ TEXINPUTS=$(TEXINPUTS) pdflatex $< \
+ test "$(top_srcdir)" == "$(top_builddir)" \
+ || mv -f $(builddir)/technical.pdf $(srcdir)
+
+# FIXME: Regenerating figures.stamp requires make to go back to the
+# parent directory. We already do the opposite (descending from
+# milena/doc/ to milena/doc/tutorial/Makefile in milena/doc/ to update
+# tutorial.hh). This is not sound. We probably want to put together
+# somes of these files, and maybe get rid of some directories, or at
+# least move most of the Makefile machinery into
+# milena/doc/Makefile.am.
+$(srcdir)/../figures.stamp:
+ cd .. && $(MAKE) $(AM_MAKEFLAGS) fig-convert
+
+dist_doc_DATA = $(TECHNICAL_PDF)
+
+EXTRA_DIST = \
+ technical.tex \
+ $(TECHNICAL_HH)
+
+CLEANFILES = \
+ technical.aux technical.toc technical.log technical.bbl technical.out \
+ *blg *.lot \
+ $(TECHNICAL_PDF) \
+ *.haux *.hh *.html *.htoc \
+ technical.html \
+ technical.idx \
+ $(TECHNICAL_HH)
+
+
+#<<lrde
+# Pretend the documentation is up-to-date.
+.PHONY: fake-doc
+fake-doc:
+ touch $(TECHNICAL_HH)
+ touch $(TECHNICAL_PDF)
+
+# The converse of the previous rule, voiding the timestamps.
+.PHONY: void-doc
+void-doc:
+ touch $(srcdir)/technical.tex
+#>>
diff --git a/milena/doc/technical/figures/file_layout.pdf b/milena/doc/technical/figures/file_layout.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..bd474de5eefd04fc3a5f124e66098c4f2bc19666
GIT binary patch
literal 26680
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
literal 0
HcmV?d00001
diff --git a/milena/doc/technical/figures/file_layout.png b/milena/doc/technical/figures/file_layout.png
new file mode 100644
index 0000000000000000000000000000000000000000..812cf26b0af2ea3d6058d4616d94ef392ca7f4c8
GIT binary patch
literal 117801
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
Jer)vie*s|W?RfwI
literal 0
HcmV?d00001
diff --git a/milena/doc/technical/technical.tex b/milena/doc/technical/technical.tex
new file mode 100644
index 0000000..198bcd6
--- /dev/null
+++ b/milena/doc/technical/technical.tex
@@ -0,0 +1,234 @@
+%% Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE)
+%%
+%% This file is part of Olena.
+%%
+%% Olena is free software: you can redistribute it and/or modify it under
+%% the terms of the GNU General Public License as published by the Free
+%% Software Foundation, version 2 of the License.
+%%
+%% Olena is distributed in the hope that it will be useful,
+%% but WITHOUT ANY WARRANTY; without even the implied warranty of
+%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+%% General Public License for more details.
+%%
+%% You should have received a copy of the GNU General Public License
+%% along with Olena. If not, see <http://www.gnu.org/licenses/>.
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Milena's technical documentation. %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+\documentclass{report}
+
+%\usepackage{hevea}
+
+\usepackage{html}
+\usepackage{graphicx}
+\usepackage{makeidx}
+\usepackage{xcolor}
+\usepackage{color}
+\usepackage{hyperref}
+\usepackage{pgf}
+\usepackage{hyperref}
+\usepackage{doxyfuns}
+\usepackage{milena}
+
+\title{Milena -- Technical documentation}
+\author{LRDE}
+\date{}
+\makeindex
+
+\begin{document}
+
+
+% Doxygen use only - Generate the left menu.
+%Write foreword below.
+\begin{htmlonly}
+\backslash endhtmlonly
+
+\backslash page techdoc Technical Documentation
+- \backslash subpage codingstyle
+- \backslash subpage extendlib
+- \backslash subpage ressources
+\backslash htmlonly
+\end{htmlonly}
+
+
+
+\begin{latexonly}
+\maketitle
+
+%===============================================================
+\chapter*{Copyright}
+
+Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE).
+
+
+This document is part of Olena.
+
+
+Olena is free software: you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free
+Software Foundation, version 2 of the License.
+
+
+Olena is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+for more details.
+
+
+You should have received a copy of the GNU General Public License
+along with Olena. If not, see $<$http://www.gnu.org/licenses/$>$.
+
+
+\tableofcontents
+\end{latexonly}
+
+
+
+
+
+%===============================================================
+\doxychapter{codingstyle}{Coding Style}
+
+The coding style is going to be updated. However, there are few
+reference documents available here:
+
+\begin{itemize}
+ \item https://trac.lrde.org/olena/wiki/CodingStyle
+
+ \item https://olena.lrde.epita.fr/cgi-bin/twiki/view/Olena/CodingStyle010
+\end{itemize}
+
+
+
+
+
+%===============================================================
+\doxychapter{extendlib}{Extend the Library}
+
+
+
+%***************************************************************
+\doxysection{newvaluetype}{Add a new image value type}
+
+% - classes parentes/de base
+% - Ajouts d'operateurs associes
+
+
+%***************************************************************
+\doxysection{newimagetype}{Add a new image type}
+
+
+
+%***************************************************************
+\clearpage
+\doxysection{newroutine}{Add a new routine}
+
+
+Writing a new routine in Milena requires a specific layout in the
+code. This layout is described in figure \ref{figures/file_layout}.
+
+\begin{center}
+ \doxyimg{figures/file_layout}{8cm}
+\end{center}
+
+
+For a better understanding, we are going to comment this figure
+(fig. \ref{figures/file_layout}) from the bottom to the top.
+
+\begin{itemize}
+ \item \textbf{Facade}. The facade is the public routine that will be
+ called by the user. It \should not contains any processing code
+ but call dispatch routines. It \must be fully generic.
+
+ An example:
+ \doxyrawcode{devel/facade}
+
+
+ \item \textbf{Implementation dispatch}. According to specific
+ information, the dispatch will call the proper implementation of
+ the algorithm. The dispatch is almost always static. It might
+ contains dynamic dispatch in very specific cases. Dispatch
+ function names are composed of the routine name with
+ ``\_dispatch'' appended to it.
+ Dispatch entry point routine must have the same prototype as the
+ facade.
+ Dispatch routines are not intended to be called by the user.
+
+ An example:
+ \doxyrawcode{devel/dispatch}
+
+
+ \item \textbf{Specific implementation}. Implementation routine are
+ intended to be called by the user. Thus, they must have an
+ explicit name of what they do and what they take as
+ parameter. They implement de processing code which may be specific
+ for certain types.
+ \var{namespace impl} may also have a sub namespace called
+ \var{generic} for the generic algorithm.
+
+ An example:
+ \doxyrawcode{devel/impl}
+
+
+ \item \textbf{Shared tests and internal routines}. This is the right
+ place to move all the internal routines related to this new
+ routine. They will be hidden to the user.
+
+
+ \item \textbf{Facade prototype}. This is what the user should see
+ first if the file is edited. The documentation should be written
+ here.
+\end{itemize}
+
+
+Note that all parts of the file except the ``facade prototype'' are included between \var{MLN\_INCLUDE\_ONLY} guards.
+
+
+%===============================================================
+\doxychapter{ressources}{Developer Ressources}
+
+
+%***************************************************************
+\doxysection{quality}{Project Quality}
+
+\begin{itemize}
+ \item QA Center : https://trac.lrde.org/olena/wiki/QACenter
+ \item Buildbot : https://buildfarm.lrde.org/buildfarm/oln/
+ \item Trac : http://trac.lrde.org/olena
+\end{itemize}
+
+
+%***************************************************************
+\doxysection{qna}{Questions and Answers}
+
+The best way to keep in touch with the latest patches or ask your
+questions is to subscribe to our mailing lists.
+
+Currently four mailing-lists are available:
+
+\begin{tabular}{l l}
+ \textbf{Olena} & Discussion about the project Olena \\
+ \textbf{Olena-bugs} & Bugs from Olena projects \\
+ \textbf{Olena-core} & Internal list for the Olena project \\
+ \textbf{Olena-patches} & patches for the Olena project \\
+\end{tabular}
+
+You can subscribe to these mailing lists at the following address:
+
+\begin{center}
+\begin{verbatim}
+https://www.lrde.epita.fr/mailman/listinfo/
+\end{verbatim}
+\end{center}
+
+Just click on the name of the mailing list you want to subscribe to
+and fill out the form.
+
+
+\end{document}
--
1.5.6.5
1
0
4598: doc/ref_guide/ref_guide.tex: Add a new section about common compilation errors.
by Guillaume Lazzara 01 Oct '09
by Guillaume Lazzara 01 Oct '09
01 Oct '09
---
milena/ChangeLog | 4 ++++
milena/doc/ref_guide/ref_guide.tex | 35 +++++++++++++++++++++++++++++++----
2 files changed, 35 insertions(+), 4 deletions(-)
diff --git a/milena/ChangeLog b/milena/ChangeLog
index 0e55663..351dd4c 100644
--- a/milena/ChangeLog
+++ b/milena/ChangeLog
@@ -1,3 +1,7 @@
+2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+
+ * doc/ref_guide/ref_guide.tex: Add a new section about common compilation errors.
+
2009-10-01 Roland Levillain <roland(a)lrde.epita.fr>
Clean up a creation routine in graph-morpho.
diff --git a/milena/doc/ref_guide/ref_guide.tex b/milena/doc/ref_guide/ref_guide.tex
index d978d3e..76c0682 100644
--- a/milena/doc/ref_guide/ref_guide.tex
+++ b/milena/doc/ref_guide/ref_guide.tex
@@ -1985,12 +1985,39 @@ mln\_edge\_nbh\_edge\_iter(G) & G : graph type & Iterator on the edges adjacen
%====================================
%\newpage
%\clearpage
-%Ugly workaround to avoid missing chapter references in doxygen.
-%\begin{htmlonly}
-%\doxychapter{2}{}
-%\end{htmlonly}
%\doxychapter{debugtools}{Debugging tools}
%FIXME write it
+
+
+%====================================
+\newpage
+\clearpage
+\doxychapter{compilerrors}{Common Compilation Errors}
+
+In this section, the most common compilation errors are gathered and explained.
+
+\begin{itemize}
+ \item
+ \textbf{error: 'check' is not a member of 'mln::metal::not\_equal$<$bool, bool$>$} \\
+ \textbf{error: 'check' is not a member of 'mln::metal::converts\_to$<$mln::value::rgb$<$8u$>$, unsigned int$>$'} \\
+
+ The routine does not support a given image with such a value type
+ or an automatic conversion from the image value type to the
+ expected value type is not available.
+
+
+ \item
+ \textbf{error: using 'typename' outside of template} \\
+
+ Macros like \code{mln\_site} or \code{mln\_domain} can only be
+ used in templated functions. In order to use them in a
+ non-templated function, a `\_' must be appended to the macro
+ name. For instance : \code{mln\_site\_} and \code{mln\_domain\_}.
+
+\end{itemize}
+
+
+
\end{document}
--
1.5.6.5
1
0
---
ChangeLog | 4 ++++
configure.ac | 1 +
2 files changed, 5 insertions(+), 0 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index e4af1a1..e5fb2a5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+ * configure.ac: Configure scribo/src/debug.
+
+2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+
* configure.ac: Configure milena/doc/technical.
2009-09-28 Guillaume Lazzara <z(a)lrde.epita.fr>
diff --git a/configure.ac b/configure.ac
index eee55fe..c12da4d 100644
--- a/configure.ac
+++ b/configure.ac
@@ -213,6 +213,7 @@ AC_CONFIG_FILES([
scribo/demo/Makefile
scribo/src/Makefile
scribo/src/binarization/Makefile
+ scribo/src/debug/Makefile
scribo/src/filter/Makefile
scribo/src/misc/Makefile
scribo/src/multi_scale/Makefile
--
1.5.6.5
1
0
* src/Makefile.am: Add debug as subdir.
* src/debug/Makefile.am,
* src/debug/show_left_right_links_validation.cc,
* src/debug/show_link_single_left.cc,
* src/debug/show_link_single_right.cc,
* src/debug/show_objects_large.cc,
* src/debug/show_objects_small.cc,
* src/debug/show_objects_thin.cc: New.
---
scribo/ChangeLog | 14 +++
scribo/src/Makefile.am | 1 +
scribo/src/debug/Makefile.am | 36 ++++++
.../src/debug/show_left_right_links_validation.cc | 122 ++++++++++++++++++++
scribo/src/debug/show_link_single_left.cc | 117 +++++++++++++++++++
scribo/src/debug/show_link_single_right.cc | 117 +++++++++++++++++++
scribo/src/debug/show_objects_large.cc | 84 ++++++++++++++
scribo/src/debug/show_objects_small.cc | 84 ++++++++++++++
8 files changed, 575 insertions(+), 0 deletions(-)
create mode 100644 scribo/src/debug/Makefile.am
create mode 100644 scribo/src/debug/show_left_right_links_validation.cc
create mode 100644 scribo/src/debug/show_link_single_left.cc
create mode 100644 scribo/src/debug/show_link_single_right.cc
create mode 100644 scribo/src/debug/show_objects_large.cc
create mode 100644 scribo/src/debug/show_objects_small.cc
create mode 100644 scribo/src/debug/show_objects_thin.cc
diff --git a/scribo/ChangeLog b/scribo/ChangeLog
index 6a97f58..2668fd4 100644
--- a/scribo/ChangeLog
+++ b/scribo/ChangeLog
@@ -1,5 +1,19 @@
2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+ New debugging tools for Scribo.
+
+ * src/Makefile.am: Add debug as subdir.
+
+ * src/debug/Makefile.am,
+ * src/debug/show_left_right_links_validation.cc,
+ * src/debug/show_link_single_left.cc,
+ * src/debug/show_link_single_right.cc,
+ * src/debug/show_objects_large.cc,
+ * src/debug/show_objects_small.cc,
+ * src/debug/show_objects_thin.cc: New.
+
+2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+
Few improvements in Scribo.
* debug/usage.hh: Improve output.
diff --git a/scribo/src/Makefile.am b/scribo/src/Makefile.am
index aa82499..6cc4229 100644
--- a/scribo/src/Makefile.am
+++ b/scribo/src/Makefile.am
@@ -21,6 +21,7 @@ include $(top_srcdir)/scribo/scribo.mk
SUBDIRS = \
binarization \
+ debug \
primitive \
filter \
misc \
diff --git a/scribo/src/debug/Makefile.am b/scribo/src/debug/Makefile.am
new file mode 100644
index 0000000..1d396a5
--- /dev/null
+++ b/scribo/src/debug/Makefile.am
@@ -0,0 +1,36 @@
+# Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE).
+#
+# This file is part of Olena.
+#
+# Olena is free software: you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free
+# Software Foundation, version 2 of the License.
+#
+# Olena is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Olena. If not, see <http://www.gnu.org/licenses/>.
+#
+
+## Process this file through Automake to create Makefile.in.
+
+include $(top_srcdir)/scribo/scribo.mk
+
+bin_PROGRAMS = \
+ show_objects_large \
+ show_left_right_links_validation \
+ show_link_single_left \
+ show_link_single_right \
+ show_objects_small \
+ show_objects_thin
+
+
+show_objects_large_SOURCES = show_objects_large.cc
+show_left_right_links_validation_SOURCES = show_left_right_links_validation.cc
+show_link_single_left_SOURCES = show_link_single_left.cc
+show_link_single_right_SOURCES = show_link_single_right.cc
+show_objects_small_SOURCES = show_objects_small.cc
+show_objects_thin_SOURCES = show_objects_thin.cc
diff --git a/scribo/src/debug/show_left_right_links_validation.cc b/scribo/src/debug/show_left_right_links_validation.cc
new file mode 100644
index 0000000..bb23dd5
--- /dev/null
+++ b/scribo/src/debug/show_left_right_links_validation.cc
@@ -0,0 +1,122 @@
+// Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#include <iostream>
+
+#include <mln/core/image/image2d.hh>
+#include <mln/labeling/colorize.hh>
+#include <mln/debug/println.hh>
+#include <mln/data/convert.hh>
+#include <mln/util/array.hh>
+#include <mln/literal/colors.hh>
+#include <mln/io/pbm/load.hh>
+#include <mln/io/ppm/save.hh>
+#include <mln/core/alias/neighb2d.hh>
+#include <mln/value/label_16.hh>
+
+#include <scribo/core/object_links.hh>
+#include <scribo/core/object_image.hh>
+
+#include <scribo/primitive/extract/objects.hh>
+
+#include <scribo/primitive/link/with_single_left_link.hh>
+#include <scribo/primitive/link/with_single_right_link.hh>
+#include <scribo/primitive/link/merge_double_link.hh>
+
+#include <scribo/draw/bounding_boxes.hh>
+#include <scribo/draw/bounding_box_links.hh>
+
+#include <scribo/debug/usage.hh>
+
+
+
+const char *args_desc[][2] =
+{
+ { "input.pbm", "A binary image. 'True' for objects, 'False'\
+for the background." },
+ { "hlmax", "Maximum distance between two grouped objects while browsing on the left." },
+ { "hrmax", "Maximum distance between two grouped objects while browsing on the right." },
+ {0, 0}
+};
+
+int main(int argc, char *argv[])
+{
+ using namespace scribo;
+ using namespace mln;
+
+ if (argc != 5)
+ return scribo::debug::usage(argv,
+ "Display double validated (left and right) links between objects",
+ "<input.pbm> <hlmax> <hrmax> <output.ppm>",
+ args_desc,
+ "A color image. Validated links are drawn in green.");
+
+ image2d<bool> input;
+ io::pbm::load(input, argv[1]);
+
+ // Finding objects.
+ value::label_16 nbboxes;
+ typedef image2d<value::label_16> L;
+ object_image(L) objects = primitive::extract::objects(input, c8(), nbboxes);
+
+ // Left links.
+ object_links<L> left_link
+ = primitive::link::with_single_left_link(objects, atoi(argv[2]));
+
+ // Right links.
+ object_links<L> right_link
+ = primitive::link::with_single_right_link(objects, atoi(argv[3]));
+
+ // Validation.
+ object_links<L>
+ links = primitive::link::merge_double_link(objects, left_link, right_link);
+
+
+ // Saving result.
+ image2d<value::rgb8> output = data::convert(value::rgb8(), input);
+
+// scribo::draw::bounding_boxes(output, objects, literal::blue);
+ scribo::draw::bounding_box_links(output,
+ objects.bboxes(),
+ links,
+ literal::green);
+
+ util::array<bool> drawn(objects.nlabels(), 0);
+ for_all_components(i, objects.bboxes())
+ if (links[i] == i && ! drawn(i))
+ {
+ mln::draw::box(output, objects.bbox(i), literal::orange);
+ drawn[i] = true;
+ }
+ else
+ {
+ mln::draw::box(output, objects.bbox(i), literal::blue);
+ mln::draw::box(output, objects.bbox(links[i]), literal::blue);
+ drawn[i] = true;
+ drawn[links[i]] = true;
+ }
+
+ io::ppm::save(output, argv[4]);
+}
diff --git a/scribo/src/debug/show_link_single_left.cc b/scribo/src/debug/show_link_single_left.cc
new file mode 100644
index 0000000..a8b42f2
--- /dev/null
+++ b/scribo/src/debug/show_link_single_left.cc
@@ -0,0 +1,117 @@
+// Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#include <iostream>
+
+#include <mln/core/image/image2d.hh>
+#include <mln/core/alias/neighb2d.hh>
+
+#include <mln/data/convert.hh>
+
+#include <mln/value/rgb8.hh>
+#include <mln/value/label_16.hh>
+#include <mln/literal/colors.hh>
+
+#include <mln/io/pbm/load.hh>
+#include <mln/io/ppm/save.hh>
+
+#include <scribo/primitive/extract/objects.hh>
+#include <scribo/primitive/link/with_single_left_link.hh>
+
+#include <scribo/draw/bounding_boxes.hh>
+
+#include <scribo/debug/save_linked_bboxes_image.hh>
+#include <scribo/debug/usage.hh>
+
+
+
+const char *args_desc[][2] =
+{
+ { "input.pbm", "A binary image. True for objects and False for the background." },
+ { "max_nbh_dist", " Maximum distance for neighborhood search. (common value : 30)" },
+ {0, 0}
+};
+
+
+int main(int argc, char* argv[])
+{
+ using namespace scribo;
+ using namespace scribo::primitive::internal;
+ using namespace mln;
+
+ if (argc != 4)
+ return scribo::debug::usage(argv,
+ "Show sucessful/unsuccessful left links between components.",
+ "input.pbm max_nbh_dist output.ppm",
+ args_desc,
+ "A color image. Valid links are drawn in green, invalid ones in red.");
+
+ image2d<bool> input;
+ io::pbm::load(input, argv[1]);
+
+ // Finding objects.
+ value::label_16 nbboxes;
+ typedef image2d<value::label_16> L;
+ object_image(L) objects
+ = scribo::primitive::extract::objects(input, c8(), nbboxes);
+
+ // Finding left links.
+ object_links<L> left_link
+ = primitive::link::with_single_left_link(objects, atoi(argv[2]));
+
+
+
+ // Preparing output image.
+ image2d<value::rgb8> output = data::convert(value::rgb8(), input);
+ scribo::draw::bounding_boxes(output, objects, literal::blue);
+
+
+ // Drawing links.
+ mln::util::array<mln_result_(accu::center<mln_psite_(L)>)>
+ mass_centers = labeling::compute(accu::meta::center(),
+ objects, objects.nlabels());
+
+ for_all_ncomponents(i, objects.nlabels())
+ {
+ unsigned midcol = (objects.bbox(i).pmax().col()
+ - objects.bbox(i).pmin().col()) / 2;
+ int dmax = midcol + atoi(argv[2]);
+ mln_site_(L) c = mass_centers(i);
+
+ mln_site_(L) p = c + mln::left;
+
+ while (is_invalid_link(objects, left_link, p, i, c, dmax))
+ {
+ if (left_link[i] != i)
+ output(p) = literal::green;
+ else
+ output(p) = literal::red;
+ --p.col();
+ }
+
+ }
+
+ io::ppm::save(output, argv[3]);
+}
diff --git a/scribo/src/debug/show_link_single_right.cc b/scribo/src/debug/show_link_single_right.cc
new file mode 100644
index 0000000..5f1001a
--- /dev/null
+++ b/scribo/src/debug/show_link_single_right.cc
@@ -0,0 +1,117 @@
+// Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#include <iostream>
+
+#include <mln/core/image/image2d.hh>
+#include <mln/core/alias/neighb2d.hh>
+
+#include <mln/data/convert.hh>
+
+#include <mln/value/rgb8.hh>
+#include <mln/value/label_16.hh>
+#include <mln/literal/colors.hh>
+
+#include <mln/io/pbm/load.hh>
+#include <mln/io/ppm/save.hh>
+
+#include <scribo/primitive/extract/objects.hh>
+#include <scribo/primitive/link/with_single_right_link.hh>
+
+#include <scribo/draw/bounding_boxes.hh>
+
+#include <scribo/debug/save_linked_bboxes_image.hh>
+#include <scribo/debug/usage.hh>
+
+
+
+const char *args_desc[][2] =
+{
+ { "input.pbm", "A binary image. True for objects and False for the background." },
+ { "max_nbh_dist", " Maximum distance for neighborhood search. (common value : 30)" },
+ {0, 0}
+};
+
+
+int main(int argc, char* argv[])
+{
+ using namespace scribo;
+ using namespace scribo::primitive::internal;
+ using namespace mln;
+
+ if (argc != 4)
+ return scribo::debug::usage(argv,
+ "Show sucessful/unsuccessful right links between components.",
+ "input.pbm max_nbh_dist output.ppm",
+ args_desc,
+ "A color image. Valid links are drawn in green, invalid ones in red.");
+
+ image2d<bool> input;
+ io::pbm::load(input, argv[1]);
+
+ // Finding objects.
+ value::label_16 nbboxes;
+ typedef image2d<value::label_16> L;
+ object_image(L) objects
+ = scribo::primitive::extract::objects(input, c8(), nbboxes);
+
+ // Finding right links.
+ object_links<L> right_link
+ = primitive::link::with_single_right_link(objects, atoi(argv[2]));
+
+
+
+ // Preparing output image.
+ image2d<value::rgb8> output = data::convert(value::rgb8(), input);
+ scribo::draw::bounding_boxes(output, objects, literal::blue);
+
+
+ // Drawing links.
+ mln::util::array<mln_result_(accu::center<mln_psite_(L)>)>
+ mass_centers = labeling::compute(accu::meta::center(),
+ objects, objects.nlabels());
+
+ for_all_ncomponents(i, objects.nlabels())
+ {
+ unsigned midcol = (objects.bbox(i).pmax().col()
+ - objects.bbox(i).pmin().col()) / 2;
+ int dmax = midcol + atoi(argv[2]);
+ mln_site_(L) c = mass_centers(i);
+
+ mln_site_(L) p = c + mln::right;
+
+ while (is_invalid_link(objects, right_link, p, i, c, dmax))
+ {
+ if (right_link[i] != i)
+ output(p) = literal::green;
+ else
+ output(p) = literal::red;
+ ++p.col();
+ }
+
+ }
+
+ io::ppm::save(output, argv[3]);
+}
diff --git a/scribo/src/debug/show_objects_large.cc b/scribo/src/debug/show_objects_large.cc
new file mode 100644
index 0000000..aac7a9f
--- /dev/null
+++ b/scribo/src/debug/show_objects_large.cc
@@ -0,0 +1,84 @@
+// Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#include <iostream>
+
+#include <mln/core/image/image2d.hh>
+#include <mln/core/alias/neighb2d.hh>
+
+#include <mln/data/convert.hh>
+
+#include <mln/value/label_16.hh>
+#include <mln/value/rgb8.hh>
+#include <mln/literal/colors.hh>
+
+#include <mln/io/pbm/load.hh>
+#include <mln/io/ppm/save.hh>
+
+#include <scribo/primitive/extract/objects.hh>
+#include <scribo/filter/objects_large.hh>
+#include <scribo/draw/bounding_boxes.hh>
+#include <scribo/debug/usage.hh>
+
+
+const char *args_desc[][2] =
+{
+ { "input.pbm", "A binary image. True for objects and False for the background." },
+ { "max_card", " Maximum cardinality in a component." },
+ {0, 0}
+};
+
+
+int main(int argc, char *argv[])
+{
+ using namespace mln;
+
+ if (argc != 4)
+ return scribo::debug::usage(argv,
+ "Show components having a too high cardinality.",
+ "input.pbm min_card output.ppm",
+ args_desc,
+ "A color image. Components with high cardinality have their bounding boxes drawn in red, others in green.");
+
+ trace::entering("main");
+
+ image2d<bool> input;
+ io::pbm::load(input, argv[1]);
+
+ value::label_16 nbboxes;
+ typedef image2d<value::label_16> L;
+ object_image(L) objects
+ = scribo::primitive::extract::objects(input, c8(), nbboxes);
+
+
+ image2d<value::rgb8> output = data::convert(value::rgb8(), input);
+ scribo::draw::bounding_boxes(output, objects, literal::red);
+
+ object_image(L) filtered_objects
+ = scribo::filter::objects_large(objects, atoi(argv[2]));
+ scribo::draw::bounding_boxes(output, filtered_objects, literal::green);
+
+ io::ppm::save(output, argv[3]);
+}
diff --git a/scribo/src/debug/show_objects_small.cc b/scribo/src/debug/show_objects_small.cc
new file mode 100644
index 0000000..a5afb26
--- /dev/null
+++ b/scribo/src/debug/show_objects_small.cc
@@ -0,0 +1,84 @@
+// Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#include <iostream>
+
+#include <mln/core/image/image2d.hh>
+#include <mln/core/alias/neighb2d.hh>
+
+#include <mln/data/convert.hh>
+
+#include <mln/value/label_16.hh>
+#include <mln/value/rgb8.hh>
+#include <mln/literal/colors.hh>
+
+#include <mln/io/pbm/load.hh>
+#include <mln/io/ppm/save.hh>
+
+#include <scribo/primitive/extract/objects.hh>
+#include <scribo/filter/objects_small.hh>
+#include <scribo/draw/bounding_boxes.hh>
+#include <scribo/debug/usage.hh>
+
+
+const char *args_desc[][2] =
+{
+ { "input.pbm", "A binary image. True for objects and False for the background." },
+ { "min_card", " Minimum cardinality in a component.. (Common value : 6)" },
+ {0, 0}
+};
+
+
+int main(int argc, char *argv[])
+{
+ using namespace mln;
+
+ if (argc != 4)
+ return scribo::debug::usage(argv,
+ "Show components having a too low cardinality.",
+ "input.pbm min_card output.ppm",
+ args_desc,
+ "A color image. Components with low cardinality have their bounding boxes drawn in red, others in green.");
+
+ trace::entering("main");
+
+ image2d<bool> input;
+ io::pbm::load(input, argv[1]);
+
+ value::label_16 nbboxes;
+ typedef image2d<value::label_16> L;
+ object_image(L) objects
+ = scribo::primitive::extract::objects(input, c8(), nbboxes);
+
+
+ image2d<value::rgb8> output = data::convert(value::rgb8(), input);
+ scribo::draw::bounding_boxes(output, objects, literal::red);
+
+ object_image(L) filtered_objects
+ = scribo::filter::objects_small(objects, atoi(argv[2]));
+ scribo::draw::bounding_boxes(output, filtered_objects, literal::green);
+
+ io::ppm::save(output, argv[3]);
+}
diff --git a/scribo/src/debug/show_objects_thin.cc b/scribo/src/debug/show_objects_thin.cc
new file mode 100644
index 0000000..e69de29
--
1.5.6.5
1
0
* debug/usage.hh: Improve output.
* primitive/internal/find_left_link.hh,
* primitive/internal/find_right_link.hh: Move a big 'if'...
* primitive/internal/is_invalid_link.hh: ... in this new routine.
* primitive/internal/update_link_array.hh: Reindent.
* src/text_in_doc_ppm.cc: New example to process a color document.
---
scribo/ChangeLog | 15 +
scribo/debug/usage.hh | 8 +-
scribo/primitive/internal/find_left_link.hh | 8 +-
scribo/primitive/internal/find_right_link.hh | 33 +--
.../{find_right_link.hh => is_invalid_link.hh} | 74 ++---
scribo/primitive/internal/update_link_array.hh | 6 +-
scribo/src/text_in_doc_ppm.cc | 322 ++++++++++++++++++++
7 files changed, 398 insertions(+), 68 deletions(-)
copy scribo/primitive/internal/{find_right_link.hh => is_invalid_link.hh} (52%)
create mode 100644 scribo/src/text_in_doc_ppm.cc
diff --git a/scribo/ChangeLog b/scribo/ChangeLog
index 85c59a7..6a97f58 100644
--- a/scribo/ChangeLog
+++ b/scribo/ChangeLog
@@ -1,3 +1,18 @@
+2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+
+ Few improvements in Scribo.
+
+ * debug/usage.hh: Improve output.
+
+ * primitive/internal/find_left_link.hh,
+ * primitive/internal/find_right_link.hh: Move a big 'if'...
+
+ * primitive/internal/is_invalid_link.hh: ... in this new routine.
+
+ * primitive/internal/update_link_array.hh: Reindent.
+
+ * src/text_in_doc_ppm.cc: New example to process a color document.
+
2009-09-28 Guillaume Lazzara <lazzara(a)lrde.epita.fr>
Add a first draft of a multi-scale process.
diff --git a/scribo/debug/usage.hh b/scribo/debug/usage.hh
index f821ead..131a338 100644
--- a/scribo/debug/usage.hh
+++ b/scribo/debug/usage.hh
@@ -55,9 +55,13 @@ namespace scribo
usage(char* argv[], const char *desc, const char* args,
const char*args_desc[][2], const char *out_desc)
{
- std::cout << desc << std::endl;
+ std::cout << std::endl
+ << desc << std::endl
+ << std::endl;
std::cout << "-----------" << std::endl;
- std::cout << "Usage: " << argv[0] << " " << args << std::endl;
+ std::cout << "Usage: " << argv[0] << " " << args
+ << std::endl
+ << std::endl;
for (unsigned i = 0; args_desc[i][0] != 0; ++i)
std::cout << " " << args_desc[i][0] << ": " << args_desc[i][1]
diff --git a/scribo/primitive/internal/find_left_link.hh b/scribo/primitive/internal/find_left_link.hh
index 7ef2895..243ac99 100644
--- a/scribo/primitive/internal/find_left_link.hh
+++ b/scribo/primitive/internal/find_left_link.hh
@@ -38,6 +38,7 @@
# include <scribo/core/object_image.hh>
# include <scribo/primitive/internal/update_link_array.hh>
+# include <scribo/primitive/internal/is_invalid_link.hh>
//FIXME: not generic.
# include <mln/core/alias/dpoint2d.hh>
@@ -82,11 +83,8 @@ namespace scribo
/// First site on the right of the central site
mln_site(L) p = c + mln::left;
- while (objects.domain().has(p) // Not outside image domain
- && (objects(p) == literal::zero // Is the background
- || objects(p) == current_comp // Is the current component
- || left_link[objects(p)] == current_comp) // Creates a loop
- && math::abs(p.col() - c.col()) < dmax) // Not to far
+ while (is_invalid_link(objects, left_link, p,
+ current_comp, c, dmax))
--p.col();
update_link_array(objects, left_link, p, c, current_comp, dmax);
diff --git a/scribo/primitive/internal/find_right_link.hh b/scribo/primitive/internal/find_right_link.hh
index 10f9565..1964a6d 100644
--- a/scribo/primitive/internal/find_right_link.hh
+++ b/scribo/primitive/internal/find_right_link.hh
@@ -38,6 +38,7 @@
# include <scribo/core/object_image.hh>
# include <scribo/primitive/internal/update_link_array.hh>
+# include <scribo/primitive/internal/is_invalid_link.hh>
//FIXME: not generic.
# include <mln/core/alias/dpoint2d.hh>
@@ -51,11 +52,9 @@ namespace scribo
namespace internal
{
- using namespace mln;
-
/// Find the right neighbor of a line of text if exists.
///
- /// \param text The lines of text.
+ /// \param objects An image of objects.
/// \param right_link The right neighbors.
/// \param current_comp A text line id.
/// \param dmax The maximum lookup distance.
@@ -63,31 +62,29 @@ namespace scribo
//
template <typename L>
void
- find_right_link(const object_image(L)& text,
- mln::util::array<unsigned>& right_link,
- unsigned current_comp,
- int dmax,
- const mln_site(L)& c);
+ find_right_link(const object_image(L)& objects,
+ mln::util::array<unsigned>& right_link,
+ unsigned current_comp,
+ int dmax,
+ const mln_site(L)& c);
+
# ifndef MLN_INCLUDE_ONLY
template <typename L>
void
find_right_link(const object_image(L)& objects,
- mln::util::array<unsigned>& right_link,
- unsigned current_comp,
- int dmax,
- const mln_site(L)& c)
+ mln::util::array<unsigned>& right_link,
+ unsigned current_comp,
+ int dmax,
+ const mln_site(L)& c)
{
///FIXME: the following code is not generic...
/// First site on the right of the central site
mln_site(L) p = c + mln::right;
- while (objects.domain().has(p) // Not outside image domain
- && (objects(p) == literal::zero // Is the background
- || objects(p) == current_comp // Is the current component
- || right_link[objects(p)] == current_comp) // Creates a loop
- && math::abs(p.col() - c.col()) < dmax) // Not too far
+ while (is_invalid_link(objects, right_link, p,
+ current_comp, c, dmax))
++p.col();
update_link_array(objects, right_link, p, c, current_comp, dmax);
@@ -95,7 +92,7 @@ namespace scribo
# endif // MLN_INCLUDE_ONLY
- } // end of namespace scribo::primitive::internal
+ } // end of namespace scribo::primitive::internal
} // end of namespace scribo::primitive
diff --git a/scribo/primitive/internal/find_right_link.hh b/scribo/primitive/internal/is_invalid_link.hh
similarity index 52%
copy from scribo/primitive/internal/find_right_link.hh
copy to scribo/primitive/internal/is_invalid_link.hh
index 10f9565..dbabe72 100644
--- a/scribo/primitive/internal/find_right_link.hh
+++ b/scribo/primitive/internal/is_invalid_link.hh
@@ -23,24 +23,18 @@
// exception does not however invalidate any other reasons why the
// executable file might be covered by the GNU General Public License.
-#ifndef SCRIBO_PRIMITIVE_INTERNAL_FIND_RIGHT_LINK_HH
-# define SCRIBO_PRIMITIVE_INTERNAL_FIND_RIGHT_LINK_HH
+#ifndef SCRIBO_PRIMITIVE_INTERNAL_IS_INVALID_LINK_HH
+# define SCRIBO_PRIMITIVE_INTERNAL_IS_INVALID_LINK_HH
/// \file
///
-/// Find the right neighbor of a line of text if exists.
+/// Check whether an objects link is invalid or not.
-# include <mln/core/concept/image.hh>
# include <mln/math/abs.hh>
-
-# include <mln/util/array.hh>
+# include <mln/literal/zero.hh>
# include <scribo/core/object_image.hh>
-# include <scribo/primitive/internal/update_link_array.hh>
-
-//FIXME: not generic.
-# include <mln/core/alias/dpoint2d.hh>
namespace scribo
{
@@ -53,47 +47,45 @@ namespace scribo
using namespace mln;
- /// Find the right neighbor of a line of text if exists.
+
+ /// Check whether an objects link is invalid or not.
///
- /// \param text The lines of text.
- /// \param right_link The right neighbors.
- /// \param current_comp A text line id.
- /// \param dmax The maximum lookup distance.
- /// \param c The lookup start point.
+ /// \param objects An image of objects.
+ /// \param left_link The left neighbors.
+ /// \param p The current site.
+ /// \param current_comp The current object id.
+ /// \param c The left link start point.
+ /// \param dmax The maximum lookup distance.
//
template <typename L>
- void
- find_right_link(const object_image(L)& text,
- mln::util::array<unsigned>& right_link,
+ bool
+ is_invalid_link(const object_image(L)& objects_,
+ mln::util::array<unsigned>& link_array,
+ const mln_site(L)& p,
unsigned current_comp,
- int dmax,
- const mln_site(L)& c);
+ const mln_site(L)& c,
+ int dmax);
# ifndef MLN_INCLUDE_ONLY
template <typename L>
- void
- find_right_link(const object_image(L)& objects,
- mln::util::array<unsigned>& right_link,
+ inline
+ bool
+ is_invalid_link(const object_image(L)& objects,
+ mln::util::array<unsigned>& link_array,
+ const mln_site(L)& p,
unsigned current_comp,
- int dmax,
- const mln_site(L)& c)
+ const mln_site(L)& c,
+ int dmax)
{
- ///FIXME: the following code is not generic...
- /// First site on the right of the central site
- mln_site(L) p = c + mln::right;
-
- while (objects.domain().has(p) // Not outside image domain
- && (objects(p) == literal::zero // Is the background
- || objects(p) == current_comp // Is the current component
- || right_link[objects(p)] == current_comp) // Creates a loop
- && math::abs(p.col() - c.col()) < dmax) // Not too far
- ++p.col();
-
- update_link_array(objects, right_link, p, c, current_comp, dmax);
+ return (objects.domain().has(p) // Not outside image domain
+ && (objects(p) == literal::zero // Is the background
+ || objects(p) == current_comp // Is the current component
+ || link_array[objects(p)] == current_comp) // Creates a loop
+ && math::abs(p.col() - c.col()) < dmax); // Not too far
}
-# endif // MLN_INCLUDE_ONLY
+# endif // ! MLN_INCLUDE_ONLY
} // end of namespace scribo::primitive::internal
@@ -102,4 +94,6 @@ namespace scribo
} // end of namespace scribo
-#endif // ! SCRIBO_PRIMITIVE_INTERNAL_FIND_RIGHT_LINK_HH
+#endif // ! SCRIBO_PRIMITIVE_INTERNAL_IS_INVALID_LINK_HH
+
+
diff --git a/scribo/primitive/internal/update_link_array.hh b/scribo/primitive/internal/update_link_array.hh
index c26ec78..5e30bb5 100644
--- a/scribo/primitive/internal/update_link_array.hh
+++ b/scribo/primitive/internal/update_link_array.hh
@@ -79,9 +79,9 @@ namespace scribo
mlc_is_a(mln_value(I), mln::value::Symbolic)::check();
mln_assertion(lbl.is_valid());
- if (lbl.domain().has(p) // Not outside image domain
- && lbl(p) != literal::zero // Not the background
- && lbl(p) != i // Not the current component
+ if (lbl.domain().has(p) // Not outside image domain
+ && lbl(p) != literal::zero // Not the background
+ && lbl(p) != i // Not the current component
&& (math::abs(p.col() - c.col())) < dmax // Not too far
&& link_array[lbl(p)] != i) // Not creating a loop
link_array[i] = lbl(p);
diff --git a/scribo/src/text_in_doc_ppm.cc b/scribo/src/text_in_doc_ppm.cc
new file mode 100644
index 0000000..0dafc09
--- /dev/null
+++ b/scribo/src/text_in_doc_ppm.cc
@@ -0,0 +1,322 @@
+// Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+
+#include <libgen.h>
+#include <iostream>
+
+#include <mln/core/image/image2d.hh>
+#include <mln/core/alias/neighb2d.hh>
+
+#include <mln/logical/not.hh>
+
+#include <mln/labeling/colorize.hh>
+
+#include <mln/io/pbm/all.hh>
+#include <mln/io/ppm/save.hh>
+
+#include <mln/math/min.hh>
+
+#include <mln/literal/colors.hh>
+#include <mln/value/rgb8.hh>
+#include <mln/value/label_16.hh>
+
+#include <mln/draw/box.hh>
+
+#include <mln/extension/adjust.hh>
+
+#include <scribo/binarization/sauvola.hh>
+
+#include <scribo/table/erase.hh>
+
+#include <scribo/draw/bounding_boxes.hh>
+
+#include <scribo/primitive/extract/objects.hh>
+#include <scribo/primitive/extract/lines_h_discontinued.hh>
+#include <scribo/primitive/extract/lines_v_discontinued.hh>
+
+#include <scribo/primitive/link/merge_double_link.hh>
+#include <scribo/primitive/link/with_single_left_link.hh>
+#include <scribo/primitive/link/with_single_right_link.hh>
+
+#include <scribo/primitive/group/apply.hh>
+#include <scribo/primitive/group/from_double_link.hh>
+#include <scribo/primitive/group/from_single_link.hh>
+
+#include <scribo/filter/object_links_bottom_aligned.hh>
+#include <scribo/filter/object_links_bbox_h_ratio.hh>
+#include <scribo/filter/object_links_bbox_overlap.hh>
+
+#include <scribo/filter/objects_small.hh>
+#include <scribo/filter/objects_thin.hh>
+#include <scribo/filter/objects_thick.hh>
+
+#include <scribo/filter/object_groups_small.hh>
+
+#include <scribo/text/recognition.hh>
+
+#include <scribo/debug/decision_image.hh>
+#include <scribo/debug/save_bboxes_image.hh>
+#include <scribo/debug/save_bboxes_image.hh>
+#include <scribo/debug/save_linked_bboxes_image.hh>
+
+#include <scribo/debug/usage.hh>
+
+#include <scribo/preprocessing/split_bg_fg.hh>
+
+#include <scribo/make/debug_filename.hh>
+
+
+const char *args_desc[][2] =
+{
+ { "input.ppm", "A color image." },
+ { "out.txt", "A text file with all the recognized text" },
+ { "output_dir", "Output directory for debug image" },
+ {0, 0}
+};
+
+
+int main(int argc, char* argv[])
+{
+ using namespace scribo;
+ using namespace mln;
+
+ if (argc != 3 && argc != 4)
+ return scribo::debug::usage(argv,
+ "Find text in a color document.",
+ "input.ppm out.txt <output_dir>",
+ args_desc,
+ "Debug outputs. The recognized text is printed in the standard output.");
+
+ if (argc == 4)
+ scribo::make::internal::debug_filename_prefix = argv[3];
+
+ trace::entering("main");
+
+
+ image2d<value::rgb8> input_rgb;
+ io::ppm::load(input_rgb, argv[1]);
+
+
+ unsigned lambda;
+ if (argc == 5)
+ lambda = atoi(argv[4]);
+ else
+ lambda = 1.2 * (input_rgb.nrows() + input_rgb.ncols());
+
+ // Extract foreground
+ std::cout << "Extracting foreground..." << std::endl;
+ image2d<value::rgb8>
+ fg = preprocessing::split_bg_fg(input_rgb,
+ lambda,
+ 32).second();
+
+ // Binarize foreground to use it in the processing chain.
+ std::cout << "Binarizing foreground..." << std::endl;
+ image2d<bool> input = scribo::binarization::sauvola(fg);
+
+
+ typedef image2d<value::label_16> L;
+
+ /// Extracting vertical and horizontal lines.
+ std::cout << "Extracting lines..." << std::endl;
+ value::label_16 nhlines, nvlines;
+ object_image(L)
+ lbl_v = primitive::extract::lines_v_discontinued(input, c8(),
+ nvlines, 51, 8);
+ object_image(L)
+ lbl_h = primitive::extract::lines_h_discontinued(input, c8(),
+ nhlines, 51, 6);
+
+ /// Reconstruct and erase tables.
+ std::cout << "Reconstructing and removing tables..." << std::endl;
+ image2d<bool> input_notables
+ = scribo::table::erase(input, lbl_h, lbl_v);
+
+
+ io::pbm::save(input_notables, "table_erased.ppm");
+
+ /// Finding objects.
+ std::cout << "Finding objects..." << std::endl;
+ value::label_16 nobjects;
+ object_image(L)
+ objects = scribo::primitive::extract::objects(input_notables,
+ c8(),
+ nobjects);
+
+
+ /// First filtering.
+ std::cout << "Filtering objects..." << std::endl;
+ object_image(L) filtered_objects
+ = scribo::filter::objects_small(objects, 6);
+
+ filtered_objects
+ = scribo::filter::objects_thin(filtered_objects, 1);
+
+// filtered_objects
+// = scribo::filter::objects_thick(filtered_objects,
+// math::min(input.ncols(), input.nrows()) / 5);
+
+
+
+ /// Linking potential objects
+ std::cout << "Linking objects..." << std::endl;
+ object_links<L> left_link
+ = primitive::link::with_single_left_link(filtered_objects, 30);
+ object_links<L> right_link
+ = primitive::link::with_single_right_link(filtered_objects, 30);
+
+
+#ifndef NOUT
+ if (argc == 4)
+ {
+ std::cerr << "BEFORE - nobjects = " << nobjects << std::endl;
+ scribo::debug::save_linked_bboxes_image(input,
+ filtered_objects,
+ left_link, right_link,
+ literal::red, literal::cyan,
+ literal::yellow,
+ literal::green,
+ scribo::make::debug_filename("links.ppm"));
+ }
+#endif
+
+
+ // Validating left and right links.
+ object_links<L>
+ merged_links = primitive::link::merge_double_link(filtered_objects,
+ left_link,
+ right_link);
+
+
+
+
+ // Remove links if bboxes are not aligned.
+ std::cout << "Filtering object links..." << std::endl;
+ object_links<L> bottom_filtered_links
+ = filter::object_links_bottom_aligned(filtered_objects,
+ merged_links,
+ 5);
+
+
+
+#ifndef NOUT
+ if (argc == 4)
+ {
+ image2d<value::rgb8>
+ bottom_decision_image = scribo::debug::decision_image(input,
+ merged_links,
+ bottom_filtered_links);
+
+ io::ppm::save(bottom_decision_image,
+ scribo::make::debug_filename("bottom_links_decision_image.ppm"));
+ }
+#endif
+
+
+
+
+
+// // Remove links if bboxes have too different sizes.
+// object_links<L> hratio_filtered_links
+// = filter::object_links_bbox_h_ratio(filtered_objects,
+// bottom_filtered_links,
+// 0.6f);
+
+
+
+
+// #ifndef NOUT
+// if (argc == 4)
+// {
+// image2d<value::rgb8>
+// hratio_decision_image = scribo::debug::decision_image(input,
+// bottom_filtered_links,
+// hratio_filtered_links);
+// io::ppm::save(hratio_decision_image,
+// scribo::make::debug_filename("hratio_links_decision_image.ppm"));
+// }
+// #endif
+
+
+
+
+ //Remove links if bboxes overlap too much.
+ object_links<L> overlap_filtered_links
+ = filter::object_links_bbox_overlap(filtered_objects,
+ bottom_filtered_links,
+ 0.80f);
+
+
+
+
+#ifndef NOUT
+ if (argc == 4)
+ {
+ image2d<value::rgb8> overlap_decision_image
+ = scribo::debug::decision_image(input,
+ bottom_filtered_links,
+ overlap_filtered_links);
+ io::ppm::save(overlap_decision_image,
+ scribo::make::debug_filename("overlap_links_decision_image.ppm"));
+ }
+#endif
+
+
+
+
+ object_groups<L>
+ groups = primitive::group::from_single_link(filtered_objects,
+ overlap_filtered_links);
+
+
+// // Remove objects part of groups with strictly less than 3 objects.
+// object_groups<L> filtered_groups = filter::object_groups_small(groups, 3);
+
+
+// #ifndef NOUT
+// image2d<value::rgb8>
+// decision_image = scribo::debug::decision_image(input,
+// groups, filtered_groups);
+// #endif
+
+ std::cout << "Grouping objects..." << std::endl;
+ object_image(L)
+ grouped_objects = primitive::group::apply(filtered_objects, groups);
+
+
+#ifndef NOUT
+ if (argc == 4)
+ io::ppm::save(mln::labeling::colorize(value::rgb8(),
+ grouped_objects,
+ grouped_objects.nlabels()),
+ scribo::make::debug_filename("out.ppm"));
+#endif
+
+ std::cout << "Text recognition..." << std::endl;
+ text::recognition(grouped_objects, "fra", argv[2]);
+
+ trace::exiting("main");
+}
--
1.5.6.5
1
0
---
ChangeLog | 4 ++++
configure.ac | 1 +
2 files changed, 5 insertions(+), 0 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 151e554..e4af1a1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2009-10-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+
+ * configure.ac: Configure milena/doc/technical.
+
2009-09-28 Guillaume Lazzara <z(a)lrde.epita.fr>
* configure.ac: Update configuration of scribo/src subdirectories.
diff --git a/configure.ac b/configure.ac
index 7d17329..eee55fe 100644
--- a/configure.ac
+++ b/configure.ac
@@ -252,6 +252,7 @@ AC_CONFIG_FILES([
milena/doc/Makefile
milena/doc/examples/Makefile
milena/doc/ref_guide/Makefile
+ milena/doc/technical/Makefile
milena/doc/tutorial/Makefile
milena/doc/white_paper/Makefile
milena/mesh/Makefile
--
1.5.6.5
1
0
* apps/graph-morpho/io.hh: Rename as...
* apps/graph-morpho/make.hh: ...this.
(build_regular_complex1d_image): Turn into...
(make::complex1d_image<V>): ...this.
* apps/graph-morpho/convert.hh: Adjust client.
* apps/graph-morpho/Makefile.am (noinst_HEADERS): s/io.hh/make.hh/.
---
milena/ChangeLog | 11 ++++
milena/apps/graph-morpho/Makefile.am | 2 +-
milena/apps/graph-morpho/convert.hh | 4 +-
milena/apps/graph-morpho/io.hh | 96 -------------------------------
milena/apps/graph-morpho/make.hh | 105 ++++++++++++++++++++++++++++++++++
5 files changed, 119 insertions(+), 99 deletions(-)
delete mode 100644 milena/apps/graph-morpho/io.hh
create mode 100644 milena/apps/graph-morpho/make.hh
diff --git a/milena/ChangeLog b/milena/ChangeLog
index 39bc7c2..0e55663 100644
--- a/milena/ChangeLog
+++ b/milena/ChangeLog
@@ -1,5 +1,16 @@
2009-10-01 Roland Levillain <roland(a)lrde.epita.fr>
+ Clean up a creation routine in graph-morpho.
+
+ * apps/graph-morpho/io.hh: Rename as...
+ * apps/graph-morpho/make.hh: ...this.
+ (build_regular_complex1d_image): Turn into...
+ (make::complex1d_image<V>): ...this.
+ * apps/graph-morpho/convert.hh: Adjust client.
+ * apps/graph-morpho/Makefile.am (noinst_HEADERS): s/io.hh/make.hh/.
+
+2009-10-01 Roland Levillain <roland(a)lrde.epita.fr>
+
Clean up another conversion routine in graph-morpho.
* apps/graph-morpho/io.hh (make_regular_complex1d_image):
diff --git a/milena/apps/graph-morpho/Makefile.am b/milena/apps/graph-morpho/Makefile.am
index 76fb7d7..e4cbb6d 100644
--- a/milena/apps/graph-morpho/Makefile.am
+++ b/milena/apps/graph-morpho/Makefile.am
@@ -20,7 +20,7 @@ AM_CPPFLAGS = -I$(top_srcdir)/milena -I$(top_builddir)/milena
APPS_CXXFLAGS = @APPS_CXXFLAGS@
AM_CXXFLAGS = $(APPS_CXXFLAGS)
-noinst_HEADERS = convert.hh debug.hh io.hh morpho.hh make_complex2d.hh
+noinst_HEADERS = convert.hh debug.hh make.hh morpho.hh make_complex2d.hh
noinst_PROGRAMS = samples-complex1d samples-image2d asf-complex1d asf-image2d
samples_complex1d_SOURCES = samples-complex1d.cc
diff --git a/milena/apps/graph-morpho/convert.hh b/milena/apps/graph-morpho/convert.hh
index 4328765..6e4ad55 100644
--- a/milena/apps/graph-morpho/convert.hh
+++ b/milena/apps/graph-morpho/convert.hh
@@ -34,7 +34,7 @@
# include <mln/math/abs.hh>
-# include "apps/graph-morpho/io.hh"
+# include "apps/graph-morpho/make.hh"
namespace convert
@@ -132,7 +132,7 @@ namespace convert
// consider only vertices (edges are set ``between'' vertices).
box2d output_box(input_box.nrows() / 2 + 1,
input_box.ncols() / 2 + 1);
- bin_1complex_image2d output = build_regular_complex1d_image(output_box);
+ bin_1complex_image2d output = ::make::complex1d_image<bool>(output_box);
const unsigned dim = 1;
typedef geom::complex_geometry<dim, point2d> geom_t;
diff --git a/milena/apps/graph-morpho/io.hh b/milena/apps/graph-morpho/io.hh
deleted file mode 100644
index 6dac2c4..0000000
--- a/milena/apps/graph-morpho/io.hh
+++ /dev/null
@@ -1,96 +0,0 @@
-// Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE)
-//
-// This file is part of Olena.
-//
-// Olena is free software: you can redistribute it and/or modify it under
-// the terms of the GNU General Public License as published by the Free
-// Software Foundation, version 2 of the License.
-//
-// Olena is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-// General Public License for more details.
-//
-// You should have received a copy of the GNU General Public License
-// along with Olena. If not, see <http://www.gnu.org/licenses/>.
-//
-// As a special exception, you may use this file as part of a free
-// software project without restriction. Specifically, if other files
-// instantiate templates or use macros or inline functions from this
-// file, or you compile this file and link it with other files to produce
-// an executable, this file does not by itself cause the resulting
-// executable to be covered by the GNU General Public License. This
-// exception does not however invalidate any other reasons why the
-// executable file might be covered by the GNU General Public License.
-
-#ifndef APPS_GRAPH_MORPHO_IO_HH
-# define APPS_GRAPH_MORPHO_IO_HH
-
-/// \file apps/graph-morpho/io.hh
-/// \brief I/O routines for graphs (1-complexes).
-
-# include <mln/core/alias/complex_image.hh>
-# include <mln/core/image/image2d.hh>
-
-inline
-mln::bin_1complex_image2d
-build_regular_complex1d_image(const mln::box2d& support)
-{
- using namespace mln;
-
- unsigned nrows = support.pmax().row() - support.pmin().row() + 1;
- unsigned ncols = support.pmax().col() - support.pmin().col() + 1;
-
- const unsigned dim = 1;
- typedef topo::n_face<0, dim> vertex_t;
-
- typedef topo::complex<dim> complex_t;
- complex_t c;
- typedef geom::complex_geometry<dim, point2d> geom_t;
- geom_t geom;
-
- // Vertices.
- for (unsigned row = 0; row < nrows; ++row)
- for (unsigned col = 0; col < ncols; ++col)
- {
- c.add_face();
- geom.add_location(point2d(row,col));
- }
-
- // Edges.
- for (unsigned row = 0; row < nrows; ++row)
- {
- // Horizontal edges.
- for (unsigned col = 1; col < ncols; ++col)
- {
- // First vertex.
- vertex_t v1(c, row * ncols + col - 1);
- // Second vertex.
- vertex_t v2(c, row * ncols + col);
- // Edge bewteen V1 and V2.
- c.add_face(v1 + v2);
- }
-
- // Vertical edges.
- if (row != 0)
- for (unsigned col = 0; col < ncols; ++col)
- {
- // First vertex.
- vertex_t v1(c, (row - 1) * ncols + col);
- // Second vertex.
- vertex_t v2(c, row * ncols + col);
- // Edge bewteen V1 and V2.
- c.add_face(v1 + v2);
- }
- }
-
- // Site set (domain) of the image.
- p_complex<dim, geom_t> pc(c, geom);
-
- // Image based on this site set.
- bin_1complex_image2d ima(pc);
- return ima;
-}
-
-
-#endif // ! APPS_GRAPH_MORPHO_IO_HH
diff --git a/milena/apps/graph-morpho/make.hh b/milena/apps/graph-morpho/make.hh
new file mode 100644
index 0000000..4ebd372
--- /dev/null
+++ b/milena/apps/graph-morpho/make.hh
@@ -0,0 +1,105 @@
+// Copyright (C) 2009 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#ifndef APPS_GRAPH_MORPHO_MAKE_HH
+# define APPS_GRAPH_MORPHO_MAKE_HH
+
+/// \file
+/// \brief Creation routines for complex-based images.
+
+# include <mln/core/alias/complex_image.hh>
+# include <mln/core/alias/box2d.hh>
+
+namespace make
+{
+
+ /// Create a 1-complex images in the 2D plane of which domain is
+ /// based on an mln::box2d.
+ template <typename V>
+ inline
+ mln::complex_image<1, mln::discrete_plane_1complex_geometry, V>
+ complex1d_image(const mln::box2d& support)
+ {
+ using namespace mln;
+
+ unsigned nrows = support.pmax().row() - support.pmin().row() + 1;
+ unsigned ncols = support.pmax().col() - support.pmin().col() + 1;
+
+ const unsigned dim = 1;
+ typedef topo::n_face<0, dim> vertex_t;
+
+ typedef topo::complex<dim> complex_t;
+ complex_t c;
+ typedef geom::complex_geometry<dim, point2d> geom_t;
+ geom_t geom;
+
+ // Vertices.
+ for (unsigned row = 0; row < nrows; ++row)
+ for (unsigned col = 0; col < ncols; ++col)
+ {
+ c.add_face();
+ geom.add_location(point2d(row,col));
+ }
+
+ // Edges.
+ for (unsigned row = 0; row < nrows; ++row)
+ {
+ // Horizontal edges.
+ for (unsigned col = 1; col < ncols; ++col)
+ {
+ // First vertex.
+ vertex_t v1(c, row * ncols + col - 1);
+ // Second vertex.
+ vertex_t v2(c, row * ncols + col);
+ // Edge bewteen V1 and V2.
+ c.add_face(v1 + v2);
+ }
+
+ // Vertical edges.
+ if (row != 0)
+ for (unsigned col = 0; col < ncols; ++col)
+ {
+ // First vertex.
+ vertex_t v1(c, (row - 1) * ncols + col);
+ // Second vertex.
+ vertex_t v2(c, row * ncols + col);
+ // Edge bewteen V1 and V2.
+ c.add_face(v1 + v2);
+ }
+ }
+
+ // Site set (domain) of the image.
+ p_complex<dim, geom_t> pc(c, geom);
+
+ // Image based on this site set.
+ typedef complex_image<dim, geom_t, V> ima_t;
+ ima_t ima(pc);
+ return ima;
+ }
+
+} // end of namespace make
+
+
+#endif // ! APPS_GRAPH_MORPHO_MAKE_HH
--
1.6.3.1
1
0
01 Oct '09
* apps/graph-morpho/io.hh (make_regular_complex1d_image):
Move function...
* apps/graph-morpho/convert.hh: ...here, and turn into...
(convert::to_complex_image): ...this.
* apps/graph-morpho/asf-complex1d.cc,
* apps/graph-morpho/samples-image2d.cc,
* apps/graph-morpho/samples-complex1d.cc:
Adjust clients.
---
milena/ChangeLog | 13 +++++
milena/apps/graph-morpho/asf-complex1d.cc | 4 +-
milena/apps/graph-morpho/convert.hh | 58 ++++++++++++++++++++++++
milena/apps/graph-morpho/io.hh | 60 -------------------------
milena/apps/graph-morpho/samples-complex1d.cc | 8 ++--
milena/apps/graph-morpho/samples-image2d.cc | 2 +-
6 files changed, 78 insertions(+), 67 deletions(-)
diff --git a/milena/ChangeLog b/milena/ChangeLog
index dcad3c7..39bc7c2 100644
--- a/milena/ChangeLog
+++ b/milena/ChangeLog
@@ -1,5 +1,18 @@
2009-10-01 Roland Levillain <roland(a)lrde.epita.fr>
+ Clean up another conversion routine in graph-morpho.
+
+ * apps/graph-morpho/io.hh (make_regular_complex1d_image):
+ Move function...
+ * apps/graph-morpho/convert.hh: ...here, and turn into...
+ (convert::to_complex_image): ...this.
+ * apps/graph-morpho/asf-complex1d.cc,
+ * apps/graph-morpho/samples-image2d.cc,
+ * apps/graph-morpho/samples-complex1d.cc:
+ Adjust clients.
+
+2009-10-01 Roland Levillain <roland(a)lrde.epita.fr>
+
Clean up some conversion and pretty-printing routines in graph-morpho.
* apps/graph-morpho/convert.hh,
diff --git a/milena/apps/graph-morpho/asf-complex1d.cc b/milena/apps/graph-morpho/asf-complex1d.cc
index 72ac574..bf1d624 100644
--- a/milena/apps/graph-morpho/asf-complex1d.cc
+++ b/milena/apps/graph-morpho/asf-complex1d.cc
@@ -36,7 +36,7 @@
#include "apps/graph-morpho/morpho.hh"
#include "apps/graph-morpho/make_complex2d.hh"
-#include "apps/graph-morpho/io.hh"
+#include "apps/graph-morpho/convert.hh"
#include "apps/data.hh"
@@ -60,7 +60,7 @@ int main()
cubical 1-complex here, but they are not yet available (as of
2009-09-10). */
typedef mln::bin_1complex_image2d ima_t;
- ima_t graph_ima = make_regular_complex1d_image(input_x2);
+ ima_t graph_ima = ::convert::to_complex_image(input_x2);
// ASF.
ima_t asf_ima = asf(graph_ima, 8);
diff --git a/milena/apps/graph-morpho/convert.hh b/milena/apps/graph-morpho/convert.hh
index e51b4ac..4328765 100644
--- a/milena/apps/graph-morpho/convert.hh
+++ b/milena/apps/graph-morpho/convert.hh
@@ -32,6 +32,10 @@
# include <mln/core/alias/complex_image.hh>
# include <mln/core/image/image2d.hh>
+# include <mln/math/abs.hh>
+
+# include "apps/graph-morpho/io.hh"
+
namespace convert
{
@@ -111,6 +115,60 @@ namespace convert
return output;
}
+
+ /// Convert an mln::bin_1complex_image2d to an mln::image2d<bool>.
+ inline
+ mln::bin_1complex_image2d
+ to_complex_image(const mln::image2d<bool>& input)
+ {
+ using namespace mln;
+
+ const box2d& input_box = input.domain();
+ // The input image must have an odd number of rows and columns.
+ mln_precondition(input_box.nrows() % 2 == 1);
+ mln_precondition(input_box.ncols() % 2 == 1);
+
+ // The domain of the graph image is twice as small, since we
+ // consider only vertices (edges are set ``between'' vertices).
+ box2d output_box(input_box.nrows() / 2 + 1,
+ input_box.ncols() / 2 + 1);
+ bin_1complex_image2d output = build_regular_complex1d_image(output_box);
+
+ const unsigned dim = 1;
+ typedef geom::complex_geometry<dim, point2d> geom_t;
+
+ // Add values on vertices.
+ p_n_faces_fwd_piter<dim, geom_t> v(output.domain(), 0);
+ for_all(v)
+ {
+ mln_site_(geom_t) s(v);
+ // Site S is point2d multi-site and should be a singleton (since V
+ // iterates on vertices).
+ mln_invariant(s.size() == 1);
+ point2d p = s.front();
+ point2d q(p.row() * 2, p.col() * 2);
+ output(v) = input(q);
+ }
+
+ // Add values on edges.
+ p_n_faces_fwd_piter<dim, geom_t> e(output.domain(), 1);
+ for_all(e)
+ {
+ mln_site_(geom_t) s(e);
+ // Site S is point2d multi-site and should be a pair (since E
+ // iterates on vertices).
+ mln_invariant(s.size() == 2);
+ point2d p1 = s[0];
+ point2d p2 = s[1];
+ mln_invariant(math::abs(p1.row() - p2.row()) == 1
+ || math::abs(p1.col() - p2.col()) == 1);
+ point2d q (p1.row() + p2.row(), p1.col() + p2.col());
+ output(e) = input(q);
+ }
+
+ return output;
+ }
+
} // end of namespace convert
diff --git a/milena/apps/graph-morpho/io.hh b/milena/apps/graph-morpho/io.hh
index 8c92949..6dac2c4 100644
--- a/milena/apps/graph-morpho/io.hh
+++ b/milena/apps/graph-morpho/io.hh
@@ -32,11 +32,6 @@
# include <mln/core/alias/complex_image.hh>
# include <mln/core/image/image2d.hh>
-# include <mln/math/abs.hh>
-
-// FIXME: We should turn these routines into something much more
-// generic, and move it to the library (into make/).
-
inline
mln::bin_1complex_image2d
build_regular_complex1d_image(const mln::box2d& support)
@@ -98,59 +93,4 @@ build_regular_complex1d_image(const mln::box2d& support)
}
-template <typename I>
-inline
-mln::bin_1complex_image2d
-make_regular_complex1d_image(const mln::Image<I>& input_)
-{
- using namespace mln;
-
- const I& input = exact(input_);
- const box2d& input_box = input.domain();
- // The input image must have an odd number of rows and columns.
- mln_precondition(input_box.nrows() % 2 == 1);
- mln_precondition(input_box.ncols() % 2 == 1);
-
- // The domain of the graph image is twice as small, since we
- // consider only vertices (edges are set ``between'' vertices).
- box2d output_box(input_box.nrows() / 2 + 1,
- input_box.ncols() / 2 + 1);
- bin_1complex_image2d output = build_regular_complex1d_image(output_box);
-
- const unsigned dim = 1;
- typedef geom::complex_geometry<dim, point2d> geom_t;
-
- // Add values on vertices.
- p_n_faces_fwd_piter<dim, geom_t> v(output.domain(), 0);
- for_all(v)
- {
- mln_site_(geom_t) s(v);
- // Site S is point2d multi-site and should be a singleton (since V
- // iterates on vertices).
- mln_invariant(s.size() == 1);
- point2d p = s.front();
- point2d q(p.row() * 2, p.col() * 2);
- output(v) = input(q);
- }
-
- // Add values on edges.
- p_n_faces_fwd_piter<dim, geom_t> e(output.domain(), 1);
- for_all(e)
- {
- mln_site_(geom_t) s(e);
- // Site S is point2d multi-site and should be a pair (since E
- // iterates on vertices).
- mln_invariant(s.size() == 2);
- point2d p1 = s[0];
- point2d p2 = s[1];
- mln_invariant(math::abs(p1.row() - p2.row()) == 1
- || math::abs(p1.col() - p2.col()) == 1);
- point2d q (p1.row() + p2.row(), p1.col() + p2.col());
- output(e) = input(q);
- }
-
- return output;
-}
-
-
#endif // ! APPS_GRAPH_MORPHO_IO_HH
diff --git a/milena/apps/graph-morpho/samples-complex1d.cc b/milena/apps/graph-morpho/samples-complex1d.cc
index 0b32236..c76bbf0 100644
--- a/milena/apps/graph-morpho/samples-complex1d.cc
+++ b/milena/apps/graph-morpho/samples-complex1d.cc
@@ -34,7 +34,7 @@
#include "apps/graph-morpho/morpho.hh"
-#include "apps/graph-morpho/io.hh"
+#include "apps/graph-morpho/convert.hh"
#include "apps/graph-morpho/debug.hh"
#include "apps/data.hh"
@@ -58,7 +58,7 @@ int main()
/* Create an image corresponding to the graph X of the ISMM 2009
paper from Jean Cousty et al. */
image2d<bool> x_pbm = io::pbm::load(MLN_APPS_DIR "/graph-morpho/x.pbm");
- ima_t x = make_regular_complex1d_image(x_pbm);
+ ima_t x = ::convert::to_complex_image(x_pbm);
::debug::println_graph("x:", x);
::debug::println_graph("dilation_e2v(x):", dilation_e2v(x));
@@ -79,7 +79,7 @@ int main()
// Create an image corresponding to the graph Y.
image2d<bool> y_pbm = io::pbm::load(MLN_APPS_DIR "/graph-morpho/y.pbm");
- ima_t y = make_regular_complex1d_image(y_pbm);
+ ima_t y = ::convert::to_complex_image(y_pbm);
::debug::println_graph("y:", y);
::debug::println_graph("opening_graph(y):", opening_graph(y));
@@ -88,7 +88,7 @@ int main()
// Create an image corresponding to the graph Z.
image2d<bool> z_pbm = io::pbm::load(MLN_APPS_DIR "/graph-morpho/z.pbm");
- ima_t z = make_regular_complex1d_image(z_pbm);
+ ima_t z = ::convert::to_complex_image(z_pbm);
::debug::println_graph("z:", z);
::debug::println_graph("closing_graph(z):", closing_graph(z));
diff --git a/milena/apps/graph-morpho/samples-image2d.cc b/milena/apps/graph-morpho/samples-image2d.cc
index 76d5f7f..ab4bcb6 100644
--- a/milena/apps/graph-morpho/samples-image2d.cc
+++ b/milena/apps/graph-morpho/samples-image2d.cc
@@ -31,7 +31,7 @@
#include "apps/graph-morpho/morpho.hh"
-#include "apps/graph-morpho/io.hh"
+#include "apps/graph-morpho/convert.hh"
#include "apps/graph-morpho/debug.hh"
#include "apps/data.hh"
--
1.6.3.1
1
0