src/work/johanna/kruskal.h
author alpar
Wed, 04 Aug 2004 19:04:42 +0000
changeset 755 a8c2e828ce0b
parent 737 2d867176d10e
child 758 49b1a30c4dc4
permissions -rw-r--r--
- 'KruskalPairVec' is changed to 'KruskalMapInput'.
- Changes in KruskalMapVec. Still does not work.
beckerjc@150
     1
// -*- c++ -*- //
beckerjc@150
     2
#ifndef HUGO_KRUSKAL_H
beckerjc@150
     3
#define HUGO_KRUSKAL_H
beckerjc@150
     4
beckerjc@150
     5
#include <algorithm>
alpar@737
     6
#include <hugo/unionfind.h>
beckerjc@150
     7
alpar@682
     8
///\file
alpar@682
     9
///\brief Kruskal's algorithm to compute a minimum cost tree
alpar@682
    10
beckerjc@150
    11
namespace hugo {
beckerjc@150
    12
alpar@737
    13
  /// Kruskal's algorithm to find a minimum cost tree of a graph.
alpar@737
    14
alpar@737
    15
  /// This function runs Kruskal's algorithm to find a minimum cost tree.
alpar@737
    16
  /// \param G The graph the algorithm runs on.
alpar@737
    17
  /// \param in This object is used to describe the edge costs. It must
alpar@737
    18
  /// be an STL 'forward container'
alpar@737
    19
  /// with value_type <tt> std::pair<Graph::Edge,X> </tt>,
alpar@737
    20
  /// where X is the type of the costs. It must contain every edge in
alpar@737
    21
  /// cost-ascending order.
alpar@737
    22
  /// \retval out This must be a writeable EdgeMap. After running the algorithm
alpar@737
    23
  /// this will contain the found minimum cost spanning tree: the value of an
alpar@737
    24
  /// edge will be set to \c true if it belongs to the tree, otherwise it will
alpar@737
    25
  /// be set to \c false. The value of each edge will be set exactly once.\n
alpar@737
    26
  /// For the sake of simplicity, there is a helper class KruskalPairVec,
alpar@737
    27
  /// which converts a
alpar@737
    28
  /// simple EdgeMap to an input of this form. Alternatively, you can use
alpar@737
    29
  /// the function \ref kruskalEdgeMap to compute the minimum cost tree if
alpar@737
    30
  /// the edge costs are given by an EdgeMap.
alpar@737
    31
  /// \return The cost of the found tree.
beckerjc@150
    32
beckerjc@349
    33
  template <typename Graph, typename InputEdgeOrder, typename OutBoolMap>
alpar@737
    34
  typename InputEdgeOrder::value_type::second_type
alpar@737
    35
  kruskal(Graph const& G, InputEdgeOrder const& in, 
alpar@737
    36
		 OutBoolMap& out)
beckerjc@349
    37
  {
alpar@737
    38
    typedef typename InputEdgeOrder::value_type::second_type EdgeCost;
alpar@737
    39
    typedef typename Graph::template NodeMap<int> NodeIntMap;
beckerjc@349
    40
    typedef typename Graph::Node Node;
beckerjc@246
    41
alpar@737
    42
    NodeIntMap comp(G, -1);
alpar@737
    43
    UnionFind<Node,NodeIntMap> uf(comp); 
beckerjc@349
    44
      
beckerjc@349
    45
    EdgeCost tot_cost = 0;
alpar@737
    46
    for (typename InputEdgeOrder::const_iterator p = in.begin(); 
alpar@737
    47
	 p!=in.end(); ++p ) {
alpar@737
    48
      if ( uf.join(G.head((*p).first),
alpar@737
    49
		   G.tail((*p).first)) ) {
alpar@737
    50
	out.set((*p).first, true);
alpar@737
    51
	tot_cost += (*p).second;
beckerjc@349
    52
      }
beckerjc@349
    53
      else {
alpar@737
    54
	out.set((*p).first, false);
beckerjc@349
    55
      }
beckerjc@349
    56
    }
beckerjc@349
    57
    return tot_cost;
beckerjc@349
    58
  }
beckerjc@246
    59
beckerjc@352
    60
  /* A work-around for running Kruskal with const-reference bool maps... */
beckerjc@352
    61
beckerjc@352
    62
  template<typename Map>
beckerjc@352
    63
  class NonConstMapWr {
beckerjc@352
    64
    const Map &m;
beckerjc@352
    65
  public:
beckerjc@352
    66
    typedef typename Map::ValueType ValueType;
beckerjc@352
    67
beckerjc@352
    68
    NonConstMapWr(const Map &_m) : m(_m) {}
beckerjc@352
    69
beckerjc@352
    70
    template<typename KeyType>
beckerjc@352
    71
    void set(KeyType const& k, ValueType const &v) const { m.set(k,v); }
beckerjc@352
    72
  };
beckerjc@352
    73
beckerjc@352
    74
  template <typename Graph, typename InputEdgeOrder, typename OutBoolMap>
beckerjc@352
    75
  inline
beckerjc@352
    76
  typename InputEdgeOrder::ValueType
alpar@737
    77
  kruskal(Graph const& G, InputEdgeOrder const& edges, 
beckerjc@352
    78
	  OutBoolMap const& out_map)
beckerjc@352
    79
  {
beckerjc@352
    80
    NonConstMapWr<OutBoolMap> map_wr(out_map);
alpar@737
    81
    return kruskal(G, edges, map_wr);
beckerjc@352
    82
  }  
beckerjc@246
    83
beckerjc@349
    84
  
beckerjc@349
    85
  /* ** ** Output-objektumok: egyszeruen extra bool mapek ** ** */
beckerjc@349
    86
  
beckerjc@349
    87
  /// A writable bool-map that makes a sequence of "true" keys
beckerjc@246
    88
alpar@737
    89
  /// A writable bool-map that creates a sequence out of keys that receives
beckerjc@349
    90
  /// the value "true".
beckerjc@349
    91
  /// \warning Not a regular property map, as it doesn't know its KeyType
beckerjc@246
    92
beckerjc@349
    93
  template<typename Iterator>
beckerjc@349
    94
  class SequenceOutput {
beckerjc@352
    95
    mutable Iterator it;
beckerjc@150
    96
beckerjc@218
    97
  public:
beckerjc@349
    98
    typedef bool ValueType;
beckerjc@150
    99
beckerjc@349
   100
    SequenceOutput(Iterator const &_it) : it(_it) {}
beckerjc@150
   101
beckerjc@349
   102
    template<typename KeyType>
beckerjc@352
   103
    void set(KeyType const& k, bool v) const { if(v) {*it=k; ++it;} }
beckerjc@218
   104
  };
beckerjc@150
   105
beckerjc@349
   106
  template<typename Iterator>
beckerjc@349
   107
  inline
beckerjc@349
   108
  SequenceOutput<Iterator>
beckerjc@349
   109
  makeSequenceOutput(Iterator it) {
beckerjc@349
   110
    return SequenceOutput<Iterator>(it);
beckerjc@349
   111
  }
beckerjc@246
   112
beckerjc@246
   113
  /* ** ** InputSource -ok ** ** */
beckerjc@246
   114
alpar@737
   115
  /// Kruskal input source.
beckerjc@246
   116
alpar@737
   117
  /// Kruskal input source.
alpar@737
   118
  ///
alpar@737
   119
  template<typename Graph, typename Map>
alpar@755
   120
  class KruskalMapInput
alpar@737
   121
    : public std::vector< std::pair<typename Graph::Edge,
alpar@737
   122
				    typename Map::ValueType> > {
alpar@737
   123
    
beckerjc@246
   124
  public:
alpar@737
   125
    typedef std::vector< std::pair<typename Graph::Edge,
alpar@737
   126
				   typename Map::ValueType> > Parent;
alpar@737
   127
    typedef typename Parent::value_type value_type;
alpar@737
   128
//     typedef Key KeyType;
alpar@737
   129
//     typedef Val ValueType;
alpar@737
   130
//     typedef std::pair<Key,Val> PairType;
alpar@737
   131
//     typedef typename Parent::iterator iterator;
alpar@737
   132
//     typedef typename Parent::const_iterator const_iterator;
beckerjc@246
   133
beckerjc@246
   134
  private:
beckerjc@246
   135
    class comparePair {
beckerjc@246
   136
    public:
alpar@737
   137
      bool operator()(const value_type& a,
alpar@737
   138
		      const value_type& b) {
beckerjc@246
   139
	return a.second < b.second;
beckerjc@246
   140
      }
beckerjc@246
   141
    };
beckerjc@246
   142
beckerjc@246
   143
  public:
beckerjc@246
   144
beckerjc@246
   145
    // FIXME: kell ez?
alpar@755
   146
    // KruskalMapInput(Parent const& p) : Parent(p) {}
beckerjc@246
   147
    
beckerjc@246
   148
    void sort() {
alpar@737
   149
      std::sort(this->begin(), this->end(), comparePair());
beckerjc@246
   150
    }
beckerjc@246
   151
beckerjc@246
   152
    // FIXME: nem nagyon illik ez ide...
alpar@755
   153
    KruskalMapInput(Graph const& G, Map const& m) {
beckerjc@246
   154
      typedef typename Graph::EdgeIt EdgeIt;
alpar@737
   155
      
alpar@737
   156
      this->clear();
alpar@737
   157
      for(EdgeIt e(G);G.valid(e);G.next(e)) {
alpar@737
   158
	// for (EdgeIt e=G.template first<EdgeIt>(); G.valid(e); G.next(e)) {
beckerjc@246
   159
	push_back(make_pair(e, m[e]));
beckerjc@246
   160
      }
beckerjc@246
   161
      sort();
beckerjc@246
   162
    }
beckerjc@246
   163
alpar@737
   164
//     Key const& first(const_iterator i) const { return i->first; }
alpar@737
   165
//     Key& first(iterator i) { return i->first; }
beckerjc@246
   166
alpar@737
   167
//     Val const& second(const_iterator i) const { return i->second; }
alpar@737
   168
//     Val& second(iterator i) { return i->second; }
beckerjc@246
   169
  };
beckerjc@246
   170
beckerjc@349
   171
alpar@755
   172
//   template<typename Graph, typename Map>
alpar@755
   173
//   class KruskalMapVec {
alpar@737
   174
//   public:
alpar@737
   175
    
alpar@755
   176
//     typedef std::pair<typename Map::KeyType, Map::ValueType> value_type;
alpar@755
   177
    
alpar@755
   178
//     typedef std::vector<KeyType> Container;
alpar@755
   179
//     Container container;
alpar@755
   180
//     std::vector<typename Map::KeyType> container
alpar@755
   181
//     const Map &m;
alpar@755
   182
    
alpar@755
   183
    
alpar@755
   184
//     class iterator
alpar@755
   185
//     {
alpar@755
   186
//       Container::iterator i;
alpar@755
   187
//     public:
alpar@755
   188
//       iterator &operator ++() {++i;return *this;}
alpar@755
   189
//       valuetype operator *() {return value_type(container(i),m[container(i)]);}
alpar@755
   190
//       bool operator==(iterator b) {return i==b.i;}
alpar@755
   191
//       iterator() {}
alpar@755
   192
//       iterator(Container::iterator _i) i(_i) {}
alpar@755
   193
//     };
alpar@755
   194
//     class const_iterator
alpar@755
   195
//     {
alpar@755
   196
//       Container::const_iterator i;
alpar@755
   197
//     public:
alpar@755
   198
//       iterator &operator ++() {++i;return *this;}
alpar@755
   199
//       valuetype operator *() {return value_type(container(i),m[container(i)]);}
alpar@755
   200
//       bool operator==(iterator b) {return i==b.i;}
alpar@755
   201
//       const_iterator() {}
alpar@755
   202
//       const_iterator(Container::iterator _i) i(_i) {}
alpar@755
   203
//     };
beckerjc@349
   204
alpar@755
   205
//     iterator begin() { return iterator(container.begin());}
alpar@755
   206
//     const_iterator begin() const { return iterator(container.begin());}
alpar@755
   207
//     iterator end() { return iterator(container.end());}
alpar@755
   208
//     const_iterator end() const { return iterator(container.end());}
alpar@755
   209
    
alpar@737
   210
//   private:
alpar@755
   211
    
alpar@737
   212
//     class compareKeys {
alpar@737
   213
//       const Map &m;
alpar@737
   214
//     public:
alpar@737
   215
//       compareKeys(Map const &_m) : m(_m) {}
alpar@737
   216
//       bool operator()(KeyType const& a, KeyType const& b) {
alpar@737
   217
// 	return m[a] < m[b];
alpar@737
   218
//       }
alpar@737
   219
//     };
beckerjc@349
   220
alpar@737
   221
//   public:
beckerjc@349
   222
alpar@737
   223
//     KruskalMapVec(Map const& _m) : m(_m) {}
beckerjc@349
   224
alpar@737
   225
//     void sort() {
alpar@737
   226
//       std::sort(begin(), end(), compareKeys(m));
alpar@737
   227
//     }
beckerjc@349
   228
alpar@737
   229
//     // FIXME: nem nagyon illik ez ide...
alpar@737
   230
//     template<typename Graph>
alpar@737
   231
//     KruskalMapVec(Graph const& G, Map const& _m) : m(_m) {
alpar@737
   232
//       typedef typename Graph::EdgeIt EdgeIt;
beckerjc@349
   233
alpar@737
   234
//       clear();
alpar@737
   235
//       for(EdgeIt e(G);G.valid(e);G.next(e)) {
alpar@737
   236
//       // for (EdgeIt e=G.template first<EdgeIt>(); G.valid(e); G.next(e)) 
alpar@737
   237
// 	push_back(e);
alpar@737
   238
//       }
alpar@737
   239
//       sort();
alpar@737
   240
//     }
beckerjc@349
   241
alpar@737
   242
//     KeyType const& first(const_iterator i) const { return *i; }
alpar@737
   243
//     KeyType& first(iterator i) { return *i; }
beckerjc@349
   244
alpar@737
   245
//     ValueType const& second(const_iterator i) const { return m[*i]; }
alpar@737
   246
//     ValueType& second(iterator i) { return m[*i]; }
alpar@737
   247
//   };
beckerjc@349
   248
alpar@755
   249
beckerjc@246
   250
  /* ** ** Wrapper fuggvenyek ** ** */
beckerjc@246
   251
beckerjc@349
   252
beckerjc@349
   253
  /// \brief Wrapper to Kruskal().
beckerjc@349
   254
  /// Input is from an EdgeMap, output is a plain boolmap.
alpar@737
   255
alpar@737
   256
  ///\todo some more words would be nice here.
alpar@737
   257
  ///
beckerjc@246
   258
  template <typename Graph, typename EdgeCostMap, typename RetEdgeBoolMap>
beckerjc@352
   259
  inline
beckerjc@246
   260
  typename EdgeCostMap::ValueType
alpar@737
   261
  kruskalEdgeMap(Graph const& G,
alpar@737
   262
			EdgeCostMap const& edge_costs,
alpar@737
   263
			RetEdgeBoolMap &ret_bool_map) {
alpar@737
   264
    
alpar@755
   265
    typedef KruskalMapInput<Graph,EdgeCostMap> InputVec;
alpar@737
   266
    
beckerjc@349
   267
    InputVec iv(G, edge_costs);
alpar@737
   268
    return kruskal(G, iv, ret_bool_map);
beckerjc@246
   269
  }
beckerjc@246
   270
beckerjc@349
   271
beckerjc@349
   272
  /// \brief Wrapper to Kruskal().
beckerjc@349
   273
  /// Input is from an EdgeMap, output is to a sequence.
alpar@737
   274
alpar@737
   275
  ///\todo it does not follow the naming convention.
alpar@737
   276
  ///
beckerjc@246
   277
  template <typename Graph, typename EdgeCostMap, typename RetIterator>
beckerjc@352
   278
  inline
beckerjc@246
   279
  typename EdgeCostMap::ValueType
alpar@737
   280
  kruskalEdgeMap_IteratorOut(const Graph& G,
alpar@737
   281
			     const EdgeCostMap& edge_costs,
alpar@737
   282
			     RetIterator ret_iterator)
alpar@737
   283
  {
alpar@737
   284
    typedef typename EdgeCostMap::ValueType ValueType;
alpar@737
   285
    
beckerjc@349
   286
    typedef SequenceOutput<RetIterator> OutMap;
beckerjc@349
   287
    OutMap out(ret_iterator);
beckerjc@246
   288
alpar@755
   289
    typedef KruskalMapInput<Graph, EdgeCostMap> InputVec;
alpar@737
   290
beckerjc@349
   291
    InputVec iv(G, edge_costs);
beckerjc@246
   292
alpar@737
   293
    return kruskal(G, iv, out);
beckerjc@246
   294
  }
beckerjc@246
   295
beckerjc@150
   296
beckerjc@150
   297
} //namespace hugo
beckerjc@150
   298
beckerjc@150
   299
#endif //HUGO_KRUSKAL_H