doc/groups.dox
author ladanyi
Thu, 26 May 2005 13:21:47 +0000
changeset 1437 2a3f3448ced1
parent 1401 9588dcef6793
child 1536 308150155bb5
permissions -rw-r--r--
- test both lp implementations
- commented out the checking of LpCplex because it fails
alpar@814
     1
alpar@678
     2
/**
alpar@678
     3
@defgroup datas Data Structures
alpar@921
     4
This group describes the several graph structures implemented in LEMON.
alpar@678
     5
*/
alpar@430
     6
alpar@678
     7
/**
alpar@678
     8
@defgroup graphs Graph Structures
alpar@678
     9
@ingroup datas
alpar@921
    10
\brief Graph structures implemented in LEMON.
alpar@430
    11
marci@1172
    12
The implementation of combinatorial algorithms heavily relies on 
marci@1172
    13
efficient graph implementations. LEMON offers data structures which are 
marci@1172
    14
planned to be easily used in an experimental phase of implementation studies, 
marci@1172
    15
and thereafter the program code can be made efficient by small modifications. 
alpar@430
    16
marci@1172
    17
The most efficient implementation of diverse applications require the usage of different physical graph implementations. These differences appear in the size of 
marci@1172
    18
graph we require to handle, memory or time usage limitations or in 
marci@1172
    19
the set of operations through which the graph can be accessed. 
marci@1172
    20
LEMON provides several physical graph structures to meet the 
marci@1172
    21
diverging requirements of the possible users. 
marci@1172
    22
In order to save on running time or on memory usage, some structures may 
marci@1172
    23
fail to provide some graph features like edge or node deletion.
marci@1172
    24
marci@1172
    25
Alteration of standard containers need a very limited number of 
marci@1172
    26
operations, these together satisfy the everyday requirements. 
marci@1172
    27
In the case of graph strutures, different operations are needed which do 
marci@1172
    28
not alter the physical graph, but gives an other view. If some nodes or 
marci@1172
    29
edges have to be hidden or the reverse oriented graph have to be used, then 
marci@1172
    30
this is the case. It also may happen that in a flow implemenation 
marci@1172
    31
the residual graph can be accessed by an other algorithm, or a node-set 
marci@1172
    32
is to be shrunk for an other algorithm. 
marci@1172
    33
LEMON also provides a variety of graphs for these requirements called 
alpar@1401
    34
\ref graph_adaptors "graph adaptors". Adaptors cannot be used alone but only 
marci@1172
    35
in conjunction with other graph representation. 
alpar@430
    36
alpar@678
    37
You are free to use the graph structure that fit your requirements
alpar@678
    38
the best, most graph algorithms and auxiliary data structures can be used
marci@1172
    39
with any graph structures. 
alpar@678
    40
*/
alpar@430
    41
alpar@678
    42
/**
alpar@1043
    43
@defgroup maps Maps 
alpar@1043
    44
@ingroup datas
alpar@1043
    45
\brief Some special purpose map to make life easier.
alpar@1043
    46
alpar@1043
    47
LEMON provides several special maps that e.g. combine
alpar@1043
    48
new maps from existing ones.
alpar@1043
    49
*/
alpar@1043
    50
alpar@1402
    51
alpar@1402
    52
/**
alpar@1402
    53
@defgroup graph_maps Graph Maps 
alpar@1402
    54
@ingroup maps
alpar@1402
    55
\brief Special Graph-Related Maps.
alpar@1402
    56
alpar@1402
    57
These maps are specifically designed to assign values to the nodes and edges of
alpar@1402
    58
graphs.
alpar@1402
    59
*/
alpar@1402
    60
alpar@1402
    61
alpar@1402
    62
/**
alpar@1402
    63
\defgroup map_adaptors Map Adaptors
alpar@1402
    64
\ingroup maps
alpar@1402
    65
\brief Tools to create new maps from existing ones
alpar@1402
    66
alpar@1402
    67
Map adaptors are used to create "implicit" maps from other maps.
alpar@1402
    68
alpar@1402
    69
Most of them are \ref concept::ReadMap "ReadMap"s. They can
alpar@1402
    70
make arithmetic oprerations between one or two maps (negation, scalig,
alpar@1402
    71
addition, multiplication etc.) or e.g. convert a map to another one
alpar@1402
    72
of different Value type.
alpar@1402
    73
*/
alpar@1402
    74
alpar@1043
    75
/**
alpar@678
    76
@defgroup auxdat Auxiliary Data Structures
alpar@678
    77
@ingroup datas
alpar@921
    78
\brief Some data structures implemented in LEMON.
alpar@406
    79
alpar@921
    80
This group describes the data structures implemented in LEMON in
alpar@678
    81
order to make it easier to implement combinatorial algorithms.
alpar@678
    82
*/
alpar@406
    83
alpar@678
    84
/**
alpar@785
    85
@defgroup graphmapfactory Tools to Make It Easier to Make Graph Maps
alpar@785
    86
@ingroup auxdat
alpar@785
    87
\brief Tools to Make It Easier to Make Graph Maps.
alpar@785
    88
alpar@785
    89
This group describes the tools that makes it easier to make graph maps that
alpar@785
    90
dynamically update with the graph changes.
alpar@785
    91
*/
alpar@785
    92
alpar@785
    93
/**
alpar@678
    94
@defgroup galgs Graph Algorithms
alpar@678
    95
\brief This group describes the several graph algorithms
alpar@921
    96
implemented in LEMON.
alpar@947
    97
alpar@947
    98
This group describes the several graph algorithms
alpar@947
    99
implemented in LEMON.
alpar@947
   100
*/
alpar@947
   101
alpar@947
   102
/**
alpar@947
   103
@defgroup gutils General Graph Utilities
alpar@947
   104
\brief This group describes some simple general graph utilities.
alpar@947
   105
@ingroup galgs
alpar@947
   106
alpar@947
   107
This group describes some simple general graph utilities.
alpar@678
   108
*/
alpar@678
   109
alpar@678
   110
/**
alpar@1329
   111
@defgroup gen_opt_group General Optimization Tools
alpar@1329
   112
\brief This group describes some general optimization frameworks
alpar@1329
   113
implemented in LEMON.
alpar@1329
   114
alpar@1329
   115
\brief This group describes some general optimization frameworks
alpar@1329
   116
implemented in LEMON.
alpar@1329
   117
alpar@1329
   118
*/
alpar@1329
   119
alpar@1329
   120
/**
alpar@758
   121
@defgroup flowalgs Path and Flow Algorithms
alpar@678
   122
@ingroup galgs
alpar@758
   123
\brief This group describes the algorithms
alpar@758
   124
for finding paths and flows in graphs.
alpar@678
   125
*/
alpar@678
   126
alpar@678
   127
/**
alpar@1151
   128
@defgroup exceptions Exceptions
alpar@1151
   129
This group contains the exceptions thrown by LEMON library
alpar@1151
   130
*/
alpar@1151
   131
alpar@1151
   132
/**
alpar@678
   133
@defgroup misc Miscellaneous Tools
alpar@678
   134
Here you can find several useful tools for development,
alpar@678
   135
debugging and testing.
alpar@678
   136
*/
alpar@678
   137
alpar@678
   138
/**
alpar@1287
   139
@defgroup io_group Input Output
alpar@1287
   140
Here you can find tools for imporing and exporting graphs and graph related
alpar@1287
   141
data
alpar@1287
   142
*/
alpar@1287
   143
alpar@1287
   144
/**
klao@1030
   145
@defgroup concept Concepts
klao@959
   146
\brief Skeleton classes and concept checking classes
alpar@794
   147
klao@959
   148
This group describes the data/algorithm skeletons and concept checking
klao@1030
   149
classes implemented in LEMON.
klao@1030
   150
klao@1030
   151
One aim of these classes is to make it easier to check if a certain
klao@1030
   152
class or template function is correctly implemented.
klao@1030
   153
klao@1030
   154
The other (sometimes even more important) aim is to document the concepts.
klao@1030
   155
alpar@794
   156
*/
alpar@794
   157
klao@1030
   158
/**
klao@1030
   159
@defgroup graph_concepts Graph Structure Concepts
klao@1030
   160
@ingroup concept
klao@1030
   161
\brief Skeleton and concept checking classes for graph structures
klao@1030
   162
klao@1030
   163
This group contains the skeletons and concept checking classes of LEMON's
klao@1030
   164
graph structures and helper classes used to implement these.
klao@1030
   165
*/
alpar@794
   166
alpar@794
   167
/**
alpar@678
   168
@defgroup experimental Experimental Structures and Algorithms
alpar@678
   169
This group contains some Experimental structures and algorithms.
alpar@678
   170
The stuff here is subject to change.
alpar@678
   171
*/
alpar@1151
   172