| ... |
... |
@@ -465,193 +465,193 @@
|
| 465 |
465 |
///Processes the next arc.
|
| 466 |
466 |
|
| 467 |
467 |
///Processes the next arc.
|
| 468 |
468 |
///
|
| 469 |
469 |
///\return The processed arc.
|
| 470 |
470 |
///
|
| 471 |
471 |
///\pre The stack must not be empty.
|
| 472 |
472 |
Arc processNextArc()
|
| 473 |
473 |
{
|
| 474 |
474 |
Node m;
|
| 475 |
475 |
Arc e=_stack[_stack_head];
|
| 476 |
476 |
if(!(*_reached)[m=G->target(e)]) {
|
| 477 |
477 |
_pred->set(m,e);
|
| 478 |
478 |
_reached->set(m,true);
|
| 479 |
479 |
++_stack_head;
|
| 480 |
480 |
_stack[_stack_head] = OutArcIt(*G, m);
|
| 481 |
481 |
_dist->set(m,_stack_head);
|
| 482 |
482 |
}
|
| 483 |
483 |
else {
|
| 484 |
484 |
m=G->source(e);
|
| 485 |
485 |
++_stack[_stack_head];
|
| 486 |
486 |
}
|
| 487 |
487 |
while(_stack_head>=0 && _stack[_stack_head]==INVALID) {
|
| 488 |
488 |
_processed->set(m,true);
|
| 489 |
489 |
--_stack_head;
|
| 490 |
490 |
if(_stack_head>=0) {
|
| 491 |
491 |
m=G->source(_stack[_stack_head]);
|
| 492 |
492 |
++_stack[_stack_head];
|
| 493 |
493 |
}
|
| 494 |
494 |
}
|
| 495 |
495 |
return e;
|
| 496 |
496 |
}
|
| 497 |
497 |
|
| 498 |
498 |
///Next arc to be processed.
|
| 499 |
499 |
|
| 500 |
500 |
///Next arc to be processed.
|
| 501 |
501 |
///
|
| 502 |
502 |
///\return The next arc to be processed or \c INVALID if the stack
|
| 503 |
503 |
///is empty.
|
| 504 |
504 |
OutArcIt nextArc() const
|
| 505 |
505 |
{
|
| 506 |
506 |
return _stack_head>=0?_stack[_stack_head]:INVALID;
|
| 507 |
507 |
}
|
| 508 |
508 |
|
| 509 |
509 |
///\brief Returns \c false if there are nodes
|
| 510 |
510 |
///to be processed.
|
| 511 |
511 |
///
|
| 512 |
512 |
///Returns \c false if there are nodes
|
| 513 |
513 |
///to be processed in the queue (stack).
|
| 514 |
514 |
bool emptyQueue() const { return _stack_head<0; }
|
| 515 |
515 |
|
| 516 |
516 |
///Returns the number of the nodes to be processed.
|
| 517 |
517 |
|
| 518 |
518 |
///Returns the number of the nodes to be processed in the queue (stack).
|
| 519 |
519 |
int queueSize() const { return _stack_head+1; }
|
| 520 |
520 |
|
| 521 |
521 |
///Executes the algorithm.
|
| 522 |
522 |
|
| 523 |
523 |
///Executes the algorithm.
|
| 524 |
524 |
///
|
| 525 |
525 |
///This method runs the %DFS algorithm from the root node
|
| 526 |
526 |
///in order to compute the DFS path to each node.
|
| 527 |
527 |
///
|
| 528 |
528 |
/// The algorithm computes
|
| 529 |
529 |
///- the %DFS tree,
|
| 530 |
530 |
///- the distance of each node from the root in the %DFS tree.
|
| 531 |
531 |
///
|
| 532 |
532 |
///\pre init() must be called and a root node should be
|
| 533 |
533 |
///added with addSource() before using this function.
|
| 534 |
534 |
///
|
| 535 |
535 |
///\note <tt>d.start()</tt> is just a shortcut of the following code.
|
| 536 |
536 |
///\code
|
| 537 |
537 |
/// while ( !d.emptyQueue() ) {
|
| 538 |
538 |
/// d.processNextArc();
|
| 539 |
539 |
/// }
|
| 540 |
540 |
///\endcode
|
| 541 |
541 |
void start()
|
| 542 |
542 |
{
|
| 543 |
543 |
while ( !emptyQueue() ) processNextArc();
|
| 544 |
544 |
}
|
| 545 |
545 |
|
| 546 |
546 |
///Executes the algorithm until the given target node is reached.
|
| 547 |
547 |
|
| 548 |
548 |
///Executes the algorithm until the given target node is reached.
|
| 549 |
549 |
///
|
| 550 |
550 |
///This method runs the %DFS algorithm from the root node
|
| 551 |
551 |
///in order to compute the DFS path to \c t.
|
| 552 |
552 |
///
|
| 553 |
553 |
///The algorithm computes
|
| 554 |
554 |
///- the %DFS path to \c t,
|
| 555 |
555 |
///- the distance of \c t from the root in the %DFS tree.
|
| 556 |
556 |
///
|
| 557 |
557 |
///\pre init() must be called and a root node should be
|
| 558 |
558 |
///added with addSource() before using this function.
|
| 559 |
559 |
void start(Node t)
|
| 560 |
560 |
{
|
| 561 |
|
while ( !emptyQueue() && G->target(_stack[_stack_head])!=t )
|
|
561 |
while ( !emptyQueue() && !(*_reached)[t] )
|
| 562 |
562 |
processNextArc();
|
| 563 |
563 |
}
|
| 564 |
564 |
|
| 565 |
565 |
///Executes the algorithm until a condition is met.
|
| 566 |
566 |
|
| 567 |
567 |
///Executes the algorithm until a condition is met.
|
| 568 |
568 |
///
|
| 569 |
569 |
///This method runs the %DFS algorithm from the root node
|
| 570 |
570 |
///until an arc \c a with <tt>am[a]</tt> true is found.
|
| 571 |
571 |
///
|
| 572 |
572 |
///\param am A \c bool (or convertible) arc map. The algorithm
|
| 573 |
573 |
///will stop when it reaches an arc \c a with <tt>am[a]</tt> true.
|
| 574 |
574 |
///
|
| 575 |
575 |
///\return The reached arc \c a with <tt>am[a]</tt> true or
|
| 576 |
576 |
///\c INVALID if no such arc was found.
|
| 577 |
577 |
///
|
| 578 |
578 |
///\pre init() must be called and a root node should be
|
| 579 |
579 |
///added with addSource() before using this function.
|
| 580 |
580 |
///
|
| 581 |
581 |
///\warning Contrary to \ref Bfs and \ref Dijkstra, \c am is an arc map,
|
| 582 |
582 |
///not a node map.
|
| 583 |
583 |
template<class ArcBoolMap>
|
| 584 |
584 |
Arc start(const ArcBoolMap &am)
|
| 585 |
585 |
{
|
| 586 |
586 |
while ( !emptyQueue() && !am[_stack[_stack_head]] )
|
| 587 |
587 |
processNextArc();
|
| 588 |
588 |
return emptyQueue() ? INVALID : _stack[_stack_head];
|
| 589 |
589 |
}
|
| 590 |
590 |
|
| 591 |
591 |
///Runs the algorithm from the given source node.
|
| 592 |
592 |
|
| 593 |
593 |
///This method runs the %DFS algorithm from node \c s
|
| 594 |
594 |
///in order to compute the DFS path to each node.
|
| 595 |
595 |
///
|
| 596 |
596 |
///The algorithm computes
|
| 597 |
597 |
///- the %DFS tree,
|
| 598 |
598 |
///- the distance of each node from the root in the %DFS tree.
|
| 599 |
599 |
///
|
| 600 |
600 |
///\note <tt>d.run(s)</tt> is just a shortcut of the following code.
|
| 601 |
601 |
///\code
|
| 602 |
602 |
/// d.init();
|
| 603 |
603 |
/// d.addSource(s);
|
| 604 |
604 |
/// d.start();
|
| 605 |
605 |
///\endcode
|
| 606 |
606 |
void run(Node s) {
|
| 607 |
607 |
init();
|
| 608 |
608 |
addSource(s);
|
| 609 |
609 |
start();
|
| 610 |
610 |
}
|
| 611 |
611 |
|
| 612 |
612 |
///Finds the %DFS path between \c s and \c t.
|
| 613 |
613 |
|
| 614 |
614 |
///This method runs the %DFS algorithm from node \c s
|
| 615 |
615 |
///in order to compute the DFS path to node \c t
|
| 616 |
616 |
///(it stops searching when \c t is processed)
|
| 617 |
617 |
///
|
| 618 |
618 |
///\return \c true if \c t is reachable form \c s.
|
| 619 |
619 |
///
|
| 620 |
620 |
///\note Apart from the return value, <tt>d.run(s,t)</tt> is
|
| 621 |
621 |
///just a shortcut of the following code.
|
| 622 |
622 |
///\code
|
| 623 |
623 |
/// d.init();
|
| 624 |
624 |
/// d.addSource(s);
|
| 625 |
625 |
/// d.start(t);
|
| 626 |
626 |
///\endcode
|
| 627 |
627 |
bool run(Node s,Node t) {
|
| 628 |
628 |
init();
|
| 629 |
629 |
addSource(s);
|
| 630 |
630 |
start(t);
|
| 631 |
631 |
return reached(t);
|
| 632 |
632 |
}
|
| 633 |
633 |
|
| 634 |
634 |
///Runs the algorithm to visit all nodes in the digraph.
|
| 635 |
635 |
|
| 636 |
636 |
///This method runs the %DFS algorithm in order to compute the
|
| 637 |
637 |
///%DFS path to each node.
|
| 638 |
638 |
///
|
| 639 |
639 |
///The algorithm computes
|
| 640 |
640 |
///- the %DFS tree,
|
| 641 |
641 |
///- the distance of each node from the root in the %DFS tree.
|
| 642 |
642 |
///
|
| 643 |
643 |
///\note <tt>d.run()</tt> is just a shortcut of the following code.
|
| 644 |
644 |
///\code
|
| 645 |
645 |
/// d.init();
|
| 646 |
646 |
/// for (NodeIt n(digraph); n != INVALID; ++n) {
|
| 647 |
647 |
/// if (!d.reached(n)) {
|
| 648 |
648 |
/// d.addSource(n);
|
| 649 |
649 |
/// d.start();
|
| 650 |
650 |
/// }
|
| 651 |
651 |
/// }
|
| 652 |
652 |
///\endcode
|
| 653 |
653 |
void run() {
|
| 654 |
654 |
init();
|
| 655 |
655 |
for (NodeIt it(*G); it != INVALID; ++it) {
|
| 656 |
656 |
if (!reached(it)) {
|
| 657 |
657 |
addSource(it);
|
| ... |
... |
@@ -1418,193 +1418,193 @@
|
| 1418 |
1418 |
}
|
| 1419 |
1419 |
|
| 1420 |
1420 |
/// \brief Processes the next arc.
|
| 1421 |
1421 |
///
|
| 1422 |
1422 |
/// Processes the next arc.
|
| 1423 |
1423 |
///
|
| 1424 |
1424 |
/// \return The processed arc.
|
| 1425 |
1425 |
///
|
| 1426 |
1426 |
/// \pre The stack must not be empty.
|
| 1427 |
1427 |
Arc processNextArc() {
|
| 1428 |
1428 |
Arc e = _stack[_stack_head];
|
| 1429 |
1429 |
Node m = _digraph->target(e);
|
| 1430 |
1430 |
if(!(*_reached)[m]) {
|
| 1431 |
1431 |
_visitor->discover(e);
|
| 1432 |
1432 |
_visitor->reach(m);
|
| 1433 |
1433 |
_reached->set(m, true);
|
| 1434 |
1434 |
_digraph->firstOut(_stack[++_stack_head], m);
|
| 1435 |
1435 |
} else {
|
| 1436 |
1436 |
_visitor->examine(e);
|
| 1437 |
1437 |
m = _digraph->source(e);
|
| 1438 |
1438 |
_digraph->nextOut(_stack[_stack_head]);
|
| 1439 |
1439 |
}
|
| 1440 |
1440 |
while (_stack_head>=0 && _stack[_stack_head] == INVALID) {
|
| 1441 |
1441 |
_visitor->leave(m);
|
| 1442 |
1442 |
--_stack_head;
|
| 1443 |
1443 |
if (_stack_head >= 0) {
|
| 1444 |
1444 |
_visitor->backtrack(_stack[_stack_head]);
|
| 1445 |
1445 |
m = _digraph->source(_stack[_stack_head]);
|
| 1446 |
1446 |
_digraph->nextOut(_stack[_stack_head]);
|
| 1447 |
1447 |
} else {
|
| 1448 |
1448 |
_visitor->stop(m);
|
| 1449 |
1449 |
}
|
| 1450 |
1450 |
}
|
| 1451 |
1451 |
return e;
|
| 1452 |
1452 |
}
|
| 1453 |
1453 |
|
| 1454 |
1454 |
/// \brief Next arc to be processed.
|
| 1455 |
1455 |
///
|
| 1456 |
1456 |
/// Next arc to be processed.
|
| 1457 |
1457 |
///
|
| 1458 |
1458 |
/// \return The next arc to be processed or INVALID if the stack is
|
| 1459 |
1459 |
/// empty.
|
| 1460 |
1460 |
Arc nextArc() const {
|
| 1461 |
1461 |
return _stack_head >= 0 ? _stack[_stack_head] : INVALID;
|
| 1462 |
1462 |
}
|
| 1463 |
1463 |
|
| 1464 |
1464 |
/// \brief Returns \c false if there are nodes
|
| 1465 |
1465 |
/// to be processed.
|
| 1466 |
1466 |
///
|
| 1467 |
1467 |
/// Returns \c false if there are nodes
|
| 1468 |
1468 |
/// to be processed in the queue (stack).
|
| 1469 |
1469 |
bool emptyQueue() const { return _stack_head < 0; }
|
| 1470 |
1470 |
|
| 1471 |
1471 |
/// \brief Returns the number of the nodes to be processed.
|
| 1472 |
1472 |
///
|
| 1473 |
1473 |
/// Returns the number of the nodes to be processed in the queue (stack).
|
| 1474 |
1474 |
int queueSize() const { return _stack_head + 1; }
|
| 1475 |
1475 |
|
| 1476 |
1476 |
/// \brief Executes the algorithm.
|
| 1477 |
1477 |
///
|
| 1478 |
1478 |
/// Executes the algorithm.
|
| 1479 |
1479 |
///
|
| 1480 |
1480 |
/// This method runs the %DFS algorithm from the root node
|
| 1481 |
1481 |
/// in order to compute the %DFS path to each node.
|
| 1482 |
1482 |
///
|
| 1483 |
1483 |
/// The algorithm computes
|
| 1484 |
1484 |
/// - the %DFS tree,
|
| 1485 |
1485 |
/// - the distance of each node from the root in the %DFS tree.
|
| 1486 |
1486 |
///
|
| 1487 |
1487 |
/// \pre init() must be called and a root node should be
|
| 1488 |
1488 |
/// added with addSource() before using this function.
|
| 1489 |
1489 |
///
|
| 1490 |
1490 |
/// \note <tt>d.start()</tt> is just a shortcut of the following code.
|
| 1491 |
1491 |
/// \code
|
| 1492 |
1492 |
/// while ( !d.emptyQueue() ) {
|
| 1493 |
1493 |
/// d.processNextArc();
|
| 1494 |
1494 |
/// }
|
| 1495 |
1495 |
/// \endcode
|
| 1496 |
1496 |
void start() {
|
| 1497 |
1497 |
while ( !emptyQueue() ) processNextArc();
|
| 1498 |
1498 |
}
|
| 1499 |
1499 |
|
| 1500 |
1500 |
/// \brief Executes the algorithm until the given target node is reached.
|
| 1501 |
1501 |
///
|
| 1502 |
1502 |
/// Executes the algorithm until the given target node is reached.
|
| 1503 |
1503 |
///
|
| 1504 |
1504 |
/// This method runs the %DFS algorithm from the root node
|
| 1505 |
1505 |
/// in order to compute the DFS path to \c t.
|
| 1506 |
1506 |
///
|
| 1507 |
1507 |
/// The algorithm computes
|
| 1508 |
1508 |
/// - the %DFS path to \c t,
|
| 1509 |
1509 |
/// - the distance of \c t from the root in the %DFS tree.
|
| 1510 |
1510 |
///
|
| 1511 |
1511 |
/// \pre init() must be called and a root node should be added
|
| 1512 |
1512 |
/// with addSource() before using this function.
|
| 1513 |
1513 |
void start(Node t) {
|
| 1514 |
|
while ( !emptyQueue() && _digraph->target(_stack[_stack_head]) != t )
|
|
1514 |
while ( !emptyQueue() && !(*_reached)[t] )
|
| 1515 |
1515 |
processNextArc();
|
| 1516 |
1516 |
}
|
| 1517 |
1517 |
|
| 1518 |
1518 |
/// \brief Executes the algorithm until a condition is met.
|
| 1519 |
1519 |
///
|
| 1520 |
1520 |
/// Executes the algorithm until a condition is met.
|
| 1521 |
1521 |
///
|
| 1522 |
1522 |
/// This method runs the %DFS algorithm from the root node
|
| 1523 |
1523 |
/// until an arc \c a with <tt>am[a]</tt> true is found.
|
| 1524 |
1524 |
///
|
| 1525 |
1525 |
/// \param am A \c bool (or convertible) arc map. The algorithm
|
| 1526 |
1526 |
/// will stop when it reaches an arc \c a with <tt>am[a]</tt> true.
|
| 1527 |
1527 |
///
|
| 1528 |
1528 |
/// \return The reached arc \c a with <tt>am[a]</tt> true or
|
| 1529 |
1529 |
/// \c INVALID if no such arc was found.
|
| 1530 |
1530 |
///
|
| 1531 |
1531 |
/// \pre init() must be called and a root node should be added
|
| 1532 |
1532 |
/// with addSource() before using this function.
|
| 1533 |
1533 |
///
|
| 1534 |
1534 |
/// \warning Contrary to \ref Bfs and \ref Dijkstra, \c am is an arc map,
|
| 1535 |
1535 |
/// not a node map.
|
| 1536 |
1536 |
template <typename AM>
|
| 1537 |
1537 |
Arc start(const AM &am) {
|
| 1538 |
1538 |
while ( !emptyQueue() && !am[_stack[_stack_head]] )
|
| 1539 |
1539 |
processNextArc();
|
| 1540 |
1540 |
return emptyQueue() ? INVALID : _stack[_stack_head];
|
| 1541 |
1541 |
}
|
| 1542 |
1542 |
|
| 1543 |
1543 |
/// \brief Runs the algorithm from the given source node.
|
| 1544 |
1544 |
///
|
| 1545 |
1545 |
/// This method runs the %DFS algorithm from node \c s.
|
| 1546 |
1546 |
/// in order to compute the DFS path to each node.
|
| 1547 |
1547 |
///
|
| 1548 |
1548 |
/// The algorithm computes
|
| 1549 |
1549 |
/// - the %DFS tree,
|
| 1550 |
1550 |
/// - the distance of each node from the root in the %DFS tree.
|
| 1551 |
1551 |
///
|
| 1552 |
1552 |
/// \note <tt>d.run(s)</tt> is just a shortcut of the following code.
|
| 1553 |
1553 |
///\code
|
| 1554 |
1554 |
/// d.init();
|
| 1555 |
1555 |
/// d.addSource(s);
|
| 1556 |
1556 |
/// d.start();
|
| 1557 |
1557 |
///\endcode
|
| 1558 |
1558 |
void run(Node s) {
|
| 1559 |
1559 |
init();
|
| 1560 |
1560 |
addSource(s);
|
| 1561 |
1561 |
start();
|
| 1562 |
1562 |
}
|
| 1563 |
1563 |
|
| 1564 |
1564 |
/// \brief Finds the %DFS path between \c s and \c t.
|
| 1565 |
1565 |
|
| 1566 |
1566 |
/// This method runs the %DFS algorithm from node \c s
|
| 1567 |
1567 |
/// in order to compute the DFS path to node \c t
|
| 1568 |
1568 |
/// (it stops searching when \c t is processed).
|
| 1569 |
1569 |
///
|
| 1570 |
1570 |
/// \return \c true if \c t is reachable form \c s.
|
| 1571 |
1571 |
///
|
| 1572 |
1572 |
/// \note Apart from the return value, <tt>d.run(s,t)</tt> is
|
| 1573 |
1573 |
/// just a shortcut of the following code.
|
| 1574 |
1574 |
///\code
|
| 1575 |
1575 |
/// d.init();
|
| 1576 |
1576 |
/// d.addSource(s);
|
| 1577 |
1577 |
/// d.start(t);
|
| 1578 |
1578 |
///\endcode
|
| 1579 |
1579 |
bool run(Node s,Node t) {
|
| 1580 |
1580 |
init();
|
| 1581 |
1581 |
addSource(s);
|
| 1582 |
1582 |
start(t);
|
| 1583 |
1583 |
return reached(t);
|
| 1584 |
1584 |
}
|
| 1585 |
1585 |
|
| 1586 |
1586 |
/// \brief Runs the algorithm to visit all nodes in the digraph.
|
| 1587 |
1587 |
|
| 1588 |
1588 |
/// This method runs the %DFS algorithm in order to
|
| 1589 |
1589 |
/// compute the %DFS path to each node.
|
| 1590 |
1590 |
///
|
| 1591 |
1591 |
/// The algorithm computes
|
| 1592 |
1592 |
/// - the %DFS tree,
|
| 1593 |
1593 |
/// - the distance of each node from the root in the %DFS tree.
|
| 1594 |
1594 |
///
|
| 1595 |
1595 |
/// \note <tt>d.run()</tt> is just a shortcut of the following code.
|
| 1596 |
1596 |
///\code
|
| 1597 |
1597 |
/// d.init();
|
| 1598 |
1598 |
/// for (NodeIt n(digraph); n != INVALID; ++n) {
|
| 1599 |
1599 |
/// if (!d.reached(n)) {
|
| 1600 |
1600 |
/// d.addSource(n);
|
| 1601 |
1601 |
/// d.start();
|
| 1602 |
1602 |
/// }
|
| 1603 |
1603 |
/// }
|
| 1604 |
1604 |
///\endcode
|
| 1605 |
1605 |
void run() {
|
| 1606 |
1606 |
init();
|
| 1607 |
1607 |
for (NodeIt it(*_digraph); it != INVALID; ++it) {
|
| 1608 |
1608 |
if (!reached(it)) {
|
| 1609 |
1609 |
addSource(it);
|
| 1610 |
1610 |
start();
|