From c33906d83d527c6a6a42659aef66ad869f1925a4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Joan=20Sol=C3=A0?= <jsola@iri.upc.edu>
Date: Thu, 14 Apr 2022 13:29:12 +0200
Subject: [PATCH] Add active_search files and documentation
---
.gitignore | 2 +-
doc/doxygen.conf | 2635 ++++++++++++++++++++++
doc/doxygen.conf.bak | 2364 +++++++++++++++++++
doc/doxygen_project_name.conf | 1 +
doc/images/tesselationExample.png | Bin 0 -> 29304 bytes
doc/images/tesselationGrid.png | Bin 0 -> 18896 bytes
doc/images/wolf-120.png | Bin 0 -> 1432 bytes
doc/images/wolf-500.png | Bin 0 -> 5920 bytes
doc/images/wolf-title-100.png | Bin 0 -> 4132 bytes
doc/images/wolf-title-120.png | Bin 0 -> 2762 bytes
doc/images/wolf-title-140.png | Bin 0 -> 3017 bytes
doc/images/wolf-title-500.png | Bin 0 -> 7326 bytes
doc/main.dox | 29 +
include/vision/processor/active_search.h | 342 +++
src/processor/active_search.cpp | 160 ++
15 files changed, 5532 insertions(+), 1 deletion(-)
create mode 100644 doc/doxygen.conf
create mode 100644 doc/doxygen.conf.bak
create mode 100644 doc/doxygen_project_name.conf
create mode 100644 doc/images/tesselationExample.png
create mode 100644 doc/images/tesselationGrid.png
create mode 100644 doc/images/wolf-120.png
create mode 100644 doc/images/wolf-500.png
create mode 100644 doc/images/wolf-title-100.png
create mode 100644 doc/images/wolf-title-120.png
create mode 100644 doc/images/wolf-title-140.png
create mode 100644 doc/images/wolf-title-500.png
create mode 100644 doc/main.dox
create mode 100644 include/vision/processor/active_search.h
create mode 100644 src/processor/active_search.cpp
diff --git a/.gitignore b/.gitignore
index b1406042b..6fe086888 100644
--- a/.gitignore
+++ b/.gitignore
@@ -32,4 +32,4 @@ vision.found
\.vscode/
build_release/
-
+doc/html
diff --git a/doc/doxygen.conf b/doc/doxygen.conf
new file mode 100644
index 000000000..09076a459
--- /dev/null
+++ b/doc/doxygen.conf
@@ -0,0 +1,2635 @@
+# Doxyfile 1.9.3
+
+# This file describes the settings to be used by the documentation system
+# doxygen (www.doxygen.org) for a project.
+#
+# All text after a double hash (##) is considered a comment and is placed in
+# front of the TAG it is preceding.
+#
+# All text after a single hash (#) is considered a comment and will be ignored.
+# The format is:
+# TAG = value [value, ...]
+# For lists, items can also be appended using:
+# TAG += value [value, ...]
+# Values that contain spaces should be placed between quotes (\" \").
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+
+# This tag specifies the encoding used for all characters in the configuration
+# file that follow. The default is UTF-8 which is also the encoding used for all
+# text before the first occurrence of this tag. Doxygen uses libiconv (or the
+# iconv built into libc) for the transcoding. See
+# https://www.gnu.org/software/libiconv/ for the list of possible encodings.
+# The default value is: UTF-8.
+
+DOXYFILE_ENCODING = UTF-8
+
+# The PROJECT_NAME tag is a single word (or a sequence of words surrounded by
+# double-quotes, unless you are using Doxywizard) that should identify the
+# project for which the documentation is generated. This name is used in the
+# title of most generated pages and in a few other places.
+# The default value is: My Project.
+
+PROJECT_NAME = WOLF
+
+# The PROJECT_NUMBER tag can be used to enter a project or revision number. This
+# could be handy for archiving the generated documentation or if some version
+# control system is used.
+
+PROJECT_NUMBER =
+
+# Using the PROJECT_BRIEF tag one can provide an optional one line description
+# for a project that appears at the top of each page and should give viewer a
+# quick idea about the purpose of the project. Keep the description short.
+
+PROJECT_BRIEF =
+
+# With the PROJECT_LOGO tag one can specify a logo or an icon that is included
+# in the documentation. The maximum height of the logo should not exceed 55
+# pixels and the maximum width should not exceed 200 pixels. Doxygen will copy
+# the logo to the output directory.
+
+PROJECT_LOGO = ../doc/images/wolf-120.png
+
+# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path
+# into which the generated documentation will be written. If a relative path is
+# entered, it will be relative to the location where doxygen was started. If
+# left blank the current directory will be used.
+
+OUTPUT_DIRECTORY = ../doc
+
+# If the CREATE_SUBDIRS tag is set to YES then doxygen will create 4096 sub-
+# directories (in 2 levels) under the output directory of each output format and
+# will distribute the generated files over these directories. Enabling this
+# option can be useful when feeding doxygen a huge amount of source files, where
+# putting all generated files in the same directory would otherwise causes
+# performance problems for the file system.
+# The default value is: NO.
+
+CREATE_SUBDIRS = NO
+
+# If the ALLOW_UNICODE_NAMES tag is set to YES, doxygen will allow non-ASCII
+# characters to appear in the names of generated files. If set to NO, non-ASCII
+# characters will be escaped, for example _xE3_x81_x84 will be used for Unicode
+# U+3044.
+# The default value is: NO.
+
+ALLOW_UNICODE_NAMES = NO
+
+# The OUTPUT_LANGUAGE tag is used to specify the language in which all
+# documentation generated by doxygen is written. Doxygen will use this
+# information to generate all constant output in the proper language.
+# Possible values are: Afrikaans, Arabic, Armenian, Brazilian, Catalan, Chinese,
+# Chinese-Traditional, Croatian, Czech, Danish, Dutch, English (United States),
+# Esperanto, Farsi (Persian), Finnish, French, German, Greek, Hungarian,
+# Indonesian, Italian, Japanese, Japanese-en (Japanese with English messages),
+# Korean, Korean-en (Korean with English messages), Latvian, Lithuanian,
+# Macedonian, Norwegian, Persian (Farsi), Polish, Portuguese, Romanian, Russian,
+# Serbian, Serbian-Cyrillic, Slovak, Slovene, Spanish, Swedish, Turkish,
+# Ukrainian and Vietnamese.
+# The default value is: English.
+
+OUTPUT_LANGUAGE = English
+
+# If the BRIEF_MEMBER_DESC tag is set to YES, doxygen will include brief member
+# descriptions after the members that are listed in the file and class
+# documentation (similar to Javadoc). Set to NO to disable this.
+# The default value is: YES.
+
+BRIEF_MEMBER_DESC = YES
+
+# If the REPEAT_BRIEF tag is set to YES, doxygen will prepend the brief
+# description of a member or function before the detailed description
+#
+# Note: If both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
+# brief descriptions will be completely suppressed.
+# The default value is: YES.
+
+REPEAT_BRIEF = YES
+
+# This tag implements a quasi-intelligent brief description abbreviator that is
+# used to form the text in various listings. Each string in this list, if found
+# as the leading text of the brief description, will be stripped from the text
+# and the result, after processing the whole list, is used as the annotated
+# text. Otherwise, the brief description is used as-is. If left blank, the
+# following values are used ($name is automatically replaced with the name of
+# the entity):The $name class, The $name widget, The $name file, is, provides,
+# specifies, contains, represents, a, an and the.
+
+ABBREVIATE_BRIEF =
+
+# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
+# doxygen will generate a detailed section even if there is only a brief
+# description.
+# The default value is: NO.
+
+ALWAYS_DETAILED_SEC = NO
+
+# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
+# inherited members of a class in the documentation of that class as if those
+# members were ordinary class members. Constructors, destructors and assignment
+# operators of the base classes will not be shown.
+# The default value is: NO.
+
+INLINE_INHERITED_MEMB = NO
+
+# If the FULL_PATH_NAMES tag is set to YES, doxygen will prepend the full path
+# before files name in the file list and in the header files. If set to NO the
+# shortest path that makes the file name unique will be used
+# The default value is: YES.
+
+FULL_PATH_NAMES = NO
+
+# The STRIP_FROM_PATH tag can be used to strip a user-defined part of the path.
+# Stripping is only done if one of the specified strings matches the left-hand
+# part of the path. The tag can be used to show relative paths in the file list.
+# If left blank the directory from which doxygen is run is used as the path to
+# strip.
+#
+# Note that you can specify absolute paths here, but also relative paths, which
+# will be relative from the directory where doxygen is started.
+# This tag requires that the tag FULL_PATH_NAMES is set to YES.
+
+STRIP_FROM_PATH =
+
+# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of the
+# path mentioned in the documentation of a class, which tells the reader which
+# header file to include in order to use a class. If left blank only the name of
+# the header file containing the class definition is used. Otherwise one should
+# specify the list of include paths that are normally passed to the compiler
+# using the -I flag.
+
+STRIP_FROM_INC_PATH =
+
+# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but
+# less readable) file names. This can be useful is your file systems doesn't
+# support long names like on DOS, Mac, or CD-ROM.
+# The default value is: NO.
+
+SHORT_NAMES = NO
+
+# If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret the
+# first line (until the first dot) of a Javadoc-style comment as the brief
+# description. If set to NO, the Javadoc-style will behave just like regular Qt-
+# style comments (thus requiring an explicit @brief command for a brief
+# description.)
+# The default value is: NO.
+
+JAVADOC_AUTOBRIEF = NO
+
+# If the JAVADOC_BANNER tag is set to YES then doxygen will interpret a line
+# such as
+# /***************
+# as being the beginning of a Javadoc-style comment "banner". If set to NO, the
+# Javadoc-style will behave just like regular comments and it will not be
+# interpreted by doxygen.
+# The default value is: NO.
+
+JAVADOC_BANNER = NO
+
+# If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first
+# line (until the first dot) of a Qt-style comment as the brief description. If
+# set to NO, the Qt-style will behave just like regular Qt-style comments (thus
+# requiring an explicit \brief command for a brief description.)
+# The default value is: NO.
+
+QT_AUTOBRIEF = NO
+
+# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make doxygen treat a
+# multi-line C++ special comment block (i.e. a block of //! or /// comments) as
+# a brief description. This used to be the default behavior. The new default is
+# to treat a multi-line C++ comment block as a detailed description. Set this
+# tag to YES if you prefer the old behavior instead.
+#
+# Note that setting this tag to YES also means that rational rose comments are
+# not recognized any more.
+# The default value is: NO.
+
+MULTILINE_CPP_IS_BRIEF = NO
+
+# By default Python docstrings are displayed as preformatted text and doxygen's
+# special commands cannot be used. By setting PYTHON_DOCSTRING to NO the
+# doxygen's special commands can be used and the contents of the docstring
+# documentation blocks is shown as doxygen documentation.
+# The default value is: YES.
+
+PYTHON_DOCSTRING = YES
+
+# If the INHERIT_DOCS tag is set to YES then an undocumented member inherits the
+# documentation from any documented member that it re-implements.
+# The default value is: YES.
+
+INHERIT_DOCS = YES
+
+# If the SEPARATE_MEMBER_PAGES tag is set to YES then doxygen will produce a new
+# page for each member. If set to NO, the documentation of a member will be part
+# of the file/class/namespace that contains it.
+# The default value is: NO.
+
+SEPARATE_MEMBER_PAGES = NO
+
+# The TAB_SIZE tag can be used to set the number of spaces in a tab. Doxygen
+# uses this value to replace tabs by spaces in code fragments.
+# Minimum value: 1, maximum value: 16, default value: 4.
+
+TAB_SIZE = 4
+
+# This tag can be used to specify a number of aliases that act as commands in
+# the documentation. An alias has the form:
+# name=value
+# For example adding
+# "sideeffect=@par Side Effects:^^"
+# will allow you to put the command \sideeffect (or @sideeffect) in the
+# documentation, which will result in a user-defined paragraph with heading
+# "Side Effects:". Note that you cannot put \n's in the value part of an alias
+# to insert newlines (in the resulting output). You can put ^^ in the value part
+# of an alias to insert a newline as if a physical newline was in the original
+# file. When you need a literal { or } or , in the value part of an alias you
+# have to escape them by means of a backslash (\), this can lead to conflicts
+# with the commands \{ and \} for these it is advised to use the version @{ and
+# @} or use a double escape (\\{ and \\})
+
+ALIASES =
+
+# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources
+# only. Doxygen will then generate output that is more tailored for C. For
+# instance, some of the names that are used will be different. The list of all
+# members will be omitted, etc.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_FOR_C = NO
+
+# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java or
+# Python sources only. Doxygen will then generate output that is more tailored
+# for that language. For instance, namespaces will be presented as packages,
+# qualified scopes will look different, etc.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_JAVA = NO
+
+# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran
+# sources. Doxygen will then generate output that is tailored for Fortran.
+# The default value is: NO.
+
+OPTIMIZE_FOR_FORTRAN = NO
+
+# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL
+# sources. Doxygen will then generate output that is tailored for VHDL.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_VHDL = NO
+
+# Set the OPTIMIZE_OUTPUT_SLICE tag to YES if your project consists of Slice
+# sources only. Doxygen will then generate output that is more tailored for that
+# language. For instance, namespaces will be presented as modules, types will be
+# separated into more groups, etc.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_SLICE = NO
+
+# Doxygen selects the parser to use depending on the extension of the files it
+# parses. With this tag you can assign which parser to use for a given
+# extension. Doxygen has a built-in mapping, but you can override or extend it
+# using this tag. The format is ext=language, where ext is a file extension, and
+# language is one of the parsers supported by doxygen: IDL, Java, JavaScript,
+# Csharp (C#), C, C++, Lex, D, PHP, md (Markdown), Objective-C, Python, Slice,
+# VHDL, Fortran (fixed format Fortran: FortranFixed, free formatted Fortran:
+# FortranFree, unknown formatted Fortran: Fortran. In the later case the parser
+# tries to guess whether the code is fixed or free formatted code, this is the
+# default for Fortran type files). For instance to make doxygen treat .inc files
+# as Fortran files (default is PHP), and .f files as C (default is Fortran),
+# use: inc=Fortran f=C.
+#
+# Note: For files without extension you can use no_extension as a placeholder.
+#
+# Note that for custom extensions you also need to set FILE_PATTERNS otherwise
+# the files are not read by doxygen. When specifying no_extension you should add
+# * to the FILE_PATTERNS.
+#
+# Note see also the list of default file extension mappings.
+
+EXTENSION_MAPPING =
+
+# If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments
+# according to the Markdown format, which allows for more readable
+# documentation. See https://daringfireball.net/projects/markdown/ for details.
+# The output of markdown processing is further processed by doxygen, so you can
+# mix doxygen, HTML, and XML commands with Markdown formatting. Disable only in
+# case of backward compatibilities issues.
+# The default value is: YES.
+
+MARKDOWN_SUPPORT = YES
+
+# When the TOC_INCLUDE_HEADINGS tag is set to a non-zero value, all headings up
+# to that level are automatically included in the table of contents, even if
+# they do not have an id attribute.
+# Note: This feature currently applies only to Markdown headings.
+# Minimum value: 0, maximum value: 99, default value: 5.
+# This tag requires that the tag MARKDOWN_SUPPORT is set to YES.
+
+TOC_INCLUDE_HEADINGS = 5
+
+# When enabled doxygen tries to link words that correspond to documented
+# classes, or namespaces to their corresponding documentation. Such a link can
+# be prevented in individual cases by putting a % sign in front of the word or
+# globally by setting AUTOLINK_SUPPORT to NO.
+# The default value is: YES.
+
+AUTOLINK_SUPPORT = YES
+
+# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
+# to include (a tag file for) the STL sources as input, then you should set this
+# tag to YES in order to let doxygen match functions declarations and
+# definitions whose arguments contain STL classes (e.g. func(std::string);
+# versus func(std::string) {}). This also make the inheritance and collaboration
+# diagrams that involve STL classes more complete and accurate.
+# The default value is: NO.
+
+BUILTIN_STL_SUPPORT = NO
+
+# If you use Microsoft's C++/CLI language, you should set this option to YES to
+# enable parsing support.
+# The default value is: NO.
+
+CPP_CLI_SUPPORT = NO
+
+# Set the SIP_SUPPORT tag to YES if your project consists of sip (see:
+# https://www.riverbankcomputing.com/software/sip/intro) sources only. Doxygen
+# will parse them like normal C++ but will assume all classes use public instead
+# of private inheritance when no explicit protection keyword is present.
+# The default value is: NO.
+
+SIP_SUPPORT = NO
+
+# For Microsoft's IDL there are propget and propput attributes to indicate
+# getter and setter methods for a property. Setting this option to YES will make
+# doxygen to replace the get and set methods by a property in the documentation.
+# This will only work if the methods are indeed getting or setting a simple
+# type. If this is not the case, or you want to show the methods anyway, you
+# should set this option to NO.
+# The default value is: YES.
+
+IDL_PROPERTY_SUPPORT = YES
+
+# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
+# tag is set to YES then doxygen will reuse the documentation of the first
+# member in the group (if any) for the other members of the group. By default
+# all members of a group must be documented explicitly.
+# The default value is: NO.
+
+DISTRIBUTE_GROUP_DOC = NO
+
+# If one adds a struct or class to a group and this option is enabled, then also
+# any nested class or struct is added to the same group. By default this option
+# is disabled and one has to add nested compounds explicitly via \ingroup.
+# The default value is: NO.
+
+GROUP_NESTED_COMPOUNDS = NO
+
+# Set the SUBGROUPING tag to YES to allow class member groups of the same type
+# (for instance a group of public functions) to be put as a subgroup of that
+# type (e.g. under the Public Functions section). Set it to NO to prevent
+# subgrouping. Alternatively, this can be done per class using the
+# \nosubgrouping command.
+# The default value is: YES.
+
+SUBGROUPING = YES
+
+# When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and unions
+# are shown inside the group in which they are included (e.g. using \ingroup)
+# instead of on a separate page (for HTML and Man pages) or section (for LaTeX
+# and RTF).
+#
+# Note that this feature does not work in combination with
+# SEPARATE_MEMBER_PAGES.
+# The default value is: NO.
+
+INLINE_GROUPED_CLASSES = NO
+
+# When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions
+# with only public data fields or simple typedef fields will be shown inline in
+# the documentation of the scope in which they are defined (i.e. file,
+# namespace, or group documentation), provided this scope is documented. If set
+# to NO, structs, classes, and unions are shown on a separate page (for HTML and
+# Man pages) or section (for LaTeX and RTF).
+# The default value is: NO.
+
+INLINE_SIMPLE_STRUCTS = YES
+
+# When TYPEDEF_HIDES_STRUCT tag is enabled, a typedef of a struct, union, or
+# enum is documented as struct, union, or enum with the name of the typedef. So
+# typedef struct TypeS {} TypeT, will appear in the documentation as a struct
+# with name TypeT. When disabled the typedef will appear as a member of a file,
+# namespace, or class. And the struct will be named TypeS. This can typically be
+# useful for C code in case the coding convention dictates that all compound
+# types are typedef'ed and only the typedef is referenced, never the tag name.
+# The default value is: NO.
+
+TYPEDEF_HIDES_STRUCT = NO
+
+# The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This
+# cache is used to resolve symbols given their name and scope. Since this can be
+# an expensive process and often the same symbol appears multiple times in the
+# code, doxygen keeps a cache of pre-resolved symbols. If the cache is too small
+# doxygen will become slower. If the cache is too large, memory is wasted. The
+# cache size is given by this formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range
+# is 0..9, the default is 0, corresponding to a cache size of 2^16=65536
+# symbols. At the end of a run doxygen will report the cache usage and suggest
+# the optimal cache size from a speed point of view.
+# Minimum value: 0, maximum value: 9, default value: 0.
+
+LOOKUP_CACHE_SIZE = 0
+
+# The NUM_PROC_THREADS specifies the number threads doxygen is allowed to use
+# during processing. When set to 0 doxygen will based this on the number of
+# cores available in the system. You can set it explicitly to a value larger
+# than 0 to get more control over the balance between CPU load and processing
+# speed. At this moment only the input processing can be done using multiple
+# threads. Since this is still an experimental feature the default is set to 1,
+# which effectively disables parallel processing. Please report any issues you
+# encounter. Generating dot graphs in parallel is controlled by the
+# DOT_NUM_THREADS setting.
+# Minimum value: 0, maximum value: 32, default value: 1.
+
+NUM_PROC_THREADS = 1
+
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+
+# If the EXTRACT_ALL tag is set to YES, doxygen will assume all entities in
+# documentation are documented, even if no documentation was available. Private
+# class members and static file members will be hidden unless the
+# EXTRACT_PRIVATE respectively EXTRACT_STATIC tags are set to YES.
+# Note: This will also disable the warnings about undocumented members that are
+# normally produced when WARNINGS is set to YES.
+# The default value is: NO.
+
+EXTRACT_ALL = YES
+
+# If the EXTRACT_PRIVATE tag is set to YES, all private members of a class will
+# be included in the documentation.
+# The default value is: NO.
+
+EXTRACT_PRIVATE = NO
+
+# If the EXTRACT_PRIV_VIRTUAL tag is set to YES, documented private virtual
+# methods of a class will be included in the documentation.
+# The default value is: NO.
+
+EXTRACT_PRIV_VIRTUAL = NO
+
+# If the EXTRACT_PACKAGE tag is set to YES, all members with package or internal
+# scope will be included in the documentation.
+# The default value is: NO.
+
+EXTRACT_PACKAGE = NO
+
+# If the EXTRACT_STATIC tag is set to YES, all static members of a file will be
+# included in the documentation.
+# The default value is: NO.
+
+EXTRACT_STATIC = NO
+
+# If the EXTRACT_LOCAL_CLASSES tag is set to YES, classes (and structs) defined
+# locally in source files will be included in the documentation. If set to NO,
+# only classes defined in header files are included. Does not have any effect
+# for Java sources.
+# The default value is: YES.
+
+EXTRACT_LOCAL_CLASSES = YES
+
+# This flag is only useful for Objective-C code. If set to YES, local methods,
+# which are defined in the implementation section but not in the interface are
+# included in the documentation. If set to NO, only methods in the interface are
+# included.
+# The default value is: NO.
+
+EXTRACT_LOCAL_METHODS = NO
+
+# If this flag is set to YES, the members of anonymous namespaces will be
+# extracted and appear in the documentation as a namespace called
+# 'anonymous_namespace{file}', where file will be replaced with the base name of
+# the file that contains the anonymous namespace. By default anonymous namespace
+# are hidden.
+# The default value is: NO.
+
+EXTRACT_ANON_NSPACES = NO
+
+# If this flag is set to YES, the name of an unnamed parameter in a declaration
+# will be determined by the corresponding definition. By default unnamed
+# parameters remain unnamed in the output.
+# The default value is: YES.
+
+RESOLVE_UNNAMED_PARAMS = YES
+
+# If the HIDE_UNDOC_MEMBERS tag is set to YES, doxygen will hide all
+# undocumented members inside documented classes or files. If set to NO these
+# members will be included in the various overviews, but no documentation
+# section is generated. This option has no effect if EXTRACT_ALL is enabled.
+# The default value is: NO.
+
+HIDE_UNDOC_MEMBERS = NO
+
+# If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all
+# undocumented classes that are normally visible in the class hierarchy. If set
+# to NO, these classes will be included in the various overviews. This option
+# has no effect if EXTRACT_ALL is enabled.
+# The default value is: NO.
+
+HIDE_UNDOC_CLASSES = NO
+
+# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend
+# declarations. If set to NO, these declarations will be included in the
+# documentation.
+# The default value is: NO.
+
+HIDE_FRIEND_COMPOUNDS = NO
+
+# If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any
+# documentation blocks found inside the body of a function. If set to NO, these
+# blocks will be appended to the function's detailed documentation block.
+# The default value is: NO.
+
+HIDE_IN_BODY_DOCS = NO
+
+# The INTERNAL_DOCS tag determines if documentation that is typed after a
+# \internal command is included. If the tag is set to NO then the documentation
+# will be excluded. Set it to YES to include the internal documentation.
+# The default value is: NO.
+
+INTERNAL_DOCS = NO
+
+# With the correct setting of option CASE_SENSE_NAMES doxygen will better be
+# able to match the capabilities of the underlying filesystem. In case the
+# filesystem is case sensitive (i.e. it supports files in the same directory
+# whose names only differ in casing), the option must be set to YES to properly
+# deal with such files in case they appear in the input. For filesystems that
+# are not case sensitive the option should be be set to NO to properly deal with
+# output files written for symbols that only differ in casing, such as for two
+# classes, one named CLASS and the other named Class, and to also support
+# references to files without having to specify the exact matching casing. On
+# Windows (including Cygwin) and MacOS, users should typically set this option
+# to NO, whereas on Linux or other Unix flavors it should typically be set to
+# YES.
+# The default value is: system dependent.
+
+CASE_SENSE_NAMES = YES
+
+# If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with
+# their full class and namespace scopes in the documentation. If set to YES, the
+# scope will be hidden.
+# The default value is: NO.
+
+HIDE_SCOPE_NAMES = NO
+
+# If the HIDE_COMPOUND_REFERENCE tag is set to NO (default) then doxygen will
+# append additional text to a page's title, such as Class Reference. If set to
+# YES the compound reference will be hidden.
+# The default value is: NO.
+
+HIDE_COMPOUND_REFERENCE= NO
+
+# If the SHOW_HEADERFILE tag is set to YES then the documentation for a class
+# will show which file needs to be included to use the class.
+# The default value is: YES.
+
+SHOW_HEADERFILE = YES
+
+# If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of
+# the files that are included by a file in the documentation of that file.
+# The default value is: YES.
+
+SHOW_INCLUDE_FILES = YES
+
+# If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each
+# grouped member an include statement to the documentation, telling the reader
+# which file to include in order to use the member.
+# The default value is: NO.
+
+SHOW_GROUPED_MEMB_INC = NO
+
+# If the FORCE_LOCAL_INCLUDES tag is set to YES then doxygen will list include
+# files with double quotes in the documentation rather than with sharp brackets.
+# The default value is: NO.
+
+FORCE_LOCAL_INCLUDES = NO
+
+# If the INLINE_INFO tag is set to YES then a tag [inline] is inserted in the
+# documentation for inline members.
+# The default value is: YES.
+
+INLINE_INFO = YES
+
+# If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the
+# (detailed) documentation of file and class members alphabetically by member
+# name. If set to NO, the members will appear in declaration order.
+# The default value is: YES.
+
+SORT_MEMBER_DOCS = NO
+
+# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief
+# descriptions of file, namespace and class members alphabetically by member
+# name. If set to NO, the members will appear in declaration order. Note that
+# this will also influence the order of the classes in the class list.
+# The default value is: NO.
+
+SORT_BRIEF_DOCS = NO
+
+# If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the
+# (brief and detailed) documentation of class members so that constructors and
+# destructors are listed first. If set to NO the constructors will appear in the
+# respective orders defined by SORT_BRIEF_DOCS and SORT_MEMBER_DOCS.
+# Note: If SORT_BRIEF_DOCS is set to NO this option is ignored for sorting brief
+# member documentation.
+# Note: If SORT_MEMBER_DOCS is set to NO this option is ignored for sorting
+# detailed member documentation.
+# The default value is: NO.
+
+SORT_MEMBERS_CTORS_1ST = NO
+
+# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy
+# of group names into alphabetical order. If set to NO the group names will
+# appear in their defined order.
+# The default value is: NO.
+
+SORT_GROUP_NAMES = NO
+
+# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by
+# fully-qualified names, including namespaces. If set to NO, the class list will
+# be sorted only by class name, not including the namespace part.
+# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.
+# Note: This option applies only to the class list, not to the alphabetical
+# list.
+# The default value is: NO.
+
+SORT_BY_SCOPE_NAME = NO
+
+# If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to do proper
+# type resolution of all parameters of a function it will reject a match between
+# the prototype and the implementation of a member function even if there is
+# only one candidate or it is obvious which candidate to choose by doing a
+# simple string match. By disabling STRICT_PROTO_MATCHING doxygen will still
+# accept a match between prototype and implementation in such cases.
+# The default value is: NO.
+
+STRICT_PROTO_MATCHING = NO
+
+# The GENERATE_TODOLIST tag can be used to enable (YES) or disable (NO) the todo
+# list. This list is created by putting \todo commands in the documentation.
+# The default value is: YES.
+
+GENERATE_TODOLIST = YES
+
+# The GENERATE_TESTLIST tag can be used to enable (YES) or disable (NO) the test
+# list. This list is created by putting \test commands in the documentation.
+# The default value is: YES.
+
+GENERATE_TESTLIST = YES
+
+# The GENERATE_BUGLIST tag can be used to enable (YES) or disable (NO) the bug
+# list. This list is created by putting \bug commands in the documentation.
+# The default value is: YES.
+
+GENERATE_BUGLIST = YES
+
+# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or disable (NO)
+# the deprecated list. This list is created by putting \deprecated commands in
+# the documentation.
+# The default value is: YES.
+
+GENERATE_DEPRECATEDLIST= YES
+
+# The ENABLED_SECTIONS tag can be used to enable conditional documentation
+# sections, marked by \if <section_label> ... \endif and \cond <section_label>
+# ... \endcond blocks.
+
+ENABLED_SECTIONS =
+
+# The MAX_INITIALIZER_LINES tag determines the maximum number of lines that the
+# initial value of a variable or macro / define can have for it to appear in the
+# documentation. If the initializer consists of more lines than specified here
+# it will be hidden. Use a value of 0 to hide initializers completely. The
+# appearance of the value of individual variables and macros / defines can be
+# controlled using \showinitializer or \hideinitializer command in the
+# documentation regardless of this setting.
+# Minimum value: 0, maximum value: 10000, default value: 30.
+
+MAX_INITIALIZER_LINES = 30
+
+# Set the SHOW_USED_FILES tag to NO to disable the list of files generated at
+# the bottom of the documentation of classes and structs. If set to YES, the
+# list will mention the files that were used to generate the documentation.
+# The default value is: YES.
+
+SHOW_USED_FILES = YES
+
+# Set the SHOW_FILES tag to NO to disable the generation of the Files page. This
+# will remove the Files entry from the Quick Index and from the Folder Tree View
+# (if specified).
+# The default value is: YES.
+
+SHOW_FILES = YES
+
+# Set the SHOW_NAMESPACES tag to NO to disable the generation of the Namespaces
+# page. This will remove the Namespaces entry from the Quick Index and from the
+# Folder Tree View (if specified).
+# The default value is: YES.
+
+SHOW_NAMESPACES = YES
+
+# The FILE_VERSION_FILTER tag can be used to specify a program or script that
+# doxygen should invoke to get the current version for each file (typically from
+# the version control system). Doxygen will invoke the program by executing (via
+# popen()) the command command input-file, where command is the value of the
+# FILE_VERSION_FILTER tag, and input-file is the name of an input file provided
+# by doxygen. Whatever the program writes to standard output is used as the file
+# version. For an example see the documentation.
+
+FILE_VERSION_FILTER =
+
+# The LAYOUT_FILE tag can be used to specify a layout file which will be parsed
+# by doxygen. The layout file controls the global structure of the generated
+# output files in an output format independent way. To create the layout file
+# that represents doxygen's defaults, run doxygen with the -l option. You can
+# optionally specify a file name after the option, if omitted DoxygenLayout.xml
+# will be used as the name of the layout file. See also section "Changing the
+# layout of pages" for information.
+#
+# Note that if you run doxygen from a directory containing a file called
+# DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE
+# tag is left empty.
+
+LAYOUT_FILE =
+
+# The CITE_BIB_FILES tag can be used to specify one or more bib files containing
+# the reference definitions. This must be a list of .bib files. The .bib
+# extension is automatically appended if omitted. This requires the bibtex tool
+# to be installed. See also https://en.wikipedia.org/wiki/BibTeX for more info.
+# For LaTeX the style of the bibliography can be controlled using
+# LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the
+# search path. See also \cite for info how to create references.
+
+CITE_BIB_FILES =
+
+#---------------------------------------------------------------------------
+# Configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+
+# The QUIET tag can be used to turn on/off the messages that are generated to
+# standard output by doxygen. If QUIET is set to YES this implies that the
+# messages are off.
+# The default value is: NO.
+
+QUIET = NO
+
+# The WARNINGS tag can be used to turn on/off the warning messages that are
+# generated to standard error (stderr) by doxygen. If WARNINGS is set to YES
+# this implies that the warnings are on.
+#
+# Tip: Turn warnings on while writing the documentation.
+# The default value is: YES.
+
+WARNINGS = YES
+
+# If the WARN_IF_UNDOCUMENTED tag is set to YES then doxygen will generate
+# warnings for undocumented members. If EXTRACT_ALL is set to YES then this flag
+# will automatically be disabled.
+# The default value is: YES.
+
+WARN_IF_UNDOCUMENTED = YES
+
+# If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for
+# potential errors in the documentation, such as documenting some parameters in
+# a documented function twice, or documenting parameters that don't exist or
+# using markup commands wrongly.
+# The default value is: YES.
+
+WARN_IF_DOC_ERROR = YES
+
+# If WARN_IF_INCOMPLETE_DOC is set to YES, doxygen will warn about incomplete
+# function parameter documentation. If set to NO, doxygen will accept that some
+# parameters have no documentation without warning.
+# The default value is: YES.
+
+WARN_IF_INCOMPLETE_DOC = YES
+
+# This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that
+# are documented, but have no documentation for their parameters or return
+# value. If set to NO, doxygen will only warn about wrong parameter
+# documentation, but not about the absence of documentation. If EXTRACT_ALL is
+# set to YES then this flag will automatically be disabled. See also
+# WARN_IF_INCOMPLETE_DOC
+# The default value is: NO.
+
+WARN_NO_PARAMDOC = YES
+
+# If the WARN_AS_ERROR tag is set to YES then doxygen will immediately stop when
+# a warning is encountered. If the WARN_AS_ERROR tag is set to FAIL_ON_WARNINGS
+# then doxygen will continue running as if WARN_AS_ERROR tag is set to NO, but
+# at the end of the doxygen process doxygen will return with a non-zero status.
+# Possible values are: NO, YES and FAIL_ON_WARNINGS.
+# The default value is: NO.
+
+WARN_AS_ERROR = NO
+
+# The WARN_FORMAT tag determines the format of the warning messages that doxygen
+# can produce. The string should contain the $file, $line, and $text tags, which
+# will be replaced by the file and line number from which the warning originated
+# and the warning text. Optionally the format may contain $version, which will
+# be replaced by the version of the file (if it could be obtained via
+# FILE_VERSION_FILTER)
+# The default value is: $file:$line: $text.
+
+WARN_FORMAT = "$file:$line: $text"
+
+# The WARN_LOGFILE tag can be used to specify a file to which warning and error
+# messages should be written. If left blank the output is written to standard
+# error (stderr). In case the file specified cannot be opened for writing the
+# warning and error messages are written to standard error. When as file - is
+# specified the warning and error messages are written to standard output
+# (stdout).
+
+WARN_LOGFILE =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the input files
+#---------------------------------------------------------------------------
+
+# The INPUT tag is used to specify the files and/or directories that contain
+# documented source files. You may enter file names like myfile.cpp or
+# directories like /usr/src/myproject. Separate the files or directories with
+# spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
+# Note: If this tag is empty the current directory is searched.
+
+INPUT = ../doc/main.dox \
+ ../include/vision \
+ ../src
+
+# This tag can be used to specify the character encoding of the source files
+# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
+# libiconv (or the iconv built into libc) for the transcoding. See the libiconv
+# documentation (see:
+# https://www.gnu.org/software/libiconv/) for the list of possible encodings.
+# The default value is: UTF-8.
+
+INPUT_ENCODING = UTF-8
+
+# If the value of the INPUT tag contains directories, you can use the
+# FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and
+# *.h) to filter out the source-files in the directories.
+#
+# Note that for custom extensions or not directly supported extensions you also
+# need to set EXTENSION_MAPPING for the extension otherwise the files are not
+# read by doxygen.
+#
+# Note the list of default checked file patterns might differ from the list of
+# default file extension mappings.
+#
+# If left blank the following patterns are tested:*.c, *.cc, *.cxx, *.cpp,
+# *.c++, *.java, *.ii, *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h,
+# *.hh, *.hxx, *.hpp, *.h++, *.l, *.cs, *.d, *.php, *.php4, *.php5, *.phtml,
+# *.inc, *.m, *.markdown, *.md, *.mm, *.dox (to be provided as doxygen C
+# comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08, *.f18, *.f, *.for, *.vhd,
+# *.vhdl, *.ucf, *.qsf and *.ice.
+
+FILE_PATTERNS = *.c \
+ *.h \
+ *.cpp
+
+# The RECURSIVE tag can be used to specify whether or not subdirectories should
+# be searched for input files as well.
+# The default value is: NO.
+
+RECURSIVE = YES
+
+# The EXCLUDE tag can be used to specify files and/or directories that should be
+# excluded from the INPUT source files. This way you can easily exclude a
+# subdirectory from a directory tree whose root is specified with the INPUT tag.
+#
+# Note that relative paths are relative to the directory from which doxygen is
+# run.
+
+EXCLUDE = ../src/old \
+ ../src/examples
+
+# The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
+# directories that are symbolic links (a Unix file system feature) are excluded
+# from the input.
+# The default value is: NO.
+
+EXCLUDE_SYMLINKS = NO
+
+# If the value of the INPUT tag contains directories, you can use the
+# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
+# certain files from those directories.
+#
+# Note that the wildcards are matched against the file with absolute path, so to
+# exclude all test directories for example use the pattern */test/*
+
+EXCLUDE_PATTERNS = parental.* \
+ test_branch*.* \
+ test_circ*.* \
+ test_error* \
+ test_graph* \
+ test_hete*.* \
+ test_map* \
+ test_mi* \
+ test_multimap* \
+ test_node*.* \
+ test_parent*.* \
+ test_Sensor* \
+ test_point* \
+ test_quat* \
+ test_shared*.* \
+ test_states* \
+ test_traj*.* \
+ test_unor*.* \
+ test_up_down* \
+ test_wolf_tree* \
+ *.tab.c \
+ *.tab.h \
+ lex* \
+ *glr.h \
+ *llr.h \
+ *glr.c \
+ *llr.c \
+ *general.h
+
+# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
+# (namespaces, classes, functions, etc.) that should be excluded from the
+# output. The symbol name can be a fully qualified name, a word, or if the
+# wildcard * is used, a substring. Examples: ANamespace, AClass,
+# ANamespace::AClass, ANamespace::*Test
+#
+# Note that the wildcards are matched against the file with absolute path, so to
+# exclude all test directories use the pattern */test/*
+
+EXCLUDE_SYMBOLS =
+
+# The EXAMPLE_PATH tag can be used to specify one or more files or directories
+# that contain example code fragments that are included (see the \include
+# command).
+
+EXAMPLE_PATH = ../src/examples
+
+# If the value of the EXAMPLE_PATH tag contains directories, you can use the
+# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
+# *.h) to filter out the source-files in the directories. If left blank all
+# files are included.
+
+EXAMPLE_PATTERNS =
+
+# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
+# searched for input files to be used with the \include or \dontinclude commands
+# irrespective of the value of the RECURSIVE tag.
+# The default value is: NO.
+
+EXAMPLE_RECURSIVE = NO
+
+# The IMAGE_PATH tag can be used to specify one or more files or directories
+# that contain images that are to be included in the documentation (see the
+# \image command).
+
+IMAGE_PATH = ../doc/images
+
+# The INPUT_FILTER tag can be used to specify a program that doxygen should
+# invoke to filter for each input file. Doxygen will invoke the filter program
+# by executing (via popen()) the command:
+#
+# <filter> <input-file>
+#
+# where <filter> is the value of the INPUT_FILTER tag, and <input-file> is the
+# name of an input file. Doxygen will then use the output that the filter
+# program writes to standard output. If FILTER_PATTERNS is specified, this tag
+# will be ignored.
+#
+# Note that the filter must not add or remove lines; it is applied before the
+# code is scanned, but not when the output code is generated. If lines are added
+# or removed, the anchors will not be placed correctly.
+#
+# Note that for custom extensions or not directly supported extensions you also
+# need to set EXTENSION_MAPPING for the extension otherwise the files are not
+# properly processed by doxygen.
+
+INPUT_FILTER =
+
+# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern
+# basis. Doxygen will compare the file name with each pattern and apply the
+# filter if there is a match. The filters are a list of the form: pattern=filter
+# (like *.cpp=my_cpp_filter). See INPUT_FILTER for further information on how
+# filters are used. If the FILTER_PATTERNS tag is empty or if none of the
+# patterns match the file name, INPUT_FILTER is applied.
+#
+# Note that for custom extensions or not directly supported extensions you also
+# need to set EXTENSION_MAPPING for the extension otherwise the files are not
+# properly processed by doxygen.
+
+FILTER_PATTERNS =
+
+# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
+# INPUT_FILTER) will also be used to filter the input files that are used for
+# producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES).
+# The default value is: NO.
+
+FILTER_SOURCE_FILES = NO
+
+# The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file
+# pattern. A pattern will override the setting for FILTER_PATTERN (if any) and
+# it is also possible to disable source filtering for a specific pattern using
+# *.ext= (so without naming a filter).
+# This tag requires that the tag FILTER_SOURCE_FILES is set to YES.
+
+FILTER_SOURCE_PATTERNS =
+
+# If the USE_MDFILE_AS_MAINPAGE tag refers to the name of a markdown file that
+# is part of the input, its contents will be placed on the main page
+# (index.html). This can be useful if you have a project on for instance GitHub
+# and want to reuse the introduction page also for the doxygen output.
+
+USE_MDFILE_AS_MAINPAGE =
+
+#---------------------------------------------------------------------------
+# Configuration options related to source browsing
+#---------------------------------------------------------------------------
+
+# If the SOURCE_BROWSER tag is set to YES then a list of source files will be
+# generated. Documented entities will be cross-referenced with these sources.
+#
+# Note: To get rid of all source code in the generated output, make sure that
+# also VERBATIM_HEADERS is set to NO.
+# The default value is: NO.
+
+SOURCE_BROWSER = YES
+
+# Setting the INLINE_SOURCES tag to YES will include the body of functions,
+# classes and enums directly into the documentation.
+# The default value is: NO.
+
+INLINE_SOURCES = NO
+
+# Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any
+# special comment blocks from generated source code fragments. Normal C, C++ and
+# Fortran comments will always remain visible.
+# The default value is: YES.
+
+STRIP_CODE_COMMENTS = YES
+
+# If the REFERENCED_BY_RELATION tag is set to YES then for each documented
+# entity all documented functions referencing it will be listed.
+# The default value is: NO.
+
+REFERENCED_BY_RELATION = YES
+
+# If the REFERENCES_RELATION tag is set to YES then for each documented function
+# all documented entities called/used by that function will be listed.
+# The default value is: NO.
+
+REFERENCES_RELATION = YES
+
+# If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set
+# to YES then the hyperlinks from functions in REFERENCES_RELATION and
+# REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will
+# link to the documentation.
+# The default value is: YES.
+
+REFERENCES_LINK_SOURCE = YES
+
+# If SOURCE_TOOLTIPS is enabled (the default) then hovering a hyperlink in the
+# source code will show a tooltip with additional information such as prototype,
+# brief description and links to the definition and documentation. Since this
+# will make the HTML file larger and loading of large files a bit slower, you
+# can opt to disable this feature.
+# The default value is: YES.
+# This tag requires that the tag SOURCE_BROWSER is set to YES.
+
+SOURCE_TOOLTIPS = YES
+
+# If the USE_HTAGS tag is set to YES then the references to source code will
+# point to the HTML generated by the htags(1) tool instead of doxygen built-in
+# source browser. The htags tool is part of GNU's global source tagging system
+# (see https://www.gnu.org/software/global/global.html). You will need version
+# 4.8.6 or higher.
+#
+# To use it do the following:
+# - Install the latest version of global
+# - Enable SOURCE_BROWSER and USE_HTAGS in the configuration file
+# - Make sure the INPUT points to the root of the source tree
+# - Run doxygen as normal
+#
+# Doxygen will invoke htags (and that will in turn invoke gtags), so these
+# tools must be available from the command line (i.e. in the search path).
+#
+# The result: instead of the source browser generated by doxygen, the links to
+# source code will now point to the output of htags.
+# The default value is: NO.
+# This tag requires that the tag SOURCE_BROWSER is set to YES.
+
+USE_HTAGS = NO
+
+# If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a
+# verbatim copy of the header file for each class for which an include is
+# specified. Set to NO to disable this.
+# See also: Section \class.
+# The default value is: YES.
+
+VERBATIM_HEADERS = YES
+
+#---------------------------------------------------------------------------
+# Configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+
+# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index of all
+# compounds will be generated. Enable this if the project contains a lot of
+# classes, structs, unions or interfaces.
+# The default value is: YES.
+
+ALPHABETICAL_INDEX = YES
+
+# In case all classes in a project start with a common prefix, all classes will
+# be put under the same header in the alphabetical index. The IGNORE_PREFIX tag
+# can be used to specify a prefix (or a list of prefixes) that should be ignored
+# while generating the index headers.
+# This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
+
+IGNORE_PREFIX =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the HTML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_HTML tag is set to YES, doxygen will generate HTML output
+# The default value is: YES.
+
+GENERATE_HTML = YES
+
+# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: html.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_OUTPUT = html
+
+# The HTML_FILE_EXTENSION tag can be used to specify the file extension for each
+# generated HTML page (for example: .htm, .php, .asp).
+# The default value is: .html.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_FILE_EXTENSION = .html
+
+# The HTML_HEADER tag can be used to specify a user-defined HTML header file for
+# each generated HTML page. If the tag is left blank doxygen will generate a
+# standard header.
+#
+# To get valid HTML the header file that includes any scripts and style sheets
+# that doxygen needs, which is dependent on the configuration options used (e.g.
+# the setting GENERATE_TREEVIEW). It is highly recommended to start with a
+# default header using
+# doxygen -w html new_header.html new_footer.html new_stylesheet.css
+# YourConfigFile
+# and then modify the file new_header.html. See also section "Doxygen usage"
+# for information on how to generate the default header that doxygen normally
+# uses.
+# Note: The header is subject to change so you typically have to regenerate the
+# default header when upgrading to a newer version of doxygen. For a description
+# of the possible markers and block names see the documentation.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_HEADER =
+
+# The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each
+# generated HTML page. If the tag is left blank doxygen will generate a standard
+# footer. See HTML_HEADER for more information on how to generate a default
+# footer and what special commands can be used inside the footer. See also
+# section "Doxygen usage" for information on how to generate the default footer
+# that doxygen normally uses.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_FOOTER =
+
+# The HTML_STYLESHEET tag can be used to specify a user-defined cascading style
+# sheet that is used by each HTML page. It can be used to fine-tune the look of
+# the HTML output. If left blank doxygen will generate a default style sheet.
+# See also section "Doxygen usage" for information on how to generate the style
+# sheet that doxygen normally uses.
+# Note: It is recommended to use HTML_EXTRA_STYLESHEET instead of this tag, as
+# it is more robust and this tag (HTML_STYLESHEET) will in the future become
+# obsolete.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_STYLESHEET =
+
+# The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined
+# cascading style sheets that are included after the standard style sheets
+# created by doxygen. Using this option one can overrule certain style aspects.
+# This is preferred over using HTML_STYLESHEET since it does not replace the
+# standard style sheet and is therefore more robust against future updates.
+# Doxygen will copy the style sheet files to the output directory.
+# Note: The order of the extra style sheet files is of importance (e.g. the last
+# style sheet in the list overrules the setting of the previous ones in the
+# list). For an example see the documentation.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_EXTRA_STYLESHEET =
+
+# The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
+# other source files which should be copied to the HTML output directory. Note
+# that these files will be copied to the base HTML output directory. Use the
+# $relpath^ marker in the HTML_HEADER and/or HTML_FOOTER files to load these
+# files. In the HTML_STYLESHEET file, use the file name only. Also note that the
+# files will be copied as-is; there are no commands or markers available.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_EXTRA_FILES =
+
+# The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
+# will adjust the colors in the style sheet and background images according to
+# this color. Hue is specified as an angle on a color-wheel, see
+# https://en.wikipedia.org/wiki/Hue for more information. For instance the value
+# 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300
+# purple, and 360 is red again.
+# Minimum value: 0, maximum value: 359, default value: 220.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_COLORSTYLE_HUE = 220
+
+# The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors
+# in the HTML output. For a value of 0 the output will use gray-scales only. A
+# value of 255 will produce the most vivid colors.
+# Minimum value: 0, maximum value: 255, default value: 100.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_COLORSTYLE_SAT = 100
+
+# The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to the
+# luminance component of the colors in the HTML output. Values below 100
+# gradually make the output lighter, whereas values above 100 make the output
+# darker. The value divided by 100 is the actual gamma applied, so 80 represents
+# a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not
+# change the gamma.
+# Minimum value: 40, maximum value: 240, default value: 80.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_COLORSTYLE_GAMMA = 80
+
+# If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML
+# page will contain the date and time when the page was generated. Setting this
+# to YES can help to show when doxygen was last run and thus if the
+# documentation is up to date.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_TIMESTAMP = YES
+
+# If the HTML_DYNAMIC_MENUS tag is set to YES then the generated HTML
+# documentation will contain a main index with vertical navigation menus that
+# are dynamically created via JavaScript. If disabled, the navigation index will
+# consists of multiple levels of tabs that are statically embedded in every HTML
+# page. Disable this option to support browsers that do not have JavaScript,
+# like the Qt help browser.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_DYNAMIC_MENUS = YES
+
+# If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
+# documentation will contain sections that can be hidden and shown after the
+# page has loaded.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_DYNAMIC_SECTIONS = NO
+
+# With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries
+# shown in the various tree structured indices initially; the user can expand
+# and collapse entries dynamically later on. Doxygen will expand the tree to
+# such a level that at most the specified number of entries are visible (unless
+# a fully collapsed tree already exceeds this amount). So setting the number of
+# entries 1 will produce a full collapsed tree by default. 0 is a special value
+# representing an infinite number of entries and will result in a full expanded
+# tree by default.
+# Minimum value: 0, maximum value: 9999, default value: 100.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_INDEX_NUM_ENTRIES = 100
+
+# If the GENERATE_DOCSET tag is set to YES, additional index files will be
+# generated that can be used as input for Apple's Xcode 3 integrated development
+# environment (see:
+# https://developer.apple.com/xcode/), introduced with OSX 10.5 (Leopard). To
+# create a documentation set, doxygen will generate a Makefile in the HTML
+# output directory. Running make will produce the docset in that directory and
+# running make install will install the docset in
+# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at
+# startup. See https://developer.apple.com/library/archive/featuredarticles/Doxy
+# genXcode/_index.html for more information.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_DOCSET = NO
+
+# This tag determines the name of the docset feed. A documentation feed provides
+# an umbrella under which multiple documentation sets from a single provider
+# (such as a company or product suite) can be grouped.
+# The default value is: Doxygen generated docs.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_FEEDNAME = "Doxygen generated docs"
+
+# This tag determines the URL of the docset feed. A documentation feed provides
+# an umbrella under which multiple documentation sets from a single provider
+# (such as a company or product suite) can be grouped.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_FEEDURL =
+
+# This tag specifies a string that should uniquely identify the documentation
+# set bundle. This should be a reverse domain-name style string, e.g.
+# com.mycompany.MyDocSet. Doxygen will append .docset to the name.
+# The default value is: org.doxygen.Project.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_BUNDLE_ID = org.doxygen.Project
+
+# The DOCSET_PUBLISHER_ID tag specifies a string that should uniquely identify
+# the documentation publisher. This should be a reverse domain-name style
+# string, e.g. com.mycompany.MyDocSet.documentation.
+# The default value is: org.doxygen.Publisher.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_PUBLISHER_ID = org.doxygen.Publisher
+
+# The DOCSET_PUBLISHER_NAME tag identifies the documentation publisher.
+# The default value is: Publisher.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_PUBLISHER_NAME = Publisher
+
+# If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three
+# additional HTML index files: index.hhp, index.hhc, and index.hhk. The
+# index.hhp is a project file that can be read by Microsoft's HTML Help Workshop
+# on Windows. In the beginning of 2021 Microsoft took the original page, with
+# a.o. the download links, offline the HTML help workshop was already many years
+# in maintenance mode). You can download the HTML help workshop from the web
+# archives at Installation executable (see:
+# http://web.archive.org/web/20160201063255/http://download.microsoft.com/downlo
+# ad/0/A/9/0A939EF6-E31C-430F-A3DF-DFAE7960D564/htmlhelp.exe).
+#
+# The HTML Help Workshop contains a compiler that can convert all HTML output
+# generated by doxygen into a single compiled HTML file (.chm). Compiled HTML
+# files are now used as the Windows 98 help format, and will replace the old
+# Windows help format (.hlp) on all Windows platforms in the future. Compressed
+# HTML files also contain an index, a table of contents, and you can search for
+# words in the documentation. The HTML workshop also contains a viewer for
+# compressed HTML files.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_HTMLHELP = NO
+
+# The CHM_FILE tag can be used to specify the file name of the resulting .chm
+# file. You can add a path in front of the file if the result should not be
+# written to the html output directory.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+CHM_FILE =
+
+# The HHC_LOCATION tag can be used to specify the location (absolute path
+# including file name) of the HTML help compiler (hhc.exe). If non-empty,
+# doxygen will try to run the HTML help compiler on the generated index.hhp.
+# The file has to be specified with full path.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+HHC_LOCATION =
+
+# The GENERATE_CHI flag controls if a separate .chi index file is generated
+# (YES) or that it should be included in the main .chm file (NO).
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+GENERATE_CHI = NO
+
+# The CHM_INDEX_ENCODING is used to encode HtmlHelp index (hhk), content (hhc)
+# and project file content.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+CHM_INDEX_ENCODING =
+
+# The BINARY_TOC flag controls whether a binary table of contents is generated
+# (YES) or a normal table of contents (NO) in the .chm file. Furthermore it
+# enables the Previous and Next buttons.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+BINARY_TOC = NO
+
+# The TOC_EXPAND flag can be set to YES to add extra items for group members to
+# the table of contents of the HTML help documentation and to the tree view.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+TOC_EXPAND = NO
+
+# If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and
+# QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that
+# can be used as input for Qt's qhelpgenerator to generate a Qt Compressed Help
+# (.qch) of the generated HTML documentation.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_QHP = NO
+
+# If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify
+# the file name of the resulting .qch file. The path specified is relative to
+# the HTML output folder.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QCH_FILE =
+
+# The QHP_NAMESPACE tag specifies the namespace to use when generating Qt Help
+# Project output. For more information please see Qt Help Project / Namespace
+# (see:
+# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#namespace).
+# The default value is: org.doxygen.Project.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_NAMESPACE = org.doxygen.Project
+
+# The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating Qt
+# Help Project output. For more information please see Qt Help Project / Virtual
+# Folders (see:
+# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#virtual-folders).
+# The default value is: doc.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_VIRTUAL_FOLDER = doc
+
+# If the QHP_CUST_FILTER_NAME tag is set, it specifies the name of a custom
+# filter to add. For more information please see Qt Help Project / Custom
+# Filters (see:
+# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#custom-filters).
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_CUST_FILTER_NAME =
+
+# The QHP_CUST_FILTER_ATTRS tag specifies the list of the attributes of the
+# custom filter to add. For more information please see Qt Help Project / Custom
+# Filters (see:
+# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#custom-filters).
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_CUST_FILTER_ATTRS =
+
+# The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this
+# project's filter section matches. Qt Help Project / Filter Attributes (see:
+# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#filter-attributes).
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_SECT_FILTER_ATTRS =
+
+# The QHG_LOCATION tag can be used to specify the location (absolute path
+# including file name) of Qt's qhelpgenerator. If non-empty doxygen will try to
+# run qhelpgenerator on the generated .qhp file.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHG_LOCATION =
+
+# If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be
+# generated, together with the HTML files, they form an Eclipse help plugin. To
+# install this plugin and make it available under the help contents menu in
+# Eclipse, the contents of the directory containing the HTML and XML files needs
+# to be copied into the plugins directory of eclipse. The name of the directory
+# within the plugins directory should be the same as the ECLIPSE_DOC_ID value.
+# After copying Eclipse needs to be restarted before the help appears.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_ECLIPSEHELP = NO
+
+# A unique identifier for the Eclipse help plugin. When installing the plugin
+# the directory name containing the HTML and XML files should also have this
+# name. Each documentation set should have its own identifier.
+# The default value is: org.doxygen.Project.
+# This tag requires that the tag GENERATE_ECLIPSEHELP is set to YES.
+
+ECLIPSE_DOC_ID = org.doxygen.Project
+
+# If you want full control over the layout of the generated HTML pages it might
+# be necessary to disable the index and replace it with your own. The
+# DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top
+# of each HTML page. A value of NO enables the index and the value YES disables
+# it. Since the tabs in the index contain the same information as the navigation
+# tree, you can set this option to YES if you also set GENERATE_TREEVIEW to YES.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+DISABLE_INDEX = NO
+
+# The GENERATE_TREEVIEW tag is used to specify whether a tree-like index
+# structure should be generated to display hierarchical information. If the tag
+# value is set to YES, a side panel will be generated containing a tree-like
+# index structure (just like the one that is generated for HTML Help). For this
+# to work a browser that supports JavaScript, DHTML, CSS and frames is required
+# (i.e. any modern browser). Windows users are probably better off using the
+# HTML help feature. Via custom style sheets (see HTML_EXTRA_STYLESHEET) one can
+# further fine tune the look of the index (see "Fine-tuning the output"). As an
+# example, the default style sheet generated by doxygen has an example that
+# shows how to put an image at the root of the tree instead of the PROJECT_NAME.
+# Since the tree basically has the same information as the tab index, you could
+# consider setting DISABLE_INDEX to YES when enabling this option.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_TREEVIEW = NO
+
+# When both GENERATE_TREEVIEW and DISABLE_INDEX are set to YES, then the
+# FULL_SIDEBAR option determines if the side bar is limited to only the treeview
+# area (value NO) or if it should extend to the full height of the window (value
+# YES). Setting this to YES gives a layout similar to
+# https://docs.readthedocs.io with more room for contents, but less room for the
+# project logo, title, and description. If either GENERATE_TREEVIEW or
+# DISABLE_INDEX is set to NO, this option has no effect.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+FULL_SIDEBAR = NO
+
+# The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that
+# doxygen will group on one line in the generated HTML documentation.
+#
+# Note that a value of 0 will completely suppress the enum values from appearing
+# in the overview section.
+# Minimum value: 0, maximum value: 20, default value: 4.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+ENUM_VALUES_PER_LINE = 4
+
+# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be used
+# to set the initial width (in pixels) of the frame in which the tree is shown.
+# Minimum value: 0, maximum value: 1500, default value: 250.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+TREEVIEW_WIDTH = 250
+
+# If the EXT_LINKS_IN_WINDOW option is set to YES, doxygen will open links to
+# external symbols imported via tag files in a separate window.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+EXT_LINKS_IN_WINDOW = NO
+
+# If the OBFUSCATE_EMAILS tag is set to YES, doxygen will obfuscate email
+# addresses.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+OBFUSCATE_EMAILS = YES
+
+# If the HTML_FORMULA_FORMAT option is set to svg, doxygen will use the pdf2svg
+# tool (see https://github.com/dawbarton/pdf2svg) or inkscape (see
+# https://inkscape.org) to generate formulas as SVG images instead of PNGs for
+# the HTML output. These images will generally look nicer at scaled resolutions.
+# Possible values are: png (the default) and svg (looks nicer but requires the
+# pdf2svg or inkscape tool).
+# The default value is: png.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_FORMULA_FORMAT = png
+
+# Use this tag to change the font size of LaTeX formulas included as images in
+# the HTML documentation. When you change the font size after a successful
+# doxygen run you need to manually remove any form_*.png images from the HTML
+# output directory to force them to be regenerated.
+# Minimum value: 8, maximum value: 50, default value: 10.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+FORMULA_FONTSIZE = 10
+
+# Use the FORMULA_TRANSPARENT tag to determine whether or not the images
+# generated for formulas are transparent PNGs. Transparent PNGs are not
+# supported properly for IE 6.0, but are supported on all modern browsers.
+#
+# Note that when changing this option you need to delete any form_*.png files in
+# the HTML output directory before the changes have effect.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+FORMULA_TRANSPARENT = YES
+
+# The FORMULA_MACROFILE can contain LaTeX \newcommand and \renewcommand commands
+# to create new LaTeX commands to be used in formulas as building blocks. See
+# the section "Including formulas" for details.
+
+FORMULA_MACROFILE =
+
+# Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see
+# https://www.mathjax.org) which uses client side JavaScript for the rendering
+# instead of using pre-rendered bitmaps. Use this if you do not have LaTeX
+# installed or if you want to formulas look prettier in the HTML output. When
+# enabled you may also need to install MathJax separately and configure the path
+# to it using the MATHJAX_RELPATH option.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+USE_MATHJAX = NO
+
+# With MATHJAX_VERSION it is possible to specify the MathJax version to be used.
+# Note that the different versions of MathJax have different requirements with
+# regards to the different settings, so it is possible that also other MathJax
+# settings have to be changed when switching between the different MathJax
+# versions.
+# Possible values are: MathJax_2 and MathJax_3.
+# The default value is: MathJax_2.
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_VERSION = MathJax_2
+
+# When MathJax is enabled you can set the default output format to be used for
+# the MathJax output. For more details about the output format see MathJax
+# version 2 (see:
+# http://docs.mathjax.org/en/v2.7-latest/output.html) and MathJax version 3
+# (see:
+# http://docs.mathjax.org/en/latest/web/components/output.html).
+# Possible values are: HTML-CSS (which is slower, but has the best
+# compatibility. This is the name for Mathjax version 2, for MathJax version 3
+# this will be translated into chtml), NativeMML (i.e. MathML. Only supported
+# for NathJax 2. For MathJax version 3 chtml will be used instead.), chtml (This
+# is the name for Mathjax version 3, for MathJax version 2 this will be
+# translated into HTML-CSS) and SVG.
+# The default value is: HTML-CSS.
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_FORMAT = HTML-CSS
+
+# When MathJax is enabled you need to specify the location relative to the HTML
+# output directory using the MATHJAX_RELPATH option. The destination directory
+# should contain the MathJax.js script. For instance, if the mathjax directory
+# is located at the same level as the HTML output directory, then
+# MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax
+# Content Delivery Network so you can quickly see the result without installing
+# MathJax. However, it is strongly recommended to install a local copy of
+# MathJax from https://www.mathjax.org before deployment. The default value is:
+# - in case of MathJax version 2: https://cdn.jsdelivr.net/npm/mathjax@2
+# - in case of MathJax version 3: https://cdn.jsdelivr.net/npm/mathjax@3
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest
+
+# The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax
+# extension names that should be enabled during MathJax rendering. For example
+# for MathJax version 2 (see https://docs.mathjax.org/en/v2.7-latest/tex.html
+# #tex-and-latex-extensions):
+# MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols
+# For example for MathJax version 3 (see
+# http://docs.mathjax.org/en/latest/input/tex/extensions/index.html):
+# MATHJAX_EXTENSIONS = ams
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_EXTENSIONS =
+
+# The MATHJAX_CODEFILE tag can be used to specify a file with javascript pieces
+# of code that will be used on startup of the MathJax code. See the MathJax site
+# (see:
+# http://docs.mathjax.org/en/v2.7-latest/output.html) for more details. For an
+# example see the documentation.
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_CODEFILE =
+
+# When the SEARCHENGINE tag is enabled doxygen will generate a search box for
+# the HTML output. The underlying search engine uses javascript and DHTML and
+# should work on any modern browser. Note that when using HTML help
+# (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets (GENERATE_DOCSET)
+# there is already a search function so this one should typically be disabled.
+# For large projects the javascript based search engine can be slow, then
+# enabling SERVER_BASED_SEARCH may provide a better solution. It is possible to
+# search using the keyboard; to jump to the search box use <access key> + S
+# (what the <access key> is depends on the OS and browser, but it is typically
+# <CTRL>, <ALT>/<option>, or both). Inside the search box use the <cursor down
+# key> to jump into the search results window, the results can be navigated
+# using the <cursor keys>. Press <Enter> to select an item or <escape> to cancel
+# the search. The filter options can be selected when the cursor is inside the
+# search box by pressing <Shift>+<cursor down>. Also here use the <cursor keys>
+# to select a filter and <Enter> or <escape> to activate or cancel the filter
+# option.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+SEARCHENGINE = YES
+
+# When the SERVER_BASED_SEARCH tag is enabled the search engine will be
+# implemented using a web server instead of a web client using JavaScript. There
+# are two flavors of web server based searching depending on the EXTERNAL_SEARCH
+# setting. When disabled, doxygen will generate a PHP script for searching and
+# an index file used by the script. When EXTERNAL_SEARCH is enabled the indexing
+# and searching needs to be provided by external tools. See the section
+# "External Indexing and Searching" for details.
+# The default value is: NO.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+SERVER_BASED_SEARCH = NO
+
+# When EXTERNAL_SEARCH tag is enabled doxygen will no longer generate the PHP
+# script for searching. Instead the search results are written to an XML file
+# which needs to be processed by an external indexer. Doxygen will invoke an
+# external search engine pointed to by the SEARCHENGINE_URL option to obtain the
+# search results.
+#
+# Doxygen ships with an example indexer (doxyindexer) and search engine
+# (doxysearch.cgi) which are based on the open source search engine library
+# Xapian (see:
+# https://xapian.org/).
+#
+# See the section "External Indexing and Searching" for details.
+# The default value is: NO.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+EXTERNAL_SEARCH = NO
+
+# The SEARCHENGINE_URL should point to a search engine hosted by a web server
+# which will return the search results when EXTERNAL_SEARCH is enabled.
+#
+# Doxygen ships with an example indexer (doxyindexer) and search engine
+# (doxysearch.cgi) which are based on the open source search engine library
+# Xapian (see:
+# https://xapian.org/). See the section "External Indexing and Searching" for
+# details.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+SEARCHENGINE_URL =
+
+# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the unindexed
+# search data is written to a file for indexing by an external tool. With the
+# SEARCHDATA_FILE tag the name of this file can be specified.
+# The default file is: searchdata.xml.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+SEARCHDATA_FILE = searchdata.xml
+
+# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the
+# EXTERNAL_SEARCH_ID tag can be used as an identifier for the project. This is
+# useful in combination with EXTRA_SEARCH_MAPPINGS to search through multiple
+# projects and redirect the results back to the right project.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+EXTERNAL_SEARCH_ID =
+
+# The EXTRA_SEARCH_MAPPINGS tag can be used to enable searching through doxygen
+# projects other than the one defined by this configuration file, but that are
+# all added to the same external search index. Each project needs to have a
+# unique id set via EXTERNAL_SEARCH_ID. The search mapping then maps the id of
+# to a relative location where the documentation can be found. The format is:
+# EXTRA_SEARCH_MAPPINGS = tagname1=loc1 tagname2=loc2 ...
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+EXTRA_SEARCH_MAPPINGS =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output.
+# The default value is: YES.
+
+GENERATE_LATEX = NO
+
+# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: latex.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_OUTPUT = latex
+
+# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
+# invoked.
+#
+# Note that when not enabling USE_PDFLATEX the default is latex when enabling
+# USE_PDFLATEX the default is pdflatex and when in the later case latex is
+# chosen this is overwritten by pdflatex. For specific output languages the
+# default can have been set differently, this depends on the implementation of
+# the output language.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_CMD_NAME = latex
+
+# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to generate
+# index for LaTeX.
+# Note: This tag is used in the Makefile / make.bat.
+# See also: LATEX_MAKEINDEX_CMD for the part in the generated output file
+# (.tex).
+# The default file is: makeindex.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+MAKEINDEX_CMD_NAME = makeindex
+
+# The LATEX_MAKEINDEX_CMD tag can be used to specify the command name to
+# generate index for LaTeX. In case there is no backslash (\) as first character
+# it will be automatically added in the LaTeX code.
+# Note: This tag is used in the generated output file (.tex).
+# See also: MAKEINDEX_CMD_NAME for the part in the Makefile / make.bat.
+# The default value is: makeindex.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_MAKEINDEX_CMD = makeindex
+
+# If the COMPACT_LATEX tag is set to YES, doxygen generates more compact LaTeX
+# documents. This may be useful for small projects and may help to save some
+# trees in general.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+COMPACT_LATEX = NO
+
+# The PAPER_TYPE tag can be used to set the paper type that is used by the
+# printer.
+# Possible values are: a4 (210 x 297 mm), letter (8.5 x 11 inches), legal (8.5 x
+# 14 inches) and executive (7.25 x 10.5 inches).
+# The default value is: a4.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+PAPER_TYPE = a4
+
+# The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names
+# that should be included in the LaTeX output. The package can be specified just
+# by its name or with the correct syntax as to be used with the LaTeX
+# \usepackage command. To get the times font for instance you can specify :
+# EXTRA_PACKAGES=times or EXTRA_PACKAGES={times}
+# To use the option intlimits with the amsmath package you can specify:
+# EXTRA_PACKAGES=[intlimits]{amsmath}
+# If left blank no extra packages will be included.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+EXTRA_PACKAGES =
+
+# The LATEX_HEADER tag can be used to specify a user-defined LaTeX header for
+# the generated LaTeX document. The header should contain everything until the
+# first chapter. If it is left blank doxygen will generate a standard header. It
+# is highly recommended to start with a default header using
+# doxygen -w latex new_header.tex new_footer.tex new_stylesheet.sty
+# and then modify the file new_header.tex. See also section "Doxygen usage" for
+# information on how to generate the default header that doxygen normally uses.
+#
+# Note: Only use a user-defined header if you know what you are doing!
+# Note: The header is subject to change so you typically have to regenerate the
+# default header when upgrading to a newer version of doxygen. The following
+# commands have a special meaning inside the header (and footer): For a
+# description of the possible markers and block names see the documentation.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_HEADER =
+
+# The LATEX_FOOTER tag can be used to specify a user-defined LaTeX footer for
+# the generated LaTeX document. The footer should contain everything after the
+# last chapter. If it is left blank doxygen will generate a standard footer. See
+# LATEX_HEADER for more information on how to generate a default footer and what
+# special commands can be used inside the footer. See also section "Doxygen
+# usage" for information on how to generate the default footer that doxygen
+# normally uses. Note: Only use a user-defined footer if you know what you are
+# doing!
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_FOOTER =
+
+# The LATEX_EXTRA_STYLESHEET tag can be used to specify additional user-defined
+# LaTeX style sheets that are included after the standard style sheets created
+# by doxygen. Using this option one can overrule certain style aspects. Doxygen
+# will copy the style sheet files to the output directory.
+# Note: The order of the extra style sheet files is of importance (e.g. the last
+# style sheet in the list overrules the setting of the previous ones in the
+# list).
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_EXTRA_STYLESHEET =
+
+# The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or
+# other source files which should be copied to the LATEX_OUTPUT output
+# directory. Note that the files will be copied as-is; there are no commands or
+# markers available.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_EXTRA_FILES =
+
+# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated is
+# prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will
+# contain links (just like the HTML output) instead of page references. This
+# makes the output suitable for online browsing using a PDF viewer.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+PDF_HYPERLINKS = YES
+
+# If the USE_PDFLATEX tag is set to YES, doxygen will use the engine as
+# specified with LATEX_CMD_NAME to generate the PDF file directly from the LaTeX
+# files. Set this option to YES, to get a higher quality PDF documentation.
+#
+# See also section LATEX_CMD_NAME for selecting the engine.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+USE_PDFLATEX = NO
+
+# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode
+# command to the generated LaTeX files. This will instruct LaTeX to keep running
+# if errors occur, instead of asking the user for help.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_BATCHMODE = NO
+
+# If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the
+# index chapters (such as File Index, Compound Index, etc.) in the output.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_HIDE_INDICES = NO
+
+# The LATEX_BIB_STYLE tag can be used to specify the style to use for the
+# bibliography, e.g. plainnat, or ieeetr. See
+# https://en.wikipedia.org/wiki/BibTeX and \cite for more info.
+# The default value is: plain.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_BIB_STYLE = plain
+
+# If the LATEX_TIMESTAMP tag is set to YES then the footer of each generated
+# page will contain the date and time when the page was generated. Setting this
+# to NO can help when comparing the output of multiple runs.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_TIMESTAMP = NO
+
+# The LATEX_EMOJI_DIRECTORY tag is used to specify the (relative or absolute)
+# path from which the emoji images will be read. If a relative path is entered,
+# it will be relative to the LATEX_OUTPUT directory. If left blank the
+# LATEX_OUTPUT directory will be used.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_EMOJI_DIRECTORY =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the RTF output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_RTF tag is set to YES, doxygen will generate RTF output. The
+# RTF output is optimized for Word 97 and may not look too pretty with other RTF
+# readers/editors.
+# The default value is: NO.
+
+GENERATE_RTF = NO
+
+# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: rtf.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_OUTPUT = rtf
+
+# If the COMPACT_RTF tag is set to YES, doxygen generates more compact RTF
+# documents. This may be useful for small projects and may help to save some
+# trees in general.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+COMPACT_RTF = NO
+
+# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated will
+# contain hyperlink fields. The RTF file will contain links (just like the HTML
+# output) instead of page references. This makes the output suitable for online
+# browsing using Word or some other Word compatible readers that support those
+# fields.
+#
+# Note: WordPad (write) and others do not support links.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_HYPERLINKS = NO
+
+# Load stylesheet definitions from file. Syntax is similar to doxygen's
+# configuration file, i.e. a series of assignments. You only have to provide
+# replacements, missing definitions are set to their default value.
+#
+# See also section "Doxygen usage" for information on how to generate the
+# default style sheet that doxygen normally uses.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_STYLESHEET_FILE =
+
+# Set optional variables used in the generation of an RTF document. Syntax is
+# similar to doxygen's configuration file. A template extensions file can be
+# generated using doxygen -e rtf extensionFile.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_EXTENSIONS_FILE =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the man page output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_MAN tag is set to YES, doxygen will generate man pages for
+# classes and files.
+# The default value is: NO.
+
+GENERATE_MAN = NO
+
+# The MAN_OUTPUT tag is used to specify where the man pages will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it. A directory man3 will be created inside the directory specified by
+# MAN_OUTPUT.
+# The default directory is: man.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_OUTPUT = man
+
+# The MAN_EXTENSION tag determines the extension that is added to the generated
+# man pages. In case the manual section does not start with a number, the number
+# 3 is prepended. The dot (.) at the beginning of the MAN_EXTENSION tag is
+# optional.
+# The default value is: .3.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_EXTENSION = .3
+
+# The MAN_SUBDIR tag determines the name of the directory created within
+# MAN_OUTPUT in which the man pages are placed. If defaults to man followed by
+# MAN_EXTENSION with the initial . removed.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_SUBDIR =
+
+# If the MAN_LINKS tag is set to YES and doxygen generates man output, then it
+# will generate one additional man file for each entity documented in the real
+# man page(s). These additional files only source the real man page, but without
+# them the man command would be unable to find the correct page.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_LINKS = NO
+
+#---------------------------------------------------------------------------
+# Configuration options related to the XML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_XML tag is set to YES, doxygen will generate an XML file that
+# captures the structure of the code including all documentation.
+# The default value is: NO.
+
+GENERATE_XML = NO
+
+# The XML_OUTPUT tag is used to specify where the XML pages will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: xml.
+# This tag requires that the tag GENERATE_XML is set to YES.
+
+XML_OUTPUT = xml
+
+# If the XML_PROGRAMLISTING tag is set to YES, doxygen will dump the program
+# listings (including syntax highlighting and cross-referencing information) to
+# the XML output. Note that enabling this will significantly increase the size
+# of the XML output.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_XML is set to YES.
+
+XML_PROGRAMLISTING = YES
+
+# If the XML_NS_MEMB_FILE_SCOPE tag is set to YES, doxygen will include
+# namespace members in file scope as well, matching the HTML output.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_XML is set to YES.
+
+XML_NS_MEMB_FILE_SCOPE = NO
+
+#---------------------------------------------------------------------------
+# Configuration options related to the DOCBOOK output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_DOCBOOK tag is set to YES, doxygen will generate Docbook files
+# that can be used to generate PDF.
+# The default value is: NO.
+
+GENERATE_DOCBOOK = NO
+
+# The DOCBOOK_OUTPUT tag is used to specify where the Docbook pages will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be put in
+# front of it.
+# The default directory is: docbook.
+# This tag requires that the tag GENERATE_DOCBOOK is set to YES.
+
+DOCBOOK_OUTPUT = docbook
+
+#---------------------------------------------------------------------------
+# Configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_AUTOGEN_DEF tag is set to YES, doxygen will generate an
+# AutoGen Definitions (see http://autogen.sourceforge.net/) file that captures
+# the structure of the code including all documentation. Note that this feature
+# is still experimental and incomplete at the moment.
+# The default value is: NO.
+
+GENERATE_AUTOGEN_DEF = NO
+
+#---------------------------------------------------------------------------
+# Configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_PERLMOD tag is set to YES, doxygen will generate a Perl module
+# file that captures the structure of the code including all documentation.
+#
+# Note that this feature is still experimental and incomplete at the moment.
+# The default value is: NO.
+
+GENERATE_PERLMOD = NO
+
+# If the PERLMOD_LATEX tag is set to YES, doxygen will generate the necessary
+# Makefile rules, Perl scripts and LaTeX code to be able to generate PDF and DVI
+# output from the Perl module output.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_PERLMOD is set to YES.
+
+PERLMOD_LATEX = NO
+
+# If the PERLMOD_PRETTY tag is set to YES, the Perl module output will be nicely
+# formatted so it can be parsed by a human reader. This is useful if you want to
+# understand what is going on. On the other hand, if this tag is set to NO, the
+# size of the Perl module output will be much smaller and Perl will parse it
+# just the same.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_PERLMOD is set to YES.
+
+PERLMOD_PRETTY = YES
+
+# The names of the make variables in the generated doxyrules.make file are
+# prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. This is useful
+# so different doxyrules.make files included by the same Makefile don't
+# overwrite each other's variables.
+# This tag requires that the tag GENERATE_PERLMOD is set to YES.
+
+PERLMOD_MAKEVAR_PREFIX =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor
+#---------------------------------------------------------------------------
+
+# If the ENABLE_PREPROCESSING tag is set to YES, doxygen will evaluate all
+# C-preprocessor directives found in the sources and include files.
+# The default value is: YES.
+
+ENABLE_PREPROCESSING = YES
+
+# If the MACRO_EXPANSION tag is set to YES, doxygen will expand all macro names
+# in the source code. If set to NO, only conditional compilation will be
+# performed. Macro expansion can be done in a controlled way by setting
+# EXPAND_ONLY_PREDEF to YES.
+# The default value is: NO.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+MACRO_EXPANSION = NO
+
+# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then
+# the macro expansion is limited to the macros specified with the PREDEFINED and
+# EXPAND_AS_DEFINED tags.
+# The default value is: NO.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+EXPAND_ONLY_PREDEF = NO
+
+# If the SEARCH_INCLUDES tag is set to YES, the include files in the
+# INCLUDE_PATH will be searched if a #include is found.
+# The default value is: YES.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+SEARCH_INCLUDES = YES
+
+# The INCLUDE_PATH tag can be used to specify one or more directories that
+# contain include files that are not input files but should be processed by the
+# preprocessor.
+# This tag requires that the tag SEARCH_INCLUDES is set to YES.
+
+INCLUDE_PATH =
+
+# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
+# patterns (like *.h and *.hpp) to filter out the header-files in the
+# directories. If left blank, the patterns specified with FILE_PATTERNS will be
+# used.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+INCLUDE_FILE_PATTERNS =
+
+# The PREDEFINED tag can be used to specify one or more macro names that are
+# defined before the preprocessor is started (similar to the -D option of e.g.
+# gcc). The argument of the tag is a list of macros of the form: name or
+# name=definition (no spaces). If the definition and the "=" are omitted, "=1"
+# is assumed. To prevent a macro definition from being undefined via #undef or
+# recursively expanded use the := operator instead of the = operator.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+PREDEFINED = _USE_MPI=1
+
+# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
+# tag can be used to specify a list of macro names that should be expanded. The
+# macro definition that is found in the sources will be used. Use the PREDEFINED
+# tag if you want to use a different macro definition that overrules the
+# definition found in the source code.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+EXPAND_AS_DEFINED =
+
+# If the SKIP_FUNCTION_MACROS tag is set to YES then doxygen's preprocessor will
+# remove all references to function-like macros that are alone on a line, have
+# an all uppercase name, and do not end with a semicolon. Such function macros
+# are typically used for boiler-plate code, and will confuse the parser if not
+# removed.
+# The default value is: YES.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+SKIP_FUNCTION_MACROS = YES
+
+#---------------------------------------------------------------------------
+# Configuration options related to external references
+#---------------------------------------------------------------------------
+
+# The TAGFILES tag can be used to specify one or more tag files. For each tag
+# file the location of the external documentation should be added. The format of
+# a tag file without this location is as follows:
+# TAGFILES = file1 file2 ...
+# Adding location for the tag files is done as follows:
+# TAGFILES = file1=loc1 "file2 = loc2" ...
+# where loc1 and loc2 can be relative or absolute paths or URLs. See the
+# section "Linking to external documentation" for more information about the use
+# of tag files.
+# Note: Each tag file must have a unique name (where the name does NOT include
+# the path). If a tag file is not located in the directory in which doxygen is
+# run, you must also specify the path to the tagfile here.
+
+TAGFILES =
+
+# When a file name is specified after GENERATE_TAGFILE, doxygen will create a
+# tag file that is based on the input files it reads. See section "Linking to
+# external documentation" for more information about the usage of tag files.
+
+GENERATE_TAGFILE =
+
+# If the ALLEXTERNALS tag is set to YES, all external class will be listed in
+# the class index. If set to NO, only the inherited external classes will be
+# listed.
+# The default value is: NO.
+
+ALLEXTERNALS = NO
+
+# If the EXTERNAL_GROUPS tag is set to YES, all external groups will be listed
+# in the modules index. If set to NO, only the current project's groups will be
+# listed.
+# The default value is: YES.
+
+EXTERNAL_GROUPS = YES
+
+# If the EXTERNAL_PAGES tag is set to YES, all external pages will be listed in
+# the related pages index. If set to NO, only the current project's pages will
+# be listed.
+# The default value is: YES.
+
+EXTERNAL_PAGES = YES
+
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool
+#---------------------------------------------------------------------------
+
+# You can include diagrams made with dia in doxygen documentation. Doxygen will
+# then run dia to produce the diagram and insert it in the documentation. The
+# DIA_PATH tag allows you to specify the directory where the dia binary resides.
+# If left empty dia is assumed to be found in the default search path.
+
+DIA_PATH =
+
+# If set to YES the inheritance and collaboration graphs will hide inheritance
+# and usage relations if the target is undocumented or is not a class.
+# The default value is: YES.
+
+HIDE_UNDOC_RELATIONS = NO
+
+# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
+# available from the path. This tool is part of Graphviz (see:
+# http://www.graphviz.org/), a graph visualization toolkit from AT&T and Lucent
+# Bell Labs. The other options in this section have no effect if this option is
+# set to NO
+# The default value is: NO.
+
+HAVE_DOT = YES
+
+# The DOT_NUM_THREADS specifies the number of dot invocations doxygen is allowed
+# to run in parallel. When set to 0 doxygen will base this on the number of
+# processors available in the system. You can set it explicitly to a value
+# larger than 0 to get control over the balance between CPU load and processing
+# speed.
+# Minimum value: 0, maximum value: 32, default value: 0.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_NUM_THREADS = 0
+
+# When you want a differently looking font in the dot files that doxygen
+# generates you can specify the font name using DOT_FONTNAME. You need to make
+# sure dot is able to find the font, which can be done by putting it in a
+# standard location or by setting the DOTFONTPATH environment variable or by
+# setting DOT_FONTPATH to the directory containing the font.
+# The default value is: Helvetica.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_FONTNAME = Helvetica
+
+# The DOT_FONTSIZE tag can be used to set the size (in points) of the font of
+# dot graphs.
+# Minimum value: 4, maximum value: 24, default value: 10.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_FONTSIZE = 10
+
+# By default doxygen will tell dot to use the default font as specified with
+# DOT_FONTNAME. If you specify a different font using DOT_FONTNAME you can set
+# the path where dot can find it using this tag.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_FONTPATH =
+
+# If the CLASS_GRAPH tag is set to YES (or GRAPH) then doxygen will generate a
+# graph for each documented class showing the direct and indirect inheritance
+# relations. In case HAVE_DOT is set as well dot will be used to draw the graph,
+# otherwise the built-in generator will be used. If the CLASS_GRAPH tag is set
+# to TEXT the direct and indirect inheritance relations will be shown as texts /
+# links.
+# Possible values are: NO, YES, TEXT and GRAPH.
+# The default value is: YES.
+
+CLASS_GRAPH = YES
+
+# If the COLLABORATION_GRAPH tag is set to YES then doxygen will generate a
+# graph for each documented class showing the direct and indirect implementation
+# dependencies (inheritance, containment, and class references variables) of the
+# class with other documented classes.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+COLLABORATION_GRAPH = YES
+
+# If the GROUP_GRAPHS tag is set to YES then doxygen will generate a graph for
+# groups, showing the direct groups dependencies.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+GROUP_GRAPHS = YES
+
+# If the UML_LOOK tag is set to YES, doxygen will generate inheritance and
+# collaboration diagrams in a style similar to the OMG's Unified Modeling
+# Language.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+UML_LOOK = NO
+
+# If the UML_LOOK tag is enabled, the fields and methods are shown inside the
+# class node. If there are many fields or methods and many nodes the graph may
+# become too big to be useful. The UML_LIMIT_NUM_FIELDS threshold limits the
+# number of items for each type to make the size more manageable. Set this to 0
+# for no limit. Note that the threshold may be exceeded by 50% before the limit
+# is enforced. So when you set the threshold to 10, up to 15 fields may appear,
+# but if the number exceeds 15, the total amount of fields shown is limited to
+# 10.
+# Minimum value: 0, maximum value: 100, default value: 10.
+# This tag requires that the tag UML_LOOK is set to YES.
+
+UML_LIMIT_NUM_FIELDS = 10
+
+# If the DOT_UML_DETAILS tag is set to NO, doxygen will show attributes and
+# methods without types and arguments in the UML graphs. If the DOT_UML_DETAILS
+# tag is set to YES, doxygen will add type and arguments for attributes and
+# methods in the UML graphs. If the DOT_UML_DETAILS tag is set to NONE, doxygen
+# will not generate fields with class member information in the UML graphs. The
+# class diagrams will look similar to the default class diagrams but using UML
+# notation for the relationships.
+# Possible values are: NO, YES and NONE.
+# The default value is: NO.
+# This tag requires that the tag UML_LOOK is set to YES.
+
+DOT_UML_DETAILS = NO
+
+# The DOT_WRAP_THRESHOLD tag can be used to set the maximum number of characters
+# to display on a single line. If the actual line length exceeds this threshold
+# significantly it will wrapped across multiple lines. Some heuristics are apply
+# to avoid ugly line breaks.
+# Minimum value: 0, maximum value: 1000, default value: 17.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_WRAP_THRESHOLD = 17
+
+# If the TEMPLATE_RELATIONS tag is set to YES then the inheritance and
+# collaboration graphs will show the relations between templates and their
+# instances.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+TEMPLATE_RELATIONS = NO
+
+# If the INCLUDE_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are set to
+# YES then doxygen will generate a graph for each documented file showing the
+# direct and indirect include dependencies of the file with other documented
+# files.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+INCLUDE_GRAPH = YES
+
+# If the INCLUDED_BY_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are
+# set to YES then doxygen will generate a graph for each documented file showing
+# the direct and indirect include dependencies of the file with other documented
+# files.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+INCLUDED_BY_GRAPH = YES
+
+# If the CALL_GRAPH tag is set to YES then doxygen will generate a call
+# dependency graph for every global function or class method.
+#
+# Note that enabling this option will significantly increase the time of a run.
+# So in most cases it will be better to enable call graphs for selected
+# functions only using the \callgraph command. Disabling a call graph can be
+# accomplished by means of the command \hidecallgraph.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+CALL_GRAPH = NO
+
+# If the CALLER_GRAPH tag is set to YES then doxygen will generate a caller
+# dependency graph for every global function or class method.
+#
+# Note that enabling this option will significantly increase the time of a run.
+# So in most cases it will be better to enable caller graphs for selected
+# functions only using the \callergraph command. Disabling a caller graph can be
+# accomplished by means of the command \hidecallergraph.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+CALLER_GRAPH = NO
+
+# If the GRAPHICAL_HIERARCHY tag is set to YES then doxygen will graphical
+# hierarchy of all classes instead of a textual one.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+GRAPHICAL_HIERARCHY = YES
+
+# If the DIRECTORY_GRAPH tag is set to YES then doxygen will show the
+# dependencies a directory has on other directories in a graphical way. The
+# dependency relations are determined by the #include relations between the
+# files in the directories.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DIRECTORY_GRAPH = NO
+
+# The DIR_GRAPH_MAX_DEPTH tag can be used to limit the maximum number of levels
+# of child directories generated in directory dependency graphs by dot.
+# Minimum value: 1, maximum value: 25, default value: 1.
+# This tag requires that the tag DIRECTORY_GRAPH is set to YES.
+
+DIR_GRAPH_MAX_DEPTH = 1
+
+# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
+# generated by dot. For an explanation of the image formats see the section
+# output formats in the documentation of the dot tool (Graphviz (see:
+# http://www.graphviz.org/)).
+# Note: If you choose svg you need to set HTML_FILE_EXTENSION to xhtml in order
+# to make the SVG files visible in IE 9+ (other browsers do not have this
+# requirement).
+# Possible values are: png, jpg, gif, svg, png:gd, png:gd:gd, png:cairo,
+# png:cairo:gd, png:cairo:cairo, png:cairo:gdiplus, png:gdiplus and
+# png:gdiplus:gdiplus.
+# The default value is: png.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_IMAGE_FORMAT = png
+
+# If DOT_IMAGE_FORMAT is set to svg, then this option can be set to YES to
+# enable generation of interactive SVG images that allow zooming and panning.
+#
+# Note that this requires a modern browser other than Internet Explorer. Tested
+# and working are Firefox, Chrome, Safari, and Opera.
+# Note: For IE 9+ you need to set HTML_FILE_EXTENSION to xhtml in order to make
+# the SVG files visible. Older versions of IE do not have SVG support.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+INTERACTIVE_SVG = NO
+
+# The DOT_PATH tag can be used to specify the path where the dot tool can be
+# found. If left blank, it is assumed the dot tool can be found in the path.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_PATH =
+
+# The DOTFILE_DIRS tag can be used to specify one or more directories that
+# contain dot files that are included in the documentation (see the \dotfile
+# command).
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOTFILE_DIRS =
+
+# The MSCFILE_DIRS tag can be used to specify one or more directories that
+# contain msc files that are included in the documentation (see the \mscfile
+# command).
+
+MSCFILE_DIRS =
+
+# The DIAFILE_DIRS tag can be used to specify one or more directories that
+# contain dia files that are included in the documentation (see the \diafile
+# command).
+
+DIAFILE_DIRS =
+
+# When using plantuml, the PLANTUML_JAR_PATH tag should be used to specify the
+# path where java can find the plantuml.jar file or to the filename of jar file
+# to be used. If left blank, it is assumed PlantUML is not used or called during
+# a preprocessing step. Doxygen will generate a warning when it encounters a
+# \startuml command in this case and will not generate output for the diagram.
+
+PLANTUML_JAR_PATH =
+
+# When using plantuml, the PLANTUML_CFG_FILE tag can be used to specify a
+# configuration file for plantuml.
+
+PLANTUML_CFG_FILE =
+
+# When using plantuml, the specified paths are searched for files specified by
+# the !include statement in a plantuml block.
+
+PLANTUML_INCLUDE_PATH =
+
+# The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of nodes
+# that will be shown in the graph. If the number of nodes in a graph becomes
+# larger than this value, doxygen will truncate the graph, which is visualized
+# by representing a node as a red box. Note that doxygen if the number of direct
+# children of the root node in a graph is already larger than
+# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note that
+# the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.
+# Minimum value: 0, maximum value: 10000, default value: 50.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_GRAPH_MAX_NODES = 20
+
+# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the graphs
+# generated by dot. A depth value of 3 means that only nodes reachable from the
+# root by following a path via at most 3 edges will be shown. Nodes that lay
+# further from the root node will be omitted. Note that setting this option to 1
+# or 2 may greatly reduce the computation time needed for large code bases. Also
+# note that the size of a graph can be further restricted by
+# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction.
+# Minimum value: 0, maximum value: 1000, default value: 0.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+MAX_DOT_GRAPH_DEPTH = 2
+
+# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent
+# background. This is disabled by default, because dot on Windows does not seem
+# to support this out of the box.
+#
+# Warning: Depending on the platform used, enabling this option may lead to
+# badly anti-aliased labels on the edges of a graph (i.e. they become hard to
+# read).
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_TRANSPARENT = YES
+
+# Set the DOT_MULTI_TARGETS tag to YES to allow dot to generate multiple output
+# files in one run (i.e. multiple -o and -T options on the command line). This
+# makes dot run faster, but since only newer versions of dot (>1.8.10) support
+# this, this feature is disabled by default.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_MULTI_TARGETS = YES
+
+# If the GENERATE_LEGEND tag is set to YES doxygen will generate a legend page
+# explaining the meaning of the various boxes and arrows in the dot generated
+# graphs.
+# Note: This tag requires that UML_LOOK isn't set, i.e. the doxygen internal
+# graphical representation for inheritance and collaboration diagrams is used.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+GENERATE_LEGEND = YES
+
+# If the DOT_CLEANUP tag is set to YES, doxygen will remove the intermediate
+# files that are used to generate the various graphs.
+#
+# Note: This setting is not only used for dot files but also for msc temporary
+# files.
+# The default value is: YES.
+
+DOT_CLEANUP = YES
diff --git a/doc/doxygen.conf.bak b/doc/doxygen.conf.bak
new file mode 100644
index 000000000..852fb79d2
--- /dev/null
+++ b/doc/doxygen.conf.bak
@@ -0,0 +1,2364 @@
+# Doxyfile 1.8.8
+
+# This file describes the settings to be used by the documentation system
+# doxygen (www.doxygen.org) for a project.
+#
+# All text after a double hash (##) is considered a comment and is placed in
+# front of the TAG it is preceding.
+#
+# All text after a single hash (#) is considered a comment and will be ignored.
+# The format is:
+# TAG = value [value, ...]
+# For lists, items can also be appended using:
+# TAG += value [value, ...]
+# Values that contain spaces should be placed between quotes (\" \").
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+
+# This tag specifies the encoding used for all characters in the config file
+# that follow. The default is UTF-8 which is also the encoding used for all text
+# before the first occurrence of this tag. Doxygen uses libiconv (or the iconv
+# built into libc) for the transcoding. See http://www.gnu.org/software/libiconv
+# for the list of possible encodings.
+# The default value is: UTF-8.
+
+DOXYFILE_ENCODING = UTF-8
+
+# The PROJECT_NAME tag is a single word (or a sequence of words surrounded by
+# double-quotes, unless you are using Doxywizard) that should identify the
+# project for which the documentation is generated. This name is used in the
+# title of most generated pages and in a few other places.
+# The default value is: My Project.
+
+PROJECT_NAME = "WOLF"
+
+# The PROJECT_NUMBER tag can be used to enter a project or revision number. This
+# could be handy for archiving the generated documentation or if some version
+# control system is used.
+
+PROJECT_NUMBER =
+
+# Using the PROJECT_BRIEF tag one can provide an optional one line description
+# for a project that appears at the top of each page and should give viewer a
+# quick idea about the purpose of the project. Keep the description short.
+
+PROJECT_BRIEF =
+# "A lion and a tiger might be stronger, but a wolf does not perform in circus"
+# Windowed Localization Frames
+
+# With the PROJECT_LOGO tag one can specify an logo or icon that is included in
+# the documentation. The maximum height of the logo should not exceed 55 pixels
+# and the maximum width should not exceed 200 pixels. Doxygen will copy the logo
+# to the output directory.
+
+PROJECT_LOGO = ../doc/images/wolf-120.png
+
+# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path
+# into which the generated documentation will be written. If a relative path is
+# entered, it will be relative to the location where doxygen was started. If
+# left blank the current directory will be used.
+
+OUTPUT_DIRECTORY = ../doc
+
+# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create 4096 sub-
+# directories (in 2 levels) under the output directory of each output format and
+# will distribute the generated files over these directories. Enabling this
+# option can be useful when feeding doxygen a huge amount of source files, where
+# putting all generated files in the same directory would otherwise causes
+# performance problems for the file system.
+# The default value is: NO.
+
+CREATE_SUBDIRS = NO
+
+# If the ALLOW_UNICODE_NAMES tag is set to YES, doxygen will allow non-ASCII
+# characters to appear in the names of generated files. If set to NO, non-ASCII
+# characters will be escaped, for example _xE3_x81_x84 will be used for Unicode
+# U+3044.
+# The default value is: NO.
+
+ALLOW_UNICODE_NAMES = NO
+
+# The OUTPUT_LANGUAGE tag is used to specify the language in which all
+# documentation generated by doxygen is written. Doxygen will use this
+# information to generate all constant output in the proper language.
+# Possible values are: Afrikaans, Arabic, Armenian, Brazilian, Catalan, Chinese,
+# Chinese-Traditional, Croatian, Czech, Danish, Dutch, English (United States),
+# Esperanto, Farsi (Persian), Finnish, French, German, Greek, Hungarian,
+# Indonesian, Italian, Japanese, Japanese-en (Japanese with English messages),
+# Korean, Korean-en (Korean with English messages), Latvian, Lithuanian,
+# Macedonian, Norwegian, Persian (Farsi), Polish, Portuguese, Romanian, Russian,
+# Serbian, Serbian-Cyrillic, Slovak, Slovene, Spanish, Swedish, Turkish,
+# Ukrainian and Vietnamese.
+# The default value is: English.
+
+OUTPUT_LANGUAGE = English
+
+# If the BRIEF_MEMBER_DESC tag is set to YES doxygen will include brief member
+# descriptions after the members that are listed in the file and class
+# documentation (similar to Javadoc). Set to NO to disable this.
+# The default value is: YES.
+
+BRIEF_MEMBER_DESC = YES
+
+# If the REPEAT_BRIEF tag is set to YES doxygen will prepend the brief
+# description of a member or function before the detailed description
+#
+# Note: If both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
+# brief descriptions will be completely suppressed.
+# The default value is: YES.
+
+REPEAT_BRIEF = YES
+
+# This tag implements a quasi-intelligent brief description abbreviator that is
+# used to form the text in various listings. Each string in this list, if found
+# as the leading text of the brief description, will be stripped from the text
+# and the result, after processing the whole list, is used as the annotated
+# text. Otherwise, the brief description is used as-is. If left blank, the
+# following values are used ($name is automatically replaced with the name of
+# the entity):The $name class, The $name widget, The $name file, is, provides,
+# specifies, contains, represents, a, an and the.
+
+ABBREVIATE_BRIEF =
+
+# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
+# doxygen will generate a detailed section even if there is only a brief
+# description.
+# The default value is: NO.
+
+ALWAYS_DETAILED_SEC = NO
+
+# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
+# inherited members of a class in the documentation of that class as if those
+# members were ordinary class members. Constructors, destructors and assignment
+# operators of the base classes will not be shown.
+# The default value is: NO.
+
+INLINE_INHERITED_MEMB = NO
+
+# If the FULL_PATH_NAMES tag is set to YES doxygen will prepend the full path
+# before files name in the file list and in the header files. If set to NO the
+# shortest path that makes the file name unique will be used
+# The default value is: YES.
+
+FULL_PATH_NAMES = NO
+
+# The STRIP_FROM_PATH tag can be used to strip a user-defined part of the path.
+# Stripping is only done if one of the specified strings matches the left-hand
+# part of the path. The tag can be used to show relative paths in the file list.
+# If left blank the directory from which doxygen is run is used as the path to
+# strip.
+#
+# Note that you can specify absolute paths here, but also relative paths, which
+# will be relative from the directory where doxygen is started.
+# This tag requires that the tag FULL_PATH_NAMES is set to YES.
+
+STRIP_FROM_PATH =
+
+# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of the
+# path mentioned in the documentation of a class, which tells the reader which
+# header file to include in order to use a class. If left blank only the name of
+# the header file containing the class definition is used. Otherwise one should
+# specify the list of include paths that are normally passed to the compiler
+# using the -I flag.
+
+STRIP_FROM_INC_PATH =
+
+# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but
+# less readable) file names. This can be useful is your file systems doesn't
+# support long names like on DOS, Mac, or CD-ROM.
+# The default value is: NO.
+
+SHORT_NAMES = NO
+
+# If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret the
+# first line (until the first dot) of a Javadoc-style comment as the brief
+# description. If set to NO, the Javadoc-style will behave just like regular Qt-
+# style comments (thus requiring an explicit @brief command for a brief
+# description.)
+# The default value is: NO.
+
+JAVADOC_AUTOBRIEF = NO
+
+# If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first
+# line (until the first dot) of a Qt-style comment as the brief description. If
+# set to NO, the Qt-style will behave just like regular Qt-style comments (thus
+# requiring an explicit \brief command for a brief description.)
+# The default value is: NO.
+
+QT_AUTOBRIEF = NO
+
+# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make doxygen treat a
+# multi-line C++ special comment block (i.e. a block of //! or /// comments) as
+# a brief description. This used to be the default behavior. The new default is
+# to treat a multi-line C++ comment block as a detailed description. Set this
+# tag to YES if you prefer the old behavior instead.
+#
+# Note that setting this tag to YES also means that rational rose comments are
+# not recognized any more.
+# The default value is: NO.
+
+MULTILINE_CPP_IS_BRIEF = NO
+
+# If the INHERIT_DOCS tag is set to YES then an undocumented member inherits the
+# documentation from any documented member that it re-implements.
+# The default value is: YES.
+
+INHERIT_DOCS = YES
+
+# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce a
+# new page for each member. If set to NO, the documentation of a member will be
+# part of the file/class/namespace that contains it.
+# The default value is: NO.
+
+SEPARATE_MEMBER_PAGES = NO
+
+# The TAB_SIZE tag can be used to set the number of spaces in a tab. Doxygen
+# uses this value to replace tabs by spaces in code fragments.
+# Minimum value: 1, maximum value: 16, default value: 4.
+
+TAB_SIZE = 4
+
+# This tag can be used to specify a number of aliases that act as commands in
+# the documentation. An alias has the form:
+# name=value
+# For example adding
+# "sideeffect=@par Side Effects:\n"
+# will allow you to put the command \sideeffect (or @sideeffect) in the
+# documentation, which will result in a user-defined paragraph with heading
+# "Side Effects:". You can put \n's in the value part of an alias to insert
+# newlines.
+
+ALIASES =
+
+# This tag can be used to specify a number of word-keyword mappings (TCL only).
+# A mapping has the form "name=value". For example adding "class=itcl::class"
+# will allow you to use the command class in the itcl::class meaning.
+
+TCL_SUBST =
+
+# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources
+# only. Doxygen will then generate output that is more tailored for C. For
+# instance, some of the names that are used will be different. The list of all
+# members will be omitted, etc.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_FOR_C = NO
+
+# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java or
+# Python sources only. Doxygen will then generate output that is more tailored
+# for that language. For instance, namespaces will be presented as packages,
+# qualified scopes will look different, etc.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_JAVA = NO
+
+# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran
+# sources. Doxygen will then generate output that is tailored for Fortran.
+# The default value is: NO.
+
+OPTIMIZE_FOR_FORTRAN = NO
+
+# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL
+# sources. Doxygen will then generate output that is tailored for VHDL.
+# The default value is: NO.
+
+OPTIMIZE_OUTPUT_VHDL = NO
+
+# Doxygen selects the parser to use depending on the extension of the files it
+# parses. With this tag you can assign which parser to use for a given
+# extension. Doxygen has a built-in mapping, but you can override or extend it
+# using this tag. The format is ext=language, where ext is a file extension, and
+# language is one of the parsers supported by doxygen: IDL, Java, Javascript,
+# C#, C, C++, D, PHP, Objective-C, Python, Fortran (fixed format Fortran:
+# FortranFixed, free formatted Fortran: FortranFree, unknown formatted Fortran:
+# Fortran. In the later case the parser tries to guess whether the code is fixed
+# or free formatted code, this is the default for Fortran type files), VHDL. For
+# instance to make doxygen treat .inc files as Fortran files (default is PHP),
+# and .f files as C (default is Fortran), use: inc=Fortran f=C.
+#
+# Note For files without extension you can use no_extension as a placeholder.
+#
+# Note that for custom extensions you also need to set FILE_PATTERNS otherwise
+# the files are not read by doxygen.
+
+EXTENSION_MAPPING =
+
+# If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments
+# according to the Markdown format, which allows for more readable
+# documentation. See http://daringfireball.net/projects/markdown/ for details.
+# The output of markdown processing is further processed by doxygen, so you can
+# mix doxygen, HTML, and XML commands with Markdown formatting. Disable only in
+# case of backward compatibilities issues.
+# The default value is: YES.
+
+MARKDOWN_SUPPORT = YES
+
+# When enabled doxygen tries to link words that correspond to documented
+# classes, or namespaces to their corresponding documentation. Such a link can
+# be prevented in individual cases by by putting a % sign in front of the word
+# or globally by setting AUTOLINK_SUPPORT to NO.
+# The default value is: YES.
+
+AUTOLINK_SUPPORT = YES
+
+# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
+# to include (a tag file for) the STL sources as input, then you should set this
+# tag to YES in order to let doxygen match functions declarations and
+# definitions whose arguments contain STL classes (e.g. func(std::string);
+# versus func(std::string) {}). This also make the inheritance and collaboration
+# diagrams that involve STL classes more complete and accurate.
+# The default value is: NO.
+
+BUILTIN_STL_SUPPORT = NO
+
+# If you use Microsoft's C++/CLI language, you should set this option to YES to
+# enable parsing support.
+# The default value is: NO.
+
+CPP_CLI_SUPPORT = NO
+
+# Set the SIP_SUPPORT tag to YES if your project consists of sip (see:
+# http://www.riverbankcomputing.co.uk/software/sip/intro) sources only. Doxygen
+# will parse them like normal C++ but will assume all classes use public instead
+# of private inheritance when no explicit protection keyword is present.
+# The default value is: NO.
+
+SIP_SUPPORT = NO
+
+# For Microsoft's IDL there are propget and propput attributes to indicate
+# getter and setter methods for a property. Setting this option to YES will make
+# doxygen to replace the get and set methods by a property in the documentation.
+# This will only work if the methods are indeed getting or setting a simple
+# type. If this is not the case, or you want to show the methods anyway, you
+# should set this option to NO.
+# The default value is: YES.
+
+IDL_PROPERTY_SUPPORT = YES
+
+# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
+# tag is set to YES, then doxygen will reuse the documentation of the first
+# member in the group (if any) for the other members of the group. By default
+# all members of a group must be documented explicitly.
+# The default value is: NO.
+
+DISTRIBUTE_GROUP_DOC = NO
+
+# Set the SUBGROUPING tag to YES to allow class member groups of the same type
+# (for instance a group of public functions) to be put as a subgroup of that
+# type (e.g. under the Public Functions section). Set it to NO to prevent
+# subgrouping. Alternatively, this can be done per class using the
+# \nosubgrouping command.
+# The default value is: YES.
+
+SUBGROUPING = YES
+
+# When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and unions
+# are shown inside the group in which they are included (e.g. using \ingroup)
+# instead of on a separate page (for HTML and Man pages) or section (for LaTeX
+# and RTF).
+#
+# Note that this feature does not work in combination with
+# SEPARATE_MEMBER_PAGES.
+# The default value is: NO.
+
+INLINE_GROUPED_CLASSES = NO
+
+# When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions
+# with only public data fields or simple typedef fields will be shown inline in
+# the documentation of the scope in which they are defined (i.e. file,
+# namespace, or group documentation), provided this scope is documented. If set
+# to NO, structs, classes, and unions are shown on a separate page (for HTML and
+# Man pages) or section (for LaTeX and RTF).
+# The default value is: NO.
+
+INLINE_SIMPLE_STRUCTS = YES
+
+# When TYPEDEF_HIDES_STRUCT tag is enabled, a typedef of a struct, union, or
+# enum is documented as struct, union, or enum with the name of the typedef. So
+# typedef struct TypeS {} TypeT, will appear in the documentation as a struct
+# with name TypeT. When disabled the typedef will appear as a member of a file,
+# namespace, or class. And the struct will be named TypeS. This can typically be
+# useful for C code in case the coding convention dictates that all compound
+# types are typedef'ed and only the typedef is referenced, never the tag name.
+# The default value is: NO.
+
+TYPEDEF_HIDES_STRUCT = NO
+
+# The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This
+# cache is used to resolve symbols given their name and scope. Since this can be
+# an expensive process and often the same symbol appears multiple times in the
+# code, doxygen keeps a cache of pre-resolved symbols. If the cache is too small
+# doxygen will become slower. If the cache is too large, memory is wasted. The
+# cache size is given by this formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range
+# is 0..9, the default is 0, corresponding to a cache size of 2^16=65536
+# symbols. At the end of a run doxygen will report the cache usage and suggest
+# the optimal cache size from a speed point of view.
+# Minimum value: 0, maximum value: 9, default value: 0.
+
+LOOKUP_CACHE_SIZE = 0
+
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+
+# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in
+# documentation are documented, even if no documentation was available. Private
+# class members and static file members will be hidden unless the
+# EXTRACT_PRIVATE respectively EXTRACT_STATIC tags are set to YES.
+# Note: This will also disable the warnings about undocumented members that are
+# normally produced when WARNINGS is set to YES.
+# The default value is: NO.
+
+EXTRACT_ALL = YES
+
+# If the EXTRACT_PRIVATE tag is set to YES all private members of a class will
+# be included in the documentation.
+# The default value is: NO.
+
+EXTRACT_PRIVATE = NO
+
+# If the EXTRACT_PACKAGE tag is set to YES all members with package or internal
+# scope will be included in the documentation.
+# The default value is: NO.
+
+EXTRACT_PACKAGE = NO
+
+# If the EXTRACT_STATIC tag is set to YES all static members of a file will be
+# included in the documentation.
+# The default value is: NO.
+
+EXTRACT_STATIC = NO
+
+# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) defined
+# locally in source files will be included in the documentation. If set to NO
+# only classes defined in header files are included. Does not have any effect
+# for Java sources.
+# The default value is: YES.
+
+EXTRACT_LOCAL_CLASSES = YES
+
+# This flag is only useful for Objective-C code. When set to YES local methods,
+# which are defined in the implementation section but not in the interface are
+# included in the documentation. If set to NO only methods in the interface are
+# included.
+# The default value is: NO.
+
+EXTRACT_LOCAL_METHODS = NO
+
+# If this flag is set to YES, the members of anonymous namespaces will be
+# extracted and appear in the documentation as a namespace called
+# 'anonymous_namespace{file}', where file will be replaced with the base name of
+# the file that contains the anonymous namespace. By default anonymous namespace
+# are hidden.
+# The default value is: NO.
+
+EXTRACT_ANON_NSPACES = NO
+
+# If the HIDE_UNDOC_MEMBERS tag is set to YES, doxygen will hide all
+# undocumented members inside documented classes or files. If set to NO these
+# members will be included in the various overviews, but no documentation
+# section is generated. This option has no effect if EXTRACT_ALL is enabled.
+# The default value is: NO.
+
+HIDE_UNDOC_MEMBERS = NO
+
+# If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all
+# undocumented classes that are normally visible in the class hierarchy. If set
+# to NO these classes will be included in the various overviews. This option has
+# no effect if EXTRACT_ALL is enabled.
+# The default value is: NO.
+
+HIDE_UNDOC_CLASSES = NO
+
+# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend
+# (class|struct|union) declarations. If set to NO these declarations will be
+# included in the documentation.
+# The default value is: NO.
+
+HIDE_FRIEND_COMPOUNDS = NO
+
+# If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any
+# documentation blocks found inside the body of a function. If set to NO these
+# blocks will be appended to the function's detailed documentation block.
+# The default value is: NO.
+
+HIDE_IN_BODY_DOCS = NO
+
+# The INTERNAL_DOCS tag determines if documentation that is typed after a
+# \internal command is included. If the tag is set to NO then the documentation
+# will be excluded. Set it to YES to include the internal documentation.
+# The default value is: NO.
+
+INTERNAL_DOCS = NO
+
+# If the CASE_SENSE_NAMES tag is set to NO then doxygen will only generate file
+# names in lower-case letters. If set to YES upper-case letters are also
+# allowed. This is useful if you have classes or files whose names only differ
+# in case and if your file system supports case sensitive file names. Windows
+# and Mac users are advised to set this option to NO.
+# The default value is: system dependent.
+
+CASE_SENSE_NAMES = YES
+
+# If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with
+# their full class and namespace scopes in the documentation. If set to YES the
+# scope will be hidden.
+# The default value is: NO.
+
+HIDE_SCOPE_NAMES = NO
+
+# If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of
+# the files that are included by a file in the documentation of that file.
+# The default value is: YES.
+
+SHOW_INCLUDE_FILES = YES
+
+# If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each
+# grouped member an include statement to the documentation, telling the reader
+# which file to include in order to use the member.
+# The default value is: NO.
+
+SHOW_GROUPED_MEMB_INC = NO
+
+# If the FORCE_LOCAL_INCLUDES tag is set to YES then doxygen will list include
+# files with double quotes in the documentation rather than with sharp brackets.
+# The default value is: NO.
+
+FORCE_LOCAL_INCLUDES = NO
+
+# If the INLINE_INFO tag is set to YES then a tag [inline] is inserted in the
+# documentation for inline members.
+# The default value is: YES.
+
+INLINE_INFO = YES
+
+# If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the
+# (detailed) documentation of file and class members alphabetically by member
+# name. If set to NO the members will appear in declaration order.
+# The default value is: YES.
+
+SORT_MEMBER_DOCS = NO
+
+# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief
+# descriptions of file, namespace and class members alphabetically by member
+# name. If set to NO the members will appear in declaration order. Note that
+# this will also influence the order of the classes in the class list.
+# The default value is: NO.
+
+SORT_BRIEF_DOCS = NO
+
+# If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the
+# (brief and detailed) documentation of class members so that constructors and
+# destructors are listed first. If set to NO the constructors will appear in the
+# respective orders defined by SORT_BRIEF_DOCS and SORT_MEMBER_DOCS.
+# Note: If SORT_BRIEF_DOCS is set to NO this option is ignored for sorting brief
+# member documentation.
+# Note: If SORT_MEMBER_DOCS is set to NO this option is ignored for sorting
+# detailed member documentation.
+# The default value is: NO.
+
+SORT_MEMBERS_CTORS_1ST = NO
+
+# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy
+# of group names into alphabetical order. If set to NO the group names will
+# appear in their defined order.
+# The default value is: NO.
+
+SORT_GROUP_NAMES = NO
+
+# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by
+# fully-qualified names, including namespaces. If set to NO, the class list will
+# be sorted only by class name, not including the namespace part.
+# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.
+# Note: This option applies only to the class list, not to the alphabetical
+# list.
+# The default value is: NO.
+
+SORT_BY_SCOPE_NAME = NO
+
+# If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to do proper
+# type resolution of all parameters of a function it will reject a match between
+# the prototype and the implementation of a member function even if there is
+# only one candidate or it is obvious which candidate to choose by doing a
+# simple string match. By disabling STRICT_PROTO_MATCHING doxygen will still
+# accept a match between prototype and implementation in such cases.
+# The default value is: NO.
+
+STRICT_PROTO_MATCHING = NO
+
+# The GENERATE_TODOLIST tag can be used to enable ( YES) or disable ( NO) the
+# todo list. This list is created by putting \todo commands in the
+# documentation.
+# The default value is: YES.
+
+GENERATE_TODOLIST = YES
+
+# The GENERATE_TESTLIST tag can be used to enable ( YES) or disable ( NO) the
+# test list. This list is created by putting \test commands in the
+# documentation.
+# The default value is: YES.
+
+GENERATE_TESTLIST = YES
+
+# The GENERATE_BUGLIST tag can be used to enable ( YES) or disable ( NO) the bug
+# list. This list is created by putting \bug commands in the documentation.
+# The default value is: YES.
+
+GENERATE_BUGLIST = YES
+
+# The GENERATE_DEPRECATEDLIST tag can be used to enable ( YES) or disable ( NO)
+# the deprecated list. This list is created by putting \deprecated commands in
+# the documentation.
+# The default value is: YES.
+
+GENERATE_DEPRECATEDLIST= YES
+
+# The ENABLED_SECTIONS tag can be used to enable conditional documentation
+# sections, marked by \if <section_label> ... \endif and \cond <section_label>
+# ... \endcond blocks.
+
+ENABLED_SECTIONS =
+
+# The MAX_INITIALIZER_LINES tag determines the maximum number of lines that the
+# initial value of a variable or macro / define can have for it to appear in the
+# documentation. If the initializer consists of more lines than specified here
+# it will be hidden. Use a value of 0 to hide initializers completely. The
+# appearance of the value of individual variables and macros / defines can be
+# controlled using \showinitializer or \hideinitializer command in the
+# documentation regardless of this setting.
+# Minimum value: 0, maximum value: 10000, default value: 30.
+
+MAX_INITIALIZER_LINES = 30
+
+# Set the SHOW_USED_FILES tag to NO to disable the list of files generated at
+# the bottom of the documentation of classes and structs. If set to YES the list
+# will mention the files that were used to generate the documentation.
+# The default value is: YES.
+
+SHOW_USED_FILES = YES
+
+# Set the SHOW_FILES tag to NO to disable the generation of the Files page. This
+# will remove the Files entry from the Quick Index and from the Folder Tree View
+# (if specified).
+# The default value is: YES.
+
+SHOW_FILES = YES
+
+# Set the SHOW_NAMESPACES tag to NO to disable the generation of the Namespaces
+# page. This will remove the Namespaces entry from the Quick Index and from the
+# Folder Tree View (if specified).
+# The default value is: YES.
+
+SHOW_NAMESPACES = YES
+
+# The FILE_VERSION_FILTER tag can be used to specify a program or script that
+# doxygen should invoke to get the current version for each file (typically from
+# the version control system). Doxygen will invoke the program by executing (via
+# popen()) the command command input-file, where command is the value of the
+# FILE_VERSION_FILTER tag, and input-file is the name of an input file provided
+# by doxygen. Whatever the program writes to standard output is used as the file
+# version. For an example see the documentation.
+
+FILE_VERSION_FILTER =
+
+# The LAYOUT_FILE tag can be used to specify a layout file which will be parsed
+# by doxygen. The layout file controls the global structure of the generated
+# output files in an output format independent way. To create the layout file
+# that represents doxygen's defaults, run doxygen with the -l option. You can
+# optionally specify a file name after the option, if omitted DoxygenLayout.xml
+# will be used as the name of the layout file.
+#
+# Note that if you run doxygen from a directory containing a file called
+# DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE
+# tag is left empty.
+
+LAYOUT_FILE =
+
+# The CITE_BIB_FILES tag can be used to specify one or more bib files containing
+# the reference definitions. This must be a list of .bib files. The .bib
+# extension is automatically appended if omitted. This requires the bibtex tool
+# to be installed. See also http://en.wikipedia.org/wiki/BibTeX for more info.
+# For LaTeX the style of the bibliography can be controlled using
+# LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the
+# search path. See also \cite for info how to create references.
+
+CITE_BIB_FILES =
+
+#---------------------------------------------------------------------------
+# Configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+
+# The QUIET tag can be used to turn on/off the messages that are generated to
+# standard output by doxygen. If QUIET is set to YES this implies that the
+# messages are off.
+# The default value is: NO.
+
+QUIET = NO
+
+# The WARNINGS tag can be used to turn on/off the warning messages that are
+# generated to standard error ( stderr) by doxygen. If WARNINGS is set to YES
+# this implies that the warnings are on.
+#
+# Tip: Turn warnings on while writing the documentation.
+# The default value is: YES.
+
+WARNINGS = YES
+
+# If the WARN_IF_UNDOCUMENTED tag is set to YES, then doxygen will generate
+# warnings for undocumented members. If EXTRACT_ALL is set to YES then this flag
+# will automatically be disabled.
+# The default value is: YES.
+
+WARN_IF_UNDOCUMENTED = YES
+
+# If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for
+# potential errors in the documentation, such as not documenting some parameters
+# in a documented function, or documenting parameters that don't exist or using
+# markup commands wrongly.
+# The default value is: YES.
+
+WARN_IF_DOC_ERROR = YES
+
+# This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that
+# are documented, but have no documentation for their parameters or return
+# value. If set to NO doxygen will only warn about wrong or incomplete parameter
+# documentation, but not about the absence of documentation.
+# The default value is: NO.
+
+WARN_NO_PARAMDOC = YES
+
+# The WARN_FORMAT tag determines the format of the warning messages that doxygen
+# can produce. The string should contain the $file, $line, and $text tags, which
+# will be replaced by the file and line number from which the warning originated
+# and the warning text. Optionally the format may contain $version, which will
+# be replaced by the version of the file (if it could be obtained via
+# FILE_VERSION_FILTER)
+# The default value is: $file:$line: $text.
+
+WARN_FORMAT = "$file:$line: $text"
+
+# The WARN_LOGFILE tag can be used to specify a file to which warning and error
+# messages should be written. If left blank the output is written to standard
+# error (stderr).
+
+WARN_LOGFILE =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the input files
+#---------------------------------------------------------------------------
+
+# The INPUT tag is used to specify the files and/or directories that contain
+# documented source files. You may enter file names like myfile.cpp or
+# directories like /usr/src/myproject. Separate the files or directories with
+# spaces.
+# Note: If this tag is empty the current directory is searched.
+
+INPUT = ../doc/main.dox \
+ ../src
+
+# This tag can be used to specify the character encoding of the source files
+# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
+# libiconv (or the iconv built into libc) for the transcoding. See the libiconv
+# documentation (see: http://www.gnu.org/software/libiconv) for the list of
+# possible encodings.
+# The default value is: UTF-8.
+
+INPUT_ENCODING = UTF-8
+
+# If the value of the INPUT tag contains directories, you can use the
+# FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and
+# *.h) to filter out the source-files in the directories. If left blank the
+# following patterns are tested:*.c, *.cc, *.cxx, *.cpp, *.c++, *.java, *.ii,
+# *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h, *.hh, *.hxx, *.hpp,
+# *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc, *.m, *.markdown,
+# *.md, *.mm, *.dox, *.py, *.f90, *.f, *.for, *.tcl, *.vhd, *.vhdl, *.ucf,
+# *.qsf, *.as and *.js.
+
+FILE_PATTERNS = *.c \
+ *.h \
+ *.cpp
+
+# The RECURSIVE tag can be used to specify whether or not subdirectories should
+# be searched for input files as well.
+# The default value is: NO.
+
+RECURSIVE = YES
+
+# The EXCLUDE tag can be used to specify files and/or directories that should be
+# excluded from the INPUT source files. This way you can easily exclude a
+# subdirectory from a directory tree whose root is specified with the INPUT tag.
+#
+# Note that relative paths are relative to the directory from which doxygen is
+# run.
+
+EXCLUDE = ../src/old \
+ ../src/examples
+
+# The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
+# directories that are symbolic links (a Unix file system feature) are excluded
+# from the input.
+# The default value is: NO.
+
+EXCLUDE_SYMLINKS = NO
+
+# If the value of the INPUT tag contains directories, you can use the
+# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
+# certain files from those directories.
+#
+# Note that the wildcards are matched against the file with absolute path, so to
+# exclude all test directories for example use the pattern */test/*
+
+EXCLUDE_PATTERNS = parental.* \
+ test_branch*.* \
+ test_circ*.* \
+ test_error* \
+ test_graph* \
+ test_hete*.* \
+ test_map* \
+ test_mi* \
+ test_multimap* \
+ test_node*.* \
+ test_parent*.* \
+ test_Sensor* \
+ test_point* \
+ test_quat* \
+ test_shared*.* \
+ test_states* \
+ test_traj*.* \
+ test_unor*.* \
+ test_up_down* \
+ test_wolf_tree* \
+ *.tab.c \
+ *.tab.h \
+ lex* \
+ *glr.h \
+ *llr.h \
+ *glr.c \
+ *llr.c \
+ *general.h
+
+# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
+# (namespaces, classes, functions, etc.) that should be excluded from the
+# output. The symbol name can be a fully qualified name, a word, or if the
+# wildcard * is used, a substring. Examples: ANamespace, AClass,
+# AClass::ANamespace, ANamespace::*Test
+#
+# Note that the wildcards are matched against the file with absolute path, so to
+# exclude all test directories use the pattern */test/*
+
+EXCLUDE_SYMBOLS =
+
+# The EXAMPLE_PATH tag can be used to specify one or more files or directories
+# that contain example code fragments that are included (see the \include
+# command).
+
+EXAMPLE_PATH = ../src/examples
+
+# If the value of the EXAMPLE_PATH tag contains directories, you can use the
+# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
+# *.h) to filter out the source-files in the directories. If left blank all
+# files are included.
+
+EXAMPLE_PATTERNS =
+
+# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
+# searched for input files to be used with the \include or \dontinclude commands
+# irrespective of the value of the RECURSIVE tag.
+# The default value is: NO.
+
+EXAMPLE_RECURSIVE = NO
+
+# The IMAGE_PATH tag can be used to specify one or more files or directories
+# that contain images that are to be included in the documentation (see the
+# \image command).
+
+IMAGE_PATH = ../doc/images
+
+# The INPUT_FILTER tag can be used to specify a program that doxygen should
+# invoke to filter for each input file. Doxygen will invoke the filter program
+# by executing (via popen()) the command:
+#
+# <filter> <input-file>
+#
+# where <filter> is the value of the INPUT_FILTER tag, and <input-file> is the
+# name of an input file. Doxygen will then use the output that the filter
+# program writes to standard output. If FILTER_PATTERNS is specified, this tag
+# will be ignored.
+#
+# Note that the filter must not add or remove lines; it is applied before the
+# code is scanned, but not when the output code is generated. If lines are added
+# or removed, the anchors will not be placed correctly.
+
+INPUT_FILTER =
+
+# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern
+# basis. Doxygen will compare the file name with each pattern and apply the
+# filter if there is a match. The filters are a list of the form: pattern=filter
+# (like *.cpp=my_cpp_filter). See INPUT_FILTER for further information on how
+# filters are used. If the FILTER_PATTERNS tag is empty or if none of the
+# patterns match the file name, INPUT_FILTER is applied.
+
+FILTER_PATTERNS =
+
+# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
+# INPUT_FILTER ) will also be used to filter the input files that are used for
+# producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES).
+# The default value is: NO.
+
+FILTER_SOURCE_FILES = NO
+
+# The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file
+# pattern. A pattern will override the setting for FILTER_PATTERN (if any) and
+# it is also possible to disable source filtering for a specific pattern using
+# *.ext= (so without naming a filter).
+# This tag requires that the tag FILTER_SOURCE_FILES is set to YES.
+
+FILTER_SOURCE_PATTERNS =
+
+# If the USE_MDFILE_AS_MAINPAGE tag refers to the name of a markdown file that
+# is part of the input, its contents will be placed on the main page
+# (index.html). This can be useful if you have a project on for instance GitHub
+# and want to reuse the introduction page also for the doxygen output.
+
+USE_MDFILE_AS_MAINPAGE =
+
+#---------------------------------------------------------------------------
+# Configuration options related to source browsing
+#---------------------------------------------------------------------------
+
+# If the SOURCE_BROWSER tag is set to YES then a list of source files will be
+# generated. Documented entities will be cross-referenced with these sources.
+#
+# Note: To get rid of all source code in the generated output, make sure that
+# also VERBATIM_HEADERS is set to NO.
+# The default value is: NO.
+
+SOURCE_BROWSER = YES
+
+# Setting the INLINE_SOURCES tag to YES will include the body of functions,
+# classes and enums directly into the documentation.
+# The default value is: NO.
+
+INLINE_SOURCES = NO
+
+# Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any
+# special comment blocks from generated source code fragments. Normal C, C++ and
+# Fortran comments will always remain visible.
+# The default value is: YES.
+
+STRIP_CODE_COMMENTS = YES
+
+# If the REFERENCED_BY_RELATION tag is set to YES then for each documented
+# function all documented functions referencing it will be listed.
+# The default value is: NO.
+
+REFERENCED_BY_RELATION = YES
+
+# If the REFERENCES_RELATION tag is set to YES then for each documented function
+# all documented entities called/used by that function will be listed.
+# The default value is: NO.
+
+REFERENCES_RELATION = YES
+
+# If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set
+# to YES, then the hyperlinks from functions in REFERENCES_RELATION and
+# REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will
+# link to the documentation.
+# The default value is: YES.
+
+REFERENCES_LINK_SOURCE = YES
+
+# If SOURCE_TOOLTIPS is enabled (the default) then hovering a hyperlink in the
+# source code will show a tooltip with additional information such as prototype,
+# brief description and links to the definition and documentation. Since this
+# will make the HTML file larger and loading of large files a bit slower, you
+# can opt to disable this feature.
+# The default value is: YES.
+# This tag requires that the tag SOURCE_BROWSER is set to YES.
+
+SOURCE_TOOLTIPS = YES
+
+# If the USE_HTAGS tag is set to YES then the references to source code will
+# point to the HTML generated by the htags(1) tool instead of doxygen built-in
+# source browser. The htags tool is part of GNU's global source tagging system
+# (see http://www.gnu.org/software/global/global.html). You will need version
+# 4.8.6 or higher.
+#
+# To use it do the following:
+# - Install the latest version of global
+# - Enable SOURCE_BROWSER and USE_HTAGS in the config file
+# - Make sure the INPUT points to the root of the source tree
+# - Run doxygen as normal
+#
+# Doxygen will invoke htags (and that will in turn invoke gtags), so these
+# tools must be available from the command line (i.e. in the search path).
+#
+# The result: instead of the source browser generated by doxygen, the links to
+# source code will now point to the output of htags.
+# The default value is: NO.
+# This tag requires that the tag SOURCE_BROWSER is set to YES.
+
+USE_HTAGS = NO
+
+# If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a
+# verbatim copy of the header file for each class for which an include is
+# specified. Set to NO to disable this.
+# See also: Section \class.
+# The default value is: YES.
+
+VERBATIM_HEADERS = YES
+
+#---------------------------------------------------------------------------
+# Configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+
+# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index of all
+# compounds will be generated. Enable this if the project contains a lot of
+# classes, structs, unions or interfaces.
+# The default value is: YES.
+
+ALPHABETICAL_INDEX = YES
+
+# The COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns in
+# which the alphabetical index list will be split.
+# Minimum value: 1, maximum value: 20, default value: 5.
+# This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
+
+COLS_IN_ALPHA_INDEX = 5
+
+# In case all classes in a project start with a common prefix, all classes will
+# be put under the same header in the alphabetical index. The IGNORE_PREFIX tag
+# can be used to specify a prefix (or a list of prefixes) that should be ignored
+# while generating the index headers.
+# This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
+
+IGNORE_PREFIX =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the HTML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_HTML tag is set to YES doxygen will generate HTML output
+# The default value is: YES.
+
+GENERATE_HTML = YES
+
+# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: html.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_OUTPUT = html
+
+# The HTML_FILE_EXTENSION tag can be used to specify the file extension for each
+# generated HTML page (for example: .htm, .php, .asp).
+# The default value is: .html.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_FILE_EXTENSION = .html
+
+# The HTML_HEADER tag can be used to specify a user-defined HTML header file for
+# each generated HTML page. If the tag is left blank doxygen will generate a
+# standard header.
+#
+# To get valid HTML the header file that includes any scripts and style sheets
+# that doxygen needs, which is dependent on the configuration options used (e.g.
+# the setting GENERATE_TREEVIEW). It is highly recommended to start with a
+# default header using
+# doxygen -w html new_header.html new_footer.html new_stylesheet.css
+# YourConfigFile
+# and then modify the file new_header.html. See also section "Doxygen usage"
+# for information on how to generate the default header that doxygen normally
+# uses.
+# Note: The header is subject to change so you typically have to regenerate the
+# default header when upgrading to a newer version of doxygen. For a description
+# of the possible markers and block names see the documentation.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_HEADER =
+
+# The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each
+# generated HTML page. If the tag is left blank doxygen will generate a standard
+# footer. See HTML_HEADER for more information on how to generate a default
+# footer and what special commands can be used inside the footer. See also
+# section "Doxygen usage" for information on how to generate the default footer
+# that doxygen normally uses.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_FOOTER =
+
+# The HTML_STYLESHEET tag can be used to specify a user-defined cascading style
+# sheet that is used by each HTML page. It can be used to fine-tune the look of
+# the HTML output. If left blank doxygen will generate a default style sheet.
+# See also section "Doxygen usage" for information on how to generate the style
+# sheet that doxygen normally uses.
+# Note: It is recommended to use HTML_EXTRA_STYLESHEET instead of this tag, as
+# it is more robust and this tag (HTML_STYLESHEET) will in the future become
+# obsolete.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_STYLESHEET =
+
+# The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined
+# cascading style sheets that are included after the standard style sheets
+# created by doxygen. Using this option one can overrule certain style aspects.
+# This is preferred over using HTML_STYLESHEET since it does not replace the
+# standard style sheet and is therefor more robust against future updates.
+# Doxygen will copy the style sheet files to the output directory.
+# Note: The order of the extra stylesheet files is of importance (e.g. the last
+# stylesheet in the list overrules the setting of the previous ones in the
+# list). For an example see the documentation.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_EXTRA_STYLESHEET =
+
+# The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
+# other source files which should be copied to the HTML output directory. Note
+# that these files will be copied to the base HTML output directory. Use the
+# $relpath^ marker in the HTML_HEADER and/or HTML_FOOTER files to load these
+# files. In the HTML_STYLESHEET file, use the file name only. Also note that the
+# files will be copied as-is; there are no commands or markers available.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_EXTRA_FILES =
+
+# The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
+# will adjust the colors in the stylesheet and background images according to
+# this color. Hue is specified as an angle on a colorwheel, see
+# http://en.wikipedia.org/wiki/Hue for more information. For instance the value
+# 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300
+# purple, and 360 is red again.
+# Minimum value: 0, maximum value: 359, default value: 220.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_COLORSTYLE_HUE = 220
+
+# The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors
+# in the HTML output. For a value of 0 the output will use grayscales only. A
+# value of 255 will produce the most vivid colors.
+# Minimum value: 0, maximum value: 255, default value: 100.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_COLORSTYLE_SAT = 100
+
+# The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to the
+# luminance component of the colors in the HTML output. Values below 100
+# gradually make the output lighter, whereas values above 100 make the output
+# darker. The value divided by 100 is the actual gamma applied, so 80 represents
+# a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not
+# change the gamma.
+# Minimum value: 40, maximum value: 240, default value: 80.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_COLORSTYLE_GAMMA = 80
+
+# If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML
+# page will contain the date and time when the page was generated. Setting this
+# to NO can help when comparing the output of multiple runs.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_TIMESTAMP = YES
+
+# If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
+# documentation will contain sections that can be hidden and shown after the
+# page has loaded.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_DYNAMIC_SECTIONS = NO
+
+# With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries
+# shown in the various tree structured indices initially; the user can expand
+# and collapse entries dynamically later on. Doxygen will expand the tree to
+# such a level that at most the specified number of entries are visible (unless
+# a fully collapsed tree already exceeds this amount). So setting the number of
+# entries 1 will produce a full collapsed tree by default. 0 is a special value
+# representing an infinite number of entries and will result in a full expanded
+# tree by default.
+# Minimum value: 0, maximum value: 9999, default value: 100.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+HTML_INDEX_NUM_ENTRIES = 100
+
+# If the GENERATE_DOCSET tag is set to YES, additional index files will be
+# generated that can be used as input for Apple's Xcode 3 integrated development
+# environment (see: http://developer.apple.com/tools/xcode/), introduced with
+# OSX 10.5 (Leopard). To create a documentation set, doxygen will generate a
+# Makefile in the HTML output directory. Running make will produce the docset in
+# that directory and running make install will install the docset in
+# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at
+# startup. See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html
+# for more information.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_DOCSET = NO
+
+# This tag determines the name of the docset feed. A documentation feed provides
+# an umbrella under which multiple documentation sets from a single provider
+# (such as a company or product suite) can be grouped.
+# The default value is: Doxygen generated docs.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_FEEDNAME = "Doxygen generated docs"
+
+# This tag specifies a string that should uniquely identify the documentation
+# set bundle. This should be a reverse domain-name style string, e.g.
+# com.mycompany.MyDocSet. Doxygen will append .docset to the name.
+# The default value is: org.doxygen.Project.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_BUNDLE_ID = org.doxygen.Project
+
+# The DOCSET_PUBLISHER_ID tag specifies a string that should uniquely identify
+# the documentation publisher. This should be a reverse domain-name style
+# string, e.g. com.mycompany.MyDocSet.documentation.
+# The default value is: org.doxygen.Publisher.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_PUBLISHER_ID = org.doxygen.Publisher
+
+# The DOCSET_PUBLISHER_NAME tag identifies the documentation publisher.
+# The default value is: Publisher.
+# This tag requires that the tag GENERATE_DOCSET is set to YES.
+
+DOCSET_PUBLISHER_NAME = Publisher
+
+# If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three
+# additional HTML index files: index.hhp, index.hhc, and index.hhk. The
+# index.hhp is a project file that can be read by Microsoft's HTML Help Workshop
+# (see: http://www.microsoft.com/en-us/download/details.aspx?id=21138) on
+# Windows.
+#
+# The HTML Help Workshop contains a compiler that can convert all HTML output
+# generated by doxygen into a single compiled HTML file (.chm). Compiled HTML
+# files are now used as the Windows 98 help format, and will replace the old
+# Windows help format (.hlp) on all Windows platforms in the future. Compressed
+# HTML files also contain an index, a table of contents, and you can search for
+# words in the documentation. The HTML workshop also contains a viewer for
+# compressed HTML files.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_HTMLHELP = NO
+
+# The CHM_FILE tag can be used to specify the file name of the resulting .chm
+# file. You can add a path in front of the file if the result should not be
+# written to the html output directory.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+CHM_FILE =
+
+# The HHC_LOCATION tag can be used to specify the location (absolute path
+# including file name) of the HTML help compiler ( hhc.exe). If non-empty
+# doxygen will try to run the HTML help compiler on the generated index.hhp.
+# The file has to be specified with full path.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+HHC_LOCATION =
+
+# The GENERATE_CHI flag controls if a separate .chi index file is generated (
+# YES) or that it should be included in the master .chm file ( NO).
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+GENERATE_CHI = NO
+
+# The CHM_INDEX_ENCODING is used to encode HtmlHelp index ( hhk), content ( hhc)
+# and project file content.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+CHM_INDEX_ENCODING =
+
+# The BINARY_TOC flag controls whether a binary table of contents is generated (
+# YES) or a normal table of contents ( NO) in the .chm file. Furthermore it
+# enables the Previous and Next buttons.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+BINARY_TOC = NO
+
+# The TOC_EXPAND flag can be set to YES to add extra items for group members to
+# the table of contents of the HTML help documentation and to the tree view.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
+
+TOC_EXPAND = NO
+
+# If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and
+# QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that
+# can be used as input for Qt's qhelpgenerator to generate a Qt Compressed Help
+# (.qch) of the generated HTML documentation.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_QHP = NO
+
+# If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify
+# the file name of the resulting .qch file. The path specified is relative to
+# the HTML output folder.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QCH_FILE =
+
+# The QHP_NAMESPACE tag specifies the namespace to use when generating Qt Help
+# Project output. For more information please see Qt Help Project / Namespace
+# (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#namespace).
+# The default value is: org.doxygen.Project.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_NAMESPACE = org.doxygen.Project
+
+# The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating Qt
+# Help Project output. For more information please see Qt Help Project / Virtual
+# Folders (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#virtual-
+# folders).
+# The default value is: doc.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_VIRTUAL_FOLDER = doc
+
+# If the QHP_CUST_FILTER_NAME tag is set, it specifies the name of a custom
+# filter to add. For more information please see Qt Help Project / Custom
+# Filters (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom-
+# filters).
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_CUST_FILTER_NAME =
+
+# The QHP_CUST_FILTER_ATTRS tag specifies the list of the attributes of the
+# custom filter to add. For more information please see Qt Help Project / Custom
+# Filters (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom-
+# filters).
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_CUST_FILTER_ATTRS =
+
+# The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this
+# project's filter section matches. Qt Help Project / Filter Attributes (see:
+# http://qt-project.org/doc/qt-4.8/qthelpproject.html#filter-attributes).
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHP_SECT_FILTER_ATTRS =
+
+# The QHG_LOCATION tag can be used to specify the location of Qt's
+# qhelpgenerator. If non-empty doxygen will try to run qhelpgenerator on the
+# generated .qhp file.
+# This tag requires that the tag GENERATE_QHP is set to YES.
+
+QHG_LOCATION =
+
+# If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be
+# generated, together with the HTML files, they form an Eclipse help plugin. To
+# install this plugin and make it available under the help contents menu in
+# Eclipse, the contents of the directory containing the HTML and XML files needs
+# to be copied into the plugins directory of eclipse. The name of the directory
+# within the plugins directory should be the same as the ECLIPSE_DOC_ID value.
+# After copying Eclipse needs to be restarted before the help appears.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_ECLIPSEHELP = NO
+
+# A unique identifier for the Eclipse help plugin. When installing the plugin
+# the directory name containing the HTML and XML files should also have this
+# name. Each documentation set should have its own identifier.
+# The default value is: org.doxygen.Project.
+# This tag requires that the tag GENERATE_ECLIPSEHELP is set to YES.
+
+ECLIPSE_DOC_ID = org.doxygen.Project
+
+# If you want full control over the layout of the generated HTML pages it might
+# be necessary to disable the index and replace it with your own. The
+# DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top
+# of each HTML page. A value of NO enables the index and the value YES disables
+# it. Since the tabs in the index contain the same information as the navigation
+# tree, you can set this option to YES if you also set GENERATE_TREEVIEW to YES.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+DISABLE_INDEX = NO
+
+# The GENERATE_TREEVIEW tag is used to specify whether a tree-like index
+# structure should be generated to display hierarchical information. If the tag
+# value is set to YES, a side panel will be generated containing a tree-like
+# index structure (just like the one that is generated for HTML Help). For this
+# to work a browser that supports JavaScript, DHTML, CSS and frames is required
+# (i.e. any modern browser). Windows users are probably better off using the
+# HTML help feature. Via custom stylesheets (see HTML_EXTRA_STYLESHEET) one can
+# further fine-tune the look of the index. As an example, the default style
+# sheet generated by doxygen has an example that shows how to put an image at
+# the root of the tree instead of the PROJECT_NAME. Since the tree basically has
+# the same information as the tab index, you could consider setting
+# DISABLE_INDEX to YES when enabling this option.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+GENERATE_TREEVIEW = NO
+
+# The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that
+# doxygen will group on one line in the generated HTML documentation.
+#
+# Note that a value of 0 will completely suppress the enum values from appearing
+# in the overview section.
+# Minimum value: 0, maximum value: 20, default value: 4.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+ENUM_VALUES_PER_LINE = 4
+
+# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be used
+# to set the initial width (in pixels) of the frame in which the tree is shown.
+# Minimum value: 0, maximum value: 1500, default value: 250.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+TREEVIEW_WIDTH = 250
+
+# When the EXT_LINKS_IN_WINDOW option is set to YES doxygen will open links to
+# external symbols imported via tag files in a separate window.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+EXT_LINKS_IN_WINDOW = NO
+
+# Use this tag to change the font size of LaTeX formulas included as images in
+# the HTML documentation. When you change the font size after a successful
+# doxygen run you need to manually remove any form_*.png images from the HTML
+# output directory to force them to be regenerated.
+# Minimum value: 8, maximum value: 50, default value: 10.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+FORMULA_FONTSIZE = 10
+
+# Use the FORMULA_TRANPARENT tag to determine whether or not the images
+# generated for formulas are transparent PNGs. Transparent PNGs are not
+# supported properly for IE 6.0, but are supported on all modern browsers.
+#
+# Note that when changing this option you need to delete any form_*.png files in
+# the HTML output directory before the changes have effect.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+FORMULA_TRANSPARENT = YES
+
+# Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see
+# http://www.mathjax.org) which uses client side Javascript for the rendering
+# instead of using prerendered bitmaps. Use this if you do not have LaTeX
+# installed or if you want to formulas look prettier in the HTML output. When
+# enabled you may also need to install MathJax separately and configure the path
+# to it using the MATHJAX_RELPATH option.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+USE_MATHJAX = NO
+
+# When MathJax is enabled you can set the default output format to be used for
+# the MathJax output. See the MathJax site (see:
+# http://docs.mathjax.org/en/latest/output.html) for more details.
+# Possible values are: HTML-CSS (which is slower, but has the best
+# compatibility), NativeMML (i.e. MathML) and SVG.
+# The default value is: HTML-CSS.
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_FORMAT = HTML-CSS
+
+# When MathJax is enabled you need to specify the location relative to the HTML
+# output directory using the MATHJAX_RELPATH option. The destination directory
+# should contain the MathJax.js script. For instance, if the mathjax directory
+# is located at the same level as the HTML output directory, then
+# MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax
+# Content Delivery Network so you can quickly see the result without installing
+# MathJax. However, it is strongly recommended to install a local copy of
+# MathJax from http://www.mathjax.org before deployment.
+# The default value is: http://cdn.mathjax.org/mathjax/latest.
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest
+
+# The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax
+# extension names that should be enabled during MathJax rendering. For example
+# MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_EXTENSIONS =
+
+# The MATHJAX_CODEFILE tag can be used to specify a file with javascript pieces
+# of code that will be used on startup of the MathJax code. See the MathJax site
+# (see: http://docs.mathjax.org/en/latest/output.html) for more details. For an
+# example see the documentation.
+# This tag requires that the tag USE_MATHJAX is set to YES.
+
+MATHJAX_CODEFILE =
+
+# When the SEARCHENGINE tag is enabled doxygen will generate a search box for
+# the HTML output. The underlying search engine uses javascript and DHTML and
+# should work on any modern browser. Note that when using HTML help
+# (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets (GENERATE_DOCSET)
+# there is already a search function so this one should typically be disabled.
+# For large projects the javascript based search engine can be slow, then
+# enabling SERVER_BASED_SEARCH may provide a better solution. It is possible to
+# search using the keyboard; to jump to the search box use <access key> + S
+# (what the <access key> is depends on the OS and browser, but it is typically
+# <CTRL>, <ALT>/<option>, or both). Inside the search box use the <cursor down
+# key> to jump into the search results window, the results can be navigated
+# using the <cursor keys>. Press <Enter> to select an item or <escape> to cancel
+# the search. The filter options can be selected when the cursor is inside the
+# search box by pressing <Shift>+<cursor down>. Also here use the <cursor keys>
+# to select a filter and <Enter> or <escape> to activate or cancel the filter
+# option.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_HTML is set to YES.
+
+SEARCHENGINE = YES
+
+# When the SERVER_BASED_SEARCH tag is enabled the search engine will be
+# implemented using a web server instead of a web client using Javascript. There
+# are two flavors of web server based searching depending on the EXTERNAL_SEARCH
+# setting. When disabled, doxygen will generate a PHP script for searching and
+# an index file used by the script. When EXTERNAL_SEARCH is enabled the indexing
+# and searching needs to be provided by external tools. See the section
+# "External Indexing and Searching" for details.
+# The default value is: NO.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+SERVER_BASED_SEARCH = NO
+
+# When EXTERNAL_SEARCH tag is enabled doxygen will no longer generate the PHP
+# script for searching. Instead the search results are written to an XML file
+# which needs to be processed by an external indexer. Doxygen will invoke an
+# external search engine pointed to by the SEARCHENGINE_URL option to obtain the
+# search results.
+#
+# Doxygen ships with an example indexer ( doxyindexer) and search engine
+# (doxysearch.cgi) which are based on the open source search engine library
+# Xapian (see: http://xapian.org/).
+#
+# See the section "External Indexing and Searching" for details.
+# The default value is: NO.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+EXTERNAL_SEARCH = NO
+
+# The SEARCHENGINE_URL should point to a search engine hosted by a web server
+# which will return the search results when EXTERNAL_SEARCH is enabled.
+#
+# Doxygen ships with an example indexer ( doxyindexer) and search engine
+# (doxysearch.cgi) which are based on the open source search engine library
+# Xapian (see: http://xapian.org/). See the section "External Indexing and
+# Searching" for details.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+SEARCHENGINE_URL =
+
+# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the unindexed
+# search data is written to a file for indexing by an external tool. With the
+# SEARCHDATA_FILE tag the name of this file can be specified.
+# The default file is: searchdata.xml.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+SEARCHDATA_FILE = searchdata.xml
+
+# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the
+# EXTERNAL_SEARCH_ID tag can be used as an identifier for the project. This is
+# useful in combination with EXTRA_SEARCH_MAPPINGS to search through multiple
+# projects and redirect the results back to the right project.
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+EXTERNAL_SEARCH_ID =
+
+# The EXTRA_SEARCH_MAPPINGS tag can be used to enable searching through doxygen
+# projects other than the one defined by this configuration file, but that are
+# all added to the same external search index. Each project needs to have a
+# unique id set via EXTERNAL_SEARCH_ID. The search mapping then maps the id of
+# to a relative location where the documentation can be found. The format is:
+# EXTRA_SEARCH_MAPPINGS = tagname1=loc1 tagname2=loc2 ...
+# This tag requires that the tag SEARCHENGINE is set to YES.
+
+EXTRA_SEARCH_MAPPINGS =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_LATEX tag is set to YES doxygen will generate LaTeX output.
+# The default value is: YES.
+
+GENERATE_LATEX = NO
+
+# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: latex.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_OUTPUT = latex
+
+# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
+# invoked.
+#
+# Note that when enabling USE_PDFLATEX this option is only used for generating
+# bitmaps for formulas in the HTML output, but not in the Makefile that is
+# written to the output directory.
+# The default file is: latex.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_CMD_NAME = latex
+
+# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to generate
+# index for LaTeX.
+# The default file is: makeindex.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+MAKEINDEX_CMD_NAME = makeindex
+
+# If the COMPACT_LATEX tag is set to YES doxygen generates more compact LaTeX
+# documents. This may be useful for small projects and may help to save some
+# trees in general.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+COMPACT_LATEX = NO
+
+# The PAPER_TYPE tag can be used to set the paper type that is used by the
+# printer.
+# Possible values are: a4 (210 x 297 mm), letter (8.5 x 11 inches), legal (8.5 x
+# 14 inches) and executive (7.25 x 10.5 inches).
+# The default value is: a4.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+PAPER_TYPE = a4
+
+# The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names
+# that should be included in the LaTeX output. To get the times font for
+# instance you can specify
+# EXTRA_PACKAGES=times
+# If left blank no extra packages will be included.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+EXTRA_PACKAGES =
+
+# The LATEX_HEADER tag can be used to specify a personal LaTeX header for the
+# generated LaTeX document. The header should contain everything until the first
+# chapter. If it is left blank doxygen will generate a standard header. See
+# section "Doxygen usage" for information on how to let doxygen write the
+# default header to a separate file.
+#
+# Note: Only use a user-defined header if you know what you are doing! The
+# following commands have a special meaning inside the header: $title,
+# $datetime, $date, $doxygenversion, $projectname, $projectnumber,
+# $projectbrief, $projectlogo. Doxygen will replace $title with the empy string,
+# for the replacement values of the other commands the user is refered to
+# HTML_HEADER.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_HEADER =
+
+# The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for the
+# generated LaTeX document. The footer should contain everything after the last
+# chapter. If it is left blank doxygen will generate a standard footer. See
+# LATEX_HEADER for more information on how to generate a default footer and what
+# special commands can be used inside the footer.
+#
+# Note: Only use a user-defined footer if you know what you are doing!
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_FOOTER =
+
+# The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or
+# other source files which should be copied to the LATEX_OUTPUT output
+# directory. Note that the files will be copied as-is; there are no commands or
+# markers available.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_EXTRA_FILES =
+
+# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated is
+# prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will
+# contain links (just like the HTML output) instead of page references. This
+# makes the output suitable for online browsing using a PDF viewer.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+PDF_HYPERLINKS = YES
+
+# If the USE_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate
+# the PDF file directly from the LaTeX files. Set this option to YES to get a
+# higher quality PDF documentation.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+USE_PDFLATEX = NO
+
+# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode
+# command to the generated LaTeX files. This will instruct LaTeX to keep running
+# if errors occur, instead of asking the user for help. This option is also used
+# when generating formulas in HTML.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_BATCHMODE = NO
+
+# If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the
+# index chapters (such as File Index, Compound Index, etc.) in the output.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_HIDE_INDICES = NO
+
+# If the LATEX_SOURCE_CODE tag is set to YES then doxygen will include source
+# code with syntax highlighting in the LaTeX output.
+#
+# Note that which sources are shown also depends on other settings such as
+# SOURCE_BROWSER.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_SOURCE_CODE = NO
+
+# The LATEX_BIB_STYLE tag can be used to specify the style to use for the
+# bibliography, e.g. plainnat, or ieeetr. See
+# http://en.wikipedia.org/wiki/BibTeX and \cite for more info.
+# The default value is: plain.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_BIB_STYLE = plain
+
+#---------------------------------------------------------------------------
+# Configuration options related to the RTF output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_RTF tag is set to YES doxygen will generate RTF output. The
+# RTF output is optimized for Word 97 and may not look too pretty with other RTF
+# readers/editors.
+# The default value is: NO.
+
+GENERATE_RTF = NO
+
+# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: rtf.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_OUTPUT = rtf
+
+# If the COMPACT_RTF tag is set to YES doxygen generates more compact RTF
+# documents. This may be useful for small projects and may help to save some
+# trees in general.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+COMPACT_RTF = NO
+
+# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated will
+# contain hyperlink fields. The RTF file will contain links (just like the HTML
+# output) instead of page references. This makes the output suitable for online
+# browsing using Word or some other Word compatible readers that support those
+# fields.
+#
+# Note: WordPad (write) and others do not support links.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_HYPERLINKS = NO
+
+# Load stylesheet definitions from file. Syntax is similar to doxygen's config
+# file, i.e. a series of assignments. You only have to provide replacements,
+# missing definitions are set to their default value.
+#
+# See also section "Doxygen usage" for information on how to generate the
+# default style sheet that doxygen normally uses.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_STYLESHEET_FILE =
+
+# Set optional variables used in the generation of an RTF document. Syntax is
+# similar to doxygen's config file. A template extensions file can be generated
+# using doxygen -e rtf extensionFile.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_EXTENSIONS_FILE =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the man page output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_MAN tag is set to YES doxygen will generate man pages for
+# classes and files.
+# The default value is: NO.
+
+GENERATE_MAN = NO
+
+# The MAN_OUTPUT tag is used to specify where the man pages will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it. A directory man3 will be created inside the directory specified by
+# MAN_OUTPUT.
+# The default directory is: man.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_OUTPUT = man
+
+# The MAN_EXTENSION tag determines the extension that is added to the generated
+# man pages. In case the manual section does not start with a number, the number
+# 3 is prepended. The dot (.) at the beginning of the MAN_EXTENSION tag is
+# optional.
+# The default value is: .3.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_EXTENSION = .3
+
+# The MAN_SUBDIR tag determines the name of the directory created within
+# MAN_OUTPUT in which the man pages are placed. If defaults to man followed by
+# MAN_EXTENSION with the initial . removed.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_SUBDIR =
+
+# If the MAN_LINKS tag is set to YES and doxygen generates man output, then it
+# will generate one additional man file for each entity documented in the real
+# man page(s). These additional files only source the real man page, but without
+# them the man command would be unable to find the correct page.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_LINKS = NO
+
+#---------------------------------------------------------------------------
+# Configuration options related to the XML output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_XML tag is set to YES doxygen will generate an XML file that
+# captures the structure of the code including all documentation.
+# The default value is: NO.
+
+GENERATE_XML = NO
+
+# The XML_OUTPUT tag is used to specify where the XML pages will be put. If a
+# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
+# it.
+# The default directory is: xml.
+# This tag requires that the tag GENERATE_XML is set to YES.
+
+XML_OUTPUT = xml
+
+# If the XML_PROGRAMLISTING tag is set to YES doxygen will dump the program
+# listings (including syntax highlighting and cross-referencing information) to
+# the XML output. Note that enabling this will significantly increase the size
+# of the XML output.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_XML is set to YES.
+
+XML_PROGRAMLISTING = YES
+
+#---------------------------------------------------------------------------
+# Configuration options related to the DOCBOOK output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_DOCBOOK tag is set to YES doxygen will generate Docbook files
+# that can be used to generate PDF.
+# The default value is: NO.
+
+GENERATE_DOCBOOK = NO
+
+# The DOCBOOK_OUTPUT tag is used to specify where the Docbook pages will be put.
+# If a relative path is entered the value of OUTPUT_DIRECTORY will be put in
+# front of it.
+# The default directory is: docbook.
+# This tag requires that the tag GENERATE_DOCBOOK is set to YES.
+
+DOCBOOK_OUTPUT = docbook
+
+# If the DOCBOOK_PROGRAMLISTING tag is set to YES doxygen will include the
+# program listings (including syntax highlighting and cross-referencing
+# information) to the DOCBOOK output. Note that enabling this will significantly
+# increase the size of the DOCBOOK output.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_DOCBOOK is set to YES.
+
+DOCBOOK_PROGRAMLISTING = NO
+
+#---------------------------------------------------------------------------
+# Configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_AUTOGEN_DEF tag is set to YES doxygen will generate an AutoGen
+# Definitions (see http://autogen.sf.net) file that captures the structure of
+# the code including all documentation. Note that this feature is still
+# experimental and incomplete at the moment.
+# The default value is: NO.
+
+GENERATE_AUTOGEN_DEF = NO
+
+#---------------------------------------------------------------------------
+# Configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+
+# If the GENERATE_PERLMOD tag is set to YES doxygen will generate a Perl module
+# file that captures the structure of the code including all documentation.
+#
+# Note that this feature is still experimental and incomplete at the moment.
+# The default value is: NO.
+
+GENERATE_PERLMOD = NO
+
+# If the PERLMOD_LATEX tag is set to YES doxygen will generate the necessary
+# Makefile rules, Perl scripts and LaTeX code to be able to generate PDF and DVI
+# output from the Perl module output.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_PERLMOD is set to YES.
+
+PERLMOD_LATEX = NO
+
+# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be nicely
+# formatted so it can be parsed by a human reader. This is useful if you want to
+# understand what is going on. On the other hand, if this tag is set to NO the
+# size of the Perl module output will be much smaller and Perl will parse it
+# just the same.
+# The default value is: YES.
+# This tag requires that the tag GENERATE_PERLMOD is set to YES.
+
+PERLMOD_PRETTY = YES
+
+# The names of the make variables in the generated doxyrules.make file are
+# prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. This is useful
+# so different doxyrules.make files included by the same Makefile don't
+# overwrite each other's variables.
+# This tag requires that the tag GENERATE_PERLMOD is set to YES.
+
+PERLMOD_MAKEVAR_PREFIX =
+
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor
+#---------------------------------------------------------------------------
+
+# If the ENABLE_PREPROCESSING tag is set to YES doxygen will evaluate all
+# C-preprocessor directives found in the sources and include files.
+# The default value is: YES.
+
+ENABLE_PREPROCESSING = YES
+
+# If the MACRO_EXPANSION tag is set to YES doxygen will expand all macro names
+# in the source code. If set to NO only conditional compilation will be
+# performed. Macro expansion can be done in a controlled way by setting
+# EXPAND_ONLY_PREDEF to YES.
+# The default value is: NO.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+MACRO_EXPANSION = NO
+
+# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then
+# the macro expansion is limited to the macros specified with the PREDEFINED and
+# EXPAND_AS_DEFINED tags.
+# The default value is: NO.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+EXPAND_ONLY_PREDEF = NO
+
+# If the SEARCH_INCLUDES tag is set to YES the includes files in the
+# INCLUDE_PATH will be searched if a #include is found.
+# The default value is: YES.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+SEARCH_INCLUDES = YES
+
+# The INCLUDE_PATH tag can be used to specify one or more directories that
+# contain include files that are not input files but should be processed by the
+# preprocessor.
+# This tag requires that the tag SEARCH_INCLUDES is set to YES.
+
+INCLUDE_PATH =
+
+# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
+# patterns (like *.h and *.hpp) to filter out the header-files in the
+# directories. If left blank, the patterns specified with FILE_PATTERNS will be
+# used.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+INCLUDE_FILE_PATTERNS =
+
+# The PREDEFINED tag can be used to specify one or more macro names that are
+# defined before the preprocessor is started (similar to the -D option of e.g.
+# gcc). The argument of the tag is a list of macros of the form: name or
+# name=definition (no spaces). If the definition and the "=" are omitted, "=1"
+# is assumed. To prevent a macro definition from being undefined via #undef or
+# recursively expanded use the := operator instead of the = operator.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+PREDEFINED = _USE_MPI=1
+
+# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
+# tag can be used to specify a list of macro names that should be expanded. The
+# macro definition that is found in the sources will be used. Use the PREDEFINED
+# tag if you want to use a different macro definition that overrules the
+# definition found in the source code.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+EXPAND_AS_DEFINED =
+
+# If the SKIP_FUNCTION_MACROS tag is set to YES then doxygen's preprocessor will
+# remove all references to function-like macros that are alone on a line, have
+# an all uppercase name, and do not end with a semicolon. Such function macros
+# are typically used for boiler-plate code, and will confuse the parser if not
+# removed.
+# The default value is: YES.
+# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
+
+SKIP_FUNCTION_MACROS = YES
+
+#---------------------------------------------------------------------------
+# Configuration options related to external references
+#---------------------------------------------------------------------------
+
+# The TAGFILES tag can be used to specify one or more tag files. For each tag
+# file the location of the external documentation should be added. The format of
+# a tag file without this location is as follows:
+# TAGFILES = file1 file2 ...
+# Adding location for the tag files is done as follows:
+# TAGFILES = file1=loc1 "file2 = loc2" ...
+# where loc1 and loc2 can be relative or absolute paths or URLs. See the
+# section "Linking to external documentation" for more information about the use
+# of tag files.
+# Note: Each tag file must have a unique name (where the name does NOT include
+# the path). If a tag file is not located in the directory in which doxygen is
+# run, you must also specify the path to the tagfile here.
+
+TAGFILES =
+
+# When a file name is specified after GENERATE_TAGFILE, doxygen will create a
+# tag file that is based on the input files it reads. See section "Linking to
+# external documentation" for more information about the usage of tag files.
+
+GENERATE_TAGFILE =
+
+# If the ALLEXTERNALS tag is set to YES all external class will be listed in the
+# class index. If set to NO only the inherited external classes will be listed.
+# The default value is: NO.
+
+ALLEXTERNALS = NO
+
+# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed in
+# the modules index. If set to NO, only the current project's groups will be
+# listed.
+# The default value is: YES.
+
+EXTERNAL_GROUPS = YES
+
+# If the EXTERNAL_PAGES tag is set to YES all external pages will be listed in
+# the related pages index. If set to NO, only the current project's pages will
+# be listed.
+# The default value is: YES.
+
+EXTERNAL_PAGES = YES
+
+# The PERL_PATH should be the absolute path and name of the perl script
+# interpreter (i.e. the result of 'which perl').
+# The default file (with absolute path) is: /usr/bin/perl.
+
+PERL_PATH = /usr/bin/perl
+
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool
+#---------------------------------------------------------------------------
+
+# If the CLASS_DIAGRAMS tag is set to YES doxygen will generate a class diagram
+# (in HTML and LaTeX) for classes with base or super classes. Setting the tag to
+# NO turns the diagrams off. Note that this option also works with HAVE_DOT
+# disabled, but it is recommended to install and use dot, since it yields more
+# powerful graphs.
+# The default value is: YES.
+
+CLASS_DIAGRAMS = YES
+
+# You can define message sequence charts within doxygen comments using the \msc
+# command. Doxygen will then run the mscgen tool (see:
+# http://www.mcternan.me.uk/mscgen/)) to produce the chart and insert it in the
+# documentation. The MSCGEN_PATH tag allows you to specify the directory where
+# the mscgen tool resides. If left empty the tool is assumed to be found in the
+# default search path.
+
+MSCGEN_PATH =
+
+# You can include diagrams made with dia in doxygen documentation. Doxygen will
+# then run dia to produce the diagram and insert it in the documentation. The
+# DIA_PATH tag allows you to specify the directory where the dia binary resides.
+# If left empty dia is assumed to be found in the default search path.
+
+DIA_PATH =
+
+# If set to YES, the inheritance and collaboration graphs will hide inheritance
+# and usage relations if the target is undocumented or is not a class.
+# The default value is: YES.
+
+HIDE_UNDOC_RELATIONS = NO
+
+# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
+# available from the path. This tool is part of Graphviz (see:
+# http://www.graphviz.org/), a graph visualization toolkit from AT&T and Lucent
+# Bell Labs. The other options in this section have no effect if this option is
+# set to NO
+# The default value is: NO.
+
+HAVE_DOT = YES
+
+# The DOT_NUM_THREADS specifies the number of dot invocations doxygen is allowed
+# to run in parallel. When set to 0 doxygen will base this on the number of
+# processors available in the system. You can set it explicitly to a value
+# larger than 0 to get control over the balance between CPU load and processing
+# speed.
+# Minimum value: 0, maximum value: 32, default value: 0.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_NUM_THREADS = 0
+
+# When you want a differently looking font in the dot files that doxygen
+# generates you can specify the font name using DOT_FONTNAME. You need to make
+# sure dot is able to find the font, which can be done by putting it in a
+# standard location or by setting the DOTFONTPATH environment variable or by
+# setting DOT_FONTPATH to the directory containing the font.
+# The default value is: Helvetica.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_FONTNAME = Helvetica
+
+# The DOT_FONTSIZE tag can be used to set the size (in points) of the font of
+# dot graphs.
+# Minimum value: 4, maximum value: 24, default value: 10.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_FONTSIZE = 10
+
+# By default doxygen will tell dot to use the default font as specified with
+# DOT_FONTNAME. If you specify a different font using DOT_FONTNAME you can set
+# the path where dot can find it using this tag.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_FONTPATH =
+
+# If the CLASS_GRAPH tag is set to YES then doxygen will generate a graph for
+# each documented class showing the direct and indirect inheritance relations.
+# Setting this tag to YES will force the CLASS_DIAGRAMS tag to NO.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+CLASS_GRAPH = YES
+
+# If the COLLABORATION_GRAPH tag is set to YES then doxygen will generate a
+# graph for each documented class showing the direct and indirect implementation
+# dependencies (inheritance, containment, and class references variables) of the
+# class with other documented classes.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+COLLABORATION_GRAPH = YES
+
+# If the GROUP_GRAPHS tag is set to YES then doxygen will generate a graph for
+# groups, showing the direct groups dependencies.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+GROUP_GRAPHS = YES
+
+# If the UML_LOOK tag is set to YES doxygen will generate inheritance and
+# collaboration diagrams in a style similar to the OMG's Unified Modeling
+# Language.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+UML_LOOK = NO
+
+# If the UML_LOOK tag is enabled, the fields and methods are shown inside the
+# class node. If there are many fields or methods and many nodes the graph may
+# become too big to be useful. The UML_LIMIT_NUM_FIELDS threshold limits the
+# number of items for each type to make the size more manageable. Set this to 0
+# for no limit. Note that the threshold may be exceeded by 50% before the limit
+# is enforced. So when you set the threshold to 10, up to 15 fields may appear,
+# but if the number exceeds 15, the total amount of fields shown is limited to
+# 10.
+# Minimum value: 0, maximum value: 100, default value: 10.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+UML_LIMIT_NUM_FIELDS = 10
+
+# If the TEMPLATE_RELATIONS tag is set to YES then the inheritance and
+# collaboration graphs will show the relations between templates and their
+# instances.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+TEMPLATE_RELATIONS = NO
+
+# If the INCLUDE_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are set to
+# YES then doxygen will generate a graph for each documented file showing the
+# direct and indirect include dependencies of the file with other documented
+# files.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+INCLUDE_GRAPH = YES
+
+# If the INCLUDED_BY_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are
+# set to YES then doxygen will generate a graph for each documented file showing
+# the direct and indirect include dependencies of the file with other documented
+# files.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+INCLUDED_BY_GRAPH = YES
+
+# If the CALL_GRAPH tag is set to YES then doxygen will generate a call
+# dependency graph for every global function or class method.
+#
+# Note that enabling this option will significantly increase the time of a run.
+# So in most cases it will be better to enable call graphs for selected
+# functions only using the \callgraph command.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+CALL_GRAPH = NO
+
+# If the CALLER_GRAPH tag is set to YES then doxygen will generate a caller
+# dependency graph for every global function or class method.
+#
+# Note that enabling this option will significantly increase the time of a run.
+# So in most cases it will be better to enable caller graphs for selected
+# functions only using the \callergraph command.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+CALLER_GRAPH = NO
+
+# If the GRAPHICAL_HIERARCHY tag is set to YES then doxygen will graphical
+# hierarchy of all classes instead of a textual one.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+GRAPHICAL_HIERARCHY = YES
+
+# If the DIRECTORY_GRAPH tag is set to YES then doxygen will show the
+# dependencies a directory has on other directories in a graphical way. The
+# dependency relations are determined by the #include relations between the
+# files in the directories.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DIRECTORY_GRAPH = NO
+
+# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
+# generated by dot.
+# Note: If you choose svg you need to set HTML_FILE_EXTENSION to xhtml in order
+# to make the SVG files visible in IE 9+ (other browsers do not have this
+# requirement).
+# Possible values are: png, jpg, gif and svg.
+# The default value is: png.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_IMAGE_FORMAT = png
+
+# If DOT_IMAGE_FORMAT is set to svg, then this option can be set to YES to
+# enable generation of interactive SVG images that allow zooming and panning.
+#
+# Note that this requires a modern browser other than Internet Explorer. Tested
+# and working are Firefox, Chrome, Safari, and Opera.
+# Note: For IE 9+ you need to set HTML_FILE_EXTENSION to xhtml in order to make
+# the SVG files visible. Older versions of IE do not have SVG support.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+INTERACTIVE_SVG = NO
+
+# The DOT_PATH tag can be used to specify the path where the dot tool can be
+# found. If left blank, it is assumed the dot tool can be found in the path.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_PATH =
+
+# The DOTFILE_DIRS tag can be used to specify one or more directories that
+# contain dot files that are included in the documentation (see the \dotfile
+# command).
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOTFILE_DIRS =
+
+# The MSCFILE_DIRS tag can be used to specify one or more directories that
+# contain msc files that are included in the documentation (see the \mscfile
+# command).
+
+MSCFILE_DIRS =
+
+# The DIAFILE_DIRS tag can be used to specify one or more directories that
+# contain dia files that are included in the documentation (see the \diafile
+# command).
+
+DIAFILE_DIRS =
+
+# When using plantuml, the PLANTUML_JAR_PATH tag should be used to specify the
+# path where java can find the plantuml.jar file. If left blank, it is assumed
+# PlantUML is not used or called during a preprocessing step. Doxygen will
+# generate a warning when it encounters a \startuml command in this case and
+# will not generate output for the diagram.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+PLANTUML_JAR_PATH =
+
+# The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of nodes
+# that will be shown in the graph. If the number of nodes in a graph becomes
+# larger than this value, doxygen will truncate the graph, which is visualized
+# by representing a node as a red box. Note that doxygen if the number of direct
+# children of the root node in a graph is already larger than
+# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note that
+# the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.
+# Minimum value: 0, maximum value: 10000, default value: 50.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_GRAPH_MAX_NODES = 20
+
+# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the graphs
+# generated by dot. A depth value of 3 means that only nodes reachable from the
+# root by following a path via at most 3 edges will be shown. Nodes that lay
+# further from the root node will be omitted. Note that setting this option to 1
+# or 2 may greatly reduce the computation time needed for large code bases. Also
+# note that the size of a graph can be further restricted by
+# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction.
+# Minimum value: 0, maximum value: 1000, default value: 0.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+MAX_DOT_GRAPH_DEPTH = 2
+
+# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent
+# background. This is disabled by default, because dot on Windows does not seem
+# to support this out of the box.
+#
+# Warning: Depending on the platform used, enabling this option may lead to
+# badly anti-aliased labels on the edges of a graph (i.e. they become hard to
+# read).
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_TRANSPARENT = YES
+
+# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output
+# files in one run (i.e. multiple -o and -T options on the command line). This
+# makes dot run faster, but since only newer versions of dot (>1.8.10) support
+# this, this feature is disabled by default.
+# The default value is: NO.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_MULTI_TARGETS = YES
+
+# If the GENERATE_LEGEND tag is set to YES doxygen will generate a legend page
+# explaining the meaning of the various boxes and arrows in the dot generated
+# graphs.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+GENERATE_LEGEND = YES
+
+# If the DOT_CLEANUP tag is set to YES doxygen will remove the intermediate dot
+# files that are used to generate the various graphs.
+# The default value is: YES.
+# This tag requires that the tag HAVE_DOT is set to YES.
+
+DOT_CLEANUP = YES
diff --git a/doc/doxygen_project_name.conf b/doc/doxygen_project_name.conf
new file mode 100644
index 000000000..183aad81d
--- /dev/null
+++ b/doc/doxygen_project_name.conf
@@ -0,0 +1 @@
+PROJECT_NAME = "WOLF"
diff --git a/doc/images/tesselationExample.png b/doc/images/tesselationExample.png
new file mode 100644
index 0000000000000000000000000000000000000000..21801400c2257327da79b6d338e09889cc37ca20
GIT binary patch
literal 29304
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
J?49xF{|8;`kZ%A0
literal 0
HcmV?d00001
diff --git a/doc/images/tesselationGrid.png b/doc/images/tesselationGrid.png
new file mode 100644
index 0000000000000000000000000000000000000000..6ce0ee485b9b308bbcc836827ea9de3f71eb05f8
GIT binary patch
literal 18896
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�@;Y?bM%S!!Cz2o_xJr)73ao9;)`Wwb%
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
Dk{Iiq
literal 0
HcmV?d00001
diff --git a/doc/images/wolf-120.png b/doc/images/wolf-120.png
new file mode 100644
index 0000000000000000000000000000000000000000..8ba161e383c22deda95eb5f950f9fea2baff418d
GIT binary patch
literal 1432
zcmeAS@N?(olHy`uVBq!ia0vp^6(G#P1SGeyEo=o+jKx9jP7LeL$-D$|I14-?iy0X7
zltGxWVyS%@P*AbNHKHUqKdq!Zu_%?ny(qCDBQx1KKd&scs3f&WLBlhzBsE8~y#1FX
z0|Tpor;B4q#hf>DU;AG!mpJ-2`deD$rn816r(7rTCN11{!^yRfM|Xc*&zhNeXB^v^
zy`migSMGIKX<*hi!yzC&%|!JC)8j?XIxo(g*`%{O<B#^X$N!p^?-xJcVXglB>Gvm=
z&nF+~R`cEd*LP*c?fTdU|CO4;gdDXy7ff}z;H8wID!645N0cYaS`}=<UJK0S?7Wuf
zFLgiO;+N`{o_D9_(`)(u`k%fTHf}7AKSe{F3}u<T7OeL<D>7wIbWEV?mvfuA{1-gE
z_UBdao2CmDJseG+v{$qwS+PuU@Q?p1cKB4T-@?;6+n!BJD0_JC>`v8%A0-4?o`wf-
z9xdSzFmV*#!YK$OO&n(nfJhYXm(#3O&wiD=J`H_;bB@#do7voRvi{eVCYKeWxF*fv
z|JN_)f4}}N_v9V--i<#MEKMTv?uI`t;K<z=ZZ0wJ+`fO8FB&^NHdNv`wSIw6*TQ)<
z+-=GGgkH2B{rT_n#fU#^E_7b`8N60q*7RG{bmxrlxy9?Remb^JHvio{O%plgrUiev
zv=&OdI=MZ;;+b}1TvXhFlUFV@TzKiT$MnXg`<d$tEnC*vK3KCQRP>$Z&A>1%bUh${
z;XwJJ7fx$;e|)lY;lmjhW=>4G{d|6yb<Vk4f1R3}QsYw{Julu~dK8P(-`vTmzAnCS
z-i8Yg_q}kRKgXirMCpfuxfj~+*+&G2CvS|_y_$4;ZHI!!{w6PtwyICM5`90t7N{>v
z%aZCneDAT-_3Hlm2Vc#9^6b28cewhDFvpM2MoRB$)*a9Y)0bmP{?W2hpK}IdZRM|3
zuUBk8_<!M@-hIh=`N47De)K*|%a3zYxv#A;?YaQZ@tP*J3>@giTCS?3tYbGbuKfS~
zbNK~cx%+~LYmZoHZGV`3O58-La;}4_$m#5k;LpjIZd#XH?K(VhpWVjuCEr`D4zHd2
z&}`xEMF+1v@SK1A?RQho-s9+g2@emy?7Z^g#GV_|FC7+t+&u9|Ldc7hUE8gNj@)k$
z|Id?hEZIe1O1z`0h_mfaF`z?LFKBCPuMAO|?AdK=V__oT-Ijc^<H7;~uI*2`rJzYN
zz<(d>VZ-?gIA`HNRjZrgqJAlg?QWQyq%M52n7Q+VgObvhqgS{u*d2cRT?$K7rJtYo
ztmyUZ*_Ip4H{Hyh>GS=BNB@QR-mj%4wK0iX!*1nb>d6qU`t<qMkBE#<v*Q*nUq8q8
zu3*L6xv{sqyIbMDx~#Z><=035^8NpeN-Fn+zgT%vd_nyE*pPrIMEaY-#|VlWGet-Y
z2`ho43YlBC)4{%KhmF;pzC<VgK6m@<&wDrhT^r8Ljb_o$&-d&1%#MwpEo`;juKxA6
zt^X?iI2j>w2hgT}F<bEzEZEAMe~b(a|Nk>H%z5Z|Y~tES!oY%*!PC{xWt~$(696-q
BiLd|w
literal 0
HcmV?d00001
diff --git a/doc/images/wolf-500.png b/doc/images/wolf-500.png
new file mode 100644
index 0000000000000000000000000000000000000000..4e59fa03457dd3f9a697384bca7896dc0f207245
GIT binary patch
literal 5920
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
Zl&#(`RRgiL!LnPF{}!BggI83}p8>fr0jB@}
literal 0
HcmV?d00001
diff --git a/doc/images/wolf-title-100.png b/doc/images/wolf-title-100.png
new file mode 100644
index 0000000000000000000000000000000000000000..b27ba0260cc1c1bfc81e5326a513a04cadbcc6d8
GIT binary patch
literal 4132
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
literal 0
HcmV?d00001
diff --git a/doc/images/wolf-title-120.png b/doc/images/wolf-title-120.png
new file mode 100644
index 0000000000000000000000000000000000000000..ee0c4b6a0d08657ae31b01ad74f55f5cf3a55791
GIT binary patch
literal 2762
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
Uq&)u3bAc4XI2=aTqXOvv1&v4f)c^nh
literal 0
HcmV?d00001
diff --git a/doc/images/wolf-title-140.png b/doc/images/wolf-title-140.png
new file mode 100644
index 0000000000000000000000000000000000000000..0398db3e5846b983854086c55973b1a7190b85c9
GIT binary patch
literal 3017
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
NC_Q7{BAwg!{sq44dRPDe
literal 0
HcmV?d00001
diff --git a/doc/images/wolf-title-500.png b/doc/images/wolf-title-500.png
new file mode 100644
index 0000000000000000000000000000000000000000..fd9b4f1483311431c3ca77b7e3c8a3b7bd3a6954
GIT binary patch
literal 7326
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
literal 0
HcmV?d00001
diff --git a/doc/main.dox b/doc/main.dox
new file mode 100644
index 000000000..efde8f91e
--- /dev/null
+++ b/doc/main.dox
@@ -0,0 +1,29 @@
+// EDIT CAPS TEXTS
+/*! \mainpage WOLF
+
+ WOLF (Windowed Localization Frames) is a C++ framework for state estimation based on factor graphs.
+
+ This is the Doxygen documentation of the **WOLF core** library.
+
+ If you are looking for one of the following:
+
+ - full documentation
+ - installation instructions
+ - access to the repositories
+ - WOLF plugins
+ - ROS packages
+
+ please visit the main WOLF page at http://www.iri.upc.edu/wolf.
+
+ WOLF is copyright 2015--2022
+
+ - Joan SolÃ
+ - Joan Vallvé
+ - Joaquim Casals,
+ - Jérémie Deray,
+ - Médéric Fourmy,
+ - Dinesh Atchuthan,
+ - Andreu Corominas-Murtra
+
+ at IRI-CSIC-UPC.
+*/
diff --git a/include/vision/processor/active_search.h b/include/vision/processor/active_search.h
new file mode 100644
index 000000000..136bfeda3
--- /dev/null
+++ b/include/vision/processor/active_search.h
@@ -0,0 +1,342 @@
+/**
+ * \file active_search.h
+ *
+ * Active search detection and matching for points.
+ *
+ * \date 10/04/2016
+ * \author jsola, dinesh
+ */
+
+#ifndef ACTIVESEARCH_H_
+#define ACTIVESEARCH_H_
+
+// Wolf includes
+#include "wolf.h"
+
+//OpenCV includes
+#include <opencv2/core/core.hpp>
+#include "opencv2/features2d/features2d.hpp"
+
+namespace wolf{
+
+ /**
+ * \brief Active search tesselation grid.
+ *
+ * \author jsola, dinesh
+ *
+ * This class implements a tesselation grid for achieving active search
+ * behavior in landmark initialization.
+ *
+ * The grid defines a set of cells in the image.
+ * The idea is to count the number of projected landmarks per grid cell,
+ * and use one randomly chosen cell that is empty
+ * for feature detection and landmark initialization.
+ * This guarantees that the system will automatically populate all the
+ * regions of the image.
+ *
+ * The feature density can be controlled by
+ * adjusting the grid's number of cells.
+ * Typically, use grids of 5x5 to 18x12 cells. Try to make reasonably square cells.
+ *
+ * This class implements a few interesting features:
+ * - The grid can be randomly re-positioned at each frame to avoid dead zones at the cell edges.
+ * - Only the inner cells are activated for feature detection to avoid reaching the image edges.
+ * - The region of interest (ROI) associated with a particular cell is shrinked with a parametrizable amount
+ * to guarantee a minimum 'separation' between existing and new features.
+ * - The region of interest is ensured to lie at a distance from the image boundaries, defined by the parameter 'margin'.
+ *
+ * The blue and green grids in the figure below represent the grid
+ * at two different offsets, corresponding to two different frames.
+ *
+ * \image html tesselationGrid.png "The tesselation grid used for active feature detection and initialization"
+ *
+ * This second figure shows a typical situation that we use to explain the basic mechanism.
+ *
+ * \image html tesselationExample.png "A typical configuration of the tesselation grid"
+ *
+ * Observe the figure and use the following facts as an operation guide:
+ * - The grid is offset by a fraction of a cell size.
+ * - use renew() at each frame to clear the grid and set a new offset.
+ * - Projected landmarks are represented by red dots.
+ * - After projection, use hitCell() to add a new dot to the grid.
+ * - Cells with projected landmarks inside are 'occupied'.
+ * - Only the inner cells (thick blue rectangle) are considered for Region of Interest (ROI) extraction.
+ * - One cell is chosen randomly among those that are empty.
+ * - Use pickRoi() to obtain an empty ROI for initialization.
+ * - The ROI is smaller than the cell to guarantee a minimum feature separation.
+ * - Use the optional 'separation' parameter at construction time to control this separation.
+ * - A new feature is to be be searched inside this ROI.
+ * - If there is no feature found in this ROI, call blockCell() function to avoid searching in this area again.
+ * - If you need to search more than one feature per frame, proceed like this:
+ * - Call pickRoi().
+ * - Try to detect a Feature in ROI.
+ * - If successful detection
+ * - add the detected pixel with hitCell().
+ * - Else
+ * - block the cell with blockCell().
+ * - Repeat these steps for each feature to be searched.
+ *
+ * We include here a schematic active-search pseudo-code algorithm to illustrate its operation:
+ * \code
+ * // Init necessary objects
+ * ActiveSearch activeSearch;
+ * ActiveSearchGrid grid(640, 480, 4, 4, 10); // Construction with 10 pixels separation.
+ *
+ * // We start projecting everybody
+ * for (obs = begin(); obs != end(); obs++) // loop observations
+ * {
+ * obs->project();
+ * if (obs->isVisible())
+ * grid.hiCell(obs->expectation.x()); // add only visible landmarks
+ * }
+ *
+ * // Then we process the selected observations
+ * activeSearch.selectObs(); // select interesting features
+ * for (activeSearch.selectedObs); // loop selected obs
+ * obs.process(); // process observation
+ *
+ * // Now we go to initialization
+ * grid.pickRoi(roi); // roi is now region of interest
+ * if (detectFeature(roi)) // detect inside ROI
+ * initLandmark(); // initialize only if successful detection
+ * \endcode
+ *
+ */
+class ActiveSearchGrid {
+
+ private:
+ Eigen::Vector2i img_size_;
+ Eigen::Vector2i grid_size_;
+ Eigen::Vector2i cell_size_;
+ Eigen::Vector2i offset_;
+ Eigen::Vector2i roi_coordinates_;
+ Eigen::MatrixXi projections_count_;
+ Eigen::MatrixXi empty_cells_tile_tmp_;
+ int separation_;
+ int margin_;
+
+ public:
+ EIGEN_MAKE_ALIGNED_OPERATOR_NEW; // to guarantee alignment (see http://eigen.tuxfamily.org/dox-devel/group__TopicStructHavingEigenMembers.html)
+
+ /**
+ * \brief Void constructor
+ *
+ * Calling this constructor requires the use of setParameters() to configure.
+ */
+ ActiveSearchGrid();
+
+ /**
+ * \brief Constructor.
+ * \param _img_size_h horizontal image size, in pixels.
+ * \param _img_size_v vertical image size.
+ * \param _n_cells_h horizontal number of cells per image width.
+ * \param _n_cells_v vertical number of cells per image height.
+ * \param _separation minimum separation between existing and new points.
+ * \param _margin minimum separation to the edge of the image
+ */
+ ActiveSearchGrid(const int & _img_size_h, const int & _img_size_v,
+ const int & _n_cells_h, const int & _n_cells_v,
+ const int & _margin = 0, const int & _separation = 0);
+
+ /**
+ * \brief Function to set the parameters of the active search grid
+ * \param _img_size_h horizontal image size, in pixels.
+ * \param _img_size_v vertical image size.
+ * \param _n_cells_h horizontal number of cells per image width.
+ * \param _n_cells_v vertical number of cells per image height.
+ * \param _separation minimum separation between existing and new points.
+ * \param _margin minimum separation to the edge of the image
+ */
+ void setup(const int & _img_size_h, const int & _img_size_v,
+ const int & _n_cells_h, const int & _n_cells_v,
+ const int & _margin = 0, const int & _separation = 0);
+
+ /**
+ * \brief Re-set the image size
+ * \param _img_size_h horizontal image size, in pixels.
+ * \param _img_size_v vertical image size.
+ */
+ void resizeImage(unsigned int _img_size_h, unsigned int _img_size_v);
+
+ /** \brief Clear grid.
+ *
+ * Sets all cell counters to zero.
+ */
+ void clear();
+
+ /**
+ * \brief Clear grid and position it at a new random location.
+ *
+ * Sets all cell counters to zero and sets a new random grid position.
+ */
+ void renew();
+
+ /**
+ * \brief Add a projected pixel to the grid.
+ * \param _x the x-coordinate of the pixel to add.
+ * \param _y the y-coordinate of the pixel to add.
+ */
+ template<typename Scalar>
+ void hitCell(const Scalar _x, const Scalar _y);
+
+ /**
+ * \brief Add a projected pixel to the grid.
+ * \param _pix the pixel to add as an Eigen 2-vector with any Scalar type.
+ */
+ template<typename Scalar>
+ void hitCell(const Eigen::Matrix<Scalar, 2, 1>& _pix);
+
+ /**
+ * \brief Add a projected pixel to the grid.
+ * \param _pix the pixel to add as a cv::KeyPoint.
+ */
+ void hitCell(const cv::KeyPoint& _pix);
+
+ /**
+ * \brief Get ROI of a random empty cell.
+ * \param _roi the resulting ROI
+ * \return true if ROI exists.
+ */
+ bool pickRoi(cv::Rect & _roi);
+
+ /**
+ * \brief Call this after pickRoi if no point was found in the roi
+ * in order to avoid searching again in it.
+ * \param _roi the ROI where nothing was found
+ */
+ void blockCell(const cv::Rect & _roi);
+
+
+ private:
+ /**
+ * \brief Get cell corresponding to pixel
+ */
+ template<typename Scalar>
+ Eigen::Vector2i coords2cell(const Scalar _x, const Scalar _y);
+
+ /**
+ * \brief Get cell origin (exact pixel)
+ */
+ Eigen::Vector2i cellOrigin(const Eigen::Vector2i & _cell);
+
+ /**
+ * \brief Get cell center (can be decimal if size of cell is an odd number of pixels)
+ */
+ Eigen::Vector2i cellCenter(const Eigen::Vector2i& _cell);
+
+ /**
+ * \brief Get one random empty cell
+ */
+ bool pickEmptyCell(Eigen::Vector2i & _cell);
+
+ /**
+ * \brief Get the region of interest, reduced by a margin.
+ */
+ void cell2roi(const Eigen::Vector2i & _cell, cv::Rect& _roi);
+
+};
+
+inline void ActiveSearchGrid::clear()
+{
+ projections_count_.setZero();
+}
+
+inline void ActiveSearchGrid::renew()
+{
+ offset_(0) = -(margin_ + rand() % (cell_size_(0) - 2 * margin_)); // from -margin to -(cellSize(0)-margin)
+ offset_(1) = -(margin_ + rand() % (cell_size_(1) - 2 * margin_)); // from -margin to -(cellSize(0)-margin)
+ clear();
+}
+
+inline void ActiveSearchGrid::hitCell(const cv::KeyPoint& _pix)
+{
+ hitCell(_pix.pt.x, _pix.pt.y);
+}
+
+/**
+ * \brief Add a projected pixel to the grid.
+ * \param _pix the pixel to add as an Eigen 2-vector.
+ */
+template<typename Scalar>
+inline void ActiveSearchGrid::hitCell(const Eigen::Matrix<Scalar, 2, 1>& _pix)
+{
+ hitCell(_pix(0), _pix(1));
+}
+
+/**
+ * \brief Add a projected pixel to the grid.
+ * \param _x the x-coordinate of the pixel to add.
+ * \param _y the y-coordinate of the pixel to add.
+ */
+template<typename Scalar>
+inline void ActiveSearchGrid::hitCell(const Scalar _x, const Scalar _y)
+{
+ Eigen::Vector2i cell = coords2cell(_x, _y);
+ if (cell(0) < 0 || cell(1) < 0 || cell(0) >= grid_size_(0) || cell(1) >= grid_size_(1))
+ return;
+
+ if (projections_count_(cell(0), cell(1)) == -1)
+ projections_count_(cell(0), cell(1)) = 0;
+
+ projections_count_(cell(0), cell(1))++;
+}
+
+/**
+ * Get cell corresponding to pixel
+ */
+template<typename Scalar>
+inline Eigen::Vector2i ActiveSearchGrid::coords2cell(const Scalar _x, const Scalar _y)
+{
+ Eigen::Vector2i cell;
+ cell(0) = (_x - offset_(0)) / cell_size_(0);
+ cell(1) = (_y - offset_(1)) / cell_size_(1);
+ return cell;
+}
+
+inline Eigen::Vector2i ActiveSearchGrid::cellCenter(const Eigen::Vector2i& _cell)
+{
+ return cellOrigin(_cell) + cell_size_ / 2;
+}
+
+//#if 0
+// /**
+// * Class for active search algorithms.
+// * \ingroup rtslam
+// */
+// class ActiveSearch {
+// public:
+// vecb visibleObs;
+// vecb selectedObs;
+
+// /**
+// * Project all landmarks to the sensor space.
+// *
+// * This function also computes visibility and information gain
+// * for each observation.
+// * The result is a map of visible observations,
+// * ordered from least to most expected information gain.
+// *
+// * \param senPtr pointer to the sensor under consideration.
+// * \return a map of all observations that are visible from the sensor, ordered according to the information gain.
+// */
+// std::map<double, observation_ptr_t> projectAll(const sensor_ptr_t & senPtr, Size & numVis);
+
+// /**
+// * Predict observed appearance.
+// * This function predicts the appearance of the perceived landmark.
+// * It does so by computing the appearance of the landmark descriptor from the current sensor position.
+// * The result of this operation is an updated observation.
+// * \param obsPtr a pointer to the observation.
+// */
+// void predictApp(const observation_ptr_t & obsPtr);
+
+// /**
+// * Scan search region for match.
+// */
+// void scanObs(const observation_ptr_t & obsPtr, const image::ConvexRoi & roi);
+// };
+//#endif
+
+}
+
+#endif /* ACTIVESEARCH_H_ */
diff --git a/src/processor/active_search.cpp b/src/processor/active_search.cpp
new file mode 100644
index 000000000..90ecc355a
--- /dev/null
+++ b/src/processor/active_search.cpp
@@ -0,0 +1,160 @@
+/**
+ * \file active_search.cpp
+ * \date 10/04/2016
+ * \author jsola, dinesh
+ */
+
+#include "active_search.h"
+
+#include <iostream>
+
+namespace wolf{
+
+// CLASS ActiveSearchGrid
+ActiveSearchGrid::ActiveSearchGrid() : separation_(0), margin_(0) {}
+
+ActiveSearchGrid::ActiveSearchGrid(const int & _img_size_h, const int & _img_size_v, const int & _n_cells_h,
+ const int & _n_cells_v, const int & _margin, const int & _separation)
+{
+ setup(_img_size_h, _img_size_v, _n_cells_h, _n_cells_v, _margin, _separation);
+}
+
+void ActiveSearchGrid::setup(const int & _img_size_h, const int & _img_size_v,
+ const int & _n_cells_h, const int & _n_cells_v,
+ const int & _margin, const int & _separation)
+ {
+ separation_ = _separation;
+ margin_ = _margin;
+
+ projections_count_.resize(_n_cells_h + 1, _n_cells_v + 1);
+ empty_cells_tile_tmp_.resize(2, (_n_cells_h + 1) * (_n_cells_v + 1));
+ img_size_(0) = _img_size_h;
+ img_size_(1) = _img_size_v;
+ grid_size_(0) = _n_cells_h + 1;
+ grid_size_(1) = _n_cells_v + 1;
+ cell_size_(0) = _img_size_h / _n_cells_h;
+ cell_size_(1) = _img_size_v / _n_cells_v;
+ offset_ = -cell_size_ / 2;
+ renew();
+}
+
+void ActiveSearchGrid::resizeImage(unsigned int _img_size_h, unsigned int _img_size_v)
+{
+ img_size_(0) = _img_size_h;
+ img_size_(1) = _img_size_v;
+ cell_size_(0) = _img_size_h / (grid_size_(0) - 1);
+ cell_size_(1) = _img_size_v / (grid_size_(1) - 1);
+ offset_ = -cell_size_ / 2;
+ renew();
+}
+
+
+// Functions to fill in cells
+bool ActiveSearchGrid::pickEmptyCell(Eigen::Vector2i & _cell) {
+ int k = 0;
+ Eigen::Vector2i cell0;
+ for (int i = 1; i < grid_size_(0) - 1; i++) {
+ for (int j = 1; j < grid_size_(1) - 1; j++) {
+ cell0(0) = i;
+ cell0(1) = j;
+ if (projections_count_(i, j) == 0) {
+ empty_cells_tile_tmp_(0,k) = i; //may be done in a better way
+ empty_cells_tile_tmp_(1,k) = j;
+ k++;
+ }
+ }
+ }
+ if (k > 0) { // number of empty inner cells
+ int idx = rand() % k; // between 0 and k-1
+ _cell(0) = empty_cells_tile_tmp_(0, idx);
+ _cell(1) = empty_cells_tile_tmp_(1, idx);
+ return true;
+ }
+ else
+ return false;
+}
+
+/*
+ * Get cell origin (exact pixel)
+ */
+Eigen::Vector2i ActiveSearchGrid::cellOrigin(const Eigen::Vector2i & _cell) {
+ Eigen::Vector2i cell0;
+ cell0(0) = offset_(0) + cell_size_(0) * _cell(0);
+ cell0(1) = offset_(1) + cell_size_(1) * _cell(1);
+ return cell0;
+}
+
+void ActiveSearchGrid::cell2roi(const Eigen::Vector2i & _cell, cv::Rect & _roi) {
+ roi_coordinates_ = cellOrigin(_cell);
+ roi_coordinates_(0) += separation_;
+ roi_coordinates_(1) += separation_;
+ Eigen::Vector2i roi_size = cell_size_;
+ roi_size(0) -= 2 * separation_;
+ roi_size(1) -= 2 * separation_;
+ _roi.x = roi_coordinates_(0);
+ _roi.y = roi_coordinates_(1);
+ _roi.width = roi_size(0);
+ _roi.height = roi_size(1);
+}
+
+
+bool ActiveSearchGrid::pickRoi(cv::Rect & _roi) {
+
+ Eigen::Vector2i cell;
+ if (pickEmptyCell(cell)) {
+ cell2roi(cell, _roi);
+ return true;
+ }
+ else
+ return false;
+}
+
+void ActiveSearchGrid::blockCell(const cv::Rect & _roi)
+{
+ Eigen::Vector2i pix;
+ pix(0) = _roi.x+_roi.width/2;
+ pix(1) = _roi.y+_roi.height/2;
+ Eigen::Vector2i cell = coords2cell(pix(0), pix(1));
+ projections_count_(cell(0), cell(1)) = -1;
+}
+
+/*
+#if 0
+ ////////////////////////////////////////////////////////
+ // ACTIVE SEARCH ALGORITHMS
+ ////////////////////////////////////////////////////////
+
+ map<double, observation_ptr_t> ActiveSearch::projectAll(const sensor_ptr_t & senPtr, Size & numVis) {
+ map<double, observation_ptr_t> visObs;
+ for (SensorAbstract::DataManagerList::iterator dmaIter = senPtr->dataManagerList().begin(); dmaIter!=senPtr->dataManagerList().end(); dmaIter++ )
+ {
+ data_manager_ptr_t dmaPtr = *dmaIter;
+ for (DataManagerAbstract::ObservationList::iterator obsIter = dmaPtr->observationList().begin(); obsIter
+ != dmaPtr->observationList().end(); obsIter++) {
+ observation_ptr_t obsPtr = *obsIter;
+ obsPtr->project();
+ obsPtr->predictVisibility();
+ if (obsPtr->isVisible()) {
+ obsPtr->predictInfoGain();
+ visObs[obsPtr->expectation.infoGain] = obsPtr; // this automatically sorts the observations ! ;-)
+ }
+ }
+ }
+ return visObs;
+ }
+
+ void ActiveSearch::predictApp(const observation_ptr_t & obsPtr) {
+
+ // Get landmark descriptor
+ landmark_ptr_t lmkPtr = obsPtr->landmarkPtr();
+
+ // Get the sensor's current global pose
+ vec7 senPose = obsPtr->sensorPtr()->globalPose();
+ }
+
+ void ActiveSearch::scanObs(const observation_ptr_t & obsPtr, const image::ConvexRoi & roi) {
+ }
+#endif
+*/
+
+}
--
GitLab