# source:lemon-0.x/doc/groups.dox@2016:ecb067198349

Last change on this file since 2016:ecb067198349 was 2016:ecb067198349, checked in by Balazs Dezso, 15 years ago

Doc rearrangement
Section readers moved to own group

File size: 6.5 KB
Line
1
2/**
3@defgroup datas Data Structures
4This group describes the several graph structures implemented in LEMON.
5*/
6
7/**
8@defgroup graphs Graph Structures
9@ingroup datas
10\brief Graph structures implemented in LEMON.
11
12The implementation of combinatorial algorithms heavily relies on
13efficient graph implementations. LEMON offers data structures which are
14planned to be easily used in an experimental phase of implementation studies,
15and thereafter the program code can be made efficient by small modifications.
16
17The most efficient implementation of diverse applications require the usage of different physical graph implementations. These differences appear in the size of
18graph we require to handle, memory or time usage limitations or in
19the set of operations through which the graph can be accessed.
20LEMON provides several physical graph structures to meet the
21diverging requirements of the possible users.
22In order to save on running time or on memory usage, some structures may
23fail to provide some graph features like edge or node deletion.
24
25Alteration of standard containers need a very limited number of
26operations, these together satisfy the everyday requirements.
27In the case of graph strutures, different operations are needed which do
28not alter the physical graph, but gives another view. If some nodes or
29edges have to be hidden or the reverse oriented graph have to be used, then
30this is the case. It also may happen that in a flow implemenation
31the residual graph can be accessed by another algorithm, or a node-set
32is to be shrunk for another algorithm.
33LEMON also provides a variety of graphs for these requirements called
35in conjunction with other graph representation.
36
37You are free to use the graph structure that fit your requirements
38the best, most graph algorithms and auxiliary data structures can be used
39with any graph structures.
40*/
41
42/**
44@ingroup graphs
45\brief Graph types between real graphs and graph adaptors.
46
47Graph types between real graphs and graph adaptors. These classes
48wrap graphs to give new functionality as the adaptors do it. But the
49other way they are not light-weigth structures as the adaptors.
50*/
51
52/**
53@defgroup maps Maps
54@ingroup datas
55\brief Some special purpose map to make life easier.
56
57LEMON provides several special maps that e.g. combine
58new maps from existing ones.
59*/
60
61/**
62@defgroup graph_maps Graph Maps
63@ingroup maps
64\brief Special Graph-Related Maps.
65
66These maps are specifically designed to assign values to the nodes and edges of
67graphs.
68*/
69
70
71/**
73\ingroup maps
74\brief Tools to create new maps from existing ones
75
76Map adaptors are used to create "implicit" maps from other maps.
77
79make arithmetic oprerations between one or two maps (negation, scalig,
80addition, multiplication etc.) or e.g. convert a map to another one
81of different Value type.
82*/
83
84/**
85@defgroup auxdat Auxiliary Data Structures
86@ingroup datas
87\brief Some data structures implemented in LEMON.
88
89This group describes the data structures implemented in LEMON in
90order to make it easier to implement combinatorial algorithms.
91*/
92
93/**
94@defgroup graphbits Tools to Make It Easier to Make Graphs
95@ingroup auxdat
96\brief Tools to Make It Easier to Make Graphs.
97
98This group describes the tools that makes it easier to make graphs and
99the maps that dynamically update with the graph changes.
100*/
101
102/**
103@defgroup galgs Graph Algorithms
104\brief This group describes the several graph algorithms
105implemented in LEMON.
106
107This group describes the several graph algorithms
108implemented in LEMON.
109*/
110
111/**
112@defgroup gutils General Graph Utilities
113@ingroup galgs
114\brief This group describes some simple general graph utilities.
115
116This group describes some simple general graph utilities.
117*/
118
119/**
120@defgroup gen_opt_group General Optimization Tools
121\brief This group describes some general optimization frameworks
122implemented in LEMON.
123
124\brief This group describes some general optimization frameworks
125implemented in LEMON.
126
127*/
128
129/**
130@defgroup flowalgs Path and Flow Algorithms
131@ingroup galgs
132\brief This group describes the algorithms
133for finding paths and flows in graphs.
134*/
135
136/**
137@defgroup topology Topology related algorithms
138@ingroup galgs
139\brief This group describes the algorithms
140for discover the topology of the graphs.
141*/
142
143/**
144@defgroup exceptions Exceptions
145This group contains the exceptions thrown by LEMON library
146*/
147
148/**
149@defgroup misc Miscellaneous Tools
150Here you can find several useful tools for development,
151debugging and testing.
152*/
153
154/**
155@defgroup timecount Time measuring and Counting
156@ingroup misc
157Here you can find simple tools for measuring the performance
158of algorithms.
159*/
160
161/**
162@defgroup io_group Input-Output
163Here you can find tools for imporing and exporting graphs and graph related
164data
165*/
166
167/**
168@defgroup section_io Section readers and writers
169@ingroup io_group
170\brief Section readers and writers for lemon Input-Output.
171
172Here you can find which section readers and writers can attach to
174*/
175
176/**
177@defgroup item_io Item Readers and Writers
178@ingroup io_group
179\brief Item readers and writers for lemon Input-Output.
180
181The Input-Output classes can handle more data type by example
182as map or attribute value. Each of these should be written and
183read some way. The module make possible to do this.
184*/
185
186/**
187@defgroup concept Concepts
188\brief Skeleton classes and concept checking classes
189
190This group describes the data/algorithm skeletons and concept checking
191classes implemented in LEMON.
192
193One aim of these classes is to make it easier to check if a certain
194class or template function is correctly implemented.
195
196The other (sometimes even more important) aim is to document the concepts.
197
198*/
199
200/**
201@defgroup graph_concepts Graph Structure Concepts
202@ingroup concept
203\brief Skeleton and concept checking classes for graph structures
204
205This group contains the skeletons and concept checking classes of LEMON's
206graph structures and helper classes used to implement these.
207*/
208
209/* --- Unused group
210@defgroup experimental Experimental Structures and Algorithms
211This group contains some Experimental structures and algorithms.
212The stuff here is subject to change.
213*/
214
215/**
216\anchor demoprograms
217
218@defgroup demos Demo programs
219
220Some demo programs are listed here. Their full source codes can be found in
221the \c demo subdirectory of the source tree.
222
223The standard compilation procedure (<tt>./configure;make</tt>) will compile
224them, as well.
225
226*/
227
Note: See TracBrowser for help on using the repository browser.