0
3
0
... | ... |
@@ -2,74 +2,63 @@ |
2 | 2 |
* |
3 | 3 |
* This file is a part of LEMON, a generic C++ optimization library |
4 | 4 |
* |
5 | 5 |
* Copyright (C) 2003-2008 |
6 | 6 |
* Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport |
7 | 7 |
* (Egervary Research Group on Combinatorial Optimization, EGRES). |
8 | 8 |
* |
9 | 9 |
* Permission to use, modify and distribute this software is granted |
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_DIGRAPH_ADAPTOR_H |
20 | 20 |
#define LEMON_DIGRAPH_ADAPTOR_H |
21 | 21 |
|
22 | 22 |
///\ingroup graph_adaptors |
23 | 23 |
///\file |
24 | 24 |
///\brief Several digraph adaptors. |
25 | 25 |
/// |
26 |
///This file contains several useful digraph adaptor |
|
26 |
///This file contains several useful digraph adaptor classes. |
|
27 | 27 |
|
28 | 28 |
#include <lemon/core.h> |
29 | 29 |
#include <lemon/maps.h> |
30 | 30 |
#include <lemon/bits/variant.h> |
31 | 31 |
|
32 | 32 |
#include <lemon/bits/base_extender.h> |
33 | 33 |
#include <lemon/bits/graph_adaptor_extender.h> |
34 | 34 |
#include <lemon/bits/graph_extender.h> |
35 | 35 |
#include <lemon/tolerance.h> |
36 | 36 |
|
37 | 37 |
#include <algorithm> |
38 | 38 |
|
39 | 39 |
namespace lemon { |
40 | 40 |
|
41 |
///\brief Base type for the Digraph Adaptors |
|
42 |
/// |
|
43 |
///Base type for the Digraph Adaptors |
|
44 |
/// |
|
45 |
///This is the base type for most of LEMON digraph adaptors. This |
|
46 |
///class implements a trivial digraph adaptor i.e. it only wraps the |
|
47 |
///functions and types of the digraph. The purpose of this class is |
|
48 |
///to make easier implementing digraph adaptors. E.g. if an adaptor |
|
49 |
///is considered which differs from the wrapped digraph only in some |
|
50 |
///of its functions or types, then it can be derived from |
|
51 |
///DigraphAdaptor, and only the differences should be implemented. |
|
52 | 41 |
template<typename _Digraph> |
53 | 42 |
class DigraphAdaptorBase { |
54 | 43 |
public: |
55 | 44 |
typedef _Digraph Digraph; |
56 | 45 |
typedef DigraphAdaptorBase Adaptor; |
57 | 46 |
typedef Digraph ParentDigraph; |
58 | 47 |
|
59 | 48 |
protected: |
60 | 49 |
Digraph* _digraph; |
61 | 50 |
DigraphAdaptorBase() : _digraph(0) { } |
62 | 51 |
void setDigraph(Digraph& digraph) { _digraph = &digraph; } |
63 | 52 |
|
64 | 53 |
public: |
65 | 54 |
DigraphAdaptorBase(Digraph& digraph) : _digraph(&digraph) { } |
66 | 55 |
|
67 | 56 |
typedef typename Digraph::Node Node; |
68 | 57 |
typedef typename Digraph::Arc Arc; |
69 | 58 |
|
70 | 59 |
void first(Node& i) const { _digraph->first(i); } |
71 | 60 |
void first(Arc& i) const { _digraph->first(i); } |
72 | 61 |
void firstIn(Arc& i, const Node& n) const { _digraph->firstIn(i, n); } |
73 | 62 |
void firstOut(Arc& i, const Node& n ) const { _digraph->firstOut(i, n); } |
74 | 63 |
|
75 | 64 |
void next(Node& i) const { _digraph->next(i); } |
... | ... |
@@ -145,166 +134,139 @@ |
145 | 134 |
|
146 | 135 |
typedef typename Digraph::template ArcMap<_Value> Parent; |
147 | 136 |
|
148 | 137 |
explicit ArcMap(const Adaptor& adaptor) |
149 | 138 |
: Parent(*adaptor._digraph) {} |
150 | 139 |
|
151 | 140 |
ArcMap(const Adaptor& adaptor, const _Value& value) |
152 | 141 |
: Parent(*adaptor._digraph, value) {} |
153 | 142 |
|
154 | 143 |
private: |
155 | 144 |
ArcMap& operator=(const ArcMap& cmap) { |
156 | 145 |
return operator=<ArcMap>(cmap); |
157 | 146 |
} |
158 | 147 |
|
159 | 148 |
template <typename CMap> |
160 | 149 |
ArcMap& operator=(const CMap& cmap) { |
161 | 150 |
Parent::operator=(cmap); |
162 | 151 |
return *this; |
163 | 152 |
} |
164 | 153 |
|
165 | 154 |
}; |
166 | 155 |
|
167 | 156 |
}; |
168 | 157 |
|
169 |
///\ingroup graph_adaptors |
|
170 |
/// |
|
171 |
///\brief Trivial Digraph Adaptor |
|
172 |
/// |
|
173 |
/// This class is an adaptor which does not change the adapted |
|
174 |
/// digraph. It can be used only to test the digraph adaptors. |
|
175 |
template <typename _Digraph> |
|
176 |
class DigraphAdaptor : |
|
177 |
public DigraphAdaptorExtender<DigraphAdaptorBase<_Digraph> > { |
|
178 |
public: |
|
179 |
typedef _Digraph Digraph; |
|
180 |
typedef DigraphAdaptorExtender<DigraphAdaptorBase<_Digraph> > Parent; |
|
181 |
protected: |
|
182 |
DigraphAdaptor() : Parent() { } |
|
183 |
|
|
184 |
public: |
|
185 |
explicit DigraphAdaptor(Digraph& digraph) { setDigraph(digraph); } |
|
186 |
}; |
|
187 |
|
|
188 |
/// \brief Just gives back a digraph adaptor |
|
189 |
/// |
|
190 |
/// Just gives back a digraph adaptor which |
|
191 |
/// should be provide original digraph |
|
192 |
template<typename Digraph> |
|
193 |
DigraphAdaptor<const Digraph> |
|
194 |
digraphAdaptor(const Digraph& digraph) { |
|
195 |
return DigraphAdaptor<const Digraph>(digraph); |
|
196 |
} |
|
197 |
|
|
198 | 158 |
|
199 | 159 |
template <typename _Digraph> |
200 | 160 |
class RevDigraphAdaptorBase : public DigraphAdaptorBase<_Digraph> { |
201 | 161 |
public: |
202 | 162 |
typedef _Digraph Digraph; |
203 | 163 |
typedef DigraphAdaptorBase<_Digraph> Parent; |
204 | 164 |
protected: |
205 | 165 |
RevDigraphAdaptorBase() : Parent() { } |
206 | 166 |
public: |
207 | 167 |
typedef typename Parent::Node Node; |
208 | 168 |
typedef typename Parent::Arc Arc; |
209 | 169 |
|
210 | 170 |
void firstIn(Arc& a, const Node& n) const { Parent::firstOut(a, n); } |
211 | 171 |
void firstOut(Arc& a, const Node& n ) const { Parent::firstIn(a, n); } |
212 | 172 |
|
213 | 173 |
void nextIn(Arc& a) const { Parent::nextOut(a); } |
214 | 174 |
void nextOut(Arc& a) const { Parent::nextIn(a); } |
215 | 175 |
|
216 | 176 |
Node source(const Arc& a) const { return Parent::target(a); } |
217 | 177 |
Node target(const Arc& a) const { return Parent::source(a); } |
218 | 178 |
|
219 | 179 |
typedef FindEdgeTagIndicator<Digraph> FindEdgeTag; |
220 | 180 |
Arc findArc(const Node& u, const Node& v, |
221 | 181 |
const Arc& prev = INVALID) { |
222 | 182 |
return Parent::findArc(v, u, prev); |
223 | 183 |
} |
224 | 184 |
|
225 | 185 |
}; |
226 | 186 |
|
227 | 187 |
|
228 | 188 |
///\ingroup graph_adaptors |
229 | 189 |
/// |
230 | 190 |
///\brief A digraph adaptor which reverses the orientation of the arcs. |
231 | 191 |
/// |
232 | 192 |
/// If \c g is defined as |
233 | 193 |
///\code |
234 |
/// ListDigraph |
|
194 |
/// ListDigraph dg; |
|
235 | 195 |
///\endcode |
236 | 196 |
/// then |
237 | 197 |
///\code |
238 |
/// RevDigraphAdaptor<ListDigraph> |
|
198 |
/// RevDigraphAdaptor<ListDigraph> dga(dg); |
|
239 | 199 |
///\endcode |
240 |
/// implements the digraph obtained from \c |
|
200 |
/// implements the digraph obtained from \c dg by |
|
241 | 201 |
/// reversing the orientation of its arcs. |
242 | 202 |
/// |
243 |
/// A good example of using RevDigraphAdaptor is to decide that the |
|
244 |
/// directed graph is wheter strongly connected or not. If from one |
|
245 |
/// node each node is reachable and from each node is reachable this |
|
246 |
/// node then and just then the digraph is strongly |
|
247 |
/// connected. Instead of this condition we use a little bit |
|
248 |
/// different. From one node each node ahould be reachable in the |
|
249 |
/// digraph and in the reversed digraph. Now this condition can be |
|
250 |
/// checked with the Dfs algorithm class and the RevDigraphAdaptor |
|
251 |
/// |
|
203 |
/// A good example of using RevDigraphAdaptor is to decide whether |
|
204 |
/// the directed graph is strongly connected or not. The digraph is |
|
205 |
/// strongly connected iff each node is reachable from one node and |
|
206 |
/// this node is reachable from the others. Instead of this |
|
207 |
/// condition we use a slightly different, from one node each node |
|
208 |
/// is reachable both in the digraph and the reversed digraph. Now |
|
209 |
/// this condition can be checked with the Dfs algorithm and the |
|
210 |
/// RevDigraphAdaptor class. |
|
252 | 211 |
/// |
253 |
/// And look at the code: |
|
254 |
/// |
|
212 |
/// The implementation: |
|
255 | 213 |
///\code |
256 | 214 |
/// bool stronglyConnected(const Digraph& digraph) { |
257 | 215 |
/// if (NodeIt(digraph) == INVALID) return true; |
258 | 216 |
/// Dfs<Digraph> dfs(digraph); |
259 | 217 |
/// dfs.run(NodeIt(digraph)); |
260 | 218 |
/// for (NodeIt it(digraph); it != INVALID; ++it) { |
261 | 219 |
/// if (!dfs.reached(it)) { |
262 | 220 |
/// return false; |
263 | 221 |
/// } |
264 | 222 |
/// } |
265 | 223 |
/// typedef RevDigraphAdaptor<const Digraph> RDigraph; |
266 | 224 |
/// RDigraph rdigraph(digraph); |
267 | 225 |
/// DfsVisit<RDigraph> rdfs(rdigraph); |
268 | 226 |
/// rdfs.run(NodeIt(digraph)); |
269 | 227 |
/// for (NodeIt it(digraph); it != INVALID; ++it) { |
270 | 228 |
/// if (!rdfs.reached(it)) { |
271 | 229 |
/// return false; |
272 | 230 |
/// } |
273 | 231 |
/// } |
274 | 232 |
/// return true; |
275 | 233 |
/// } |
276 | 234 |
///\endcode |
277 | 235 |
template<typename _Digraph> |
278 | 236 |
class RevDigraphAdaptor : |
279 | 237 |
public DigraphAdaptorExtender<RevDigraphAdaptorBase<_Digraph> > { |
280 | 238 |
public: |
281 | 239 |
typedef _Digraph Digraph; |
282 | 240 |
typedef DigraphAdaptorExtender< |
283 | 241 |
RevDigraphAdaptorBase<_Digraph> > Parent; |
284 | 242 |
protected: |
285 | 243 |
RevDigraphAdaptor() { } |
286 | 244 |
public: |
245 |
|
|
246 |
/// \brief Constructor |
|
247 |
/// |
|
248 |
/// Creates a reverse graph adaptor for the given digraph |
|
287 | 249 |
explicit RevDigraphAdaptor(Digraph& digraph) { |
288 | 250 |
Parent::setDigraph(digraph); |
289 | 251 |
} |
290 | 252 |
}; |
291 | 253 |
|
292 | 254 |
/// \brief Just gives back a reverse digraph adaptor |
293 | 255 |
/// |
294 | 256 |
/// Just gives back a reverse digraph adaptor |
295 | 257 |
template<typename Digraph> |
296 | 258 |
RevDigraphAdaptor<const Digraph> |
297 | 259 |
revDigraphAdaptor(const Digraph& digraph) { |
298 | 260 |
return RevDigraphAdaptor<const Digraph>(digraph); |
299 | 261 |
} |
300 | 262 |
|
301 | 263 |
template <typename _Digraph, typename _NodeFilterMap, |
302 | 264 |
typename _ArcFilterMap, bool checked = true> |
303 | 265 |
class SubDigraphAdaptorBase : public DigraphAdaptorBase<_Digraph> { |
304 | 266 |
public: |
305 | 267 |
typedef _Digraph Digraph; |
306 | 268 |
typedef _NodeFilterMap NodeFilterMap; |
307 | 269 |
typedef _ArcFilterMap ArcFilterMap; |
308 | 270 |
|
309 | 271 |
typedef SubDigraphAdaptorBase Adaptor; |
310 | 272 |
typedef DigraphAdaptorBase<_Digraph> Parent; |
... | ... |
@@ -353,86 +315,55 @@ |
353 | 315 |
void next(Node& i) const { |
354 | 316 |
Parent::next(i); |
355 | 317 |
while (i != INVALID && !(*_node_filter)[i]) Parent::next(i); |
356 | 318 |
} |
357 | 319 |
|
358 | 320 |
void next(Arc& i) const { |
359 | 321 |
Parent::next(i); |
360 | 322 |
while (i != INVALID && (!(*_arc_filter)[i] |
361 | 323 |
|| !(*_node_filter)[Parent::source(i)] |
362 | 324 |
|| !(*_node_filter)[Parent::target(i)])) Parent::next(i); |
363 | 325 |
} |
364 | 326 |
|
365 | 327 |
void nextIn(Arc& i) const { |
366 | 328 |
Parent::nextIn(i); |
367 | 329 |
while (i != INVALID && (!(*_arc_filter)[i] |
368 | 330 |
|| !(*_node_filter)[Parent::source(i)])) Parent::nextIn(i); |
369 | 331 |
} |
370 | 332 |
|
371 | 333 |
void nextOut(Arc& i) const { |
372 | 334 |
Parent::nextOut(i); |
373 | 335 |
while (i != INVALID && (!(*_arc_filter)[i] |
374 | 336 |
|| !(*_node_filter)[Parent::target(i)])) Parent::nextOut(i); |
375 | 337 |
} |
376 | 338 |
|
377 |
///\e |
|
378 |
|
|
379 |
/// This function hides \c n in the digraph, i.e. the iteration |
|
380 |
/// jumps over it. This is done by simply setting the value of \c n |
|
381 |
/// to be false in the corresponding node-map. |
|
382 | 339 |
void hide(const Node& n) const { _node_filter->set(n, false); } |
383 |
|
|
384 |
///\e |
|
385 |
|
|
386 |
/// This function hides \c a in the digraph, i.e. the iteration |
|
387 |
/// jumps over it. This is done by simply setting the value of \c a |
|
388 |
/// to be false in the corresponding arc-map. |
|
389 | 340 |
void hide(const Arc& a) const { _arc_filter->set(a, false); } |
390 | 341 |
|
391 |
///\e |
|
392 |
|
|
393 |
/// The value of \c n is set to be true in the node-map which stores |
|
394 |
/// hide information. If \c n was hidden previuosly, then it is shown |
|
395 |
/// again |
|
396 |
void unHide(const Node& n) const { _node_filter->set(n, true); } |
|
397 |
|
|
398 |
///\e |
|
399 |
|
|
400 |
/// The value of \c a is set to be true in the arc-map which stores |
|
401 |
/// hide information. If \c a was hidden previuosly, then it is shown |
|
402 |
/// again |
|
342 |
void unHide(const Node& n) const { _node_filter->set(n, true); } |
|
403 | 343 |
void unHide(const Arc& a) const { _arc_filter->set(a, true); } |
404 | 344 |
|
405 |
/// Returns true if \c n is hidden. |
|
406 |
|
|
407 |
///\e |
|
408 |
/// |
|
409 | 345 |
bool hidden(const Node& n) const { return !(*_node_filter)[n]; } |
410 |
|
|
411 |
/// Returns true if \c a is hidden. |
|
412 |
|
|
413 |
///\e |
|
414 |
/// |
|
415 | 346 |
bool hidden(const Arc& a) const { return !(*_arc_filter)[a]; } |
416 | 347 |
|
417 | 348 |
typedef False NodeNumTag; |
418 | 349 |
typedef False EdgeNumTag; |
419 | 350 |
|
420 | 351 |
typedef FindEdgeTagIndicator<Digraph> FindEdgeTag; |
421 | 352 |
Arc findArc(const Node& source, const Node& target, |
422 | 353 |
const Arc& prev = INVALID) { |
423 | 354 |
if (!(*_node_filter)[source] || !(*_node_filter)[target]) { |
424 | 355 |
return INVALID; |
425 | 356 |
} |
426 | 357 |
Arc arc = Parent::findArc(source, target, prev); |
427 | 358 |
while (arc != INVALID && !(*_arc_filter)[arc]) { |
428 | 359 |
arc = Parent::findArc(source, target, arc); |
429 | 360 |
} |
430 | 361 |
return arc; |
431 | 362 |
} |
432 | 363 |
|
433 | 364 |
template <typename _Value> |
434 | 365 |
class NodeMap : public SubMapExtender<Adaptor, |
435 | 366 |
typename Parent::template NodeMap<_Value> > { |
436 | 367 |
public: |
437 | 368 |
typedef _Value Value; |
438 | 369 |
typedef SubMapExtender<Adaptor, typename Parent:: |
... | ... |
@@ -527,86 +458,55 @@ |
527 | 458 |
|
528 | 459 |
void firstOut(Arc& i, const Node& n) const { |
529 | 460 |
Parent::firstOut(i, n); |
530 | 461 |
while (i!=INVALID && !(*_arc_filter)[i]) Parent::nextOut(i); |
531 | 462 |
} |
532 | 463 |
|
533 | 464 |
void next(Node& i) const { |
534 | 465 |
Parent::next(i); |
535 | 466 |
while (i!=INVALID && !(*_node_filter)[i]) Parent::next(i); |
536 | 467 |
} |
537 | 468 |
void next(Arc& i) const { |
538 | 469 |
Parent::next(i); |
539 | 470 |
while (i!=INVALID && !(*_arc_filter)[i]) Parent::next(i); |
540 | 471 |
} |
541 | 472 |
void nextIn(Arc& i) const { |
542 | 473 |
Parent::nextIn(i); |
543 | 474 |
while (i!=INVALID && !(*_arc_filter)[i]) Parent::nextIn(i); |
544 | 475 |
} |
545 | 476 |
|
546 | 477 |
void nextOut(Arc& i) const { |
547 | 478 |
Parent::nextOut(i); |
548 | 479 |
while (i!=INVALID && !(*_arc_filter)[i]) Parent::nextOut(i); |
549 | 480 |
} |
550 | 481 |
|
551 |
///\e |
|
552 |
|
|
553 |
/// This function hides \c n in the digraph, i.e. the iteration |
|
554 |
/// jumps over it. This is done by simply setting the value of \c n |
|
555 |
/// to be false in the corresponding node-map. |
|
556 | 482 |
void hide(const Node& n) const { _node_filter->set(n, false); } |
557 |
|
|
558 |
///\e |
|
559 |
|
|
560 |
/// This function hides \c e in the digraph, i.e. the iteration |
|
561 |
/// jumps over it. This is done by simply setting the value of \c e |
|
562 |
/// to be false in the corresponding arc-map. |
|
563 | 483 |
void hide(const Arc& e) const { _arc_filter->set(e, false); } |
564 | 484 |
|
565 |
///\e |
|
566 |
|
|
567 |
/// The value of \c n is set to be true in the node-map which stores |
|
568 |
/// hide information. If \c n was hidden previuosly, then it is shown |
|
569 |
/// again |
|
570 |
void unHide(const Node& n) const { _node_filter->set(n, true); } |
|
571 |
|
|
572 |
///\e |
|
573 |
|
|
574 |
/// The value of \c e is set to be true in the arc-map which stores |
|
575 |
/// hide information. If \c e was hidden previuosly, then it is shown |
|
576 |
/// again |
|
485 |
void unHide(const Node& n) const { _node_filter->set(n, true); } |
|
577 | 486 |
void unHide(const Arc& e) const { _arc_filter->set(e, true); } |
578 | 487 |
|
579 |
/// Returns true if \c n is hidden. |
|
580 |
|
|
581 |
///\e |
|
582 |
/// |
|
583 | 488 |
bool hidden(const Node& n) const { return !(*_node_filter)[n]; } |
584 |
|
|
585 |
/// Returns true if \c n is hidden. |
|
586 |
|
|
587 |
///\e |
|
588 |
/// |
|
589 | 489 |
bool hidden(const Arc& e) const { return !(*_arc_filter)[e]; } |
590 | 490 |
|
591 | 491 |
typedef False NodeNumTag; |
592 | 492 |
typedef False EdgeNumTag; |
593 | 493 |
|
594 | 494 |
typedef FindEdgeTagIndicator<Digraph> FindEdgeTag; |
595 | 495 |
Arc findArc(const Node& source, const Node& target, |
596 | 496 |
const Arc& prev = INVALID) { |
597 | 497 |
if (!(*_node_filter)[source] || !(*_node_filter)[target]) { |
598 | 498 |
return INVALID; |
599 | 499 |
} |
600 | 500 |
Arc arc = Parent::findArc(source, target, prev); |
601 | 501 |
while (arc != INVALID && !(*_arc_filter)[arc]) { |
602 | 502 |
arc = Parent::findArc(source, target, arc); |
603 | 503 |
} |
604 | 504 |
return arc; |
605 | 505 |
} |
606 | 506 |
|
607 | 507 |
template <typename _Value> |
608 | 508 |
class NodeMap : public SubMapExtender<Adaptor, |
609 | 509 |
typename Parent::template NodeMap<_Value> > { |
610 | 510 |
public: |
611 | 511 |
typedef _Value Value; |
612 | 512 |
typedef SubMapExtender<Adaptor, typename Parent:: |
... | ... |
@@ -640,256 +540,317 @@ |
640 | 540 |
ArcMap(const Adaptor& adaptor) |
641 | 541 |
: MapParent(adaptor) {} |
642 | 542 |
ArcMap(const Adaptor& adaptor, const Value& value) |
643 | 543 |
: MapParent(adaptor, value) {} |
644 | 544 |
|
645 | 545 |
private: |
646 | 546 |
ArcMap& operator=(const ArcMap& cmap) { |
647 | 547 |
return operator=<ArcMap>(cmap); |
648 | 548 |
} |
649 | 549 |
|
650 | 550 |
template <typename CMap> |
651 | 551 |
ArcMap& operator=(const CMap& cmap) { |
652 | 552 |
MapParent::operator=(cmap); |
653 | 553 |
return *this; |
654 | 554 |
} |
655 | 555 |
}; |
656 | 556 |
|
657 | 557 |
}; |
658 | 558 |
|
659 | 559 |
/// \ingroup graph_adaptors |
660 | 560 |
/// |
661 | 561 |
/// \brief A digraph adaptor for hiding nodes and arcs from a digraph. |
662 | 562 |
/// |
663 | 563 |
/// SubDigraphAdaptor shows the digraph with filtered node-set and |
664 |
/// arc-set. If the \c checked parameter is true then it filters the arcset |
|
665 |
/// to do not get invalid arcs without source or target. |
|
666 |
/// Let \f$ G=(V, A) \f$ be a directed digraph |
|
667 |
/// and suppose that the digraph instance \c g of type ListDigraph |
|
668 |
/// implements \f$ G \f$. |
|
669 |
/// Let moreover \f$ b_V \f$ and \f$ b_A \f$ be bool-valued functions resp. |
|
670 |
/// on the node-set and arc-set. |
|
671 |
/// SubDigraphAdaptor<...>::NodeIt iterates |
|
672 |
/// on the node-set \f$ \{v\in V : b_V(v)=true\} \f$ and |
|
673 |
/// SubDigraphAdaptor<...>::ArcIt iterates |
|
674 |
/// on the arc-set \f$ \{e\in A : b_A(e)=true\} \f$. Similarly, |
|
675 |
/// SubDigraphAdaptor<...>::OutArcIt and |
|
676 |
/// SubDigraphAdaptor<...>::InArcIt iterates |
|
677 |
/// only on arcs leaving and entering a specific node which have true value. |
|
564 |
/// arc-set. If the \c checked parameter is true then it filters the arc-set |
|
565 |
/// respect to the source and target. |
|
678 | 566 |
/// |
679 |
/// If the \c checked template parameter is false then we have to |
|
680 |
/// note that the node-iterator cares only the filter on the |
|
681 |
/// node-set, and the arc-iterator cares only the filter on the |
|
682 |
/// arc-set. This way the arc-map should filter all arcs which's |
|
683 |
/// |
|
567 |
/// If the \c checked template parameter is false then the |
|
568 |
/// node-iterator cares only the filter on the node-set, and the |
|
569 |
/// arc-iterator cares only the filter on the arc-set. Therefore |
|
570 |
/// the arc-map have to filter all arcs which's source or target is |
|
571 |
/// filtered by the node-filter. |
|
684 | 572 |
///\code |
685 | 573 |
/// typedef ListDigraph Digraph; |
686 | 574 |
/// DIGRAPH_TYPEDEFS(Digraph); |
687 | 575 |
/// Digraph g; |
688 | 576 |
/// Node u=g.addNode(); //node of id 0 |
689 | 577 |
/// Node v=g.addNode(); //node of id 1 |
690 | 578 |
/// Arc a=g.addArc(u, v); //arc of id 0 |
691 | 579 |
/// Arc f=g.addArc(v, u); //arc of id 1 |
692 | 580 |
/// BoolNodeMap nm(g, true); |
693 | 581 |
/// nm.set(u, false); |
694 | 582 |
/// BoolArcMap am(g, true); |
695 | 583 |
/// am.set(a, false); |
696 |
/// typedef SubDigraphAdaptor<Digraph, BoolNodeMap, BoolArcMap> SubGA; |
|
697 |
/// SubGA ga(g, nm, am); |
|
698 |
/// |
|
584 |
/// typedef SubDigraphAdaptor<Digraph, BoolNodeMap, BoolArcMap> SubDGA; |
|
585 |
/// SubDGA ga(g, nm, am); |
|
586 |
/// for (SubDGA::NodeIt n(ga); n!=INVALID; ++n) |
|
699 | 587 |
/// std::cout << g.id(n) << std::endl; |
700 |
/// std::cout << ":-)" << std::endl; |
|
701 |
/// for (SubGA::ArcIt a(ga); a!=INVALID; ++a) |
|
588 |
/// for (SubDGA::ArcIt a(ga); a!=INVALID; ++a) |
|
702 | 589 |
/// std::cout << g.id(a) << std::endl; |
703 | 590 |
///\endcode |
704 | 591 |
/// The output of the above code is the following. |
705 | 592 |
///\code |
706 | 593 |
/// 1 |
707 |
/// :-) |
|
708 | 594 |
/// 1 |
709 | 595 |
///\endcode |
710 |
/// Note that \c n is of type \c |
|
596 |
/// Note that \c n is of type \c SubDGA::NodeIt, but it can be converted to |
|
711 | 597 |
/// \c Digraph::Node that is why \c g.id(n) can be applied. |
712 | 598 |
/// |
713 | 599 |
/// For other examples see also the documentation of |
714 | 600 |
/// NodeSubDigraphAdaptor and ArcSubDigraphAdaptor. |
715 | 601 |
template<typename _Digraph, |
716 | 602 |
typename _NodeFilterMap = typename _Digraph::template NodeMap<bool>, |
717 | 603 |
typename _ArcFilterMap = typename _Digraph::template ArcMap<bool>, |
718 | 604 |
bool checked = true> |
719 | 605 |
class SubDigraphAdaptor : |
720 | 606 |
public DigraphAdaptorExtender< |
721 | 607 |
SubDigraphAdaptorBase<_Digraph, _NodeFilterMap, _ArcFilterMap, checked> > { |
722 | 608 |
public: |
723 | 609 |
typedef _Digraph Digraph; |
724 | 610 |
typedef _NodeFilterMap NodeFilterMap; |
725 | 611 |
typedef _ArcFilterMap ArcFilterMap; |
726 | 612 |
|
727 | 613 |
typedef DigraphAdaptorExtender< |
728 | 614 |
SubDigraphAdaptorBase<Digraph, NodeFilterMap, ArcFilterMap, checked> > |
729 | 615 |
Parent; |
730 | 616 |
|
617 |
typedef typename Parent::Node Node; |
|
618 |
typedef typename Parent::Arc Arc; |
|
619 |
|
|
731 | 620 |
protected: |
732 | 621 |
SubDigraphAdaptor() { } |
733 | 622 |
public: |
734 | 623 |
|
624 |
/// \brief Constructor |
|
625 |
/// |
|
626 |
/// Creates a sub-digraph-adaptor for the given digraph with |
|
627 |
/// given node and arc map filters. |
|
735 | 628 |
SubDigraphAdaptor(Digraph& digraph, NodeFilterMap& node_filter, |
736 | 629 |
ArcFilterMap& arc_filter) { |
737 | 630 |
setDigraph(digraph); |
738 | 631 |
setNodeFilterMap(node_filter); |
739 | 632 |
setArcFilterMap(arc_filter); |
740 | 633 |
} |
741 | 634 |
|
635 |
/// \brief Hides the node of the graph |
|
636 |
/// |
|
637 |
/// This function hides \c n in the digraph, i.e. the iteration |
|
638 |
/// jumps over it. This is done by simply setting the value of \c n |
|
639 |
/// to be false in the corresponding node-map. |
|
640 |
void hide(const Node& n) const { Parent::hide(n); } |
|
641 |
|
|
642 |
/// \brief Hides the arc of the graph |
|
643 |
/// |
|
644 |
/// This function hides \c a in the digraph, i.e. the iteration |
|
645 |
/// jumps over it. This is done by simply setting the value of \c a |
|
646 |
/// to be false in the corresponding arc-map. |
|
647 |
void hide(const Arc& a) const { Parent::hide(a); } |
|
648 |
|
|
649 |
/// \brief Unhides the node of the graph |
|
650 |
/// |
|
651 |
/// The value of \c n is set to be true in the node-map which stores |
|
652 |
/// hide information. If \c n was hidden previuosly, then it is shown |
|
653 |
/// again |
|
654 |
void unHide(const Node& n) const { Parent::unHide(n); } |
|
655 |
|
|
656 |
/// \brief Unhides the arc of the graph |
|
657 |
/// |
|
658 |
/// The value of \c a is set to be true in the arc-map which stores |
|
659 |
/// hide information. If \c a was hidden previuosly, then it is shown |
|
660 |
/// again |
|
661 |
void unHide(const Arc& a) const { Parent::unHide(a); } |
|
662 |
|
|
663 |
/// \brief Returns true if \c n is hidden. |
|
664 |
/// |
|
665 |
/// Returns true if \c n is hidden. |
|
666 |
/// |
|
667 |
bool hidden(const Node& n) const { return Parent::hidden(n); } |
|
668 |
|
|
669 |
/// \brief Returns true if \c a is hidden. |
|
670 |
/// |
|
671 |
/// Returns true if \c a is hidden. |
|
672 |
/// |
|
673 |
bool hidden(const Arc& a) const { return Parent::hidden(a); } |
|
674 |
|
|
742 | 675 |
}; |
743 | 676 |
|
744 |
/// \brief Just gives back a sub |
|
677 |
/// \brief Just gives back a sub-digraph-adaptor |
|
745 | 678 |
/// |
746 |
/// Just gives back a sub |
|
679 |
/// Just gives back a sub-digraph-adaptor |
|
747 | 680 |
template<typename Digraph, typename NodeFilterMap, typename ArcFilterMap> |
748 | 681 |
SubDigraphAdaptor<const Digraph, NodeFilterMap, ArcFilterMap> |
749 | 682 |
subDigraphAdaptor(const Digraph& digraph, |
750 | 683 |
NodeFilterMap& nfm, ArcFilterMap& afm) { |
751 | 684 |
return SubDigraphAdaptor<const Digraph, NodeFilterMap, ArcFilterMap> |
752 | 685 |
(digraph, nfm, afm); |
753 | 686 |
} |
754 | 687 |
|
755 | 688 |
template<typename Digraph, typename NodeFilterMap, typename ArcFilterMap> |
756 | 689 |
SubDigraphAdaptor<const Digraph, const NodeFilterMap, ArcFilterMap> |
757 | 690 |
subDigraphAdaptor(const Digraph& digraph, |
758 | 691 |
NodeFilterMap& nfm, ArcFilterMap& afm) { |
759 | 692 |
return SubDigraphAdaptor<const Digraph, const NodeFilterMap, ArcFilterMap> |
760 | 693 |
(digraph, nfm, afm); |
761 | 694 |
} |
762 | 695 |
|
763 | 696 |
template<typename Digraph, typename NodeFilterMap, typename ArcFilterMap> |
764 | 697 |
SubDigraphAdaptor<const Digraph, NodeFilterMap, const ArcFilterMap> |
765 | 698 |
subDigraphAdaptor(const Digraph& digraph, |
766 | 699 |
NodeFilterMap& nfm, ArcFilterMap& afm) { |
767 | 700 |
return SubDigraphAdaptor<const Digraph, NodeFilterMap, const ArcFilterMap> |
768 | 701 |
(digraph, nfm, afm); |
769 | 702 |
} |
770 | 703 |
|
771 | 704 |
template<typename Digraph, typename NodeFilterMap, typename ArcFilterMap> |
772 | 705 |
SubDigraphAdaptor<const Digraph, const NodeFilterMap, const ArcFilterMap> |
773 | 706 |
subDigraphAdaptor(const Digraph& digraph, |
774 | 707 |
NodeFilterMap& nfm, ArcFilterMap& afm) { |
775 | 708 |
return SubDigraphAdaptor<const Digraph, const NodeFilterMap, |
776 | 709 |
const ArcFilterMap>(digraph, nfm, afm); |
710 |
|
|
777 | 711 |
} |
778 | 712 |
|
779 | 713 |
|
780 | 714 |
|
781 | 715 |
///\ingroup graph_adaptors |
782 | 716 |
/// |
783 | 717 |
///\brief An adaptor for hiding nodes from a digraph. |
784 | 718 |
/// |
785 | 719 |
///An adaptor for hiding nodes from a digraph. This adaptor |
786 | 720 |
///specializes SubDigraphAdaptor in the way that only the node-set |
787 | 721 |
///can be filtered. In usual case the checked parameter is true, we |
788 | 722 |
///get the induced subgraph. But if the checked parameter is false |
789 | 723 |
///then we can filter only isolated nodes. |
790 | 724 |
template<typename _Digraph, |
791 | 725 |
typename _NodeFilterMap = typename _Digraph::template NodeMap<bool>, |
792 | 726 |
bool checked = true> |
793 | 727 |
class NodeSubDigraphAdaptor : |
794 | 728 |
public SubDigraphAdaptor<_Digraph, _NodeFilterMap, |
795 | 729 |
ConstMap<typename _Digraph::Arc, bool>, checked> { |
796 | 730 |
public: |
797 | 731 |
|
798 | 732 |
typedef _Digraph Digraph; |
799 | 733 |
typedef _NodeFilterMap NodeFilterMap; |
800 | 734 |
|
801 | 735 |
typedef SubDigraphAdaptor<Digraph, NodeFilterMap, |
802 | 736 |
ConstMap<typename Digraph::Arc, bool>, checked> |
803 | 737 |
Parent; |
804 | 738 |
|
739 |
typedef typename Parent::Node Node; |
|
740 |
|
|
805 | 741 |
protected: |
806 | 742 |
ConstMap<typename Digraph::Arc, bool> const_true_map; |
807 | 743 |
|
808 | 744 |
NodeSubDigraphAdaptor() : const_true_map(true) { |
809 | 745 |
Parent::setArcFilterMap(const_true_map); |
810 | 746 |
} |
811 | 747 |
|
812 | 748 |
public: |
813 | 749 |
|
750 |
/// \brief Constructor |
|
751 |
/// |
|
752 |
/// Creates a node-sub-digraph-adaptor for the given digraph with |
|
753 |
/// given node map filter. |
|
814 | 754 |
NodeSubDigraphAdaptor(Digraph& _digraph, NodeFilterMap& node_filter) : |
815 | 755 |
Parent(), const_true_map(true) { |
816 | 756 |
Parent::setDigraph(_digraph); |
817 | 757 |
Parent::setNodeFilterMap(node_filter); |
818 | 758 |
Parent::setArcFilterMap(const_true_map); |
819 | 759 |
} |
820 | 760 |
|
761 |
/// \brief Hides the node of the graph |
|
762 |
/// |
|
763 |
/// This function hides \c n in the digraph, i.e. the iteration |
|
764 |
/// jumps over it. This is done by simply setting the value of \c n |
|
765 |
/// to be false in the corresponding node-map. |
|
766 |
void hide(const Node& n) const { Parent::hide(n); } |
|
767 |
|
|
768 |
/// \brief Unhides the node of the graph |
|
769 |
/// |
|
770 |
/// The value of \c n is set to be true in the node-map which stores |
|
771 |
/// hide information. If \c n was hidden previuosly, then it is shown |
|
772 |
/// again |
|
773 |
void unHide(const Node& n) const { Parent::unHide(n); } |
|
774 |
|
|
775 |
/// \brief Returns true if \c n is hidden. |
|
776 |
/// |
|
777 |
/// Returns true if \c n is hidden. |
|
778 |
/// |
|
779 |
bool hidden(const Node& n) const { return Parent::hidden(n); } |
|
780 |
|
|
821 | 781 |
}; |
822 | 782 |
|
823 | 783 |
|
824 |
/// \brief Just gives back a |
|
784 |
/// \brief Just gives back a node-sub-digraph adaptor |
|
825 | 785 |
/// |
826 |
/// Just gives back a |
|
786 |
/// Just gives back a node-sub-digraph adaptor |
|
827 | 787 |
template<typename Digraph, typename NodeFilterMap> |
828 | 788 |
NodeSubDigraphAdaptor<const Digraph, NodeFilterMap> |
829 | 789 |
nodeSubDigraphAdaptor(const Digraph& digraph, NodeFilterMap& nfm) { |
830 | 790 |
return NodeSubDigraphAdaptor<const Digraph, NodeFilterMap>(digraph, nfm); |
831 | 791 |
} |
832 | 792 |
|
833 | 793 |
template<typename Digraph, typename NodeFilterMap> |
834 | 794 |
NodeSubDigraphAdaptor<const Digraph, const NodeFilterMap> |
835 | 795 |
nodeSubDigraphAdaptor(const Digraph& digraph, const NodeFilterMap& nfm) { |
836 | 796 |
return NodeSubDigraphAdaptor<const Digraph, const NodeFilterMap> |
837 | 797 |
(digraph, nfm); |
838 | 798 |
} |
839 | 799 |
|
840 | 800 |
///\ingroup graph_adaptors |
841 | 801 |
/// |
842 | 802 |
///\brief An adaptor for hiding arcs from a digraph. |
843 | 803 |
/// |
844 | 804 |
///An adaptor for hiding arcs from a digraph. This adaptor |
845 | 805 |
///specializes SubDigraphAdaptor in the way that only the arc-set |
846 | 806 |
///can be filtered. The usefulness of this adaptor is demonstrated |
847 | 807 |
///in the problem of searching a maximum number of arc-disjoint |
848 | 808 |
///shortest paths between two nodes \c s and \c t. Shortest here |
849 |
///means being shortest w.r.t. non-negative arc-lengths. Note that |
|
850 |
///the comprehension of the presented solution need's some |
|
851 |
/// |
|
809 |
///means being shortest with respect to non-negative |
|
810 |
///arc-lengths. Note that the comprehension of the presented |
|
811 |
///solution need's some elementary knowledge from combinatorial |
|
812 |
///optimization. |
|
852 | 813 |
/// |
853 | 814 |
///If a single shortest path is to be searched between \c s and \c |
854 | 815 |
///t, then this can be done easily by applying the Dijkstra |
855 | 816 |
///algorithm. What happens, if a maximum number of arc-disjoint |
856 | 817 |
///shortest paths is to be computed. It can be proved that an arc |
857 | 818 |
///can be in a shortest path if and only if it is tight with respect |
858 | 819 |
///to the potential function computed by Dijkstra. Moreover, any |
859 | 820 |
///path containing only such arcs is a shortest one. Thus we have |
860 | 821 |
///to compute a maximum number of arc-disjoint paths between \c s |
861 | 822 |
///and \c t in the digraph which has arc-set all the tight arcs. The |
862 | 823 |
///computation will be demonstrated on the following digraph, which |
863 | 824 |
///is read from the dimacs file \c sub_digraph_adaptor_demo.dim. |
864 | 825 |
///The full source code is available in \ref |
865 | 826 |
///sub_digraph_adaptor_demo.cc. If you are interested in more demo |
866 | 827 |
///programs, you can use \ref dim_to_dot.cc to generate .dot files |
867 | 828 |
///from dimacs files. The .dot file of the following figure was |
868 | 829 |
///generated by the demo program \ref dim_to_dot.cc. |
869 | 830 |
/// |
870 | 831 |
///\dot |
871 |
/// |
|
832 |
///digraph lemon_dot_example { |
|
872 | 833 |
///node [ shape=ellipse, fontname=Helvetica, fontsize=10 ]; |
873 | 834 |
///n0 [ label="0 (s)" ]; |
874 | 835 |
///n1 [ label="1" ]; |
875 | 836 |
///n2 [ label="2" ]; |
876 | 837 |
///n3 [ label="3" ]; |
877 | 838 |
///n4 [ label="4" ]; |
878 | 839 |
///n5 [ label="5" ]; |
879 | 840 |
///n6 [ label="6 (t)" ]; |
880 | 841 |
///arc [ shape=ellipse, fontname=Helvetica, fontsize=10 ]; |
881 | 842 |
///n5 -> n6 [ label="9, length:4" ]; |
882 | 843 |
///n4 -> n6 [ label="8, length:2" ]; |
883 | 844 |
///n3 -> n5 [ label="7, length:1" ]; |
884 | 845 |
///n2 -> n5 [ label="6, length:3" ]; |
885 | 846 |
///n2 -> n6 [ label="5, length:5" ]; |
886 | 847 |
///n2 -> n4 [ label="4, length:2" ]; |
887 | 848 |
///n1 -> n4 [ label="3, length:3" ]; |
888 | 849 |
///n0 -> n3 [ label="2, length:1" ]; |
889 | 850 |
///n0 -> n2 [ label="1, length:2" ]; |
890 | 851 |
///n0 -> n1 [ label="0, length:3" ]; |
891 | 852 |
///} |
892 | 853 |
///\enddot |
893 | 854 |
/// |
894 | 855 |
///\code |
895 | 856 |
///Digraph g; |
... | ... |
@@ -953,69 +914,96 @@ |
953 | 914 |
/// 3, 1--3->4 |
954 | 915 |
/// 2, 0--1->3 |
955 | 916 |
/// 1, 0--2->2 |
956 | 917 |
/// 0, 0--3->1 |
957 | 918 |
///s: 0 t: 6 |
958 | 919 |
///maximum number of arc-disjoint shortest path: 2 |
959 | 920 |
///arcs of the maximum number of arc-disjoint shortest s-t paths: |
960 | 921 |
/// 9, 5--4->6 |
961 | 922 |
/// 8, 4--2->6 |
962 | 923 |
/// 7, 3--1->5 |
963 | 924 |
/// 4, 2--2->4 |
964 | 925 |
/// 2, 0--1->3 |
965 | 926 |
/// 1, 0--2->2 |
966 | 927 |
///\endcode |
967 | 928 |
template<typename _Digraph, typename _ArcFilterMap> |
968 | 929 |
class ArcSubDigraphAdaptor : |
969 | 930 |
public SubDigraphAdaptor<_Digraph, ConstMap<typename _Digraph::Node, bool>, |
970 | 931 |
_ArcFilterMap, false> { |
971 | 932 |
public: |
972 | 933 |
typedef _Digraph Digraph; |
973 | 934 |
typedef _ArcFilterMap ArcFilterMap; |
974 | 935 |
|
975 | 936 |
typedef SubDigraphAdaptor<Digraph, ConstMap<typename Digraph::Node, bool>, |
976 | 937 |
ArcFilterMap, false> Parent; |
938 |
|
|
939 |
typedef typename Parent::Arc Arc; |
|
940 |
|
|
977 | 941 |
protected: |
978 | 942 |
ConstMap<typename Digraph::Node, bool> const_true_map; |
979 | 943 |
|
980 | 944 |
ArcSubDigraphAdaptor() : const_true_map(true) { |
981 | 945 |
Parent::setNodeFilterMap(const_true_map); |
982 | 946 |
} |
983 | 947 |
|
984 | 948 |
public: |
985 | 949 |
|
950 |
/// \brief Constructor |
|
951 |
/// |
|
952 |
/// Creates a arc-sub-digraph-adaptor for the given digraph with |
|
953 |
/// given arc map filter. |
|
986 | 954 |
ArcSubDigraphAdaptor(Digraph& digraph, ArcFilterMap& arc_filter) |
987 | 955 |
: Parent(), const_true_map(true) { |
988 | 956 |
Parent::setDigraph(digraph); |
989 | 957 |
Parent::setNodeFilterMap(const_true_map); |
990 | 958 |
Parent::setArcFilterMap(arc_filter); |
991 | 959 |
} |
992 | 960 |
|
961 |
/// \brief Hides the arc of the graph |
|
962 |
/// |
|
963 |
/// This function hides \c a in the digraph, i.e. the iteration |
|
964 |
/// jumps over it. This is done by simply setting the value of \c a |
|
965 |
/// to be false in the corresponding arc-map. |
|
966 |
void hide(const Arc& a) const { Parent::hide(a); } |
|
967 |
|
|
968 |
/// \brief Unhides the arc of the graph |
|
969 |
/// |
|
970 |
/// The value of \c a is set to be true in the arc-map which stores |
|
971 |
/// hide information. If \c a was hidden previuosly, then it is shown |
|
972 |
/// again |
|
973 |
void unHide(const Arc& a) const { Parent::unHide(a); } |
|
974 |
|
|
975 |
/// \brief Returns true if \c a is hidden. |
|
976 |
/// |
|
977 |
/// Returns true if \c a is hidden. |
|
978 |
/// |
|
979 |
bool hidden(const Arc& a) const { return Parent::hidden(a); } |
|
980 |
|
|
993 | 981 |
}; |
994 | 982 |
|
995 |
/// \brief Just gives back an arc |
|
983 |
/// \brief Just gives back an arc-sub-digraph adaptor |
|
996 | 984 |
/// |
997 |
/// Just gives back an arc |
|
985 |
/// Just gives back an arc-sub-digraph adaptor |
|
998 | 986 |
template<typename Digraph, typename ArcFilterMap> |
999 | 987 |
ArcSubDigraphAdaptor<const Digraph, ArcFilterMap> |
1000 | 988 |
arcSubDigraphAdaptor(const Digraph& digraph, ArcFilterMap& afm) { |
1001 | 989 |
return ArcSubDigraphAdaptor<const Digraph, ArcFilterMap>(digraph, afm); |
1002 | 990 |
} |
1003 | 991 |
|
1004 | 992 |
template<typename Digraph, typename ArcFilterMap> |
1005 | 993 |
ArcSubDigraphAdaptor<const Digraph, const ArcFilterMap> |
1006 | 994 |
arcSubDigraphAdaptor(const Digraph& digraph, const ArcFilterMap& afm) { |
1007 | 995 |
return ArcSubDigraphAdaptor<const Digraph, const ArcFilterMap> |
1008 | 996 |
(digraph, afm); |
1009 | 997 |
} |
1010 | 998 |
|
1011 | 999 |
template <typename _Digraph> |
1012 | 1000 |
class UndirDigraphAdaptorBase { |
1013 | 1001 |
public: |
1014 | 1002 |
typedef _Digraph Digraph; |
1015 | 1003 |
typedef UndirDigraphAdaptorBase Adaptor; |
1016 | 1004 |
|
1017 | 1005 |
typedef True UndirectedTag; |
1018 | 1006 |
|
1019 | 1007 |
typedef typename Digraph::Arc Edge; |
1020 | 1008 |
typedef typename Digraph::Node Node; |
1021 | 1009 |
|
... | ... |
@@ -1372,54 +1360,54 @@ |
1372 | 1360 |
EdgeMap& operator=(const CMap& cmap) { |
1373 | 1361 |
Parent::operator=(cmap); |
1374 | 1362 |
return *this; |
1375 | 1363 |
} |
1376 | 1364 |
|
1377 | 1365 |
}; |
1378 | 1366 |
|
1379 | 1367 |
typedef typename ItemSetTraits<Digraph, Node>::ItemNotifier NodeNotifier; |
1380 | 1368 |
NodeNotifier& notifier(Node) const { return _digraph->notifier(Node()); } |
1381 | 1369 |
|
1382 | 1370 |
protected: |
1383 | 1371 |
|
1384 | 1372 |
UndirDigraphAdaptorBase() : _digraph(0) {} |
1385 | 1373 |
|
1386 | 1374 |
Digraph* _digraph; |
1387 | 1375 |
|
1388 | 1376 |
void setDigraph(Digraph& digraph) { |
1389 | 1377 |
_digraph = &digraph; |
1390 | 1378 |
} |
1391 | 1379 |
|
1392 | 1380 |
}; |
1393 | 1381 |
|
1394 | 1382 |
///\ingroup graph_adaptors |
1395 | 1383 |
/// |
1396 |
/// \brief |
|
1384 |
/// \brief A graph is made from a directed digraph by an adaptor |
|
1397 | 1385 |
/// |
1398 | 1386 |
/// This adaptor makes an undirected graph from a directed |
1399 |
/// digraph. All arc of the underlying will be showed in the adaptor |
|
1400 |
/// as an edge. Let's see an informal example about using |
|
1401 |
/// |
|
1387 |
/// graph. All arc of the underlying digraph will be showed in the |
|
1388 |
/// adaptor as an edge. Let's see an informal example about using |
|
1389 |
/// this adaptor. |
|
1402 | 1390 |
/// |
1403 | 1391 |
/// There is a network of the streets of a town. Of course there are |
1404 | 1392 |
/// some one-way street in the town hence the network is a directed |
1405 | 1393 |
/// one. There is a crazy driver who go oppositely in the one-way |
1406 | 1394 |
/// street without moral sense. Of course he can pass this streets |
1407 | 1395 |
/// slower than the regular way, in fact his speed is half of the |
1408 | 1396 |
/// normal speed. How long should he drive to get from a source |
1409 | 1397 |
/// point to the target? Let see the example code which calculate it: |
1410 | 1398 |
/// |
1411 | 1399 |
/// \todo BadCode, SimpleMap does no exists |
1412 | 1400 |
///\code |
1413 | 1401 |
/// typedef UndirDigraphAdaptor<Digraph> Graph; |
1414 | 1402 |
/// Graph graph(digraph); |
1415 | 1403 |
/// |
1416 | 1404 |
/// typedef SimpleMap<LengthMap> FLengthMap; |
1417 | 1405 |
/// FLengthMap flength(length); |
1418 | 1406 |
/// |
1419 | 1407 |
/// typedef ScaleMap<LengthMap> RLengthMap; |
1420 | 1408 |
/// RLengthMap rlength(length, 2.0); |
1421 | 1409 |
/// |
1422 | 1410 |
/// typedef Graph::CombinedArcMap<FLengthMap, RLengthMap > ULengthMap; |
1423 | 1411 |
/// ULengthMap ulength(flength, rlength); |
1424 | 1412 |
/// |
1425 | 1413 |
/// Dijkstra<Graph, ULengthMap> dijkstra(graph, ulength); |
... | ... |
@@ -1781,54 +1769,48 @@ |
1781 | 1769 |
return UndirDigraph::direct(e, false); |
1782 | 1770 |
} |
1783 | 1771 |
|
1784 | 1772 |
/// \brief Residual capacity map. |
1785 | 1773 |
/// |
1786 | 1774 |
/// In generic residual digraphs the residual capacity can be obtained |
1787 | 1775 |
/// as a map. |
1788 | 1776 |
class ResCap { |
1789 | 1777 |
protected: |
1790 | 1778 |
const Adaptor* _adaptor; |
1791 | 1779 |
public: |
1792 | 1780 |
typedef Arc Key; |
1793 | 1781 |
typedef typename _CapacityMap::Value Value; |
1794 | 1782 |
|
1795 | 1783 |
ResCap(const Adaptor& adaptor) : _adaptor(&adaptor) {} |
1796 | 1784 |
|
1797 | 1785 |
Value operator[](const Arc& e) const { |
1798 | 1786 |
return _adaptor->rescap(e); |
1799 | 1787 |
} |
1800 | 1788 |
|
1801 | 1789 |
}; |
1802 | 1790 |
|
1803 | 1791 |
}; |
1804 | 1792 |
|
1805 |
/// \brief Base class for split digraph adaptor |
|
1806 |
/// |
|
1807 |
/// Base class of split digraph adaptor. In most case you do not need to |
|
1808 |
/// use it directly but the documented member functions of this class can |
|
1809 |
/// be used with the SplitDigraphAdaptor class. |
|
1810 |
/// \sa SplitDigraphAdaptor |
|
1811 | 1793 |
template <typename _Digraph> |
1812 | 1794 |
class SplitDigraphAdaptorBase { |
1813 | 1795 |
public: |
1814 | 1796 |
|
1815 | 1797 |
typedef _Digraph Digraph; |
1816 | 1798 |
typedef DigraphAdaptorBase<const _Digraph> Parent; |
1817 | 1799 |
typedef SplitDigraphAdaptorBase Adaptor; |
1818 | 1800 |
|
1819 | 1801 |
typedef typename Digraph::Node DigraphNode; |
1820 | 1802 |
typedef typename Digraph::Arc DigraphArc; |
1821 | 1803 |
|
1822 | 1804 |
class Node; |
1823 | 1805 |
class Arc; |
1824 | 1806 |
|
1825 | 1807 |
private: |
1826 | 1808 |
|
1827 | 1809 |
template <typename T> class NodeMapBase; |
1828 | 1810 |
template <typename T> class ArcMapBase; |
1829 | 1811 |
|
1830 | 1812 |
public: |
1831 | 1813 |
|
1832 | 1814 |
class Node : public DigraphNode { |
1833 | 1815 |
friend class SplitDigraphAdaptorBase; |
1834 | 1816 |
template <typename T> friend class NodeMapBase; |
... | ... |
@@ -2001,100 +1983,76 @@ |
2001 | 1983 |
} |
2002 | 1984 |
int maxNodeId() const { |
2003 | 1985 |
return 2 * _digraph->maxNodeId() + 1; |
2004 | 1986 |
} |
2005 | 1987 |
|
2006 | 1988 |
int id(const Arc& e) const { |
2007 | 1989 |
if (e._item.firstState()) { |
2008 | 1990 |
return _digraph->id(e._item.first()) << 1; |
2009 | 1991 |
} else { |
2010 | 1992 |
return (_digraph->id(e._item.second()) << 1) | 1; |
2011 | 1993 |
} |
2012 | 1994 |
} |
2013 | 1995 |
Arc arcFromId(int ix) const { |
2014 | 1996 |
if ((ix & 1) == 0) { |
2015 | 1997 |
return Arc(_digraph->arcFromId(ix >> 1)); |
2016 | 1998 |
} else { |
2017 | 1999 |
return Arc(_digraph->nodeFromId(ix >> 1)); |
2018 | 2000 |
} |
2019 | 2001 |
} |
2020 | 2002 |
int maxArcId() const { |
2021 | 2003 |
return std::max(_digraph->maxNodeId() << 1, |
2022 | 2004 |
(_digraph->maxArcId() << 1) | 1); |
2023 | 2005 |
} |
2024 | 2006 |
|
2025 |
/// \brief Returns true when the node is in-node. |
|
2026 |
/// |
|
2027 |
/// Returns true when the node is in-node. |
|
2028 | 2007 |
static bool inNode(const Node& n) { |
2029 | 2008 |
return n._in; |
2030 | 2009 |
} |
2031 | 2010 |
|
2032 |
/// \brief Returns true when the node is out-node. |
|
2033 |
/// |
|
2034 |
/// Returns true when the node is out-node. |
|
2035 | 2011 |
static bool outNode(const Node& n) { |
2036 | 2012 |
return !n._in; |
2037 | 2013 |
} |
2038 | 2014 |
|
2039 |
/// \brief Returns true when the arc is arc in the original digraph. |
|
2040 |
/// |
|
2041 |
/// Returns true when the arc is arc in the original digraph. |
|
2042 | 2015 |
static bool origArc(const Arc& e) { |
2043 | 2016 |
return e._item.firstState(); |
2044 | 2017 |
} |
2045 | 2018 |
|
2046 |
/// \brief Returns true when the arc binds an in-node and an out-node. |
|
2047 |
/// |
|
2048 |
/// Returns true when the arc binds an in-node and an out-node. |
|
2049 | 2019 |
static bool bindArc(const Arc& e) { |
2050 | 2020 |
return e._item.secondState(); |
2051 | 2021 |
} |
2052 | 2022 |
|
2053 |
/// \brief Gives back the in-node created from the \c node. |
|
2054 |
/// |
|
2055 |
/// Gives back the in-node created from the \c node. |
|
2056 | 2023 |
static Node inNode(const DigraphNode& n) { |
2057 | 2024 |
return Node(n, true); |
2058 | 2025 |
} |
2059 | 2026 |
|
2060 |
/// \brief Gives back the out-node created from the \c node. |
|
2061 |
/// |
|
2062 |
/// Gives back the out-node created from the \c node. |
|
2063 | 2027 |
static Node outNode(const DigraphNode& n) { |
2064 | 2028 |
return Node(n, false); |
2065 | 2029 |
} |
2066 | 2030 |
|
2067 |
/// \brief Gives back the arc binds the two part of the node. |
|
2068 |
/// |
|
2069 |
/// Gives back the arc binds the two part of the node. |
|
2070 | 2031 |
static Arc arc(const DigraphNode& n) { |
2071 | 2032 |
return Arc(n); |
2072 | 2033 |
} |
2073 | 2034 |
|
2074 |
/// \brief Gives back the arc of the original arc. |
|
2075 |
/// |
|
2076 |
/// Gives back the arc of the original arc. |
|
2077 | 2035 |
static Arc arc(const DigraphArc& e) { |
2078 | 2036 |
return Arc(e); |
2079 | 2037 |
} |
2080 | 2038 |
|
2081 | 2039 |
typedef True NodeNumTag; |
2082 | 2040 |
|
2083 | 2041 |
int nodeNum() const { |
2084 | 2042 |
return 2 * countNodes(*_digraph); |
2085 | 2043 |
} |
2086 | 2044 |
|
2087 | 2045 |
typedef True EdgeNumTag; |
2088 | 2046 |
int arcNum() const { |
2089 | 2047 |
return countArcs(*_digraph) + countNodes(*_digraph); |
2090 | 2048 |
} |
2091 | 2049 |
|
2092 | 2050 |
typedef True FindEdgeTag; |
2093 | 2051 |
Arc findArc(const Node& u, const Node& v, |
2094 | 2052 |
const Arc& prev = INVALID) const { |
2095 | 2053 |
if (inNode(u)) { |
2096 | 2054 |
if (outNode(v)) { |
2097 | 2055 |
if (static_cast<const DigraphNode&>(u) == |
2098 | 2056 |
static_cast<const DigraphNode&>(v) && prev == INVALID) { |
2099 | 2057 |
return Arc(u); |
2100 | 2058 |
} |
... | ... |
@@ -2254,49 +2212,49 @@ |
2254 | 2212 |
_digraph = &digraph; |
2255 | 2213 |
} |
2256 | 2214 |
|
2257 | 2215 |
}; |
2258 | 2216 |
|
2259 | 2217 |
/// \ingroup graph_adaptors |
2260 | 2218 |
/// |
2261 | 2219 |
/// \brief Split digraph adaptor class |
2262 | 2220 |
/// |
2263 | 2221 |
/// This is an digraph adaptor which splits all node into an in-node |
2264 | 2222 |
/// and an out-node. Formaly, the adaptor replaces each \f$ u \f$ |
2265 | 2223 |
/// node in the digraph with two node, \f$ u_{in} \f$ node and |
2266 | 2224 |
/// \f$ u_{out} \f$ node. If there is an \f$ (v, u) \f$ arc in the |
2267 | 2225 |
/// original digraph the new target of the arc will be \f$ u_{in} \f$ and |
2268 | 2226 |
/// similarly the source of the original \f$ (u, v) \f$ arc will be |
2269 | 2227 |
/// \f$ u_{out} \f$. The adaptor will add for each node in the |
2270 | 2228 |
/// original digraph an additional arc which will connect |
2271 | 2229 |
/// \f$ (u_{in}, u_{out}) \f$. |
2272 | 2230 |
/// |
2273 | 2231 |
/// The aim of this class is to run algorithm with node costs if the |
2274 | 2232 |
/// algorithm can use directly just arc costs. In this case we should use |
2275 | 2233 |
/// a \c SplitDigraphAdaptor and set the node cost of the digraph to the |
2276 | 2234 |
/// bind arc in the adapted digraph. |
2277 | 2235 |
/// |
2278 |
/// |
|
2236 |
/// For example a maximum flow algorithm can compute how many arc |
|
2279 | 2237 |
/// disjoint paths are in the digraph. But we would like to know how |
2280 | 2238 |
/// many node disjoint paths are in the digraph. First we have to |
2281 | 2239 |
/// adapt the digraph with the \c SplitDigraphAdaptor. Then run the flow |
2282 | 2240 |
/// algorithm on the adapted digraph. The bottleneck of the flow will |
2283 | 2241 |
/// be the bind arcs which bounds the flow with the count of the |
2284 | 2242 |
/// node disjoint paths. |
2285 | 2243 |
/// |
2286 | 2244 |
///\code |
2287 | 2245 |
/// |
2288 | 2246 |
/// typedef SplitDigraphAdaptor<SmartDigraph> SDigraph; |
2289 | 2247 |
/// |
2290 | 2248 |
/// SDigraph sdigraph(digraph); |
2291 | 2249 |
/// |
2292 | 2250 |
/// typedef ConstMap<SDigraph::Arc, int> SCapacity; |
2293 | 2251 |
/// SCapacity scapacity(1); |
2294 | 2252 |
/// |
2295 | 2253 |
/// SDigraph::ArcMap<int> sflow(sdigraph); |
2296 | 2254 |
/// |
2297 | 2255 |
/// Preflow<SDigraph, SCapacity> |
2298 | 2256 |
/// spreflow(sdigraph, scapacity, |
2299 | 2257 |
/// SDigraph::outNode(source), SDigraph::inNode(target)); |
2300 | 2258 |
/// |
2301 | 2259 |
/// spreflow.run(); |
2302 | 2260 |
/// |
... | ... |
@@ -2309,58 +2267,117 @@ |
2309 | 2267 |
/// \image latex arc_disjoint.eps "Arc disjoint paths" width=\textwidth |
2310 | 2268 |
/// |
2311 | 2269 |
/// And the maximum flow on the adapted digraph: |
2312 | 2270 |
/// |
2313 | 2271 |
/// \image html node_disjoint.png |
2314 | 2272 |
/// \image latex node_disjoint.eps "Node disjoint paths" width=\textwidth |
2315 | 2273 |
/// |
2316 | 2274 |
/// The second solution contains just 3 disjoint paths while the first 4. |
2317 | 2275 |
/// The full code can be found in the \ref disjoint_paths_demo.cc demo file. |
2318 | 2276 |
/// |
2319 | 2277 |
/// This digraph adaptor is fully conform to the |
2320 | 2278 |
/// \ref concepts::Digraph "Digraph" concept and |
2321 | 2279 |
/// contains some additional member functions and types. The |
2322 | 2280 |
/// documentation of some member functions may be found just in the |
2323 | 2281 |
/// SplitDigraphAdaptorBase class. |
2324 | 2282 |
/// |
2325 | 2283 |
/// \sa SplitDigraphAdaptorBase |
2326 | 2284 |
template <typename _Digraph> |
2327 | 2285 |
class SplitDigraphAdaptor |
2328 | 2286 |
: public DigraphAdaptorExtender<SplitDigraphAdaptorBase<_Digraph> > { |
2329 | 2287 |
public: |
2330 | 2288 |
typedef _Digraph Digraph; |
2331 | 2289 |
typedef DigraphAdaptorExtender<SplitDigraphAdaptorBase<Digraph> > Parent; |
2332 | 2290 |
|
2291 |
typedef typename Digraph::Node DigraphNode; |
|
2292 |
typedef typename Digraph::Arc DigraphArc; |
|
2293 |
|
|
2333 | 2294 |
typedef typename Parent::Node Node; |
2334 | 2295 |
typedef typename Parent::Arc Arc; |
2335 | 2296 |
|
2336 | 2297 |
/// \brief Constructor of the adaptor. |
2337 | 2298 |
/// |
2338 | 2299 |
/// Constructor of the adaptor. |
2339 | 2300 |
SplitDigraphAdaptor(Digraph& g) { |
2340 | 2301 |
Parent::setDigraph(g); |
2341 | 2302 |
} |
2342 | 2303 |
|
2304 |
/// \brief Returns true when the node is in-node. |
|
2305 |
/// |
|
2306 |
/// Returns true when the node is in-node. |
|
2307 |
static bool inNode(const Node& n) { |
|
2308 |
return Parent::inNode(n); |
|
2309 |
} |
|
2310 |
|
|
2311 |
/// \brief Returns true when the node is out-node. |
|
2312 |
/// |
|
2313 |
/// Returns true when the node is out-node. |
|
2314 |
static bool outNode(const Node& n) { |
|
2315 |
return Parent::outNode(n); |
|
2316 |
} |
|
2317 |
|
|
2318 |
/// \brief Returns true when the arc is arc in the original digraph. |
|
2319 |
/// |
|
2320 |
/// Returns true when the arc is arc in the original digraph. |
|
2321 |
static bool origArc(const Arc& a) { |
|
2322 |
return Parent::origArc(a); |
|
2323 |
} |
|
2324 |
|
|
2325 |
/// \brief Returns true when the arc binds an in-node and an out-node. |
|
2326 |
/// |
|
2327 |
/// Returns true when the arc binds an in-node and an out-node. |
|
2328 |
static bool bindArc(const Arc& a) { |
|
2329 |
return Parent::bindArc(a); |
|
2330 |
} |
|
2331 |
|
|
2332 |
/// \brief Gives back the in-node created from the \c node. |
|
2333 |
/// |
|
2334 |
/// Gives back the in-node created from the \c node. |
|
2335 |
static Node inNode(const DigraphNode& n) { |
|
2336 |
return Parent::inNode(n); |
|
2337 |
} |
|
2338 |
|
|
2339 |
/// \brief Gives back the out-node created from the \c node. |
|
2340 |
/// |
|
2341 |
/// Gives back the out-node created from the \c node. |
|
2342 |
static Node outNode(const DigraphNode& n) { |
|
2343 |
return Parent::outNode(n); |
|
2344 |
} |
|
2345 |
|
|
2346 |
/// \brief Gives back the arc binds the two part of the node. |
|
2347 |
/// |
|
2348 |
/// Gives back the arc binds the two part of the node. |
|
2349 |
static Arc arc(const DigraphNode& n) { |
|
2350 |
return Parent::arc(n); |
|
2351 |
} |
|
2352 |
|
|
2353 |
/// \brief Gives back the arc of the original arc. |
|
2354 |
/// |
|
2355 |
/// Gives back the arc of the original arc. |
|
2356 |
static Arc arc(const DigraphArc& a) { |
|
2357 |
return Parent::arc(a); |
|
2358 |
} |
|
2359 |
|
|
2343 | 2360 |
/// \brief NodeMap combined from two original NodeMap |
2344 | 2361 |
/// |
2345 | 2362 |
/// This class adapt two of the original digraph NodeMap to |
2346 | 2363 |
/// get a node map on the adapted digraph. |
2347 | 2364 |
template <typename InNodeMap, typename OutNodeMap> |
2348 | 2365 |
class CombinedNodeMap { |
2349 | 2366 |
public: |
2350 | 2367 |
|
2351 | 2368 |
typedef Node Key; |
2352 | 2369 |
typedef typename InNodeMap::Value Value; |
2353 | 2370 |
|
2354 | 2371 |
/// \brief Constructor |
2355 | 2372 |
/// |
2356 | 2373 |
/// Constructor. |
2357 | 2374 |
CombinedNodeMap(InNodeMap& in_map, OutNodeMap& out_map) |
2358 | 2375 |
: _in_map(in_map), _out_map(out_map) {} |
2359 | 2376 |
|
2360 | 2377 |
/// \brief The subscript operator. |
2361 | 2378 |
/// |
2362 | 2379 |
/// The subscript operator. |
2363 | 2380 |
Value& operator[](const Key& key) { |
2364 | 2381 |
if (Parent::inNode(key)) { |
2365 | 2382 |
return _in_map[key]; |
2366 | 2383 |
} else { |
... | ... |
@@ -10,57 +10,48 @@ |
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_GRAPH_ADAPTOR_H |
20 | 20 |
#define LEMON_GRAPH_ADAPTOR_H |
21 | 21 |
|
22 | 22 |
///\ingroup graph_adaptors |
23 | 23 |
///\file |
24 | 24 |
///\brief Several graph adaptors. |
25 | 25 |
/// |
26 | 26 |
///This file contains several useful undirected graph adaptor classes. |
27 | 27 |
|
28 | 28 |
#include <lemon/core.h> |
29 | 29 |
#include <lemon/maps.h> |
30 | 30 |
#include <lemon/bits/graph_adaptor_extender.h> |
31 | 31 |
|
32 | 32 |
namespace lemon { |
33 | 33 |
|
34 |
/// \brief Base type for the Graph Adaptors |
|
35 |
/// |
|
36 |
/// This is the base type for most of LEMON graph adaptors. |
|
37 |
/// This class implements a trivial graph adaptor i.e. it only wraps the |
|
38 |
/// functions and types of the graph. The purpose of this class is to |
|
39 |
/// make easier implementing graph adaptors. E.g. if an adaptor is |
|
40 |
/// considered which differs from the wrapped graph only in some of its |
|
41 |
/// functions or types, then it can be derived from GraphAdaptor, and only |
|
42 |
/// the differences should be implemented. |
|
43 | 34 |
template<typename _Graph> |
44 | 35 |
class GraphAdaptorBase { |
45 | 36 |
public: |
46 | 37 |
typedef _Graph Graph; |
47 | 38 |
typedef Graph ParentGraph; |
48 | 39 |
|
49 | 40 |
protected: |
50 | 41 |
Graph* _graph; |
51 | 42 |
|
52 | 43 |
GraphAdaptorBase() : _graph(0) {} |
53 | 44 |
|
54 | 45 |
void setGraph(Graph& graph) { _graph = &graph; } |
55 | 46 |
|
56 | 47 |
public: |
57 | 48 |
GraphAdaptorBase(Graph& graph) : _graph(&graph) {} |
58 | 49 |
|
59 | 50 |
typedef typename Graph::Node Node; |
60 | 51 |
typedef typename Graph::Arc Arc; |
61 | 52 |
typedef typename Graph::Edge Edge; |
62 | 53 |
|
63 | 54 |
void first(Node& i) const { _graph->first(i); } |
64 | 55 |
void first(Arc& i) const { _graph->first(i); } |
65 | 56 |
void first(Edge& i) const { _graph->first(i); } |
66 | 57 |
void firstIn(Arc& i, const Node& n) const { _graph->firstIn(i, n); } |
... | ... |
@@ -174,67 +165,48 @@ |
174 | 165 |
|
175 | 166 |
template <typename _Value> |
176 | 167 |
class EdgeMap : public Graph::template EdgeMap<_Value> { |
177 | 168 |
public: |
178 | 169 |
typedef typename Graph::template EdgeMap<_Value> Parent; |
179 | 170 |
explicit EdgeMap(const GraphAdaptorBase<Graph>& adapter) |
180 | 171 |
: Parent(*adapter._graph) {} |
181 | 172 |
EdgeMap(const GraphAdaptorBase<Graph>& adapter, const _Value& value) |
182 | 173 |
: Parent(*adapter._graph, value) {} |
183 | 174 |
|
184 | 175 |
private: |
185 | 176 |
EdgeMap& operator=(const EdgeMap& cmap) { |
186 | 177 |
return operator=<EdgeMap>(cmap); |
187 | 178 |
} |
188 | 179 |
|
189 | 180 |
template <typename CMap> |
190 | 181 |
EdgeMap& operator=(const CMap& cmap) { |
191 | 182 |
Parent::operator=(cmap); |
192 | 183 |
return *this; |
193 | 184 |
} |
194 | 185 |
}; |
195 | 186 |
|
196 | 187 |
}; |
197 | 188 |
|
198 |
/// \ingroup graph_adaptors |
|
199 |
/// |
|
200 |
/// \brief Trivial graph adaptor |
|
201 |
/// |
|
202 |
/// This class is an adaptor which does not change the adapted undirected |
|
203 |
/// graph. It can be used only to test the graph adaptors. |
|
204 |
template <typename _Graph> |
|
205 |
class GraphAdaptor |
|
206 |
: public GraphAdaptorExtender< GraphAdaptorBase<_Graph> > { |
|
207 |
public: |
|
208 |
typedef _Graph Graph; |
|
209 |
typedef GraphAdaptorExtender<GraphAdaptorBase<_Graph> > Parent; |
|
210 |
protected: |
|
211 |
GraphAdaptor() : Parent() {} |
|
212 |
|
|
213 |
public: |
|
214 |
explicit GraphAdaptor(Graph& graph) { setGraph(graph); } |
|
215 |
}; |
|
216 |
|
|
217 | 189 |
template <typename _Graph, typename NodeFilterMap, |
218 | 190 |
typename EdgeFilterMap, bool checked = true> |
219 | 191 |
class SubGraphAdaptorBase : public GraphAdaptorBase<_Graph> { |
220 | 192 |
public: |
221 | 193 |
typedef _Graph Graph; |
222 | 194 |
typedef SubGraphAdaptorBase Adaptor; |
223 | 195 |
typedef GraphAdaptorBase<_Graph> Parent; |
224 | 196 |
protected: |
225 | 197 |
|
226 | 198 |
NodeFilterMap* _node_filter_map; |
227 | 199 |
EdgeFilterMap* _edge_filter_map; |
228 | 200 |
|
229 | 201 |
SubGraphAdaptorBase() |
230 | 202 |
: Parent(), _node_filter_map(0), _edge_filter_map(0) { } |
231 | 203 |
|
232 | 204 |
void setNodeFilterMap(NodeFilterMap& node_filter_map) { |
233 | 205 |
_node_filter_map=&node_filter_map; |
234 | 206 |
} |
235 | 207 |
void setEdgeFilterMap(EdgeFilterMap& edge_filter_map) { |
236 | 208 |
_edge_filter_map=&edge_filter_map; |
237 | 209 |
} |
238 | 210 |
|
239 | 211 |
public: |
240 | 212 |
|
... | ... |
@@ -297,84 +269,55 @@ |
297 | 269 |
while (i!=INVALID && (!(*_edge_filter_map)[i] |
298 | 270 |
|| !(*_node_filter_map)[Parent::u(i)] |
299 | 271 |
|| !(*_node_filter_map)[Parent::v(i)])) Parent::next(i); |
300 | 272 |
} |
301 | 273 |
|
302 | 274 |
void nextIn(Arc& i) const { |
303 | 275 |
Parent::nextIn(i); |
304 | 276 |
while (i!=INVALID && (!(*_edge_filter_map)[i] |
305 | 277 |
|| !(*_node_filter_map)[Parent::source(i)])) Parent::nextIn(i); |
306 | 278 |
} |
307 | 279 |
|
308 | 280 |
void nextOut(Arc& i) const { |
309 | 281 |
Parent::nextOut(i); |
310 | 282 |
while (i!=INVALID && (!(*_edge_filter_map)[i] |
311 | 283 |
|| !(*_node_filter_map)[Parent::target(i)])) Parent::nextOut(i); |
312 | 284 |
} |
313 | 285 |
|
314 | 286 |
void nextInc(Edge& i, bool& d) const { |
315 | 287 |
Parent::nextInc(i, d); |
316 | 288 |
while (i!=INVALID && (!(*_edge_filter_map)[i] |
317 | 289 |
|| !(*_node_filter_map)[Parent::u(i)] |
318 | 290 |
|| !(*_node_filter_map)[Parent::v(i)])) Parent::nextInc(i, d); |
319 | 291 |
} |
320 | 292 |
|
321 |
/// \brief Hide the given node in the graph. |
|
322 |
/// |
|
323 |
/// This function hides \c n in the graph, i.e. the iteration |
|
324 |
/// jumps over it. This is done by simply setting the value of \c n |
|
325 |
/// to be false in the corresponding node-map. |
|
326 | 293 |
void hide(const Node& n) const { _node_filter_map->set(n, false); } |
327 |
|
|
328 |
/// \brief Hide the given edge in the graph. |
|
329 |
/// |
|
330 |
/// This function hides \c e in the graph, i.e. the iteration |
|
331 |
/// jumps over it. This is done by simply setting the value of \c e |
|
332 |
/// to be false in the corresponding edge-map. |
|
333 | 294 |
void hide(const Edge& e) const { _edge_filter_map->set(e, false); } |
334 | 295 |
|
335 |
/// \brief Unhide the given node in the graph. |
|
336 |
/// |
|
337 |
/// The value of \c n is set to be true in the node-map which stores |
|
338 |
/// hide information. If \c n was hidden previuosly, then it is shown |
|
339 |
/// again |
|
340 |
void unHide(const Node& n) const { _node_filter_map->set(n, true); } |
|
341 |
|
|
342 |
/// \brief Hide the given edge in the graph. |
|
343 |
/// |
|
344 |
/// The value of \c e is set to be true in the edge-map which stores |
|
345 |
/// hide information. If \c e was hidden previuosly, then it is shown |
|
346 |
/// again |
|
296 |
void unHide(const Node& n) const { _node_filter_map->set(n, true); } |
|
347 | 297 |
void unHide(const Edge& e) const { _edge_filter_map->set(e, true); } |
348 | 298 |
|
349 |
/// \brief Returns true if \c n is hidden. |
|
350 |
/// |
|
351 |
/// Returns true if \c n is hidden. |
|
352 | 299 |
bool hidden(const Node& n) const { return !(*_node_filter_map)[n]; } |
353 |
|
|
354 |
/// \brief Returns true if \c e is hidden. |
|
355 |
/// |
|
356 |
/// Returns true if \c e is hidden. |
|
357 | 300 |
bool hidden(const Edge& e) const { return !(*_edge_filter_map)[e]; } |
358 | 301 |
|
359 | 302 |
typedef False NodeNumTag; |
360 | 303 |
typedef False EdgeNumTag; |
361 | 304 |
|
362 | 305 |
typedef FindEdgeTagIndicator<Graph> FindEdgeTag; |
363 | 306 |
Arc findArc(const Node& u, const Node& v, |
364 | 307 |
const Arc& prev = INVALID) { |
365 | 308 |
if (!(*_node_filter_map)[u] || !(*_node_filter_map)[v]) { |
366 | 309 |
return INVALID; |
367 | 310 |
} |
368 | 311 |
Arc arc = Parent::findArc(u, v, prev); |
369 | 312 |
while (arc != INVALID && !(*_edge_filter_map)[arc]) { |
370 | 313 |
arc = Parent::findArc(u, v, arc); |
371 | 314 |
} |
372 | 315 |
return arc; |
373 | 316 |
} |
374 | 317 |
Edge findEdge(const Node& u, const Node& v, |
375 | 318 |
const Edge& prev = INVALID) { |
376 | 319 |
if (!(*_node_filter_map)[u] || !(*_node_filter_map)[v]) { |
377 | 320 |
return INVALID; |
378 | 321 |
} |
379 | 322 |
Edge edge = Parent::findEdge(u, v, prev); |
380 | 323 |
while (edge != INVALID && !(*_edge_filter_map)[edge]) { |
... | ... |
@@ -522,84 +465,55 @@ |
522 | 465 |
while (i!=INVALID && !(*_node_filter_map)[i]) Parent::next(i); |
523 | 466 |
} |
524 | 467 |
void next(Arc& i) const { |
525 | 468 |
Parent::next(i); |
526 | 469 |
while (i!=INVALID && !(*_edge_filter_map)[i]) Parent::next(i); |
527 | 470 |
} |
528 | 471 |
void next(Edge& i) const { |
529 | 472 |
Parent::next(i); |
530 | 473 |
while (i!=INVALID && !(*_edge_filter_map)[i]) Parent::next(i); |
531 | 474 |
} |
532 | 475 |
void nextIn(Arc& i) const { |
533 | 476 |
Parent::nextIn(i); |
534 | 477 |
while (i!=INVALID && !(*_edge_filter_map)[i]) Parent::nextIn(i); |
535 | 478 |
} |
536 | 479 |
|
537 | 480 |
void nextOut(Arc& i) const { |
538 | 481 |
Parent::nextOut(i); |
539 | 482 |
while (i!=INVALID && !(*_edge_filter_map)[i]) Parent::nextOut(i); |
540 | 483 |
} |
541 | 484 |
void nextInc(Edge& i, bool& d) const { |
542 | 485 |
Parent::nextInc(i, d); |
543 | 486 |
while (i!=INVALID && !(*_edge_filter_map)[i]) Parent::nextInc(i, d); |
544 | 487 |
} |
545 | 488 |
|
546 |
/// \brief Hide the given node in the graph. |
|
547 |
/// |
|
548 |
/// This function hides \c n in the graph, i.e. the iteration |
|
549 |
/// jumps over it. This is done by simply setting the value of \c n |
|
550 |
/// to be false in the corresponding node-map. |
|
551 | 489 |
void hide(const Node& n) const { _node_filter_map->set(n, false); } |
552 |
|
|
553 |
/// \brief Hide the given edge in the graph. |
|
554 |
/// |
|
555 |
/// This function hides \c e in the graph, i.e. the iteration |
|
556 |
/// jumps over it. This is done by simply setting the value of \c e |
|
557 |
/// to be false in the corresponding edge-map. |
|
558 | 490 |
void hide(const Edge& e) const { _edge_filter_map->set(e, false); } |
559 | 491 |
|
560 |
/// \brief Unhide the given node in the graph. |
|
561 |
/// |
|
562 |
/// The value of \c n is set to be true in the node-map which stores |
|
563 |
/// hide information. If \c n was hidden previuosly, then it is shown |
|
564 |
/// again |
|
565 |
void unHide(const Node& n) const { _node_filter_map->set(n, true); } |
|
566 |
|
|
567 |
/// \brief Hide the given edge in the graph. |
|
568 |
/// |
|
569 |
/// The value of \c e is set to be true in the edge-map which stores |
|
570 |
/// hide information. If \c e was hidden previuosly, then it is shown |
|
571 |
/// again |
|
492 |
void unHide(const Node& n) const { _node_filter_map->set(n, true); } |
|
572 | 493 |
void unHide(const Edge& e) const { _edge_filter_map->set(e, true); } |
573 | 494 |
|
574 |
/// \brief Returns true if \c n is hidden. |
|
575 |
/// |
|
576 |
/// Returns true if \c n is hidden. |
|
577 | 495 |
bool hidden(const Node& n) const { return !(*_node_filter_map)[n]; } |
578 |
|
|
579 |
/// \brief Returns true if \c e is hidden. |
|
580 |
/// |
|
581 |
/// Returns true if \c e is hidden. |
|
582 | 496 |
bool hidden(const Edge& e) const { return !(*_edge_filter_map)[e]; } |
583 | 497 |
|
584 | 498 |
typedef False NodeNumTag; |
585 | 499 |
typedef False EdgeNumTag; |
586 | 500 |
|
587 | 501 |
typedef FindEdgeTagIndicator<Graph> FindEdgeTag; |
588 | 502 |
Arc findArc(const Node& u, const Node& v, |
589 | 503 |
const Arc& prev = INVALID) { |
590 | 504 |
Arc arc = Parent::findArc(u, v, prev); |
591 | 505 |
while (arc != INVALID && !(*_edge_filter_map)[arc]) { |
592 | 506 |
arc = Parent::findArc(u, v, arc); |
593 | 507 |
} |
594 | 508 |
return arc; |
595 | 509 |
} |
596 | 510 |
Edge findEdge(const Node& u, const Node& v, |
597 | 511 |
const Edge& prev = INVALID) { |
598 | 512 |
Edge edge = Parent::findEdge(u, v, prev); |
599 | 513 |
while (edge != INVALID && !(*_edge_filter_map)[edge]) { |
600 | 514 |
edge = Parent::findEdge(u, v, edge); |
601 | 515 |
} |
602 | 516 |
return edge; |
603 | 517 |
} |
604 | 518 |
|
605 | 519 |
template <typename _Value> |
... | ... |
@@ -661,81 +575,133 @@ |
661 | 575 |
template EdgeMap<Value> > MapParent; |
662 | 576 |
|
663 | 577 |
EdgeMap(const Adaptor& adaptor) |
664 | 578 |
: MapParent(adaptor) {} |
665 | 579 |
|
666 | 580 |
EdgeMap(const Adaptor& adaptor, const _Value& value) |
667 | 581 |
: MapParent(adaptor, value) {} |
668 | 582 |
|
669 | 583 |
private: |
670 | 584 |
EdgeMap& operator=(const EdgeMap& cmap) { |
671 | 585 |
return operator=<EdgeMap>(cmap); |
672 | 586 |
} |
673 | 587 |
|
674 | 588 |
template <typename CMap> |
675 | 589 |
EdgeMap& operator=(const CMap& cmap) { |
676 | 590 |
MapParent::operator=(cmap); |
677 | 591 |
return *this; |
678 | 592 |
} |
679 | 593 |
}; |
680 | 594 |
|
681 | 595 |
}; |
682 | 596 |
|
683 | 597 |
/// \ingroup graph_adaptors |
684 | 598 |
/// |
685 |
/// \brief A graph adaptor for hiding nodes and |
|
599 |
/// \brief A graph adaptor for hiding nodes and edges from an |
|
686 | 600 |
/// undirected graph. |
687 | 601 |
/// |
688 | 602 |
/// SubGraphAdaptor shows the graph with filtered node-set and |
689 | 603 |
/// edge-set. If the \c checked parameter is true then it filters |
690 | 604 |
/// the edge-set to do not get invalid edges which incident node is |
691 | 605 |
/// filtered. |
692 | 606 |
/// |
693 | 607 |
/// If the \c checked template parameter is false then we have to |
694 | 608 |
/// note that the node-iterator cares only the filter on the |
695 | 609 |
/// node-set, and the edge-iterator cares only the filter on the |
696 | 610 |
/// edge-set. This way the edge-map should filter all arcs which |
697 | 611 |
/// has filtered end node. |
698 | 612 |
template<typename _Graph, typename NodeFilterMap, |
699 | 613 |
typename EdgeFilterMap, bool checked = true> |
700 | 614 |
class SubGraphAdaptor : |
701 | 615 |
public GraphAdaptorExtender< |
702 | 616 |
SubGraphAdaptorBase<_Graph, NodeFilterMap, EdgeFilterMap, checked> > { |
703 | 617 |
public: |
704 | 618 |
typedef _Graph Graph; |
705 | 619 |
typedef GraphAdaptorExtender< |
706 | 620 |
SubGraphAdaptorBase<_Graph, NodeFilterMap, EdgeFilterMap> > Parent; |
621 |
|
|
622 |
typedef typename Parent::Node Node; |
|
623 |
typedef typename Parent::Edge Edge; |
|
624 |
|
|
707 | 625 |
protected: |
708 | 626 |
SubGraphAdaptor() { } |
709 | 627 |
public: |
628 |
|
|
629 |
/// \brief Constructor |
|
630 |
/// |
|
631 |
/// Creates a sub-graph-adaptor for the given graph with |
|
632 |
/// given node and edge map filters. |
|
710 | 633 |
SubGraphAdaptor(Graph& _graph, NodeFilterMap& node_filter_map, |
711 | 634 |
EdgeFilterMap& edge_filter_map) { |
712 | 635 |
setGraph(_graph); |
713 | 636 |
setNodeFilterMap(node_filter_map); |
714 | 637 |
setEdgeFilterMap(edge_filter_map); |
715 | 638 |
} |
639 |
|
|
640 |
/// \brief Hides the node of the graph |
|
641 |
/// |
|
642 |
/// This function hides \c n in the digraph, i.e. the iteration |
|
643 |
/// jumps over it. This is done by simply setting the value of \c n |
|
644 |
/// to be false in the corresponding node-map. |
|
645 |
void hide(const Node& n) const { Parent::hide(n); } |
|
646 |
|
|
647 |
/// \brief Hides the edge of the graph |
|
648 |
/// |
|
649 |
/// This function hides \c e in the digraph, i.e. the iteration |
|
650 |
/// jumps over it. This is done by simply setting the value of \c e |
|
651 |
/// to be false in the corresponding edge-map. |
|
652 |
void hide(const Edge& e) const { Parent::hide(e); } |
|
653 |
|
|
654 |
/// \brief Unhides the node of the graph |
|
655 |
/// |
|
656 |
/// The value of \c n is set to be true in the node-map which stores |
|
657 |
/// hide information. If \c n was hidden previuosly, then it is shown |
|
658 |
/// again |
|
659 |
void unHide(const Node& n) const { Parent::unHide(n); } |
|
660 |
|
|
661 |
/// \brief Unhides the edge of the graph |
|
662 |
/// |
|
663 |
/// The value of \c e is set to be true in the edge-map which stores |
|
664 |
/// hide information. If \c e was hidden previuosly, then it is shown |
|
665 |
/// again |
|
666 |
void unHide(const Edge& e) const { Parent::unHide(e); } |
|
667 |
|
|
668 |
/// \brief Returns true if \c n is hidden. |
|
669 |
/// |
|
670 |
/// Returns true if \c n is hidden. |
|
671 |
/// |
|
672 |
bool hidden(const Node& n) const { return Parent::hidden(n); } |
|
673 |
|
|
674 |
/// \brief Returns true if \c e is hidden. |
|
675 |
/// |
|
676 |
/// Returns true if \c e is hidden. |
|
677 |
/// |
|
678 |
bool hidden(const Edge& e) const { return Parent::hidden(e); } |
|
716 | 679 |
}; |
717 | 680 |
|
681 |
/// \brief Just gives back a sub-graph adaptor |
|
682 |
/// |
|
683 |
/// Just gives back a sub-graph adaptor |
|
718 | 684 |
template<typename Graph, typename NodeFilterMap, typename ArcFilterMap> |
719 | 685 |
SubGraphAdaptor<const Graph, NodeFilterMap, ArcFilterMap> |
720 | 686 |
subGraphAdaptor(const Graph& graph, |
721 | 687 |
NodeFilterMap& nfm, ArcFilterMap& efm) { |
722 | 688 |
return SubGraphAdaptor<const Graph, NodeFilterMap, ArcFilterMap> |
723 | 689 |
(graph, nfm, efm); |
724 | 690 |
} |
725 | 691 |
|
726 | 692 |
template<typename Graph, typename NodeFilterMap, typename ArcFilterMap> |
727 | 693 |
SubGraphAdaptor<const Graph, const NodeFilterMap, ArcFilterMap> |
728 | 694 |
subGraphAdaptor(const Graph& graph, |
729 | 695 |
NodeFilterMap& nfm, ArcFilterMap& efm) { |
730 | 696 |
return SubGraphAdaptor<const Graph, const NodeFilterMap, ArcFilterMap> |
731 | 697 |
(graph, nfm, efm); |
732 | 698 |
} |
733 | 699 |
|
734 | 700 |
template<typename Graph, typename NodeFilterMap, typename ArcFilterMap> |
735 | 701 |
SubGraphAdaptor<const Graph, NodeFilterMap, const ArcFilterMap> |
736 | 702 |
subGraphAdaptor(const Graph& graph, |
737 | 703 |
NodeFilterMap& nfm, ArcFilterMap& efm) { |
738 | 704 |
return SubGraphAdaptor<const Graph, NodeFilterMap, const ArcFilterMap> |
739 | 705 |
(graph, nfm, efm); |
740 | 706 |
} |
741 | 707 |
|
... | ... |
@@ -744,131 +710,185 @@ |
744 | 710 |
subGraphAdaptor(const Graph& graph, |
745 | 711 |
NodeFilterMap& nfm, ArcFilterMap& efm) { |
746 | 712 |
return SubGraphAdaptor<const Graph, const NodeFilterMap, |
747 | 713 |
const ArcFilterMap>(graph, nfm, efm); |
748 | 714 |
} |
749 | 715 |
|
750 | 716 |
/// \ingroup graph_adaptors |
751 | 717 |
/// |
752 | 718 |
/// \brief An adaptor for hiding nodes from an graph. |
753 | 719 |
/// |
754 | 720 |
/// An adaptor for hiding nodes from an graph. This |
755 | 721 |
/// adaptor specializes SubGraphAdaptor in the way that only the |
756 | 722 |
/// node-set can be filtered. In usual case the checked parameter is |
757 | 723 |
/// true, we get the induced subgraph. But if the checked parameter |
758 | 724 |
/// is false then we can filter only isolated nodes. |
759 | 725 |
template<typename _Graph, typename _NodeFilterMap, bool checked = true> |
760 | 726 |
class NodeSubGraphAdaptor : |
761 | 727 |
public SubGraphAdaptor<_Graph, _NodeFilterMap, |
762 | 728 |
ConstMap<typename _Graph::Edge, bool>, checked> { |
763 | 729 |
public: |
764 | 730 |
typedef _Graph Graph; |
765 | 731 |
typedef _NodeFilterMap NodeFilterMap; |
766 | 732 |
typedef SubGraphAdaptor<Graph, NodeFilterMap, |
767 | 733 |
ConstMap<typename Graph::Edge, bool> > Parent; |
734 |
|
|
735 |
typedef typename Parent::Node Node; |
|
768 | 736 |
protected: |
769 | 737 |
ConstMap<typename Graph::Edge, bool> const_true_map; |
770 | 738 |
|
771 | 739 |
NodeSubGraphAdaptor() : const_true_map(true) { |
772 | 740 |
Parent::setEdgeFilterMap(const_true_map); |
773 | 741 |
} |
774 | 742 |
|
775 | 743 |
public: |
744 |
|
|
745 |
/// \brief Constructor |
|
746 |
/// |
|
747 |
/// Creates a node-sub-graph-adaptor for the given graph with |
|
748 |
/// given node map filters. |
|
776 | 749 |
NodeSubGraphAdaptor(Graph& _graph, NodeFilterMap& node_filter_map) : |
777 | 750 |
Parent(), const_true_map(true) { |
778 | 751 |
Parent::setGraph(_graph); |
779 | 752 |
Parent::setNodeFilterMap(node_filter_map); |
780 | 753 |
Parent::setEdgeFilterMap(const_true_map); |
781 | 754 |
} |
755 |
|
|
756 |
/// \brief Hides the node of the graph |
|
757 |
/// |
|
758 |
/// This function hides \c n in the digraph, i.e. the iteration |
|
759 |
/// jumps over it. This is done by simply setting the value of \c n |
|
760 |
/// to be false in the corresponding node-map. |
|
761 |
void hide(const Node& n) const { Parent::hide(n); } |
|
762 |
|
|
763 |
/// \brief Unhides the node of the graph |
|
764 |
/// |
|
765 |
/// The value of \c n is set to be true in the node-map which stores |
|
766 |
/// hide information. If \c n was hidden previuosly, then it is shown |
|
767 |
/// again |
|
768 |
void unHide(const Node& n) const { Parent::unHide(n); } |
|
769 |
|
|
770 |
/// \brief Returns true if \c n is hidden. |
|
771 |
/// |
|
772 |
/// Returns true if \c n is hidden. |
|
773 |
/// |
|
774 |
bool hidden(const Node& n) const { return Parent::hidden(n); } |
|
775 |
|
|
782 | 776 |
}; |
783 | 777 |
|
778 |
/// \brief Just gives back a node-sub-graph adaptor |
|
779 |
/// |
|
780 |
/// Just gives back a node-sub-graph adaptor |
|
784 | 781 |
template<typename Graph, typename NodeFilterMap> |
785 | 782 |
NodeSubGraphAdaptor<const Graph, NodeFilterMap> |
786 | 783 |
nodeSubGraphAdaptor(const Graph& graph, NodeFilterMap& nfm) { |
787 | 784 |
return NodeSubGraphAdaptor<const Graph, NodeFilterMap>(graph, nfm); |
788 | 785 |
} |
789 | 786 |
|
790 | 787 |
template<typename Graph, typename NodeFilterMap> |
791 | 788 |
NodeSubGraphAdaptor<const Graph, const NodeFilterMap> |
792 | 789 |
nodeSubGraphAdaptor(const Graph& graph, const NodeFilterMap& nfm) { |
793 | 790 |
return NodeSubGraphAdaptor<const Graph, const NodeFilterMap>(graph, nfm); |
794 | 791 |
} |
795 | 792 |
|
796 | 793 |
/// \ingroup graph_adaptors |
797 | 794 |
/// |
798 | 795 |
/// \brief An adaptor for hiding edges from an graph. |
799 | 796 |
/// |
800 | 797 |
/// \warning Graph adaptors are in even more experimental state |
801 | 798 |
/// than the other parts of the lib. Use them at you own risk. |
802 | 799 |
/// |
803 | 800 |
/// An adaptor for hiding edges from an graph. |
804 | 801 |
/// This adaptor specializes SubGraphAdaptor in the way that |
805 | 802 |
/// only the arc-set |
806 | 803 |
/// can be filtered. |
807 | 804 |
template<typename _Graph, typename _EdgeFilterMap> |
808 | 805 |
class EdgeSubGraphAdaptor : |
809 | 806 |
public SubGraphAdaptor<_Graph, ConstMap<typename _Graph::Node,bool>, |
810 | 807 |
_EdgeFilterMap, false> { |
811 | 808 |
public: |
812 | 809 |
typedef _Graph Graph; |
813 | 810 |
typedef _EdgeFilterMap EdgeFilterMap; |
814 | 811 |
typedef SubGraphAdaptor<Graph, ConstMap<typename Graph::Node,bool>, |
815 | 812 |
EdgeFilterMap, false> Parent; |
813 |
typedef typename Parent::Edge Edge; |
|
816 | 814 |
protected: |
817 | 815 |
ConstMap<typename Graph::Node, bool> const_true_map; |
818 | 816 |
|
819 | 817 |
EdgeSubGraphAdaptor() : const_true_map(true) { |
820 | 818 |
Parent::setNodeFilterMap(const_true_map); |
821 | 819 |
} |
822 | 820 |
|
823 | 821 |
public: |
824 | 822 |
|
823 |
/// \brief Constructor |
|
824 |
/// |
|
825 |
/// Creates a edge-sub-graph-adaptor for the given graph with |
|
826 |
/// given node map filters. |
|
825 | 827 |
EdgeSubGraphAdaptor(Graph& _graph, EdgeFilterMap& edge_filter_map) : |
826 | 828 |
Parent(), const_true_map(true) { |
827 | 829 |
Parent::setGraph(_graph); |
828 | 830 |
Parent::setNodeFilterMap(const_true_map); |
829 | 831 |
Parent::setEdgeFilterMap(edge_filter_map); |
830 | 832 |
} |
831 | 833 |
|
834 |
/// \brief Hides the edge of the graph |
|
835 |
/// |
|
836 |
/// This function hides \c e in the digraph, i.e. the iteration |
|
837 |
/// jumps over it. This is done by simply setting the value of \c e |
|
838 |
/// to be false in the corresponding edge-map. |
|
839 |
void hide(const Edge& e) const { Parent::hide(e); } |
|
840 |
|
|
841 |
/// \brief Unhides the edge of the graph |
|
842 |
/// |
|
843 |
/// The value of \c e is set to be true in the edge-map which stores |
|
844 |
/// hide information. If \c e was hidden previuosly, then it is shown |
|
845 |
/// again |
|
846 |
void unHide(const Edge& e) const { Parent::unHide(e); } |
|
847 |
|
|
848 |
/// \brief Returns true if \c e is hidden. |
|
849 |
/// |
|
850 |
/// Returns true if \c e is hidden. |
|
851 |
/// |
|
852 |
bool hidden(const Edge& e) const { return Parent::hidden(e); } |
|
853 |
|
|
832 | 854 |
}; |
833 | 855 |
|
856 |
/// \brief Just gives back an edge-sub-graph adaptor |
|
857 |
/// |
|
858 |
/// Just gives back an edge-sub-graph adaptor |
|
834 | 859 |
template<typename Graph, typename EdgeFilterMap> |
835 | 860 |
EdgeSubGraphAdaptor<const Graph, EdgeFilterMap> |
836 | 861 |
edgeSubGraphAdaptor(const Graph& graph, EdgeFilterMap& efm) { |
837 | 862 |
return EdgeSubGraphAdaptor<const Graph, EdgeFilterMap>(graph, efm); |
838 | 863 |
} |
839 | 864 |
|
840 | 865 |
template<typename Graph, typename EdgeFilterMap> |
841 | 866 |
EdgeSubGraphAdaptor<const Graph, const EdgeFilterMap> |
842 | 867 |
edgeSubGraphAdaptor(const Graph& graph, const EdgeFilterMap& efm) { |
843 | 868 |
return EdgeSubGraphAdaptor<const Graph, const EdgeFilterMap>(graph, efm); |
844 | 869 |
} |
845 | 870 |
|
846 |
/// \brief Base of direct graph adaptor |
|
847 |
/// |
|
848 |
/// Base class of the direct graph adaptor. All public member |
|
849 |
/// of this class can be used with the DirGraphAdaptor too. |
|
850 |
/// \sa DirGraphAdaptor |
|
851 | 871 |
template <typename _Graph, typename _DirectionMap> |
852 | 872 |
class DirGraphAdaptorBase { |
853 | 873 |
public: |
854 | 874 |
|
855 | 875 |
typedef _Graph Graph; |
856 | 876 |
typedef _DirectionMap DirectionMap; |
857 | 877 |
|
858 | 878 |
typedef typename Graph::Node Node; |
859 | 879 |
typedef typename Graph::Edge Arc; |
860 | 880 |
|
861 | 881 |
/// \brief Reverse arc |
862 | 882 |
/// |
863 | 883 |
/// It reverse the given arc. It simply negate the direction in the map. |
864 | 884 |
void reverseArc(const Arc& arc) { |
865 | 885 |
_direction->set(arc, !(*_direction)[arc]); |
866 | 886 |
} |
867 | 887 |
|
868 | 888 |
void first(Node& i) const { _graph->first(i); } |
869 | 889 |
void first(Arc& i) const { _graph->first(i); } |
870 | 890 |
void firstIn(Arc& i, const Node& n) const { |
871 | 891 |
bool d; |
872 | 892 |
_graph->firstInc(i, d, n); |
873 | 893 |
while (i != INVALID && d == (*_direction)[i]) _graph->nextInc(i, d); |
874 | 894 |
} |
... | ... |
@@ -1082,55 +1102,63 @@ |
1082 | 1102 |
/// |
1083 | 1103 |
/// LEMON_ASSERT(countStronglyConnectedComponents(dgraph) == |
1084 | 1104 |
/// countBiArcConnectedComponents(graph), "Wrong Orientation"); |
1085 | 1105 |
///\endcode |
1086 | 1106 |
/// |
1087 | 1107 |
/// The number of the bi-connected components is a lower bound for |
1088 | 1108 |
/// the number of the strongly connected components in the directed |
1089 | 1109 |
/// graph because if we contract the bi-connected components to |
1090 | 1110 |
/// nodes we will get a tree therefore we cannot orient arcs in |
1091 | 1111 |
/// both direction between bi-connected components. In the other way |
1092 | 1112 |
/// the algorithm will orient one component to be strongly |
1093 | 1113 |
/// connected. The two relations proof that the assertion will |
1094 | 1114 |
/// be always true and the found solution is optimal. |
1095 | 1115 |
/// |
1096 | 1116 |
/// \sa DirGraphAdaptorBase |
1097 | 1117 |
/// \sa dirGraphAdaptor |
1098 | 1118 |
template<typename _Graph, |
1099 | 1119 |
typename DirectionMap = typename _Graph::template EdgeMap<bool> > |
1100 | 1120 |
class DirGraphAdaptor : |
1101 | 1121 |
public DigraphAdaptorExtender<DirGraphAdaptorBase<_Graph, DirectionMap> > { |
1102 | 1122 |
public: |
1103 | 1123 |
typedef _Graph Graph; |
1104 | 1124 |
typedef DigraphAdaptorExtender< |
1105 | 1125 |
DirGraphAdaptorBase<_Graph, DirectionMap> > Parent; |
1126 |
typedef typename Parent::Arc Arc; |
|
1106 | 1127 |
protected: |
1107 | 1128 |
DirGraphAdaptor() { } |
1108 | 1129 |
public: |
1109 | 1130 |
|
1110 | 1131 |
/// \brief Constructor of the adaptor |
1111 | 1132 |
/// |
1112 | 1133 |
/// Constructor of the adaptor |
1113 | 1134 |
DirGraphAdaptor(Graph& graph, DirectionMap& direction) { |
1114 | 1135 |
setGraph(graph); |
1115 | 1136 |
setDirectionMap(direction); |
1116 | 1137 |
} |
1138 |
|
|
1139 |
/// \brief Reverse arc |
|
1140 |
/// |
|
1141 |
/// It reverse the given arc. It simply negate the direction in the map. |
|
1142 |
void reverseArc(const Arc& a) { |
|
1143 |
Parent::reverseArc(a); |
|
1144 |
} |
|
1117 | 1145 |
}; |
1118 | 1146 |
|
1119 | 1147 |
/// \brief Just gives back a DirGraphAdaptor |
1120 | 1148 |
/// |
1121 | 1149 |
/// Just gives back a DirGraphAdaptor |
1122 | 1150 |
template<typename Graph, typename DirectionMap> |
1123 | 1151 |
DirGraphAdaptor<const Graph, DirectionMap> |
1124 | 1152 |
dirGraphAdaptor(const Graph& graph, DirectionMap& dm) { |
1125 | 1153 |
return DirGraphAdaptor<const Graph, DirectionMap>(graph, dm); |
1126 | 1154 |
} |
1127 | 1155 |
|
1128 | 1156 |
template<typename Graph, typename DirectionMap> |
1129 | 1157 |
DirGraphAdaptor<const Graph, const DirectionMap> |
1130 | 1158 |
dirGraphAdaptor(const Graph& graph, const DirectionMap& dm) { |
1131 | 1159 |
return DirGraphAdaptor<const Graph, const DirectionMap>(graph, dm); |
1132 | 1160 |
} |
1133 | 1161 |
|
1134 | 1162 |
} |
1135 | 1163 |
|
1136 | 1164 |
#endif |
... | ... |
@@ -16,84 +16,48 @@ |
16 | 16 |
* |
17 | 17 |
*/ |
18 | 18 |
|
19 | 19 |
#include<iostream> |
20 | 20 |
#include<lemon/concept_check.h> |
21 | 21 |
|
22 | 22 |
#include<lemon/list_graph.h> |
23 | 23 |
#include<lemon/smart_graph.h> |
24 | 24 |
|
25 | 25 |
#include<lemon/concepts/digraph.h> |
26 | 26 |
#include<lemon/concepts/graph.h> |
27 | 27 |
|
28 | 28 |
#include<lemon/digraph_adaptor.h> |
29 | 29 |
#include<lemon/graph_adaptor.h> |
30 | 30 |
|
31 | 31 |
#include <limits> |
32 | 32 |
#include <lemon/bfs.h> |
33 | 33 |
#include <lemon/path.h> |
34 | 34 |
|
35 | 35 |
#include"test/test_tools.h" |
36 | 36 |
#include"test/graph_test.h" |
37 | 37 |
|
38 | 38 |
using namespace lemon; |
39 | 39 |
|
40 |
void checkDigraphAdaptor() { |
|
41 |
checkConcept<concepts::Digraph, DigraphAdaptor<concepts::Digraph> >(); |
|
42 |
|
|
43 |
typedef ListDigraph Digraph; |
|
44 |
typedef DigraphAdaptor<Digraph> Adaptor; |
|
45 |
|
|
46 |
Digraph digraph; |
|
47 |
Adaptor adaptor(digraph); |
|
48 |
|
|
49 |
Digraph::Node n1 = digraph.addNode(); |
|
50 |
Digraph::Node n2 = digraph.addNode(); |
|
51 |
Digraph::Node n3 = digraph.addNode(); |
|
52 |
|
|
53 |
Digraph::Arc a1 = digraph.addArc(n1, n2); |
|
54 |
Digraph::Arc a2 = digraph.addArc(n1, n3); |
|
55 |
Digraph::Arc a3 = digraph.addArc(n2, n3); |
|
56 |
|
|
57 |
checkGraphNodeList(adaptor, 3); |
|
58 |
checkGraphArcList(adaptor, 3); |
|
59 |
checkGraphConArcList(adaptor, 3); |
|
60 |
|
|
61 |
checkGraphOutArcList(adaptor, n1, 2); |
|
62 |
checkGraphOutArcList(adaptor, n2, 1); |
|
63 |
checkGraphOutArcList(adaptor, n3, 0); |
|
64 |
|
|
65 |
checkGraphInArcList(adaptor, n1, 0); |
|
66 |
checkGraphInArcList(adaptor, n2, 1); |
|
67 |
checkGraphInArcList(adaptor, n3, 2); |
|
68 |
|
|
69 |
checkNodeIds(adaptor); |
|
70 |
checkArcIds(adaptor); |
|
71 |
|
|
72 |
checkGraphNodeMap(adaptor); |
|
73 |
checkGraphArcMap(adaptor); |
|
74 |
} |
|
75 |
|
|
76 | 40 |
void checkRevDigraphAdaptor() { |
77 | 41 |
checkConcept<concepts::Digraph, RevDigraphAdaptor<concepts::Digraph> >(); |
78 | 42 |
|
79 | 43 |
typedef ListDigraph Digraph; |
80 | 44 |
typedef RevDigraphAdaptor<Digraph> Adaptor; |
81 | 45 |
|
82 | 46 |
Digraph digraph; |
83 | 47 |
Adaptor adaptor(digraph); |
84 | 48 |
|
85 | 49 |
Digraph::Node n1 = digraph.addNode(); |
86 | 50 |
Digraph::Node n2 = digraph.addNode(); |
87 | 51 |
Digraph::Node n3 = digraph.addNode(); |
88 | 52 |
|
89 | 53 |
Digraph::Arc a1 = digraph.addArc(n1, n2); |
90 | 54 |
Digraph::Arc a2 = digraph.addArc(n1, n3); |
91 | 55 |
Digraph::Arc a3 = digraph.addArc(n2, n3); |
92 | 56 |
|
93 | 57 |
checkGraphNodeList(adaptor, 3); |
94 | 58 |
checkGraphArcList(adaptor, 3); |
95 | 59 |
checkGraphConArcList(adaptor, 3); |
96 | 60 |
|
97 | 61 |
checkGraphOutArcList(adaptor, n1, 0); |
98 | 62 |
checkGraphOutArcList(adaptor, n2, 1); |
99 | 63 |
checkGraphOutArcList(adaptor, n3, 2); |
... | ... |
@@ -564,98 +528,48 @@ |
564 | 528 |
checkGraphInArcList(adaptor, adaptor.inNode(n3), 2); |
565 | 529 |
checkGraphInArcList(adaptor, adaptor.outNode(n3), 1); |
566 | 530 |
|
567 | 531 |
checkNodeIds(adaptor); |
568 | 532 |
checkArcIds(adaptor); |
569 | 533 |
|
570 | 534 |
checkGraphNodeMap(adaptor); |
571 | 535 |
checkGraphArcMap(adaptor); |
572 | 536 |
|
573 | 537 |
for (Adaptor::ArcIt a(adaptor); a != INVALID; ++a) { |
574 | 538 |
if (adaptor.origArc(a)) { |
575 | 539 |
Digraph::Arc oa = a; |
576 | 540 |
check(adaptor.source(a) == adaptor.outNode(digraph.source(oa)), |
577 | 541 |
"Wrong split"); |
578 | 542 |
check(adaptor.target(a) == adaptor.inNode(digraph.target(oa)), |
579 | 543 |
"Wrong split"); |
580 | 544 |
} else { |
581 | 545 |
Digraph::Node on = a; |
582 | 546 |
check(adaptor.source(a) == adaptor.inNode(on), "Wrong split"); |
583 | 547 |
check(adaptor.target(a) == adaptor.outNode(on), "Wrong split"); |
584 | 548 |
} |
585 | 549 |
} |
586 | 550 |
} |
587 | 551 |
|
588 |
void checkGraphAdaptor() { |
|
589 |
checkConcept<concepts::Graph, GraphAdaptor<concepts::Graph> >(); |
|
590 |
|
|
591 |
typedef ListGraph Graph; |
|
592 |
typedef GraphAdaptor<Graph> Adaptor; |
|
593 |
|
|
594 |
Graph graph; |
|
595 |
Adaptor adaptor(graph); |
|
596 |
|
|
597 |
Graph::Node n1 = graph.addNode(); |
|
598 |
Graph::Node n2 = graph.addNode(); |
|
599 |
Graph::Node n3 = graph.addNode(); |
|
600 |
Graph::Node n4 = graph.addNode(); |
|
601 |
|
|
602 |
Graph::Edge a1 = graph.addEdge(n1, n2); |
|
603 |
Graph::Edge a2 = graph.addEdge(n1, n3); |
|
604 |
Graph::Edge a3 = graph.addEdge(n2, n3); |
|
605 |
Graph::Edge a4 = graph.addEdge(n3, n4); |
|
606 |
|
|
607 |
checkGraphNodeList(adaptor, 4); |
|
608 |
checkGraphArcList(adaptor, 8); |
|
609 |
checkGraphEdgeList(adaptor, 4); |
|
610 |
checkGraphConArcList(adaptor, 8); |
|
611 |
checkGraphConEdgeList(adaptor, 4); |
|
612 |
|
|
613 |
checkGraphOutArcList(adaptor, n1, 2); |
|
614 |
checkGraphOutArcList(adaptor, n2, 2); |
|
615 |
checkGraphOutArcList(adaptor, n3, 3); |
|
616 |
checkGraphOutArcList(adaptor, n4, 1); |
|
617 |
|
|
618 |
checkGraphInArcList(adaptor, n1, 2); |
|
619 |
checkGraphInArcList(adaptor, n2, 2); |
|
620 |
checkGraphInArcList(adaptor, n3, 3); |
|
621 |
checkGraphInArcList(adaptor, n4, 1); |
|
622 |
|
|
623 |
checkGraphIncEdgeList(adaptor, n1, 2); |
|
624 |
checkGraphIncEdgeList(adaptor, n2, 2); |
|
625 |
checkGraphIncEdgeList(adaptor, n3, 3); |
|
626 |
checkGraphIncEdgeList(adaptor, n4, 1); |
|
627 |
|
|
628 |
|
|
629 |
checkNodeIds(adaptor); |
|
630 |
checkArcIds(adaptor); |
|
631 |
checkEdgeIds(adaptor); |
|
632 |
|
|
633 |
checkGraphNodeMap(adaptor); |
|
634 |
checkGraphArcMap(adaptor); |
|
635 |
checkGraphEdgeMap(adaptor); |
|
636 |
} |
|
637 |
|
|
638 | 552 |
void checkSubGraphAdaptor() { |
639 | 553 |
checkConcept<concepts::Graph, |
640 | 554 |
SubGraphAdaptor<concepts::Graph, |
641 | 555 |
concepts::Graph::NodeMap<bool>, |
642 | 556 |
concepts::Graph::EdgeMap<bool> > >(); |
643 | 557 |
|
644 | 558 |
typedef ListGraph Graph; |
645 | 559 |
typedef Graph::NodeMap<bool> NodeFilter; |
646 | 560 |
typedef Graph::EdgeMap<bool> EdgeFilter; |
647 | 561 |
typedef SubGraphAdaptor<Graph, NodeFilter, EdgeFilter> Adaptor; |
648 | 562 |
|
649 | 563 |
Graph graph; |
650 | 564 |
NodeFilter node_filter(graph); |
651 | 565 |
EdgeFilter edge_filter(graph); |
652 | 566 |
Adaptor adaptor(graph, node_filter, edge_filter); |
653 | 567 |
|
654 | 568 |
Graph::Node n1 = graph.addNode(); |
655 | 569 |
Graph::Node n2 = graph.addNode(); |
656 | 570 |
Graph::Node n3 = graph.addNode(); |
657 | 571 |
Graph::Node n4 = graph.addNode(); |
658 | 572 |
|
659 | 573 |
Graph::Edge e1 = graph.addEdge(n1, n2); |
660 | 574 |
Graph::Edge e2 = graph.addEdge(n1, n3); |
661 | 575 |
Graph::Edge e3 = graph.addEdge(n2, n3); |
... | ... |
@@ -1032,41 +946,39 @@ |
1032 | 946 |
|
1033 | 947 |
check ((u == n2 && v == n3) || (u == n3 && v == n2), "Wrong dir"); |
1034 | 948 |
dir[e3] = n2 == u; |
1035 | 949 |
} |
1036 | 950 |
|
1037 | 951 |
checkGraphOutArcList(adaptor, n1, 1); |
1038 | 952 |
checkGraphOutArcList(adaptor, n2, 1); |
1039 | 953 |
checkGraphOutArcList(adaptor, n3, 1); |
1040 | 954 |
|
1041 | 955 |
checkGraphInArcList(adaptor, n1, 1); |
1042 | 956 |
checkGraphInArcList(adaptor, n2, 1); |
1043 | 957 |
checkGraphInArcList(adaptor, n3, 1); |
1044 | 958 |
|
1045 | 959 |
checkNodeIds(adaptor); |
1046 | 960 |
checkArcIds(adaptor); |
1047 | 961 |
|
1048 | 962 |
checkGraphNodeMap(adaptor); |
1049 | 963 |
checkGraphArcMap(adaptor); |
1050 | 964 |
|
1051 | 965 |
} |
1052 | 966 |
|
1053 | 967 |
|
1054 | 968 |
int main(int, const char **) { |
1055 | 969 |
|
1056 |
checkDigraphAdaptor(); |
|
1057 | 970 |
checkRevDigraphAdaptor(); |
1058 | 971 |
checkSubDigraphAdaptor(); |
1059 | 972 |
checkNodeSubDigraphAdaptor(); |
1060 | 973 |
checkArcSubDigraphAdaptor(); |
1061 | 974 |
checkUndirDigraphAdaptor(); |
1062 | 975 |
checkResDigraphAdaptor(); |
1063 | 976 |
checkSplitDigraphAdaptor(); |
1064 | 977 |
|
1065 |
checkGraphAdaptor(); |
|
1066 | 978 |
checkSubGraphAdaptor(); |
1067 | 979 |
checkNodeSubGraphAdaptor(); |
1068 | 980 |
checkEdgeSubGraphAdaptor(); |
1069 | 981 |
checkDirGraphAdaptor(); |
1070 | 982 |
|
1071 | 983 |
return 0; |
1072 | 984 |
} |
0 comments (0 inline)