COIN-OR::LEMON - Graph Library

source: lemon-0.x/doc/groups.dox @ 2006:00d59f733817

Last change on this file since 2006:00d59f733817 was 2006:00d59f733817, checked in by Alpar Juttner, 18 years ago

Spellcheck

File size: 6.0 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
34\ref graph_adaptors "graph adaptors". Adaptors cannot be used alone but only
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/**
43@defgroup semi_adaptors Semi-Adaptors Classes for Graphs
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/**
72\defgroup map_adaptors Map Adaptors
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
78Most of them are \ref lemon::concept::ReadMap "ReadMap"s. They can
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 concept Concepts
169\brief Skeleton classes and concept checking classes
170
171This group describes the data/algorithm skeletons and concept checking
172classes implemented in LEMON.
173
174One aim of these classes is to make it easier to check if a certain
175class or template function is correctly implemented.
176
177The other (sometimes even more important) aim is to document the concepts.
178
179*/
180
181/**
182@defgroup graph_concepts Graph Structure Concepts
183@ingroup concept
184\brief Skeleton and concept checking classes for graph structures
185
186This group contains the skeletons and concept checking classes of LEMON's
187graph structures and helper classes used to implement these.
188*/
189
190/* --- Unused group
191@defgroup experimental Experimental Structures and Algorithms
192This group contains some Experimental structures and algorithms.
193The stuff here is subject to change.
194*/
195
196/**
197\anchor demoprograms
198
199@defgroup demos Demo programs
200
201Some demo programs are listed here. Their full source codes can be found in
202the \c demo subdirectory of the source tree.
203
204The standard compilation procedure (<tt>./configure;make</tt>) will compile
205them, as well.
206
207*/
208
Note: See TracBrowser for help on using the repository browser.