lemon/connectivity.h
author Alpar Juttner <alpar@cs.elte.hu>
Tue, 02 Dec 2008 15:33:22 +0000
changeset 434 ad483acf1654
child 435 9afe81e4c543
permissions -rw-r--r--
Merge
deba@433
     1
/* -*- mode: C++; indent-tabs-mode: nil; -*-
deba@433
     2
 *
deba@433
     3
 * This file is a part of LEMON, a generic C++ optimization library.
deba@433
     4
 *
deba@433
     5
 * Copyright (C) 2003-2008
deba@433
     6
 * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport
deba@433
     7
 * (Egervary Research Group on Combinatorial Optimization, EGRES).
deba@433
     8
 *
deba@433
     9
 * Permission to use, modify and distribute this software is granted
deba@433
    10
 * provided that this copyright notice appears in all copies. For
deba@433
    11
 * precise terms see the accompanying LICENSE file.
deba@433
    12
 *
deba@433
    13
 * This software is provided "AS IS" with no warranty of any kind,
deba@433
    14
 * express or implied, and with no claim as to its suitability for any
deba@433
    15
 * purpose.
deba@433
    16
 *
deba@433
    17
 */
deba@433
    18
deba@433
    19
#ifndef LEMON_TOPOLOGY_H
deba@433
    20
#define LEMON_TOPOLOGY_H
deba@433
    21
deba@433
    22
#include <lemon/dfs.h>
deba@433
    23
#include <lemon/bfs.h>
deba@433
    24
#include <lemon/core.h>
deba@433
    25
#include <lemon/maps.h>
deba@433
    26
#include <lemon/adaptors.h>
deba@433
    27
deba@433
    28
#include <lemon/concepts/digraph.h>
deba@433
    29
#include <lemon/concepts/graph.h>
deba@433
    30
#include <lemon/concept_check.h>
deba@433
    31
deba@433
    32
#include <stack>
deba@433
    33
#include <functional>
deba@433
    34
deba@433
    35
/// \ingroup connectivity
deba@433
    36
/// \file
deba@433
    37
/// \brief Connectivity algorithms
deba@433
    38
///
deba@433
    39
/// Connectivity algorithms
deba@433
    40
deba@433
    41
namespace lemon {
deba@433
    42
deba@433
    43
  /// \ingroup connectivity
deba@433
    44
  ///
deba@433
    45
  /// \brief Check whether the given undirected graph is connected.
deba@433
    46
  ///
deba@433
    47
  /// Check whether the given undirected graph is connected.
deba@433
    48
  /// \param graph The undirected graph.
deba@433
    49
  /// \return %True when there is path between any two nodes in the graph.
deba@433
    50
  /// \note By definition, the empty graph is connected.
deba@433
    51
  template <typename Graph>
deba@433
    52
  bool connected(const Graph& graph) {
deba@433
    53
    checkConcept<concepts::Graph, Graph>();
deba@433
    54
    typedef typename Graph::NodeIt NodeIt;
deba@433
    55
    if (NodeIt(graph) == INVALID) return true;
deba@433
    56
    Dfs<Graph> dfs(graph);
deba@433
    57
    dfs.run(NodeIt(graph));
deba@433
    58
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
    59
      if (!dfs.reached(it)) {
deba@433
    60
        return false;
deba@433
    61
      }
deba@433
    62
    }
deba@433
    63
    return true;
deba@433
    64
  }
deba@433
    65
deba@433
    66
  /// \ingroup connectivity
deba@433
    67
  ///
deba@433
    68
  /// \brief Count the number of connected components of an undirected graph
deba@433
    69
  ///
deba@433
    70
  /// Count the number of connected components of an undirected graph
deba@433
    71
  ///
deba@433
    72
  /// \param graph The graph. It must be undirected.
deba@433
    73
  /// \return The number of components
deba@433
    74
  /// \note By definition, the empty graph consists
deba@433
    75
  /// of zero connected components.
deba@433
    76
  template <typename Graph>
deba@433
    77
  int countConnectedComponents(const Graph &graph) {
deba@433
    78
    checkConcept<concepts::Graph, Graph>();
deba@433
    79
    typedef typename Graph::Node Node;
deba@433
    80
    typedef typename Graph::Arc Arc;
deba@433
    81
deba@433
    82
    typedef NullMap<Node, Arc> PredMap;
deba@433
    83
    typedef NullMap<Node, int> DistMap;
deba@433
    84
deba@433
    85
    int compNum = 0;
deba@433
    86
    typename Bfs<Graph>::
deba@433
    87
      template SetPredMap<PredMap>::
deba@433
    88
      template SetDistMap<DistMap>::
deba@433
    89
      Create bfs(graph);
deba@433
    90
deba@433
    91
    PredMap predMap;
deba@433
    92
    bfs.predMap(predMap);
deba@433
    93
deba@433
    94
    DistMap distMap;
deba@433
    95
    bfs.distMap(distMap);
deba@433
    96
deba@433
    97
    bfs.init();
deba@433
    98
    for(typename Graph::NodeIt n(graph); n != INVALID; ++n) {
deba@433
    99
      if (!bfs.reached(n)) {
deba@433
   100
        bfs.addSource(n);
deba@433
   101
        bfs.start();
deba@433
   102
        ++compNum;
deba@433
   103
      }
deba@433
   104
    }
deba@433
   105
    return compNum;
deba@433
   106
  }
deba@433
   107
deba@433
   108
  /// \ingroup connectivity
deba@433
   109
  ///
deba@433
   110
  /// \brief Find the connected components of an undirected graph
deba@433
   111
  ///
deba@433
   112
  /// Find the connected components of an undirected graph.
deba@433
   113
  ///
deba@433
   114
  /// \param graph The graph. It must be undirected.
deba@433
   115
  /// \retval compMap A writable node map. The values will be set from 0 to
deba@433
   116
  /// the number of the connected components minus one. Each values of the map
deba@433
   117
  /// will be set exactly once, the values of a certain component will be
deba@433
   118
  /// set continuously.
deba@433
   119
  /// \return The number of components
deba@433
   120
  ///
deba@433
   121
  template <class Graph, class NodeMap>
deba@433
   122
  int connectedComponents(const Graph &graph, NodeMap &compMap) {
deba@433
   123
    checkConcept<concepts::Graph, Graph>();
deba@433
   124
    typedef typename Graph::Node Node;
deba@433
   125
    typedef typename Graph::Arc Arc;
deba@433
   126
    checkConcept<concepts::WriteMap<Node, int>, NodeMap>();
deba@433
   127
deba@433
   128
    typedef NullMap<Node, Arc> PredMap;
deba@433
   129
    typedef NullMap<Node, int> DistMap;
deba@433
   130
deba@433
   131
    int compNum = 0;
deba@433
   132
    typename Bfs<Graph>::
deba@433
   133
      template SetPredMap<PredMap>::
deba@433
   134
      template SetDistMap<DistMap>::
deba@433
   135
      Create bfs(graph);
deba@433
   136
deba@433
   137
    PredMap predMap;
deba@433
   138
    bfs.predMap(predMap);
deba@433
   139
deba@433
   140
    DistMap distMap;
deba@433
   141
    bfs.distMap(distMap);
deba@433
   142
deba@433
   143
    bfs.init();
deba@433
   144
    for(typename Graph::NodeIt n(graph); n != INVALID; ++n) {
deba@433
   145
      if(!bfs.reached(n)) {
deba@433
   146
        bfs.addSource(n);
deba@433
   147
        while (!bfs.emptyQueue()) {
deba@433
   148
          compMap.set(bfs.nextNode(), compNum);
deba@433
   149
          bfs.processNextNode();
deba@433
   150
        }
deba@433
   151
        ++compNum;
deba@433
   152
      }
deba@433
   153
    }
deba@433
   154
    return compNum;
deba@433
   155
  }
deba@433
   156
deba@433
   157
  namespace _topology_bits {
deba@433
   158
deba@433
   159
    template <typename Digraph, typename Iterator >
deba@433
   160
    struct LeaveOrderVisitor : public DfsVisitor<Digraph> {
deba@433
   161
    public:
deba@433
   162
      typedef typename Digraph::Node Node;
deba@433
   163
      LeaveOrderVisitor(Iterator it) : _it(it) {}
deba@433
   164
deba@433
   165
      void leave(const Node& node) {
deba@433
   166
        *(_it++) = node;
deba@433
   167
      }
deba@433
   168
deba@433
   169
    private:
deba@433
   170
      Iterator _it;
deba@433
   171
    };
deba@433
   172
deba@433
   173
    template <typename Digraph, typename Map>
deba@433
   174
    struct FillMapVisitor : public DfsVisitor<Digraph> {
deba@433
   175
    public:
deba@433
   176
      typedef typename Digraph::Node Node;
deba@433
   177
      typedef typename Map::Value Value;
deba@433
   178
deba@433
   179
      FillMapVisitor(Map& map, Value& value)
deba@433
   180
        : _map(map), _value(value) {}
deba@433
   181
deba@433
   182
      void reach(const Node& node) {
deba@433
   183
        _map.set(node, _value);
deba@433
   184
      }
deba@433
   185
    private:
deba@433
   186
      Map& _map;
deba@433
   187
      Value& _value;
deba@433
   188
    };
deba@433
   189
deba@433
   190
    template <typename Digraph, typename ArcMap>
deba@433
   191
    struct StronglyConnectedCutEdgesVisitor : public DfsVisitor<Digraph> {
deba@433
   192
    public:
deba@433
   193
      typedef typename Digraph::Node Node;
deba@433
   194
      typedef typename Digraph::Arc Arc;
deba@433
   195
deba@433
   196
      StronglyConnectedCutEdgesVisitor(const Digraph& digraph,
deba@433
   197
                                       ArcMap& cutMap,
deba@433
   198
                                       int& cutNum)
deba@433
   199
        : _digraph(digraph), _cutMap(cutMap), _cutNum(cutNum),
deba@433
   200
          _compMap(digraph), _num(0) {
deba@433
   201
      }
deba@433
   202
deba@433
   203
      void stop(const Node&) {
deba@433
   204
        ++_num;
deba@433
   205
      }
deba@433
   206
deba@433
   207
      void reach(const Node& node) {
deba@433
   208
        _compMap.set(node, _num);
deba@433
   209
      }
deba@433
   210
deba@433
   211
      void examine(const Arc& arc) {
deba@433
   212
         if (_compMap[_digraph.source(arc)] !=
deba@433
   213
             _compMap[_digraph.target(arc)]) {
deba@433
   214
           _cutMap.set(arc, true);
deba@433
   215
           ++_cutNum;
deba@433
   216
         }
deba@433
   217
      }
deba@433
   218
    private:
deba@433
   219
      const Digraph& _digraph;
deba@433
   220
      ArcMap& _cutMap;
deba@433
   221
      int& _cutNum;
deba@433
   222
deba@433
   223
      typename Digraph::template NodeMap<int> _compMap;
deba@433
   224
      int _num;
deba@433
   225
    };
deba@433
   226
deba@433
   227
  }
deba@433
   228
deba@433
   229
deba@433
   230
  /// \ingroup connectivity
deba@433
   231
  ///
deba@433
   232
  /// \brief Check whether the given directed graph is strongly connected.
deba@433
   233
  ///
deba@433
   234
  /// Check whether the given directed graph is strongly connected. The
deba@433
   235
  /// graph is strongly connected when any two nodes of the graph are
deba@433
   236
  /// connected with directed paths in both direction.
deba@433
   237
  /// \return %False when the graph is not strongly connected.
deba@433
   238
  /// \see connected
deba@433
   239
  ///
deba@433
   240
  /// \note By definition, the empty graph is strongly connected.
deba@433
   241
  template <typename Digraph>
deba@433
   242
  bool stronglyConnected(const Digraph& digraph) {
deba@433
   243
    checkConcept<concepts::Digraph, Digraph>();
deba@433
   244
deba@433
   245
    typedef typename Digraph::Node Node;
deba@433
   246
    typedef typename Digraph::NodeIt NodeIt;
deba@433
   247
deba@433
   248
    typename Digraph::Node source = NodeIt(digraph);
deba@433
   249
    if (source == INVALID) return true;
deba@433
   250
deba@433
   251
    using namespace _topology_bits;
deba@433
   252
deba@433
   253
    typedef DfsVisitor<Digraph> Visitor;
deba@433
   254
    Visitor visitor;
deba@433
   255
deba@433
   256
    DfsVisit<Digraph, Visitor> dfs(digraph, visitor);
deba@433
   257
    dfs.init();
deba@433
   258
    dfs.addSource(source);
deba@433
   259
    dfs.start();
deba@433
   260
deba@433
   261
    for (NodeIt it(digraph); it != INVALID; ++it) {
deba@433
   262
      if (!dfs.reached(it)) {
deba@433
   263
        return false;
deba@433
   264
      }
deba@433
   265
    }
deba@433
   266
deba@433
   267
    typedef ReverseDigraph<const Digraph> RDigraph;
deba@433
   268
    RDigraph rdigraph(digraph);
deba@433
   269
deba@433
   270
    typedef DfsVisitor<Digraph> RVisitor;
deba@433
   271
    RVisitor rvisitor;
deba@433
   272
deba@433
   273
    DfsVisit<RDigraph, RVisitor> rdfs(rdigraph, rvisitor);
deba@433
   274
    rdfs.init();
deba@433
   275
    rdfs.addSource(source);
deba@433
   276
    rdfs.start();
deba@433
   277
deba@433
   278
    for (NodeIt it(rdigraph); it != INVALID; ++it) {
deba@433
   279
      if (!rdfs.reached(it)) {
deba@433
   280
        return false;
deba@433
   281
      }
deba@433
   282
    }
deba@433
   283
deba@433
   284
    return true;
deba@433
   285
  }
deba@433
   286
deba@433
   287
  /// \ingroup connectivity
deba@433
   288
  ///
deba@433
   289
  /// \brief Count the strongly connected components of a directed graph
deba@433
   290
  ///
deba@433
   291
  /// Count the strongly connected components of a directed graph.
deba@433
   292
  /// The strongly connected components are the classes of an
deba@433
   293
  /// equivalence relation on the nodes of the graph. Two nodes are in
deba@433
   294
  /// the same class if they are connected with directed paths in both
deba@433
   295
  /// direction.
deba@433
   296
  ///
deba@433
   297
  /// \param graph The graph.
deba@433
   298
  /// \return The number of components
deba@433
   299
  /// \note By definition, the empty graph has zero
deba@433
   300
  /// strongly connected components.
deba@433
   301
  template <typename Digraph>
deba@433
   302
  int countStronglyConnectedComponents(const Digraph& digraph) {
deba@433
   303
    checkConcept<concepts::Digraph, Digraph>();
deba@433
   304
deba@433
   305
    using namespace _topology_bits;
deba@433
   306
deba@433
   307
    typedef typename Digraph::Node Node;
deba@433
   308
    typedef typename Digraph::Arc Arc;
deba@433
   309
    typedef typename Digraph::NodeIt NodeIt;
deba@433
   310
    typedef typename Digraph::ArcIt ArcIt;
deba@433
   311
deba@433
   312
    typedef std::vector<Node> Container;
deba@433
   313
    typedef typename Container::iterator Iterator;
deba@433
   314
deba@433
   315
    Container nodes(countNodes(digraph));
deba@433
   316
    typedef LeaveOrderVisitor<Digraph, Iterator> Visitor;
deba@433
   317
    Visitor visitor(nodes.begin());
deba@433
   318
deba@433
   319
    DfsVisit<Digraph, Visitor> dfs(digraph, visitor);
deba@433
   320
    dfs.init();
deba@433
   321
    for (NodeIt it(digraph); it != INVALID; ++it) {
deba@433
   322
      if (!dfs.reached(it)) {
deba@433
   323
        dfs.addSource(it);
deba@433
   324
        dfs.start();
deba@433
   325
      }
deba@433
   326
    }
deba@433
   327
deba@433
   328
    typedef typename Container::reverse_iterator RIterator;
deba@433
   329
    typedef ReverseDigraph<const Digraph> RDigraph;
deba@433
   330
deba@433
   331
    RDigraph rdigraph(digraph);
deba@433
   332
deba@433
   333
    typedef DfsVisitor<Digraph> RVisitor;
deba@433
   334
    RVisitor rvisitor;
deba@433
   335
deba@433
   336
    DfsVisit<RDigraph, RVisitor> rdfs(rdigraph, rvisitor);
deba@433
   337
deba@433
   338
    int compNum = 0;
deba@433
   339
deba@433
   340
    rdfs.init();
deba@433
   341
    for (RIterator it = nodes.rbegin(); it != nodes.rend(); ++it) {
deba@433
   342
      if (!rdfs.reached(*it)) {
deba@433
   343
        rdfs.addSource(*it);
deba@433
   344
        rdfs.start();
deba@433
   345
        ++compNum;
deba@433
   346
      }
deba@433
   347
    }
deba@433
   348
    return compNum;
deba@433
   349
  }
deba@433
   350
deba@433
   351
  /// \ingroup connectivity
deba@433
   352
  ///
deba@433
   353
  /// \brief Find the strongly connected components of a directed graph
deba@433
   354
  ///
deba@433
   355
  /// Find the strongly connected components of a directed graph.  The
deba@433
   356
  /// strongly connected components are the classes of an equivalence
deba@433
   357
  /// relation on the nodes of the graph. Two nodes are in
deba@433
   358
  /// relationship when there are directed paths between them in both
deba@433
   359
  /// direction. In addition, the numbering of components will satisfy
deba@433
   360
  /// that there is no arc going from a higher numbered component to
deba@433
   361
  /// a lower.
deba@433
   362
  ///
deba@433
   363
  /// \param digraph The digraph.
deba@433
   364
  /// \retval compMap A writable node map. The values will be set from 0 to
deba@433
   365
  /// the number of the strongly connected components minus one. Each value
deba@433
   366
  /// of the map will be set exactly once, the values of a certain component
deba@433
   367
  /// will be set continuously.
deba@433
   368
  /// \return The number of components
deba@433
   369
  ///
deba@433
   370
  template <typename Digraph, typename NodeMap>
deba@433
   371
  int stronglyConnectedComponents(const Digraph& digraph, NodeMap& compMap) {
deba@433
   372
    checkConcept<concepts::Digraph, Digraph>();
deba@433
   373
    typedef typename Digraph::Node Node;
deba@433
   374
    typedef typename Digraph::NodeIt NodeIt;
deba@433
   375
    checkConcept<concepts::WriteMap<Node, int>, NodeMap>();
deba@433
   376
deba@433
   377
    using namespace _topology_bits;
deba@433
   378
deba@433
   379
    typedef std::vector<Node> Container;
deba@433
   380
    typedef typename Container::iterator Iterator;
deba@433
   381
deba@433
   382
    Container nodes(countNodes(digraph));
deba@433
   383
    typedef LeaveOrderVisitor<Digraph, Iterator> Visitor;
deba@433
   384
    Visitor visitor(nodes.begin());
deba@433
   385
deba@433
   386
    DfsVisit<Digraph, Visitor> dfs(digraph, visitor);
deba@433
   387
    dfs.init();
deba@433
   388
    for (NodeIt it(digraph); it != INVALID; ++it) {
deba@433
   389
      if (!dfs.reached(it)) {
deba@433
   390
        dfs.addSource(it);
deba@433
   391
        dfs.start();
deba@433
   392
      }
deba@433
   393
    }
deba@433
   394
deba@433
   395
    typedef typename Container::reverse_iterator RIterator;
deba@433
   396
    typedef ReverseDigraph<const Digraph> RDigraph;
deba@433
   397
deba@433
   398
    RDigraph rdigraph(digraph);
deba@433
   399
deba@433
   400
    int compNum = 0;
deba@433
   401
deba@433
   402
    typedef FillMapVisitor<RDigraph, NodeMap> RVisitor;
deba@433
   403
    RVisitor rvisitor(compMap, compNum);
deba@433
   404
deba@433
   405
    DfsVisit<RDigraph, RVisitor> rdfs(rdigraph, rvisitor);
deba@433
   406
deba@433
   407
    rdfs.init();
deba@433
   408
    for (RIterator it = nodes.rbegin(); it != nodes.rend(); ++it) {
deba@433
   409
      if (!rdfs.reached(*it)) {
deba@433
   410
        rdfs.addSource(*it);
deba@433
   411
        rdfs.start();
deba@433
   412
        ++compNum;
deba@433
   413
      }
deba@433
   414
    }
deba@433
   415
    return compNum;
deba@433
   416
  }
deba@433
   417
deba@433
   418
  /// \ingroup connectivity
deba@433
   419
  ///
deba@433
   420
  /// \brief Find the cut arcs of the strongly connected components.
deba@433
   421
  ///
deba@433
   422
  /// Find the cut arcs of the strongly connected components.
deba@433
   423
  /// The strongly connected components are the classes of an equivalence
deba@433
   424
  /// relation on the nodes of the graph. Two nodes are in relationship
deba@433
   425
  /// when there are directed paths between them in both direction.
deba@433
   426
  /// The strongly connected components are separated by the cut arcs.
deba@433
   427
  ///
deba@433
   428
  /// \param graph The graph.
deba@433
   429
  /// \retval cutMap A writable node map. The values will be set true when the
deba@433
   430
  /// arc is a cut arc.
deba@433
   431
  ///
deba@433
   432
  /// \return The number of cut arcs
deba@433
   433
  template <typename Digraph, typename ArcMap>
deba@433
   434
  int stronglyConnectedCutArcs(const Digraph& graph, ArcMap& cutMap) {
deba@433
   435
    checkConcept<concepts::Digraph, Digraph>();
deba@433
   436
    typedef typename Digraph::Node Node;
deba@433
   437
    typedef typename Digraph::Arc Arc;
deba@433
   438
    typedef typename Digraph::NodeIt NodeIt;
deba@433
   439
    checkConcept<concepts::WriteMap<Arc, bool>, ArcMap>();
deba@433
   440
deba@433
   441
    using namespace _topology_bits;
deba@433
   442
deba@433
   443
    typedef std::vector<Node> Container;
deba@433
   444
    typedef typename Container::iterator Iterator;
deba@433
   445
deba@433
   446
    Container nodes(countNodes(graph));
deba@433
   447
    typedef LeaveOrderVisitor<Digraph, Iterator> Visitor;
deba@433
   448
    Visitor visitor(nodes.begin());
deba@433
   449
deba@433
   450
    DfsVisit<Digraph, Visitor> dfs(graph, visitor);
deba@433
   451
    dfs.init();
deba@433
   452
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
   453
      if (!dfs.reached(it)) {
deba@433
   454
        dfs.addSource(it);
deba@433
   455
        dfs.start();
deba@433
   456
      }
deba@433
   457
    }
deba@433
   458
deba@433
   459
    typedef typename Container::reverse_iterator RIterator;
deba@433
   460
    typedef ReverseDigraph<const Digraph> RDigraph;
deba@433
   461
deba@433
   462
    RDigraph rgraph(graph);
deba@433
   463
deba@433
   464
    int cutNum = 0;
deba@433
   465
deba@433
   466
    typedef StronglyConnectedCutEdgesVisitor<RDigraph, ArcMap> RVisitor;
deba@433
   467
    RVisitor rvisitor(rgraph, cutMap, cutNum);
deba@433
   468
deba@433
   469
    DfsVisit<RDigraph, RVisitor> rdfs(rgraph, rvisitor);
deba@433
   470
deba@433
   471
    rdfs.init();
deba@433
   472
    for (RIterator it = nodes.rbegin(); it != nodes.rend(); ++it) {
deba@433
   473
      if (!rdfs.reached(*it)) {
deba@433
   474
        rdfs.addSource(*it);
deba@433
   475
        rdfs.start();
deba@433
   476
      }
deba@433
   477
    }
deba@433
   478
    return cutNum;
deba@433
   479
  }
deba@433
   480
deba@433
   481
  namespace _topology_bits {
deba@433
   482
deba@433
   483
    template <typename Digraph>
deba@433
   484
    class CountBiNodeConnectedComponentsVisitor : public DfsVisitor<Digraph> {
deba@433
   485
    public:
deba@433
   486
      typedef typename Digraph::Node Node;
deba@433
   487
      typedef typename Digraph::Arc Arc;
deba@433
   488
      typedef typename Digraph::Edge Edge;
deba@433
   489
deba@433
   490
      CountBiNodeConnectedComponentsVisitor(const Digraph& graph, int &compNum)
deba@433
   491
        : _graph(graph), _compNum(compNum),
deba@433
   492
          _numMap(graph), _retMap(graph), _predMap(graph), _num(0) {}
deba@433
   493
deba@433
   494
      void start(const Node& node) {
deba@433
   495
        _predMap.set(node, INVALID);
deba@433
   496
      }
deba@433
   497
deba@433
   498
      void reach(const Node& node) {
deba@433
   499
        _numMap.set(node, _num);
deba@433
   500
        _retMap.set(node, _num);
deba@433
   501
        ++_num;
deba@433
   502
      }
deba@433
   503
deba@433
   504
      void discover(const Arc& edge) {
deba@433
   505
        _predMap.set(_graph.target(edge), _graph.source(edge));
deba@433
   506
      }
deba@433
   507
deba@433
   508
      void examine(const Arc& edge) {
deba@433
   509
        if (_graph.source(edge) == _graph.target(edge) &&
deba@433
   510
            _graph.direction(edge)) {
deba@433
   511
          ++_compNum;
deba@433
   512
          return;
deba@433
   513
        }
deba@433
   514
        if (_predMap[_graph.source(edge)] == _graph.target(edge)) {
deba@433
   515
          return;
deba@433
   516
        }
deba@433
   517
        if (_retMap[_graph.source(edge)] > _numMap[_graph.target(edge)]) {
deba@433
   518
          _retMap.set(_graph.source(edge), _numMap[_graph.target(edge)]);
deba@433
   519
        }
deba@433
   520
      }
deba@433
   521
deba@433
   522
      void backtrack(const Arc& edge) {
deba@433
   523
        if (_retMap[_graph.source(edge)] > _retMap[_graph.target(edge)]) {
deba@433
   524
          _retMap.set(_graph.source(edge), _retMap[_graph.target(edge)]);
deba@433
   525
        }
deba@433
   526
        if (_numMap[_graph.source(edge)] <= _retMap[_graph.target(edge)]) {
deba@433
   527
          ++_compNum;
deba@433
   528
        }
deba@433
   529
      }
deba@433
   530
deba@433
   531
    private:
deba@433
   532
      const Digraph& _graph;
deba@433
   533
      int& _compNum;
deba@433
   534
deba@433
   535
      typename Digraph::template NodeMap<int> _numMap;
deba@433
   536
      typename Digraph::template NodeMap<int> _retMap;
deba@433
   537
      typename Digraph::template NodeMap<Node> _predMap;
deba@433
   538
      int _num;
deba@433
   539
    };
deba@433
   540
deba@433
   541
    template <typename Digraph, typename ArcMap>
deba@433
   542
    class BiNodeConnectedComponentsVisitor : public DfsVisitor<Digraph> {
deba@433
   543
    public:
deba@433
   544
      typedef typename Digraph::Node Node;
deba@433
   545
      typedef typename Digraph::Arc Arc;
deba@433
   546
      typedef typename Digraph::Edge Edge;
deba@433
   547
deba@433
   548
      BiNodeConnectedComponentsVisitor(const Digraph& graph,
deba@433
   549
                                       ArcMap& compMap, int &compNum)
deba@433
   550
        : _graph(graph), _compMap(compMap), _compNum(compNum),
deba@433
   551
          _numMap(graph), _retMap(graph), _predMap(graph), _num(0) {}
deba@433
   552
deba@433
   553
      void start(const Node& node) {
deba@433
   554
        _predMap.set(node, INVALID);
deba@433
   555
      }
deba@433
   556
deba@433
   557
      void reach(const Node& node) {
deba@433
   558
        _numMap.set(node, _num);
deba@433
   559
        _retMap.set(node, _num);
deba@433
   560
        ++_num;
deba@433
   561
      }
deba@433
   562
deba@433
   563
      void discover(const Arc& edge) {
deba@433
   564
        Node target = _graph.target(edge);
deba@433
   565
        _predMap.set(target, edge);
deba@433
   566
        _edgeStack.push(edge);
deba@433
   567
      }
deba@433
   568
deba@433
   569
      void examine(const Arc& edge) {
deba@433
   570
        Node source = _graph.source(edge);
deba@433
   571
        Node target = _graph.target(edge);
deba@433
   572
        if (source == target && _graph.direction(edge)) {
deba@433
   573
          _compMap.set(edge, _compNum);
deba@433
   574
          ++_compNum;
deba@433
   575
          return;
deba@433
   576
        }
deba@433
   577
        if (_numMap[target] < _numMap[source]) {
deba@433
   578
          if (_predMap[source] != _graph.oppositeArc(edge)) {
deba@433
   579
            _edgeStack.push(edge);
deba@433
   580
          }
deba@433
   581
        }
deba@433
   582
        if (_predMap[source] != INVALID &&
deba@433
   583
            target == _graph.source(_predMap[source])) {
deba@433
   584
          return;
deba@433
   585
        }
deba@433
   586
        if (_retMap[source] > _numMap[target]) {
deba@433
   587
          _retMap.set(source, _numMap[target]);
deba@433
   588
        }
deba@433
   589
      }
deba@433
   590
deba@433
   591
      void backtrack(const Arc& edge) {
deba@433
   592
        Node source = _graph.source(edge);
deba@433
   593
        Node target = _graph.target(edge);
deba@433
   594
        if (_retMap[source] > _retMap[target]) {
deba@433
   595
          _retMap.set(source, _retMap[target]);
deba@433
   596
        }
deba@433
   597
        if (_numMap[source] <= _retMap[target]) {
deba@433
   598
          while (_edgeStack.top() != edge) {
deba@433
   599
            _compMap.set(_edgeStack.top(), _compNum);
deba@433
   600
            _edgeStack.pop();
deba@433
   601
          }
deba@433
   602
          _compMap.set(edge, _compNum);
deba@433
   603
          _edgeStack.pop();
deba@433
   604
          ++_compNum;
deba@433
   605
        }
deba@433
   606
      }
deba@433
   607
deba@433
   608
    private:
deba@433
   609
      const Digraph& _graph;
deba@433
   610
      ArcMap& _compMap;
deba@433
   611
      int& _compNum;
deba@433
   612
deba@433
   613
      typename Digraph::template NodeMap<int> _numMap;
deba@433
   614
      typename Digraph::template NodeMap<int> _retMap;
deba@433
   615
      typename Digraph::template NodeMap<Arc> _predMap;
deba@433
   616
      std::stack<Edge> _edgeStack;
deba@433
   617
      int _num;
deba@433
   618
    };
deba@433
   619
deba@433
   620
deba@433
   621
    template <typename Digraph, typename NodeMap>
deba@433
   622
    class BiNodeConnectedCutNodesVisitor : public DfsVisitor<Digraph> {
deba@433
   623
    public:
deba@433
   624
      typedef typename Digraph::Node Node;
deba@433
   625
      typedef typename Digraph::Arc Arc;
deba@433
   626
      typedef typename Digraph::Edge Edge;
deba@433
   627
deba@433
   628
      BiNodeConnectedCutNodesVisitor(const Digraph& graph, NodeMap& cutMap,
deba@433
   629
                                     int& cutNum)
deba@433
   630
        : _graph(graph), _cutMap(cutMap), _cutNum(cutNum),
deba@433
   631
          _numMap(graph), _retMap(graph), _predMap(graph), _num(0) {}
deba@433
   632
deba@433
   633
      void start(const Node& node) {
deba@433
   634
        _predMap.set(node, INVALID);
deba@433
   635
        rootCut = false;
deba@433
   636
      }
deba@433
   637
deba@433
   638
      void reach(const Node& node) {
deba@433
   639
        _numMap.set(node, _num);
deba@433
   640
        _retMap.set(node, _num);
deba@433
   641
        ++_num;
deba@433
   642
      }
deba@433
   643
deba@433
   644
      void discover(const Arc& edge) {
deba@433
   645
        _predMap.set(_graph.target(edge), _graph.source(edge));
deba@433
   646
      }
deba@433
   647
deba@433
   648
      void examine(const Arc& edge) {
deba@433
   649
        if (_graph.source(edge) == _graph.target(edge) &&
deba@433
   650
            _graph.direction(edge)) {
deba@433
   651
          if (!_cutMap[_graph.source(edge)]) {
deba@433
   652
            _cutMap.set(_graph.source(edge), true);
deba@433
   653
            ++_cutNum;
deba@433
   654
          }
deba@433
   655
          return;
deba@433
   656
        }
deba@433
   657
        if (_predMap[_graph.source(edge)] == _graph.target(edge)) return;
deba@433
   658
        if (_retMap[_graph.source(edge)] > _numMap[_graph.target(edge)]) {
deba@433
   659
          _retMap.set(_graph.source(edge), _numMap[_graph.target(edge)]);
deba@433
   660
        }
deba@433
   661
      }
deba@433
   662
deba@433
   663
      void backtrack(const Arc& edge) {
deba@433
   664
        if (_retMap[_graph.source(edge)] > _retMap[_graph.target(edge)]) {
deba@433
   665
          _retMap.set(_graph.source(edge), _retMap[_graph.target(edge)]);
deba@433
   666
        }
deba@433
   667
        if (_numMap[_graph.source(edge)] <= _retMap[_graph.target(edge)]) {
deba@433
   668
          if (_predMap[_graph.source(edge)] != INVALID) {
deba@433
   669
            if (!_cutMap[_graph.source(edge)]) {
deba@433
   670
              _cutMap.set(_graph.source(edge), true);
deba@433
   671
              ++_cutNum;
deba@433
   672
            }
deba@433
   673
          } else if (rootCut) {
deba@433
   674
            if (!_cutMap[_graph.source(edge)]) {
deba@433
   675
              _cutMap.set(_graph.source(edge), true);
deba@433
   676
              ++_cutNum;
deba@433
   677
            }
deba@433
   678
          } else {
deba@433
   679
            rootCut = true;
deba@433
   680
          }
deba@433
   681
        }
deba@433
   682
      }
deba@433
   683
deba@433
   684
    private:
deba@433
   685
      const Digraph& _graph;
deba@433
   686
      NodeMap& _cutMap;
deba@433
   687
      int& _cutNum;
deba@433
   688
deba@433
   689
      typename Digraph::template NodeMap<int> _numMap;
deba@433
   690
      typename Digraph::template NodeMap<int> _retMap;
deba@433
   691
      typename Digraph::template NodeMap<Node> _predMap;
deba@433
   692
      std::stack<Edge> _edgeStack;
deba@433
   693
      int _num;
deba@433
   694
      bool rootCut;
deba@433
   695
    };
deba@433
   696
deba@433
   697
  }
deba@433
   698
deba@433
   699
  template <typename Graph>
deba@433
   700
  int countBiNodeConnectedComponents(const Graph& graph);
deba@433
   701
deba@433
   702
  /// \ingroup connectivity
deba@433
   703
  ///
deba@433
   704
  /// \brief Checks the graph is bi-node-connected.
deba@433
   705
  ///
deba@433
   706
  /// This function checks that the undirected graph is bi-node-connected
deba@433
   707
  /// graph. The graph is bi-node-connected if any two undirected edge is
deba@433
   708
  /// on same circle.
deba@433
   709
  ///
deba@433
   710
  /// \param graph The graph.
deba@433
   711
  /// \return %True when the graph bi-node-connected.
deba@433
   712
  template <typename Graph>
deba@433
   713
  bool biNodeConnected(const Graph& graph) {
deba@433
   714
    return countBiNodeConnectedComponents(graph) <= 1;
deba@433
   715
  }
deba@433
   716
deba@433
   717
  /// \ingroup connectivity
deba@433
   718
  ///
deba@433
   719
  /// \brief Count the biconnected components.
deba@433
   720
  ///
deba@433
   721
  /// This function finds the bi-node-connected components in an undirected
deba@433
   722
  /// graph. The biconnected components are the classes of an equivalence
deba@433
   723
  /// relation on the undirected edges. Two undirected edge is in relationship
deba@433
   724
  /// when they are on same circle.
deba@433
   725
  ///
deba@433
   726
  /// \param graph The graph.
deba@433
   727
  /// \return The number of components.
deba@433
   728
  template <typename Graph>
deba@433
   729
  int countBiNodeConnectedComponents(const Graph& graph) {
deba@433
   730
    checkConcept<concepts::Graph, Graph>();
deba@433
   731
    typedef typename Graph::NodeIt NodeIt;
deba@433
   732
deba@433
   733
    using namespace _topology_bits;
deba@433
   734
deba@433
   735
    typedef CountBiNodeConnectedComponentsVisitor<Graph> Visitor;
deba@433
   736
deba@433
   737
    int compNum = 0;
deba@433
   738
    Visitor visitor(graph, compNum);
deba@433
   739
deba@433
   740
    DfsVisit<Graph, Visitor> dfs(graph, visitor);
deba@433
   741
    dfs.init();
deba@433
   742
deba@433
   743
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
   744
      if (!dfs.reached(it)) {
deba@433
   745
        dfs.addSource(it);
deba@433
   746
        dfs.start();
deba@433
   747
      }
deba@433
   748
    }
deba@433
   749
    return compNum;
deba@433
   750
  }
deba@433
   751
deba@433
   752
  /// \ingroup connectivity
deba@433
   753
  ///
deba@433
   754
  /// \brief Find the bi-node-connected components.
deba@433
   755
  ///
deba@433
   756
  /// This function finds the bi-node-connected components in an undirected
deba@433
   757
  /// graph. The bi-node-connected components are the classes of an equivalence
deba@433
   758
  /// relation on the undirected edges. Two undirected edge are in relationship
deba@433
   759
  /// when they are on same circle.
deba@433
   760
  ///
deba@433
   761
  /// \param graph The graph.
deba@433
   762
  /// \retval compMap A writable uedge map. The values will be set from 0
deba@433
   763
  /// to the number of the biconnected components minus one. Each values
deba@433
   764
  /// of the map will be set exactly once, the values of a certain component
deba@433
   765
  /// will be set continuously.
deba@433
   766
  /// \return The number of components.
deba@433
   767
  ///
deba@433
   768
  template <typename Graph, typename EdgeMap>
deba@433
   769
  int biNodeConnectedComponents(const Graph& graph,
deba@433
   770
                                EdgeMap& compMap) {
deba@433
   771
    checkConcept<concepts::Graph, Graph>();
deba@433
   772
    typedef typename Graph::NodeIt NodeIt;
deba@433
   773
    typedef typename Graph::Edge Edge;
deba@433
   774
    checkConcept<concepts::WriteMap<Edge, int>, EdgeMap>();
deba@433
   775
deba@433
   776
    using namespace _topology_bits;
deba@433
   777
deba@433
   778
    typedef BiNodeConnectedComponentsVisitor<Graph, EdgeMap> Visitor;
deba@433
   779
deba@433
   780
    int compNum = 0;
deba@433
   781
    Visitor visitor(graph, compMap, compNum);
deba@433
   782
deba@433
   783
    DfsVisit<Graph, Visitor> dfs(graph, visitor);
deba@433
   784
    dfs.init();
deba@433
   785
deba@433
   786
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
   787
      if (!dfs.reached(it)) {
deba@433
   788
        dfs.addSource(it);
deba@433
   789
        dfs.start();
deba@433
   790
      }
deba@433
   791
    }
deba@433
   792
    return compNum;
deba@433
   793
  }
deba@433
   794
deba@433
   795
  /// \ingroup connectivity
deba@433
   796
  ///
deba@433
   797
  /// \brief Find the bi-node-connected cut nodes.
deba@433
   798
  ///
deba@433
   799
  /// This function finds the bi-node-connected cut nodes in an undirected
deba@433
   800
  /// graph. The bi-node-connected components are the classes of an equivalence
deba@433
   801
  /// relation on the undirected edges. Two undirected edges are in
deba@433
   802
  /// relationship when they are on same circle. The biconnected components
deba@433
   803
  /// are separted by nodes which are the cut nodes of the components.
deba@433
   804
  ///
deba@433
   805
  /// \param graph The graph.
deba@433
   806
  /// \retval cutMap A writable edge map. The values will be set true when
deba@433
   807
  /// the node separate two or more components.
deba@433
   808
  /// \return The number of the cut nodes.
deba@433
   809
  template <typename Graph, typename NodeMap>
deba@433
   810
  int biNodeConnectedCutNodes(const Graph& graph, NodeMap& cutMap) {
deba@433
   811
    checkConcept<concepts::Graph, Graph>();
deba@433
   812
    typedef typename Graph::Node Node;
deba@433
   813
    typedef typename Graph::NodeIt NodeIt;
deba@433
   814
    checkConcept<concepts::WriteMap<Node, bool>, NodeMap>();
deba@433
   815
deba@433
   816
    using namespace _topology_bits;
deba@433
   817
deba@433
   818
    typedef BiNodeConnectedCutNodesVisitor<Graph, NodeMap> Visitor;
deba@433
   819
deba@433
   820
    int cutNum = 0;
deba@433
   821
    Visitor visitor(graph, cutMap, cutNum);
deba@433
   822
deba@433
   823
    DfsVisit<Graph, Visitor> dfs(graph, visitor);
deba@433
   824
    dfs.init();
deba@433
   825
deba@433
   826
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
   827
      if (!dfs.reached(it)) {
deba@433
   828
        dfs.addSource(it);
deba@433
   829
        dfs.start();
deba@433
   830
      }
deba@433
   831
    }
deba@433
   832
    return cutNum;
deba@433
   833
  }
deba@433
   834
deba@433
   835
  namespace _topology_bits {
deba@433
   836
deba@433
   837
    template <typename Digraph>
deba@433
   838
    class CountBiEdgeConnectedComponentsVisitor : public DfsVisitor<Digraph> {
deba@433
   839
    public:
deba@433
   840
      typedef typename Digraph::Node Node;
deba@433
   841
      typedef typename Digraph::Arc Arc;
deba@433
   842
      typedef typename Digraph::Edge Edge;
deba@433
   843
deba@433
   844
      CountBiEdgeConnectedComponentsVisitor(const Digraph& graph, int &compNum)
deba@433
   845
        : _graph(graph), _compNum(compNum),
deba@433
   846
          _numMap(graph), _retMap(graph), _predMap(graph), _num(0) {}
deba@433
   847
deba@433
   848
      void start(const Node& node) {
deba@433
   849
        _predMap.set(node, INVALID);
deba@433
   850
      }
deba@433
   851
deba@433
   852
      void reach(const Node& node) {
deba@433
   853
        _numMap.set(node, _num);
deba@433
   854
        _retMap.set(node, _num);
deba@433
   855
        ++_num;
deba@433
   856
      }
deba@433
   857
deba@433
   858
      void leave(const Node& node) {
deba@433
   859
        if (_numMap[node] <= _retMap[node]) {
deba@433
   860
          ++_compNum;
deba@433
   861
        }
deba@433
   862
      }
deba@433
   863
deba@433
   864
      void discover(const Arc& edge) {
deba@433
   865
        _predMap.set(_graph.target(edge), edge);
deba@433
   866
      }
deba@433
   867
deba@433
   868
      void examine(const Arc& edge) {
deba@433
   869
        if (_predMap[_graph.source(edge)] == _graph.oppositeArc(edge)) {
deba@433
   870
          return;
deba@433
   871
        }
deba@433
   872
        if (_retMap[_graph.source(edge)] > _retMap[_graph.target(edge)]) {
deba@433
   873
          _retMap.set(_graph.source(edge), _retMap[_graph.target(edge)]);
deba@433
   874
        }
deba@433
   875
      }
deba@433
   876
deba@433
   877
      void backtrack(const Arc& edge) {
deba@433
   878
        if (_retMap[_graph.source(edge)] > _retMap[_graph.target(edge)]) {
deba@433
   879
          _retMap.set(_graph.source(edge), _retMap[_graph.target(edge)]);
deba@433
   880
        }
deba@433
   881
      }
deba@433
   882
deba@433
   883
    private:
deba@433
   884
      const Digraph& _graph;
deba@433
   885
      int& _compNum;
deba@433
   886
deba@433
   887
      typename Digraph::template NodeMap<int> _numMap;
deba@433
   888
      typename Digraph::template NodeMap<int> _retMap;
deba@433
   889
      typename Digraph::template NodeMap<Arc> _predMap;
deba@433
   890
      int _num;
deba@433
   891
    };
deba@433
   892
deba@433
   893
    template <typename Digraph, typename NodeMap>
deba@433
   894
    class BiEdgeConnectedComponentsVisitor : public DfsVisitor<Digraph> {
deba@433
   895
    public:
deba@433
   896
      typedef typename Digraph::Node Node;
deba@433
   897
      typedef typename Digraph::Arc Arc;
deba@433
   898
      typedef typename Digraph::Edge Edge;
deba@433
   899
deba@433
   900
      BiEdgeConnectedComponentsVisitor(const Digraph& graph,
deba@433
   901
                                       NodeMap& compMap, int &compNum)
deba@433
   902
        : _graph(graph), _compMap(compMap), _compNum(compNum),
deba@433
   903
          _numMap(graph), _retMap(graph), _predMap(graph), _num(0) {}
deba@433
   904
deba@433
   905
      void start(const Node& node) {
deba@433
   906
        _predMap.set(node, INVALID);
deba@433
   907
      }
deba@433
   908
deba@433
   909
      void reach(const Node& node) {
deba@433
   910
        _numMap.set(node, _num);
deba@433
   911
        _retMap.set(node, _num);
deba@433
   912
        _nodeStack.push(node);
deba@433
   913
        ++_num;
deba@433
   914
      }
deba@433
   915
deba@433
   916
      void leave(const Node& node) {
deba@433
   917
        if (_numMap[node] <= _retMap[node]) {
deba@433
   918
          while (_nodeStack.top() != node) {
deba@433
   919
            _compMap.set(_nodeStack.top(), _compNum);
deba@433
   920
            _nodeStack.pop();
deba@433
   921
          }
deba@433
   922
          _compMap.set(node, _compNum);
deba@433
   923
          _nodeStack.pop();
deba@433
   924
          ++_compNum;
deba@433
   925
        }
deba@433
   926
      }
deba@433
   927
deba@433
   928
      void discover(const Arc& edge) {
deba@433
   929
        _predMap.set(_graph.target(edge), edge);
deba@433
   930
      }
deba@433
   931
deba@433
   932
      void examine(const Arc& edge) {
deba@433
   933
        if (_predMap[_graph.source(edge)] == _graph.oppositeArc(edge)) {
deba@433
   934
          return;
deba@433
   935
        }
deba@433
   936
        if (_retMap[_graph.source(edge)] > _retMap[_graph.target(edge)]) {
deba@433
   937
          _retMap.set(_graph.source(edge), _retMap[_graph.target(edge)]);
deba@433
   938
        }
deba@433
   939
      }
deba@433
   940
deba@433
   941
      void backtrack(const Arc& edge) {
deba@433
   942
        if (_retMap[_graph.source(edge)] > _retMap[_graph.target(edge)]) {
deba@433
   943
          _retMap.set(_graph.source(edge), _retMap[_graph.target(edge)]);
deba@433
   944
        }
deba@433
   945
      }
deba@433
   946
deba@433
   947
    private:
deba@433
   948
      const Digraph& _graph;
deba@433
   949
      NodeMap& _compMap;
deba@433
   950
      int& _compNum;
deba@433
   951
deba@433
   952
      typename Digraph::template NodeMap<int> _numMap;
deba@433
   953
      typename Digraph::template NodeMap<int> _retMap;
deba@433
   954
      typename Digraph::template NodeMap<Arc> _predMap;
deba@433
   955
      std::stack<Node> _nodeStack;
deba@433
   956
      int _num;
deba@433
   957
    };
deba@433
   958
deba@433
   959
deba@433
   960
    template <typename Digraph, typename ArcMap>
deba@433
   961
    class BiEdgeConnectedCutEdgesVisitor : public DfsVisitor<Digraph> {
deba@433
   962
    public:
deba@433
   963
      typedef typename Digraph::Node Node;
deba@433
   964
      typedef typename Digraph::Arc Arc;
deba@433
   965
      typedef typename Digraph::Edge Edge;
deba@433
   966
deba@433
   967
      BiEdgeConnectedCutEdgesVisitor(const Digraph& graph,
deba@433
   968
                                     ArcMap& cutMap, int &cutNum)
deba@433
   969
        : _graph(graph), _cutMap(cutMap), _cutNum(cutNum),
deba@433
   970
          _numMap(graph), _retMap(graph), _predMap(graph), _num(0) {}
deba@433
   971
deba@433
   972
      void start(const Node& node) {
deba@433
   973
        _predMap[node] = INVALID;
deba@433
   974
      }
deba@433
   975
deba@433
   976
      void reach(const Node& node) {
deba@433
   977
        _numMap.set(node, _num);
deba@433
   978
        _retMap.set(node, _num);
deba@433
   979
        ++_num;
deba@433
   980
      }
deba@433
   981
deba@433
   982
      void leave(const Node& node) {
deba@433
   983
        if (_numMap[node] <= _retMap[node]) {
deba@433
   984
          if (_predMap[node] != INVALID) {
deba@433
   985
            _cutMap.set(_predMap[node], true);
deba@433
   986
            ++_cutNum;
deba@433
   987
          }
deba@433
   988
        }
deba@433
   989
      }
deba@433
   990
deba@433
   991
      void discover(const Arc& edge) {
deba@433
   992
        _predMap.set(_graph.target(edge), edge);
deba@433
   993
      }
deba@433
   994
deba@433
   995
      void examine(const Arc& edge) {
deba@433
   996
        if (_predMap[_graph.source(edge)] == _graph.oppositeArc(edge)) {
deba@433
   997
          return;
deba@433
   998
        }
deba@433
   999
        if (_retMap[_graph.source(edge)] > _retMap[_graph.target(edge)]) {
deba@433
  1000
          _retMap.set(_graph.source(edge), _retMap[_graph.target(edge)]);
deba@433
  1001
        }
deba@433
  1002
      }
deba@433
  1003
deba@433
  1004
      void backtrack(const Arc& edge) {
deba@433
  1005
        if (_retMap[_graph.source(edge)] > _retMap[_graph.target(edge)]) {
deba@433
  1006
          _retMap.set(_graph.source(edge), _retMap[_graph.target(edge)]);
deba@433
  1007
        }
deba@433
  1008
      }
deba@433
  1009
deba@433
  1010
    private:
deba@433
  1011
      const Digraph& _graph;
deba@433
  1012
      ArcMap& _cutMap;
deba@433
  1013
      int& _cutNum;
deba@433
  1014
deba@433
  1015
      typename Digraph::template NodeMap<int> _numMap;
deba@433
  1016
      typename Digraph::template NodeMap<int> _retMap;
deba@433
  1017
      typename Digraph::template NodeMap<Arc> _predMap;
deba@433
  1018
      int _num;
deba@433
  1019
    };
deba@433
  1020
  }
deba@433
  1021
deba@433
  1022
  template <typename Graph>
deba@433
  1023
  int countBiEdgeConnectedComponents(const Graph& graph);
deba@433
  1024
deba@433
  1025
  /// \ingroup connectivity
deba@433
  1026
  ///
deba@433
  1027
  /// \brief Checks that the graph is bi-edge-connected.
deba@433
  1028
  ///
deba@433
  1029
  /// This function checks that the graph is bi-edge-connected. The undirected
deba@433
  1030
  /// graph is bi-edge-connected when any two nodes are connected with two
deba@433
  1031
  /// edge-disjoint paths.
deba@433
  1032
  ///
deba@433
  1033
  /// \param graph The undirected graph.
deba@433
  1034
  /// \return The number of components.
deba@433
  1035
  template <typename Graph>
deba@433
  1036
  bool biEdgeConnected(const Graph& graph) {
deba@433
  1037
    return countBiEdgeConnectedComponents(graph) <= 1;
deba@433
  1038
  }
deba@433
  1039
deba@433
  1040
  /// \ingroup connectivity
deba@433
  1041
  ///
deba@433
  1042
  /// \brief Count the bi-edge-connected components.
deba@433
  1043
  ///
deba@433
  1044
  /// This function count the bi-edge-connected components in an undirected
deba@433
  1045
  /// graph. The bi-edge-connected components are the classes of an equivalence
deba@433
  1046
  /// relation on the nodes. Two nodes are in relationship when they are
deba@433
  1047
  /// connected with at least two edge-disjoint paths.
deba@433
  1048
  ///
deba@433
  1049
  /// \param graph The undirected graph.
deba@433
  1050
  /// \return The number of components.
deba@433
  1051
  template <typename Graph>
deba@433
  1052
  int countBiEdgeConnectedComponents(const Graph& graph) {
deba@433
  1053
    checkConcept<concepts::Graph, Graph>();
deba@433
  1054
    typedef typename Graph::NodeIt NodeIt;
deba@433
  1055
deba@433
  1056
    using namespace _topology_bits;
deba@433
  1057
deba@433
  1058
    typedef CountBiEdgeConnectedComponentsVisitor<Graph> Visitor;
deba@433
  1059
deba@433
  1060
    int compNum = 0;
deba@433
  1061
    Visitor visitor(graph, compNum);
deba@433
  1062
deba@433
  1063
    DfsVisit<Graph, Visitor> dfs(graph, visitor);
deba@433
  1064
    dfs.init();
deba@433
  1065
deba@433
  1066
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
  1067
      if (!dfs.reached(it)) {
deba@433
  1068
        dfs.addSource(it);
deba@433
  1069
        dfs.start();
deba@433
  1070
      }
deba@433
  1071
    }
deba@433
  1072
    return compNum;
deba@433
  1073
  }
deba@433
  1074
deba@433
  1075
  /// \ingroup connectivity
deba@433
  1076
  ///
deba@433
  1077
  /// \brief Find the bi-edge-connected components.
deba@433
  1078
  ///
deba@433
  1079
  /// This function finds the bi-edge-connected components in an undirected
deba@433
  1080
  /// graph. The bi-edge-connected components are the classes of an equivalence
deba@433
  1081
  /// relation on the nodes. Two nodes are in relationship when they are
deba@433
  1082
  /// connected at least two edge-disjoint paths.
deba@433
  1083
  ///
deba@433
  1084
  /// \param graph The graph.
deba@433
  1085
  /// \retval compMap A writable node map. The values will be set from 0 to
deba@433
  1086
  /// the number of the biconnected components minus one. Each values
deba@433
  1087
  /// of the map will be set exactly once, the values of a certain component
deba@433
  1088
  /// will be set continuously.
deba@433
  1089
  /// \return The number of components.
deba@433
  1090
  ///
deba@433
  1091
  template <typename Graph, typename NodeMap>
deba@433
  1092
  int biEdgeConnectedComponents(const Graph& graph, NodeMap& compMap) {
deba@433
  1093
    checkConcept<concepts::Graph, Graph>();
deba@433
  1094
    typedef typename Graph::NodeIt NodeIt;
deba@433
  1095
    typedef typename Graph::Node Node;
deba@433
  1096
    checkConcept<concepts::WriteMap<Node, int>, NodeMap>();
deba@433
  1097
deba@433
  1098
    using namespace _topology_bits;
deba@433
  1099
deba@433
  1100
    typedef BiEdgeConnectedComponentsVisitor<Graph, NodeMap> Visitor;
deba@433
  1101
deba@433
  1102
    int compNum = 0;
deba@433
  1103
    Visitor visitor(graph, compMap, compNum);
deba@433
  1104
deba@433
  1105
    DfsVisit<Graph, Visitor> dfs(graph, visitor);
deba@433
  1106
    dfs.init();
deba@433
  1107
deba@433
  1108
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
  1109
      if (!dfs.reached(it)) {
deba@433
  1110
        dfs.addSource(it);
deba@433
  1111
        dfs.start();
deba@433
  1112
      }
deba@433
  1113
    }
deba@433
  1114
    return compNum;
deba@433
  1115
  }
deba@433
  1116
deba@433
  1117
  /// \ingroup connectivity
deba@433
  1118
  ///
deba@433
  1119
  /// \brief Find the bi-edge-connected cut edges.
deba@433
  1120
  ///
deba@433
  1121
  /// This function finds the bi-edge-connected components in an undirected
deba@433
  1122
  /// graph. The bi-edge-connected components are the classes of an equivalence
deba@433
  1123
  /// relation on the nodes. Two nodes are in relationship when they are
deba@433
  1124
  /// connected with at least two edge-disjoint paths. The bi-edge-connected
deba@433
  1125
  /// components are separted by edges which are the cut edges of the
deba@433
  1126
  /// components.
deba@433
  1127
  ///
deba@433
  1128
  /// \param graph The graph.
deba@433
  1129
  /// \retval cutMap A writable node map. The values will be set true when the
deba@433
  1130
  /// edge is a cut edge.
deba@433
  1131
  /// \return The number of cut edges.
deba@433
  1132
  template <typename Graph, typename EdgeMap>
deba@433
  1133
  int biEdgeConnectedCutEdges(const Graph& graph, EdgeMap& cutMap) {
deba@433
  1134
    checkConcept<concepts::Graph, Graph>();
deba@433
  1135
    typedef typename Graph::NodeIt NodeIt;
deba@433
  1136
    typedef typename Graph::Edge Edge;
deba@433
  1137
    checkConcept<concepts::WriteMap<Edge, bool>, EdgeMap>();
deba@433
  1138
deba@433
  1139
    using namespace _topology_bits;
deba@433
  1140
deba@433
  1141
    typedef BiEdgeConnectedCutEdgesVisitor<Graph, EdgeMap> Visitor;
deba@433
  1142
deba@433
  1143
    int cutNum = 0;
deba@433
  1144
    Visitor visitor(graph, cutMap, cutNum);
deba@433
  1145
deba@433
  1146
    DfsVisit<Graph, Visitor> dfs(graph, visitor);
deba@433
  1147
    dfs.init();
deba@433
  1148
deba@433
  1149
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
  1150
      if (!dfs.reached(it)) {
deba@433
  1151
        dfs.addSource(it);
deba@433
  1152
        dfs.start();
deba@433
  1153
      }
deba@433
  1154
    }
deba@433
  1155
    return cutNum;
deba@433
  1156
  }
deba@433
  1157
deba@433
  1158
deba@433
  1159
  namespace _topology_bits {
deba@433
  1160
deba@433
  1161
    template <typename Digraph, typename IntNodeMap>
deba@433
  1162
    class TopologicalSortVisitor : public DfsVisitor<Digraph> {
deba@433
  1163
    public:
deba@433
  1164
      typedef typename Digraph::Node Node;
deba@433
  1165
      typedef typename Digraph::Arc edge;
deba@433
  1166
deba@433
  1167
      TopologicalSortVisitor(IntNodeMap& order, int num)
deba@433
  1168
        : _order(order), _num(num) {}
deba@433
  1169
deba@433
  1170
      void leave(const Node& node) {
deba@433
  1171
        _order.set(node, --_num);
deba@433
  1172
      }
deba@433
  1173
deba@433
  1174
    private:
deba@433
  1175
      IntNodeMap& _order;
deba@433
  1176
      int _num;
deba@433
  1177
    };
deba@433
  1178
deba@433
  1179
  }
deba@433
  1180
deba@433
  1181
  /// \ingroup connectivity
deba@433
  1182
  ///
deba@433
  1183
  /// \brief Sort the nodes of a DAG into topolgical order.
deba@433
  1184
  ///
deba@433
  1185
  /// Sort the nodes of a DAG into topolgical order.
deba@433
  1186
  ///
deba@433
  1187
  /// \param graph The graph. It must be directed and acyclic.
deba@433
  1188
  /// \retval order A writable node map. The values will be set from 0 to
deba@433
  1189
  /// the number of the nodes in the graph minus one. Each values of the map
deba@433
  1190
  /// will be set exactly once, the values  will be set descending order.
deba@433
  1191
  ///
deba@433
  1192
  /// \see checkedTopologicalSort
deba@433
  1193
  /// \see dag
deba@433
  1194
  template <typename Digraph, typename NodeMap>
deba@433
  1195
  void topologicalSort(const Digraph& graph, NodeMap& order) {
deba@433
  1196
    using namespace _topology_bits;
deba@433
  1197
deba@433
  1198
    checkConcept<concepts::Digraph, Digraph>();
deba@433
  1199
    checkConcept<concepts::WriteMap<typename Digraph::Node, int>, NodeMap>();
deba@433
  1200
deba@433
  1201
    typedef typename Digraph::Node Node;
deba@433
  1202
    typedef typename Digraph::NodeIt NodeIt;
deba@433
  1203
    typedef typename Digraph::Arc Arc;
deba@433
  1204
deba@433
  1205
    TopologicalSortVisitor<Digraph, NodeMap>
deba@433
  1206
      visitor(order, countNodes(graph));
deba@433
  1207
deba@433
  1208
    DfsVisit<Digraph, TopologicalSortVisitor<Digraph, NodeMap> >
deba@433
  1209
      dfs(graph, visitor);
deba@433
  1210
deba@433
  1211
    dfs.init();
deba@433
  1212
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
  1213
      if (!dfs.reached(it)) {
deba@433
  1214
        dfs.addSource(it);
deba@433
  1215
        dfs.start();
deba@433
  1216
      }
deba@433
  1217
    }
deba@433
  1218
  }
deba@433
  1219
deba@433
  1220
  /// \ingroup connectivity
deba@433
  1221
  ///
deba@433
  1222
  /// \brief Sort the nodes of a DAG into topolgical order.
deba@433
  1223
  ///
deba@433
  1224
  /// Sort the nodes of a DAG into topolgical order. It also checks
deba@433
  1225
  /// that the given graph is DAG.
deba@433
  1226
  ///
deba@433
  1227
  /// \param graph The graph. It must be directed and acyclic.
deba@433
  1228
  /// \retval order A readable - writable node map. The values will be set
deba@433
  1229
  /// from 0 to the number of the nodes in the graph minus one. Each values
deba@433
  1230
  /// of the map will be set exactly once, the values will be set descending
deba@433
  1231
  /// order.
deba@433
  1232
  /// \return %False when the graph is not DAG.
deba@433
  1233
  ///
deba@433
  1234
  /// \see topologicalSort
deba@433
  1235
  /// \see dag
deba@433
  1236
  template <typename Digraph, typename NodeMap>
deba@433
  1237
  bool checkedTopologicalSort(const Digraph& graph, NodeMap& order) {
deba@433
  1238
    using namespace _topology_bits;
deba@433
  1239
deba@433
  1240
    checkConcept<concepts::Digraph, Digraph>();
deba@433
  1241
    checkConcept<concepts::ReadWriteMap<typename Digraph::Node, int>,
deba@433
  1242
      NodeMap>();
deba@433
  1243
deba@433
  1244
    typedef typename Digraph::Node Node;
deba@433
  1245
    typedef typename Digraph::NodeIt NodeIt;
deba@433
  1246
    typedef typename Digraph::Arc Arc;
deba@433
  1247
deba@433
  1248
    order = constMap<Node, int, -1>();
deba@433
  1249
deba@433
  1250
    TopologicalSortVisitor<Digraph, NodeMap>
deba@433
  1251
      visitor(order, countNodes(graph));
deba@433
  1252
deba@433
  1253
    DfsVisit<Digraph, TopologicalSortVisitor<Digraph, NodeMap> >
deba@433
  1254
      dfs(graph, visitor);
deba@433
  1255
deba@433
  1256
    dfs.init();
deba@433
  1257
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
  1258
      if (!dfs.reached(it)) {
deba@433
  1259
        dfs.addSource(it);
deba@433
  1260
        while (!dfs.emptyQueue()) {
deba@433
  1261
           Arc edge = dfs.nextArc();
deba@433
  1262
           Node target = graph.target(edge);
deba@433
  1263
           if (dfs.reached(target) && order[target] == -1) {
deba@433
  1264
             return false;
deba@433
  1265
           }
deba@433
  1266
           dfs.processNextArc();
deba@433
  1267
         }
deba@433
  1268
      }
deba@433
  1269
    }
deba@433
  1270
    return true;
deba@433
  1271
  }
deba@433
  1272
deba@433
  1273
  /// \ingroup connectivity
deba@433
  1274
  ///
deba@433
  1275
  /// \brief Check that the given directed graph is a DAG.
deba@433
  1276
  ///
deba@433
  1277
  /// Check that the given directed graph is a DAG. The DAG is
deba@433
  1278
  /// an Directed Acyclic Digraph.
deba@433
  1279
  /// \return %False when the graph is not DAG.
deba@433
  1280
  /// \see acyclic
deba@433
  1281
  template <typename Digraph>
deba@433
  1282
  bool dag(const Digraph& graph) {
deba@433
  1283
deba@433
  1284
    checkConcept<concepts::Digraph, Digraph>();
deba@433
  1285
deba@433
  1286
    typedef typename Digraph::Node Node;
deba@433
  1287
    typedef typename Digraph::NodeIt NodeIt;
deba@433
  1288
    typedef typename Digraph::Arc Arc;
deba@433
  1289
deba@433
  1290
    typedef typename Digraph::template NodeMap<bool> ProcessedMap;
deba@433
  1291
deba@433
  1292
    typename Dfs<Digraph>::template SetProcessedMap<ProcessedMap>::
deba@433
  1293
      Create dfs(graph);
deba@433
  1294
deba@433
  1295
    ProcessedMap processed(graph);
deba@433
  1296
    dfs.processedMap(processed);
deba@433
  1297
deba@433
  1298
    dfs.init();
deba@433
  1299
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
  1300
      if (!dfs.reached(it)) {
deba@433
  1301
        dfs.addSource(it);
deba@433
  1302
        while (!dfs.emptyQueue()) {
deba@433
  1303
          Arc edge = dfs.nextArc();
deba@433
  1304
          Node target = graph.target(edge);
deba@433
  1305
          if (dfs.reached(target) && !processed[target]) {
deba@433
  1306
            return false;
deba@433
  1307
          }
deba@433
  1308
          dfs.processNextArc();
deba@433
  1309
        }
deba@433
  1310
      }
deba@433
  1311
    }
deba@433
  1312
    return true;
deba@433
  1313
  }
deba@433
  1314
deba@433
  1315
  /// \ingroup connectivity
deba@433
  1316
  ///
deba@433
  1317
  /// \brief Check that the given undirected graph is acyclic.
deba@433
  1318
  ///
deba@433
  1319
  /// Check that the given undirected graph acyclic.
deba@433
  1320
  /// \param graph The undirected graph.
deba@433
  1321
  /// \return %True when there is no circle in the graph.
deba@433
  1322
  /// \see dag
deba@433
  1323
  template <typename Graph>
deba@433
  1324
  bool acyclic(const Graph& graph) {
deba@433
  1325
    checkConcept<concepts::Graph, Graph>();
deba@433
  1326
    typedef typename Graph::Node Node;
deba@433
  1327
    typedef typename Graph::NodeIt NodeIt;
deba@433
  1328
    typedef typename Graph::Arc Arc;
deba@433
  1329
    Dfs<Graph> dfs(graph);
deba@433
  1330
    dfs.init();
deba@433
  1331
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
  1332
      if (!dfs.reached(it)) {
deba@433
  1333
        dfs.addSource(it);
deba@433
  1334
        while (!dfs.emptyQueue()) {
deba@433
  1335
          Arc edge = dfs.nextArc();
deba@433
  1336
          Node source = graph.source(edge);
deba@433
  1337
          Node target = graph.target(edge);
deba@433
  1338
          if (dfs.reached(target) &&
deba@433
  1339
              dfs.predArc(source) != graph.oppositeArc(edge)) {
deba@433
  1340
            return false;
deba@433
  1341
          }
deba@433
  1342
          dfs.processNextArc();
deba@433
  1343
        }
deba@433
  1344
      }
deba@433
  1345
    }
deba@433
  1346
    return true;
deba@433
  1347
  }
deba@433
  1348
deba@433
  1349
  /// \ingroup connectivity
deba@433
  1350
  ///
deba@433
  1351
  /// \brief Check that the given undirected graph is tree.
deba@433
  1352
  ///
deba@433
  1353
  /// Check that the given undirected graph is tree.
deba@433
  1354
  /// \param graph The undirected graph.
deba@433
  1355
  /// \return %True when the graph is acyclic and connected.
deba@433
  1356
  template <typename Graph>
deba@433
  1357
  bool tree(const Graph& graph) {
deba@433
  1358
    checkConcept<concepts::Graph, Graph>();
deba@433
  1359
    typedef typename Graph::Node Node;
deba@433
  1360
    typedef typename Graph::NodeIt NodeIt;
deba@433
  1361
    typedef typename Graph::Arc Arc;
deba@433
  1362
    Dfs<Graph> dfs(graph);
deba@433
  1363
    dfs.init();
deba@433
  1364
    dfs.addSource(NodeIt(graph));
deba@433
  1365
    while (!dfs.emptyQueue()) {
deba@433
  1366
      Arc edge = dfs.nextArc();
deba@433
  1367
      Node source = graph.source(edge);
deba@433
  1368
      Node target = graph.target(edge);
deba@433
  1369
      if (dfs.reached(target) &&
deba@433
  1370
          dfs.predArc(source) != graph.oppositeArc(edge)) {
deba@433
  1371
        return false;
deba@433
  1372
      }
deba@433
  1373
      dfs.processNextArc();
deba@433
  1374
    }
deba@433
  1375
    for (NodeIt it(graph); it != INVALID; ++it) {
deba@433
  1376
      if (!dfs.reached(it)) {
deba@433
  1377
        return false;
deba@433
  1378
      }
deba@433
  1379
    }
deba@433
  1380
    return true;
deba@433
  1381
  }
deba@433
  1382
deba@433
  1383
  namespace _topology_bits {
deba@433
  1384
deba@433
  1385
    template <typename Digraph>
deba@433
  1386
    class BipartiteVisitor : public BfsVisitor<Digraph> {
deba@433
  1387
    public:
deba@433
  1388
      typedef typename Digraph::Arc Arc;
deba@433
  1389
      typedef typename Digraph::Node Node;
deba@433
  1390
deba@433
  1391
      BipartiteVisitor(const Digraph& graph, bool& bipartite)
deba@433
  1392
        : _graph(graph), _part(graph), _bipartite(bipartite) {}
deba@433
  1393
deba@433
  1394
      void start(const Node& node) {
deba@433
  1395
        _part[node] = true;
deba@433
  1396
      }
deba@433
  1397
      void discover(const Arc& edge) {
deba@433
  1398
        _part.set(_graph.target(edge), !_part[_graph.source(edge)]);
deba@433
  1399
      }
deba@433
  1400
      void examine(const Arc& edge) {
deba@433
  1401
        _bipartite = _bipartite &&
deba@433
  1402
          _part[_graph.target(edge)] != _part[_graph.source(edge)];
deba@433
  1403
      }
deba@433
  1404
deba@433
  1405
    private:
deba@433
  1406
deba@433
  1407
      const Digraph& _graph;
deba@433
  1408
      typename Digraph::template NodeMap<bool> _part;
deba@433
  1409
      bool& _bipartite;
deba@433
  1410
    };
deba@433
  1411
deba@433
  1412
    template <typename Digraph, typename PartMap>
deba@433
  1413
    class BipartitePartitionsVisitor : public BfsVisitor<Digraph> {
deba@433
  1414
    public:
deba@433
  1415
      typedef typename Digraph::Arc Arc;
deba@433
  1416
      typedef typename Digraph::Node Node;
deba@433
  1417
deba@433
  1418
      BipartitePartitionsVisitor(const Digraph& graph,
deba@433
  1419
                                 PartMap& part, bool& bipartite)
deba@433
  1420
        : _graph(graph), _part(part), _bipartite(bipartite) {}
deba@433
  1421
deba@433
  1422
      void start(const Node& node) {
deba@433
  1423
        _part.set(node, true);
deba@433
  1424
      }
deba@433
  1425
      void discover(const Arc& edge) {
deba@433
  1426
        _part.set(_graph.target(edge), !_part[_graph.source(edge)]);
deba@433
  1427
      }
deba@433
  1428
      void examine(const Arc& edge) {
deba@433
  1429
        _bipartite = _bipartite &&
deba@433
  1430
          _part[_graph.target(edge)] != _part[_graph.source(edge)];
deba@433
  1431
      }
deba@433
  1432
deba@433
  1433
    private:
deba@433
  1434
deba@433
  1435
      const Digraph& _graph;
deba@433
  1436
      PartMap& _part;
deba@433
  1437
      bool& _bipartite;
deba@433
  1438
    };
deba@433
  1439
  }
deba@433
  1440
deba@433
  1441
  /// \ingroup connectivity
deba@433
  1442
  ///
deba@433
  1443
  /// \brief Check if the given undirected graph is bipartite or not
deba@433
  1444
  ///
deba@433
  1445
  /// The function checks if the given undirected \c graph graph is bipartite
deba@433
  1446
  /// or not. The \ref Bfs algorithm is used to calculate the result.
deba@433
  1447
  /// \param graph The undirected graph.
deba@433
  1448
  /// \return %True if \c graph is bipartite, %false otherwise.
deba@433
  1449
  /// \sa bipartitePartitions
deba@433
  1450
  template<typename Graph>
deba@433
  1451
  inline bool bipartite(const Graph &graph){
deba@433
  1452
    using namespace _topology_bits;
deba@433
  1453
deba@433
  1454
    checkConcept<concepts::Graph, Graph>();
deba@433
  1455
deba@433
  1456
    typedef typename Graph::NodeIt NodeIt;
deba@433
  1457
    typedef typename Graph::ArcIt ArcIt;
deba@433
  1458
deba@433
  1459
    bool bipartite = true;
deba@433
  1460
deba@433
  1461
    BipartiteVisitor<Graph>
deba@433
  1462
      visitor(graph, bipartite);
deba@433
  1463
    BfsVisit<Graph, BipartiteVisitor<Graph> >
deba@433
  1464
      bfs(graph, visitor);
deba@433
  1465
    bfs.init();
deba@433
  1466
    for(NodeIt it(graph); it != INVALID; ++it) {
deba@433
  1467
      if(!bfs.reached(it)){
deba@433
  1468
        bfs.addSource(it);
deba@433
  1469
        while (!bfs.emptyQueue()) {
deba@433
  1470
          bfs.processNextNode();
deba@433
  1471
          if (!bipartite) return false;
deba@433
  1472
        }
deba@433
  1473
      }
deba@433
  1474
    }
deba@433
  1475
    return true;
deba@433
  1476
  }
deba@433
  1477
deba@433
  1478
  /// \ingroup connectivity
deba@433
  1479
  ///
deba@433
  1480
  /// \brief Check if the given undirected graph is bipartite or not
deba@433
  1481
  ///
deba@433
  1482
  /// The function checks if the given undirected graph is bipartite
deba@433
  1483
  /// or not. The  \ref  Bfs  algorithm  is   used  to  calculate the result.
deba@433
  1484
  /// During the execution, the \c partMap will be set as the two
deba@433
  1485
  /// partitions of the graph.
deba@433
  1486
  /// \param graph The undirected graph.
deba@433
  1487
  /// \retval partMap A writable bool map of nodes. It will be set as the
deba@433
  1488
  /// two partitions of the graph.
deba@433
  1489
  /// \return %True if \c graph is bipartite, %false otherwise.
deba@433
  1490
  template<typename Graph, typename NodeMap>
deba@433
  1491
  inline bool bipartitePartitions(const Graph &graph, NodeMap &partMap){
deba@433
  1492
    using namespace _topology_bits;
deba@433
  1493
deba@433
  1494
    checkConcept<concepts::Graph, Graph>();
deba@433
  1495
deba@433
  1496
    typedef typename Graph::Node Node;
deba@433
  1497
    typedef typename Graph::NodeIt NodeIt;
deba@433
  1498
    typedef typename Graph::ArcIt ArcIt;
deba@433
  1499
deba@433
  1500
    bool bipartite = true;
deba@433
  1501
deba@433
  1502
    BipartitePartitionsVisitor<Graph, NodeMap>
deba@433
  1503
      visitor(graph, partMap, bipartite);
deba@433
  1504
    BfsVisit<Graph, BipartitePartitionsVisitor<Graph, NodeMap> >
deba@433
  1505
      bfs(graph, visitor);
deba@433
  1506
    bfs.init();
deba@433
  1507
    for(NodeIt it(graph); it != INVALID; ++it) {
deba@433
  1508
      if(!bfs.reached(it)){
deba@433
  1509
        bfs.addSource(it);
deba@433
  1510
        while (!bfs.emptyQueue()) {
deba@433
  1511
          bfs.processNextNode();
deba@433
  1512
          if (!bipartite) return false;
deba@433
  1513
        }
deba@433
  1514
      }
deba@433
  1515
    }
deba@433
  1516
    return true;
deba@433
  1517
  }
deba@433
  1518
deba@433
  1519
  /// \brief Returns true when there are not loop edges in the graph.
deba@433
  1520
  ///
deba@433
  1521
  /// Returns true when there are not loop edges in the graph.
deba@433
  1522
  template <typename Digraph>
deba@433
  1523
  bool loopFree(const Digraph& graph) {
deba@433
  1524
    for (typename Digraph::ArcIt it(graph); it != INVALID; ++it) {
deba@433
  1525
      if (graph.source(it) == graph.target(it)) return false;
deba@433
  1526
    }
deba@433
  1527
    return true;
deba@433
  1528
  }
deba@433
  1529
deba@433
  1530
  /// \brief Returns true when there are not parallel edges in the graph.
deba@433
  1531
  ///
deba@433
  1532
  /// Returns true when there are not parallel edges in the graph.
deba@433
  1533
  template <typename Digraph>
deba@433
  1534
  bool parallelFree(const Digraph& graph) {
deba@433
  1535
    typename Digraph::template NodeMap<bool> reached(graph, false);
deba@433
  1536
    for (typename Digraph::NodeIt n(graph); n != INVALID; ++n) {
deba@433
  1537
      for (typename Digraph::OutArcIt e(graph, n); e != INVALID; ++e) {
deba@433
  1538
        if (reached[graph.target(e)]) return false;
deba@433
  1539
        reached.set(graph.target(e), true);
deba@433
  1540
      }
deba@433
  1541
      for (typename Digraph::OutArcIt e(graph, n); e != INVALID; ++e) {
deba@433
  1542
        reached.set(graph.target(e), false);
deba@433
  1543
      }
deba@433
  1544
    }
deba@433
  1545
    return true;
deba@433
  1546
  }
deba@433
  1547
deba@433
  1548
  /// \brief Returns true when there are not loop edges and parallel
deba@433
  1549
  /// edges in the graph.
deba@433
  1550
  ///
deba@433
  1551
  /// Returns true when there are not loop edges and parallel edges in
deba@433
  1552
  /// the graph.
deba@433
  1553
  template <typename Digraph>
deba@433
  1554
  bool simpleDigraph(const Digraph& graph) {
deba@433
  1555
    typename Digraph::template NodeMap<bool> reached(graph, false);
deba@433
  1556
    for (typename Digraph::NodeIt n(graph); n != INVALID; ++n) {
deba@433
  1557
      reached.set(n, true);
deba@433
  1558
      for (typename Digraph::OutArcIt e(graph, n); e != INVALID; ++e) {
deba@433
  1559
        if (reached[graph.target(e)]) return false;
deba@433
  1560
        reached.set(graph.target(e), true);
deba@433
  1561
      }
deba@433
  1562
      for (typename Digraph::OutArcIt e(graph, n); e != INVALID; ++e) {
deba@433
  1563
        reached.set(graph.target(e), false);
deba@433
  1564
      }
deba@433
  1565
      reached.set(n, false);
deba@433
  1566
    }
deba@433
  1567
    return true;
deba@433
  1568
  }
deba@433
  1569
deba@433
  1570
} //namespace lemon
deba@433
  1571
deba@433
  1572
#endif //LEMON_TOPOLOGY_H