0
6
0
| ... | ... |
@@ -217,45 +217,66 @@ |
| 217 | 217 |
|
| 218 | 218 |
Dijkstra<Digraph, TimeMap> dijkstra(graph, time); |
| 219 | 219 |
dijkstra.run(source, target); |
| 220 | 220 |
\endcode |
| 221 | 221 |
We have a length map and a maximum speed map on the arcs of a digraph. |
| 222 | 222 |
The minimum time to pass the arc can be calculated as the division of |
| 223 | 223 |
the two maps which can be done implicitly with the \c DivMap template |
| 224 | 224 |
class. We use the implicit minimum time map as the length map of the |
| 225 | 225 |
\c Dijkstra algorithm. |
| 226 | 226 |
*/ |
| 227 | 227 |
|
| 228 | 228 |
/** |
| 229 |
@defgroup matrices Matrices |
|
| 230 |
@ingroup datas |
|
| 231 |
\brief Two dimensional data storages implemented in LEMON. |
|
| 232 |
|
|
| 233 |
This group contains two dimensional data storages implemented in LEMON. |
|
| 234 |
*/ |
|
| 235 |
|
|
| 236 |
/** |
|
| 237 | 229 |
@defgroup paths Path Structures |
| 238 | 230 |
@ingroup datas |
| 239 | 231 |
\brief %Path structures implemented in LEMON. |
| 240 | 232 |
|
| 241 | 233 |
This group contains the path structures implemented in LEMON. |
| 242 | 234 |
|
| 243 | 235 |
LEMON provides flexible data structures to work with paths. |
| 244 | 236 |
All of them have similar interfaces and they can be copied easily with |
| 245 | 237 |
assignment operators and copy constructors. This makes it easy and |
| 246 | 238 |
efficient to have e.g. the Dijkstra algorithm to store its result in |
| 247 | 239 |
any kind of path structure. |
| 248 | 240 |
|
| 249 |
\sa |
|
| 241 |
\sa \ref concepts::Path "Path concept" |
|
| 242 |
*/ |
|
| 243 |
|
|
| 244 |
/** |
|
| 245 |
@defgroup heaps Heap Structures |
|
| 246 |
@ingroup datas |
|
| 247 |
\brief %Heap structures implemented in LEMON. |
|
| 248 |
|
|
| 249 |
This group contains the heap structures implemented in LEMON. |
|
| 250 |
|
|
| 251 |
LEMON provides several heap classes. They are efficient implementations |
|
| 252 |
of the abstract data type \e priority \e queue. They store items with |
|
| 253 |
specified values called \e priorities in such a way that finding and |
|
| 254 |
removing the item with minimum priority are efficient. |
|
| 255 |
The basic operations are adding and erasing items, changing the priority |
|
| 256 |
of an item, etc. |
|
| 257 |
|
|
| 258 |
Heaps are crucial in several algorithms, such as Dijkstra and Prim. |
|
| 259 |
The heap implementations have the same interface, thus any of them can be |
|
| 260 |
used easily in such algorithms. |
|
| 261 |
|
|
| 262 |
\sa \ref concepts::Heap "Heap concept" |
|
| 263 |
*/ |
|
| 264 |
|
|
| 265 |
/** |
|
| 266 |
@defgroup matrices Matrices |
|
| 267 |
@ingroup datas |
|
| 268 |
\brief Two dimensional data storages implemented in LEMON. |
|
| 269 |
|
|
| 270 |
This group contains two dimensional data storages implemented in LEMON. |
|
| 250 | 271 |
*/ |
| 251 | 272 |
|
| 252 | 273 |
/** |
| 253 | 274 |
@defgroup auxdat Auxiliary Data Structures |
| 254 | 275 |
@ingroup datas |
| 255 | 276 |
\brief Auxiliary data structures implemented in LEMON. |
| 256 | 277 |
|
| 257 | 278 |
This group contains some data structures implemented in LEMON in |
| 258 | 279 |
order to make it easier to implement combinatorial algorithms. |
| 259 | 280 |
*/ |
| 260 | 281 |
|
| 261 | 282 |
/** |
| ... | ... |
@@ -10,35 +10,35 @@ |
| 10 | 10 |
* provided that this copyright notice appears in all copies. For |
| 11 | 11 |
* precise terms see the accompanying LICENSE file. |
| 12 | 12 |
* |
| 13 | 13 |
* This software is provided "AS IS" with no warranty of any kind, |
| 14 | 14 |
* express or implied, and with no claim as to its suitability for any |
| 15 | 15 |
* purpose. |
| 16 | 16 |
* |
| 17 | 17 |
*/ |
| 18 | 18 |
|
| 19 | 19 |
#ifndef LEMON_BIN_HEAP_H |
| 20 | 20 |
#define LEMON_BIN_HEAP_H |
| 21 | 21 |
|
| 22 |
///\ingroup |
|
| 22 |
///\ingroup heaps |
|
| 23 | 23 |
///\file |
| 24 | 24 |
///\brief Binary heap implementation. |
| 25 | 25 |
|
| 26 | 26 |
#include <vector> |
| 27 | 27 |
#include <utility> |
| 28 | 28 |
#include <functional> |
| 29 | 29 |
|
| 30 | 30 |
namespace lemon {
|
| 31 | 31 |
|
| 32 |
/// \ingroup |
|
| 32 |
/// \ingroup heaps |
|
| 33 | 33 |
/// |
| 34 | 34 |
/// \brief Binary heap data structure. |
| 35 | 35 |
/// |
| 36 | 36 |
/// This class implements the \e binary \e heap data structure. |
| 37 | 37 |
/// It fully conforms to the \ref concepts::Heap "heap concept". |
| 38 | 38 |
/// |
| 39 | 39 |
/// \tparam PR Type of the priorities of the items. |
| 40 | 40 |
/// \tparam IM A read-writable item map with \c int values, used |
| 41 | 41 |
/// internally to handle the cross references. |
| 42 | 42 |
/// \tparam CMP A functor class for comparing the priorities. |
| 43 | 43 |
/// The default is \c std::less<PR>. |
| 44 | 44 |
#ifdef DOXYGEN |
| ... | ... |
@@ -10,25 +10,25 @@ |
| 10 | 10 |
* provided that this copyright notice appears in all copies. For |
| 11 | 11 |
* precise terms see the accompanying LICENSE file. |
| 12 | 12 |
* |
| 13 | 13 |
* This software is provided "AS IS" with no warranty of any kind, |
| 14 | 14 |
* express or implied, and with no claim as to its suitability for any |
| 15 | 15 |
* purpose. |
| 16 | 16 |
* |
| 17 | 17 |
*/ |
| 18 | 18 |
|
| 19 | 19 |
#ifndef LEMON_BUCKET_HEAP_H |
| 20 | 20 |
#define LEMON_BUCKET_HEAP_H |
| 21 | 21 |
|
| 22 |
///\ingroup |
|
| 22 |
///\ingroup heaps |
|
| 23 | 23 |
///\file |
| 24 | 24 |
///\brief Bucket heap implementation. |
| 25 | 25 |
|
| 26 | 26 |
#include <vector> |
| 27 | 27 |
#include <utility> |
| 28 | 28 |
#include <functional> |
| 29 | 29 |
|
| 30 | 30 |
namespace lemon {
|
| 31 | 31 |
|
| 32 | 32 |
namespace _bucket_heap_bits {
|
| 33 | 33 |
|
| 34 | 34 |
template <bool MIN> |
| ... | ... |
@@ -44,25 +44,25 @@ |
| 44 | 44 |
template <> |
| 45 | 45 |
struct DirectionTraits<false> {
|
| 46 | 46 |
static bool less(int left, int right) {
|
| 47 | 47 |
return left > right; |
| 48 | 48 |
} |
| 49 | 49 |
static void increase(int& value) {
|
| 50 | 50 |
--value; |
| 51 | 51 |
} |
| 52 | 52 |
}; |
| 53 | 53 |
|
| 54 | 54 |
} |
| 55 | 55 |
|
| 56 |
/// \ingroup |
|
| 56 |
/// \ingroup heaps |
|
| 57 | 57 |
/// |
| 58 | 58 |
/// \brief Bucket heap data structure. |
| 59 | 59 |
/// |
| 60 | 60 |
/// This class implements the \e bucket \e heap data structure. |
| 61 | 61 |
/// It practically conforms to the \ref concepts::Heap "heap concept", |
| 62 | 62 |
/// but it has some limitations. |
| 63 | 63 |
/// |
| 64 | 64 |
/// The bucket heap is a very simple structure. It can store only |
| 65 | 65 |
/// \c int priorities and it maintains a list of items for each priority |
| 66 | 66 |
/// in the range <tt>[0..C)</tt>. So it should only be used when the |
| 67 | 67 |
/// priorities are small. It is not intended to use as a Dijkstra heap. |
| 68 | 68 |
/// |
| ... | ... |
@@ -362,25 +362,25 @@ |
| 362 | 362 |
int value; |
| 363 | 363 |
|
| 364 | 364 |
int prev, next; |
| 365 | 365 |
}; |
| 366 | 366 |
|
| 367 | 367 |
ItemIntMap& _iim; |
| 368 | 368 |
std::vector<int> _first; |
| 369 | 369 |
std::vector<BucketItem> _data; |
| 370 | 370 |
mutable int _minimum; |
| 371 | 371 |
|
| 372 | 372 |
}; // class BucketHeap |
| 373 | 373 |
|
| 374 |
/// \ingroup |
|
| 374 |
/// \ingroup heaps |
|
| 375 | 375 |
/// |
| 376 | 376 |
/// \brief Simplified bucket heap data structure. |
| 377 | 377 |
/// |
| 378 | 378 |
/// This class implements a simplified \e bucket \e heap data |
| 379 | 379 |
/// structure. It does not provide some functionality, but it is |
| 380 | 380 |
/// faster and simpler than BucketHeap. The main difference is |
| 381 | 381 |
/// that BucketHeap stores a doubly-linked list for each key while |
| 382 | 382 |
/// this class stores only simply-linked lists. It supports erasing |
| 383 | 383 |
/// only for the item having minimum priority and it does not support |
| 384 | 384 |
/// key increasing and decreasing. |
| 385 | 385 |
/// |
| 386 | 386 |
/// Note that this implementation does not conform to the |
| ... | ... |
@@ -27,25 +27,25 @@ |
| 27 | 27 |
#include <lemon/concept_check.h> |
| 28 | 28 |
|
| 29 | 29 |
namespace lemon {
|
| 30 | 30 |
|
| 31 | 31 |
namespace concepts {
|
| 32 | 32 |
|
| 33 | 33 |
/// \addtogroup concept |
| 34 | 34 |
/// @{
|
| 35 | 35 |
|
| 36 | 36 |
/// \brief The heap concept. |
| 37 | 37 |
/// |
| 38 | 38 |
/// This concept class describes the main interface of heaps. |
| 39 |
/// The various heap structures are efficient |
|
| 39 |
/// The various \ref heaps "heap structures" are efficient |
|
| 40 | 40 |
/// implementations of the abstract data type \e priority \e queue. |
| 41 | 41 |
/// They store items with specified values called \e priorities |
| 42 | 42 |
/// in such a way that finding and removing the item with minimum |
| 43 | 43 |
/// priority are efficient. The basic operations are adding and |
| 44 | 44 |
/// erasing items, changing the priority of an item, etc. |
| 45 | 45 |
/// |
| 46 | 46 |
/// Heaps are crucial in several algorithms, such as Dijkstra and Prim. |
| 47 | 47 |
/// Any class that conforms to this concept can be used easily in such |
| 48 | 48 |
/// algorithms. |
| 49 | 49 |
/// |
| 50 | 50 |
/// \tparam PR Type of the priorities of the items. |
| 51 | 51 |
/// \tparam IM A read-writable item map with \c int values, used |
| ... | ... |
@@ -11,35 +11,35 @@ |
| 11 | 11 |
* precise terms see the accompanying LICENSE file. |
| 12 | 12 |
* |
| 13 | 13 |
* This software is provided "AS IS" with no warranty of any kind, |
| 14 | 14 |
* express or implied, and with no claim as to its suitability for any |
| 15 | 15 |
* purpose. |
| 16 | 16 |
* |
| 17 | 17 |
*/ |
| 18 | 18 |
|
| 19 | 19 |
#ifndef LEMON_FIB_HEAP_H |
| 20 | 20 |
#define LEMON_FIB_HEAP_H |
| 21 | 21 |
|
| 22 | 22 |
///\file |
| 23 |
///\ingroup |
|
| 23 |
///\ingroup heaps |
|
| 24 | 24 |
///\brief Fibonacci heap implementation. |
| 25 | 25 |
|
| 26 | 26 |
#include <vector> |
| 27 | 27 |
#include <utility> |
| 28 | 28 |
#include <functional> |
| 29 | 29 |
#include <lemon/math.h> |
| 30 | 30 |
|
| 31 | 31 |
namespace lemon {
|
| 32 | 32 |
|
| 33 |
/// \ingroup |
|
| 33 |
/// \ingroup heaps |
|
| 34 | 34 |
/// |
| 35 | 35 |
/// \brief Fibonacci heap data structure. |
| 36 | 36 |
/// |
| 37 | 37 |
/// This class implements the \e Fibonacci \e heap data structure. |
| 38 | 38 |
/// It fully conforms to the \ref concepts::Heap "heap concept". |
| 39 | 39 |
/// |
| 40 | 40 |
/// The methods \ref increase() and \ref erase() are not efficient in a |
| 41 | 41 |
/// Fibonacci heap. In case of many calls of these operations, it is |
| 42 | 42 |
/// better to use other heap structure, e.g. \ref BinHeap "binary heap". |
| 43 | 43 |
/// |
| 44 | 44 |
/// \tparam PR Type of the priorities of the items. |
| 45 | 45 |
/// \tparam IM A read-writable item map with \c int values, used |
| ... | ... |
@@ -10,35 +10,35 @@ |
| 10 | 10 |
* provided that this copyright notice appears in all copies. For |
| 11 | 11 |
* precise terms see the accompanying LICENSE file. |
| 12 | 12 |
* |
| 13 | 13 |
* This software is provided "AS IS" with no warranty of any kind, |
| 14 | 14 |
* express or implied, and with no claim as to its suitability for any |
| 15 | 15 |
* purpose. |
| 16 | 16 |
* |
| 17 | 17 |
*/ |
| 18 | 18 |
|
| 19 | 19 |
#ifndef LEMON_RADIX_HEAP_H |
| 20 | 20 |
#define LEMON_RADIX_HEAP_H |
| 21 | 21 |
|
| 22 |
///\ingroup |
|
| 22 |
///\ingroup heaps |
|
| 23 | 23 |
///\file |
| 24 | 24 |
///\brief Radix heap implementation. |
| 25 | 25 |
|
| 26 | 26 |
#include <vector> |
| 27 | 27 |
#include <lemon/error.h> |
| 28 | 28 |
|
| 29 | 29 |
namespace lemon {
|
| 30 | 30 |
|
| 31 | 31 |
|
| 32 |
/// \ingroup |
|
| 32 |
/// \ingroup heaps |
|
| 33 | 33 |
/// |
| 34 | 34 |
/// \brief Radix heap data structure. |
| 35 | 35 |
/// |
| 36 | 36 |
/// This class implements the \e radix \e heap data structure. |
| 37 | 37 |
/// It practically conforms to the \ref concepts::Heap "heap concept", |
| 38 | 38 |
/// but it has some limitations due its special implementation. |
| 39 | 39 |
/// The type of the priorities must be \c int and the priority of an |
| 40 | 40 |
/// item cannot be decreased under the priority of the last removed item. |
| 41 | 41 |
/// |
| 42 | 42 |
/// \tparam IM A read-writable item map with \c int values, used |
| 43 | 43 |
/// internally to handle the cross references. |
| 44 | 44 |
template <typename IM> |
0 comments (0 inline)