... | ... |
@@ -285,32 +285,24 @@ |
285 | 285 |
\brief Geometric data structures implemented in LEMON. |
286 | 286 |
|
287 | 287 |
This group contains geometric data structures implemented in LEMON. |
288 | 288 |
|
289 | 289 |
- \ref lemon::dim2::Point "dim2::Point" implements a two dimensional |
290 | 290 |
vector with the usual operations. |
291 | 291 |
- \ref lemon::dim2::Box "dim2::Box" can be used to determine the |
292 | 292 |
rectangular bounding box of a set of \ref lemon::dim2::Point |
293 | 293 |
"dim2::Point"'s. |
294 | 294 |
*/ |
295 | 295 |
|
296 | 296 |
/** |
297 |
@defgroup matrices Matrices |
|
298 |
@ingroup auxdat |
|
299 |
\brief Two dimensional data storages implemented in LEMON. |
|
300 |
|
|
301 |
This group contains two dimensional data storages implemented in LEMON. |
|
302 |
*/ |
|
303 |
|
|
304 |
/** |
|
305 | 297 |
@defgroup algs Algorithms |
306 | 298 |
\brief This group contains the several algorithms |
307 | 299 |
implemented in LEMON. |
308 | 300 |
|
309 | 301 |
This group contains the several algorithms |
310 | 302 |
implemented in LEMON. |
311 | 303 |
*/ |
312 | 304 |
|
313 | 305 |
/** |
314 | 306 |
@defgroup search Graph Search |
315 | 307 |
@ingroup algs |
316 | 308 |
\brief Common graph search algorithms. |
... | ... |
@@ -325,28 +317,24 @@ |
325 | 317 |
@ingroup algs |
326 | 318 |
\brief Algorithms for finding shortest paths. |
327 | 319 |
|
328 | 320 |
This group contains the algorithms for finding shortest paths in digraphs |
329 | 321 |
\ref clrs01algorithms. |
330 | 322 |
|
331 | 323 |
- \ref Dijkstra algorithm for finding shortest paths from a source node |
332 | 324 |
when all arc lengths are non-negative. |
333 | 325 |
- \ref BellmanFord "Bellman-Ford" algorithm for finding shortest paths |
334 | 326 |
from a source node when arc lenghts can be either positive or negative, |
335 | 327 |
but the digraph should not contain directed cycles with negative total |
336 | 328 |
length. |
337 |
- \ref FloydWarshall "Floyd-Warshall" and \ref Johnson "Johnson" algorithms |
|
338 |
for solving the \e all-pairs \e shortest \e paths \e problem when arc |
|
339 |
lenghts can be either positive or negative, but the digraph should |
|
340 |
not contain directed cycles with negative total length. |
|
341 | 329 |
- \ref Suurballe A successive shortest path algorithm for finding |
342 | 330 |
arc-disjoint paths between two nodes having minimum total length. |
343 | 331 |
*/ |
344 | 332 |
|
345 | 333 |
/** |
346 | 334 |
@defgroup spantree Minimum Spanning Tree Algorithms |
347 | 335 |
@ingroup algs |
348 | 336 |
\brief Algorithms for finding minimum cost spanning trees and arborescences. |
349 | 337 |
|
350 | 338 |
This group contains the algorithms for finding minimum cost spanning |
351 | 339 |
trees and arborescences \ref clrs01algorithms. |
352 | 340 |
*/ |
... | ... |
@@ -362,38 +350,28 @@ |
362 | 350 |
The \e maximum \e flow \e problem is to find a flow of maximum value between |
363 | 351 |
a single source and a single target. Formally, there is a \f$G=(V,A)\f$ |
364 | 352 |
digraph, a \f$cap: A\rightarrow\mathbf{R}^+_0\f$ capacity function and |
365 | 353 |
\f$s, t \in V\f$ source and target nodes. |
366 | 354 |
A maximum flow is an \f$f: A\rightarrow\mathbf{R}^+_0\f$ solution of the |
367 | 355 |
following optimization problem. |
368 | 356 |
|
369 | 357 |
\f[ \max\sum_{sv\in A} f(sv) - \sum_{vs\in A} f(vs) \f] |
370 | 358 |
\f[ \sum_{uv\in A} f(uv) = \sum_{vu\in A} f(vu) |
371 | 359 |
\quad \forall u\in V\setminus\{s,t\} \f] |
372 | 360 |
\f[ 0 \leq f(uv) \leq cap(uv) \quad \forall uv\in A \f] |
373 | 361 |
|
374 |
LEMON contains several algorithms for solving maximum flow problems: |
|
375 |
- \ref EdmondsKarp Edmonds-Karp algorithm |
|
376 |
\ref edmondskarp72theoretical. |
|
377 |
- \ref Preflow Goldberg-Tarjan's preflow push-relabel algorithm |
|
378 |
\ref goldberg88newapproach. |
|
379 |
- \ref DinitzSleatorTarjan Dinitz's blocking flow algorithm with dynamic trees |
|
380 |
\ref dinic70algorithm, \ref sleator83dynamic. |
|
381 |
- \ref GoldbergTarjan !Preflow push-relabel algorithm with dynamic trees |
|
382 |
\ref goldberg88newapproach, \ref sleator83dynamic. |
|
383 |
|
|
384 |
In most cases the \ref Preflow algorithm provides the |
|
385 |
fastest method for computing a maximum flow. All implementations |
|
386 |
also provide functions to query the minimum cut, which is the dual |
|
387 |
problem of maximum flow. |
|
362 |
\ref Preflow is an efficient implementation of Goldberg-Tarjan's |
|
363 |
preflow push-relabel algorithm \ref goldberg88newapproach for finding |
|
364 |
maximum flows. It also provides functions to query the minimum cut, |
|
365 |
which is the dual problem of maximum flow. |
|
388 | 366 |
|
389 | 367 |
\ref Circulation is a preflow push-relabel algorithm implemented directly |
390 | 368 |
for finding feasible circulations, which is a somewhat different problem, |
391 | 369 |
but it is strongly related to maximum flow. |
392 | 370 |
For more information, see \ref Circulation. |
393 | 371 |
*/ |
394 | 372 |
|
395 | 373 |
/** |
396 | 374 |
@defgroup min_cost_flow_algs Minimum Cost Flow Algorithms |
397 | 375 |
@ingroup algs |
398 | 376 |
|
399 | 377 |
\brief Algorithms for finding minimum cost flows and circulations. |
... | ... |
@@ -432,26 +410,24 @@ |
432 | 410 |
\f$X\f$ subset of the nodes with minimum overall capacity on |
433 | 411 |
outgoing arcs. Formally, there is a \f$G=(V,A)\f$ digraph, a |
434 | 412 |
\f$cap: A\rightarrow\mathbf{R}^+_0\f$ capacity function. The minimum |
435 | 413 |
cut is the \f$X\f$ solution of the next optimization problem: |
436 | 414 |
|
437 | 415 |
\f[ \min_{X \subset V, X\not\in \{\emptyset, V\}} |
438 | 416 |
\sum_{uv\in A: u\in X, v\not\in X}cap(uv) \f] |
439 | 417 |
|
440 | 418 |
LEMON contains several algorithms related to minimum cut problems: |
441 | 419 |
|
442 | 420 |
- \ref HaoOrlin "Hao-Orlin algorithm" for calculating minimum cut |
443 | 421 |
in directed graphs. |
444 |
- \ref NagamochiIbaraki "Nagamochi-Ibaraki algorithm" for |
|
445 |
calculating minimum cut in undirected graphs. |
|
446 | 422 |
- \ref GomoryHu "Gomory-Hu tree computation" for calculating |
447 | 423 |
all-pairs minimum cut in undirected graphs. |
448 | 424 |
|
449 | 425 |
If you want to find minimum cut just between two distinict nodes, |
450 | 426 |
see the \ref max_flow "maximum flow problem". |
451 | 427 |
*/ |
452 | 428 |
|
453 | 429 |
/** |
454 | 430 |
@defgroup min_mean_cycle Minimum Mean Cycle Algorithms |
455 | 431 |
@ingroup algs |
456 | 432 |
\brief Algorithms for finding minimum mean cycles. |
457 | 433 |
|
... | ... |
@@ -496,34 +472,24 @@ |
496 | 472 |
matchings in graphs and bipartite graphs. The general matching problem is |
497 | 473 |
finding a subset of the edges for which each node has at most one incident |
498 | 474 |
edge. |
499 | 475 |
|
500 | 476 |
There are several different algorithms for calculate matchings in |
501 | 477 |
graphs. The matching problems in bipartite graphs are generally |
502 | 478 |
easier than in general graphs. The goal of the matching optimization |
503 | 479 |
can be finding maximum cardinality, maximum weight or minimum cost |
504 | 480 |
matching. The search can be constrained to find perfect or |
505 | 481 |
maximum cardinality matching. |
506 | 482 |
|
507 | 483 |
The matching algorithms implemented in LEMON: |
508 |
- \ref MaxBipartiteMatching Hopcroft-Karp augmenting path algorithm |
|
509 |
for calculating maximum cardinality matching in bipartite graphs. |
|
510 |
- \ref PrBipartiteMatching Push-relabel algorithm |
|
511 |
for calculating maximum cardinality matching in bipartite graphs. |
|
512 |
- \ref MaxWeightedBipartiteMatching |
|
513 |
Successive shortest path algorithm for calculating maximum weighted |
|
514 |
matching and maximum weighted bipartite matching in bipartite graphs. |
|
515 |
- \ref MinCostMaxBipartiteMatching |
|
516 |
Successive shortest path algorithm for calculating minimum cost maximum |
|
517 |
matching in bipartite graphs. |
|
518 | 484 |
- \ref MaxMatching Edmond's blossom shrinking algorithm for calculating |
519 | 485 |
maximum cardinality matching in general graphs. |
520 | 486 |
- \ref MaxWeightedMatching Edmond's blossom shrinking algorithm for calculating |
521 | 487 |
maximum weighted matching in general graphs. |
522 | 488 |
- \ref MaxWeightedPerfectMatching |
523 | 489 |
Edmond's blossom shrinking algorithm for calculating maximum weighted |
524 | 490 |
perfect matching in general graphs. |
525 | 491 |
- \ref MaxFractionalMatching Push-relabel algorithm for calculating |
526 | 492 |
maximum cardinality fractional matching in general graphs. |
527 | 493 |
- \ref MaxWeightedFractionalMatching Augmenting path algorithm for calculating |
528 | 494 |
maximum weighted fractional matching in general graphs. |
529 | 495 |
- \ref MaxWeightedPerfectFractionalMatching |
... | ... |
@@ -550,33 +516,24 @@ |
550 | 516 |
@defgroup planar Planarity Embedding and Drawing |
551 | 517 |
@ingroup algs |
552 | 518 |
\brief Algorithms for planarity checking, embedding and drawing |
553 | 519 |
|
554 | 520 |
This group contains the algorithms for planarity checking, |
555 | 521 |
embedding and drawing. |
556 | 522 |
|
557 | 523 |
\image html planar.png |
558 | 524 |
\image latex planar.eps "Plane graph" width=\textwidth |
559 | 525 |
*/ |
560 | 526 |
|
561 | 527 |
/** |
562 |
@defgroup approx Approximation Algorithms |
|
563 |
@ingroup algs |
|
564 |
\brief Approximation algorithms. |
|
565 |
|
|
566 |
This group contains the approximation and heuristic algorithms |
|
567 |
implemented in LEMON. |
|
568 |
*/ |
|
569 |
|
|
570 |
/** |
|
571 | 528 |
@defgroup auxalg Auxiliary Algorithms |
572 | 529 |
@ingroup algs |
573 | 530 |
\brief Auxiliary algorithms implemented in LEMON. |
574 | 531 |
|
575 | 532 |
This group contains some algorithms implemented in LEMON |
576 | 533 |
in order to make it easier to implement complex algorithms. |
577 | 534 |
*/ |
578 | 535 |
|
579 | 536 |
/** |
580 | 537 |
@defgroup gen_opt_group General Optimization Tools |
581 | 538 |
\brief This group contains some general optimization frameworks |
582 | 539 |
implemented in LEMON. |
... | ... |
@@ -590,41 +547,24 @@ |
590 | 547 |
@ingroup gen_opt_group |
591 | 548 |
\brief LP and MIP solver interfaces for LEMON. |
592 | 549 |
|
593 | 550 |
This group contains LP and MIP solver interfaces for LEMON. |
594 | 551 |
Various LP solvers could be used in the same manner with this |
595 | 552 |
high-level interface. |
596 | 553 |
|
597 | 554 |
The currently supported solvers are \ref glpk, \ref clp, \ref cbc, |
598 | 555 |
\ref cplex, \ref soplex. |
599 | 556 |
*/ |
600 | 557 |
|
601 | 558 |
/** |
602 |
@defgroup lp_utils Tools for Lp and Mip Solvers |
|
603 |
@ingroup lp_group |
|
604 |
\brief Helper tools to the Lp and Mip solvers. |
|
605 |
|
|
606 |
This group adds some helper tools to general optimization framework |
|
607 |
implemented in LEMON. |
|
608 |
*/ |
|
609 |
|
|
610 |
/** |
|
611 |
@defgroup metah Metaheuristics |
|
612 |
@ingroup gen_opt_group |
|
613 |
\brief Metaheuristics for LEMON library. |
|
614 |
|
|
615 |
This group contains some metaheuristic optimization tools. |
|
616 |
*/ |
|
617 |
|
|
618 |
/** |
|
619 | 559 |
@defgroup utils Tools and Utilities |
620 | 560 |
\brief Tools and utilities for programming in LEMON |
621 | 561 |
|
622 | 562 |
Tools and utilities for programming in LEMON. |
623 | 563 |
*/ |
624 | 564 |
|
625 | 565 |
/** |
626 | 566 |
@defgroup gutils Basic Graph Utilities |
627 | 567 |
@ingroup utils |
628 | 568 |
\brief Simple basic graph utilities. |
629 | 569 |
|
630 | 570 |
This group contains some simple basic graph utilities. |
0 comments (0 inline)