lemon/max_matching.h
author Balazs Dezso <deba@inf.elte.hu>
Mon, 13 Oct 2008 14:00:11 +0200
changeset 339 91d63b8b1a4c
parent 338 64ad48007fb2
child 342 5ba887b7def4
permissions -rw-r--r--
Several improvements in maximum matching algorithms
- The interface of MaxMatching is changed to be similar to the
weighted algorithms
- The internal data structure (the queue implementation and the
matching map) is changed in the MaxMatching algorithm, which
provides better runtime properties
- The Blossom iterators are changed slightly in the weighted matching
algorithms
- Several documentation improvments
- The test files are merged
deba@338
     1
/* -*- mode: C++; indent-tabs-mode: nil; -*-
deba@338
     2
 *
deba@338
     3
 * This file is a part of LEMON, a generic C++ optimization library.
deba@338
     4
 *
deba@338
     5
 * Copyright (C) 2003-2008
deba@338
     6
 * Egervary Jeno Kombinatorikus Optimalizalasi Kutatocsoport
deba@338
     7
 * (Egervary Research Group on Combinatorial Optimization, EGRES).
deba@338
     8
 *
deba@338
     9
 * Permission to use, modify and distribute this software is granted
deba@338
    10
 * provided that this copyright notice appears in all copies. For
deba@338
    11
 * precise terms see the accompanying LICENSE file.
deba@338
    12
 *
deba@338
    13
 * This software is provided "AS IS" with no warranty of any kind,
deba@338
    14
 * express or implied, and with no claim as to its suitability for any
deba@338
    15
 * purpose.
deba@338
    16
 *
deba@338
    17
 */
deba@338
    18
deba@338
    19
#ifndef LEMON_MAX_MATCHING_H
deba@338
    20
#define LEMON_MAX_MATCHING_H
deba@338
    21
deba@338
    22
#include <vector>
deba@338
    23
#include <queue>
deba@338
    24
#include <set>
deba@338
    25
#include <limits>
deba@338
    26
deba@338
    27
#include <lemon/core.h>
deba@338
    28
#include <lemon/unionfind.h>
deba@338
    29
#include <lemon/bin_heap.h>
deba@338
    30
#include <lemon/maps.h>
deba@338
    31
deba@338
    32
///\ingroup matching
deba@338
    33
///\file
deba@339
    34
///\brief Maximum matching algorithms in general graphs.
deba@338
    35
deba@338
    36
namespace lemon {
deba@338
    37
deba@339
    38
  /// \ingroup matching
deba@338
    39
  ///
deba@339
    40
  /// \brief Edmonds' alternating forest maximum matching algorithm.
deba@338
    41
  ///
deba@339
    42
  /// This class provides Edmonds' alternating forest matching
deba@339
    43
  /// algorithm. The starting matching (if any) can be passed to the
deba@339
    44
  /// algorithm using some of init functions.
deba@338
    45
  ///
deba@339
    46
  /// The dual side of a matching is a map of the nodes to
deba@339
    47
  /// MaxMatching::Status, having values \c EVEN/D, \c ODD/A and \c
deba@339
    48
  /// MATCHED/C showing the Gallai-Edmonds decomposition of the
deba@339
    49
  /// graph. The nodes in \c EVEN/D induce a graph with
deba@339
    50
  /// factor-critical components, the nodes in \c ODD/A form the
deba@339
    51
  /// barrier, and the nodes in \c MATCHED/C induce a graph having a
deba@339
    52
  /// perfect matching. The number of the fractor critical components
deba@339
    53
  /// minus the number of barrier nodes is a lower bound on the
deba@339
    54
  /// unmatched nodes, and if the matching is optimal this bound is
deba@339
    55
  /// tight. This decomposition can be attained by calling \c
deba@339
    56
  /// decomposition() after running the algorithm.
deba@338
    57
  ///
deba@339
    58
  /// \param _Graph The graph type the algorithm runs on.
deba@339
    59
  template <typename _Graph>
deba@338
    60
  class MaxMatching {
deba@339
    61
  public:
deba@339
    62
deba@339
    63
    typedef _Graph Graph;
deba@339
    64
    typedef typename Graph::template NodeMap<typename Graph::Arc>
deba@339
    65
    MatchingMap;
deba@339
    66
deba@339
    67
    ///\brief Indicates the Gallai-Edmonds decomposition of the graph.
deba@339
    68
    ///
deba@339
    69
    ///Indicates the Gallai-Edmonds decomposition of the graph, which
deba@339
    70
    ///shows an upper bound on the size of a maximum matching. The
deba@339
    71
    ///nodes with Status \c EVEN/D induce a graph with factor-critical
deba@339
    72
    ///components, the nodes in \c ODD/A form the canonical barrier,
deba@339
    73
    ///and the nodes in \c MATCHED/C induce a graph having a perfect
deba@339
    74
    ///matching.
deba@339
    75
    enum Status {
deba@339
    76
      EVEN = 1, D = 1, MATCHED = 0, C = 0, ODD = -1, A = -1, UNMATCHED = -2
deba@339
    77
    };
deba@339
    78
deba@339
    79
    typedef typename Graph::template NodeMap<Status> StatusMap;
deba@339
    80
deba@339
    81
  private:
deba@338
    82
deba@338
    83
    TEMPLATE_GRAPH_TYPEDEFS(Graph);
deba@338
    84
deba@339
    85
    typedef UnionFindEnum<IntNodeMap> BlossomSet;
deba@339
    86
    typedef ExtendFindEnum<IntNodeMap> TreeSet;
deba@339
    87
    typedef RangeMap<Node> NodeIntMap;
deba@339
    88
    typedef MatchingMap EarMap;
deba@339
    89
    typedef std::vector<Node> NodeQueue;
deba@339
    90
deba@339
    91
    const Graph& _graph;
deba@339
    92
    MatchingMap* _matching;
deba@339
    93
    StatusMap* _status;
deba@339
    94
deba@339
    95
    EarMap* _ear;
deba@339
    96
deba@339
    97
    IntNodeMap* _blossom_set_index;
deba@339
    98
    BlossomSet* _blossom_set;
deba@339
    99
    NodeIntMap* _blossom_rep;
deba@339
   100
deba@339
   101
    IntNodeMap* _tree_set_index;
deba@339
   102
    TreeSet* _tree_set;
deba@339
   103
deba@339
   104
    NodeQueue _node_queue;
deba@339
   105
    int _process, _postpone, _last;
deba@339
   106
deba@339
   107
    int _node_num;
deba@339
   108
deba@339
   109
  private:
deba@339
   110
deba@339
   111
    void createStructures() {
deba@339
   112
      _node_num = countNodes(_graph);
deba@339
   113
      if (!_matching) {
deba@339
   114
        _matching = new MatchingMap(_graph);
deba@339
   115
      }
deba@339
   116
      if (!_status) {
deba@339
   117
        _status = new StatusMap(_graph);
deba@339
   118
      }
deba@339
   119
      if (!_ear) {
deba@339
   120
        _ear = new EarMap(_graph);
deba@339
   121
      }
deba@339
   122
      if (!_blossom_set) {
deba@339
   123
        _blossom_set_index = new IntNodeMap(_graph);
deba@339
   124
        _blossom_set = new BlossomSet(*_blossom_set_index);
deba@339
   125
      }
deba@339
   126
      if (!_blossom_rep) {
deba@339
   127
        _blossom_rep = new NodeIntMap(_node_num);
deba@339
   128
      }
deba@339
   129
      if (!_tree_set) {
deba@339
   130
        _tree_set_index = new IntNodeMap(_graph);
deba@339
   131
        _tree_set = new TreeSet(*_tree_set_index);
deba@339
   132
      }
deba@339
   133
      _node_queue.resize(_node_num);
deba@339
   134
    }
deba@339
   135
deba@339
   136
    void destroyStructures() {
deba@339
   137
      if (_matching) {
deba@339
   138
        delete _matching;
deba@339
   139
      }
deba@339
   140
      if (_status) {
deba@339
   141
        delete _status;
deba@339
   142
      }
deba@339
   143
      if (_ear) {
deba@339
   144
        delete _ear;
deba@339
   145
      }
deba@339
   146
      if (_blossom_set) {
deba@339
   147
        delete _blossom_set;
deba@339
   148
        delete _blossom_set_index;
deba@339
   149
      }
deba@339
   150
      if (_blossom_rep) {
deba@339
   151
        delete _blossom_rep;
deba@339
   152
      }
deba@339
   153
      if (_tree_set) {
deba@339
   154
        delete _tree_set_index;
deba@339
   155
        delete _tree_set;
deba@339
   156
      }
deba@339
   157
    }
deba@339
   158
deba@339
   159
    void processDense(const Node& n) {
deba@339
   160
      _process = _postpone = _last = 0;
deba@339
   161
      _node_queue[_last++] = n;
deba@339
   162
deba@339
   163
      while (_process != _last) {
deba@339
   164
        Node u = _node_queue[_process++];
deba@339
   165
        for (OutArcIt a(_graph, u); a != INVALID; ++a) {
deba@339
   166
          Node v = _graph.target(a);
deba@339
   167
          if ((*_status)[v] == MATCHED) {
deba@339
   168
            extendOnArc(a);
deba@339
   169
          } else if ((*_status)[v] == UNMATCHED) {
deba@339
   170
            augmentOnArc(a);
deba@339
   171
            return;
deba@339
   172
          }
deba@339
   173
        }
deba@339
   174
      }
deba@339
   175
deba@339
   176
      while (_postpone != _last) {
deba@339
   177
        Node u = _node_queue[_postpone++];
deba@339
   178
deba@339
   179
        for (OutArcIt a(_graph, u); a != INVALID ; ++a) {
deba@339
   180
          Node v = _graph.target(a);
deba@339
   181
deba@339
   182
          if ((*_status)[v] == EVEN) {
deba@339
   183
            if (_blossom_set->find(u) != _blossom_set->find(v)) {
deba@339
   184
              shrinkOnEdge(a);
deba@339
   185
            }
deba@339
   186
          }
deba@339
   187
deba@339
   188
          while (_process != _last) {
deba@339
   189
            Node w = _node_queue[_process++];
deba@339
   190
            for (OutArcIt b(_graph, w); b != INVALID; ++b) {
deba@339
   191
              Node x = _graph.target(b);
deba@339
   192
              if ((*_status)[x] == MATCHED) {
deba@339
   193
                extendOnArc(b);
deba@339
   194
              } else if ((*_status)[x] == UNMATCHED) {
deba@339
   195
                augmentOnArc(b);
deba@339
   196
                return;
deba@339
   197
              }
deba@339
   198
            }
deba@339
   199
          }
deba@339
   200
        }
deba@339
   201
      }
deba@339
   202
    }
deba@339
   203
deba@339
   204
    void processSparse(const Node& n) {
deba@339
   205
      _process = _last = 0;
deba@339
   206
      _node_queue[_last++] = n;
deba@339
   207
      while (_process != _last) {
deba@339
   208
        Node u = _node_queue[_process++];
deba@339
   209
        for (OutArcIt a(_graph, u); a != INVALID; ++a) {
deba@339
   210
          Node v = _graph.target(a);
deba@339
   211
deba@339
   212
          if ((*_status)[v] == EVEN) {
deba@339
   213
            if (_blossom_set->find(u) != _blossom_set->find(v)) {
deba@339
   214
              shrinkOnEdge(a);
deba@339
   215
            }
deba@339
   216
          } else if ((*_status)[v] == MATCHED) {
deba@339
   217
            extendOnArc(a);
deba@339
   218
          } else if ((*_status)[v] == UNMATCHED) {
deba@339
   219
            augmentOnArc(a);
deba@339
   220
            return;
deba@339
   221
          }
deba@339
   222
        }
deba@339
   223
      }
deba@339
   224
    }
deba@339
   225
deba@339
   226
    void shrinkOnEdge(const Edge& e) {
deba@339
   227
      Node nca = INVALID;
deba@339
   228
deba@339
   229
      {
deba@339
   230
        std::set<Node> left_set, right_set;
deba@339
   231
deba@339
   232
        Node left = (*_blossom_rep)[_blossom_set->find(_graph.u(e))];
deba@339
   233
        left_set.insert(left);
deba@339
   234
deba@339
   235
        Node right = (*_blossom_rep)[_blossom_set->find(_graph.v(e))];
deba@339
   236
        right_set.insert(right);
deba@339
   237
deba@339
   238
        while (true) {
deba@339
   239
          if ((*_matching)[left] == INVALID) break;
deba@339
   240
          left = _graph.target((*_matching)[left]);
deba@339
   241
          left = (*_blossom_rep)[_blossom_set->
deba@339
   242
                                 find(_graph.target((*_ear)[left]))];
deba@339
   243
          if (right_set.find(left) != right_set.end()) {
deba@339
   244
            nca = left;
deba@339
   245
            break;
deba@339
   246
          }
deba@339
   247
          left_set.insert(left);
deba@339
   248
deba@339
   249
          if ((*_matching)[right] == INVALID) break;
deba@339
   250
          right = _graph.target((*_matching)[right]);
deba@339
   251
          right = (*_blossom_rep)[_blossom_set->
deba@339
   252
                                  find(_graph.target((*_ear)[right]))];
deba@339
   253
          if (left_set.find(right) != left_set.end()) {
deba@339
   254
            nca = right;
deba@339
   255
            break;
deba@339
   256
          }
deba@339
   257
          right_set.insert(right);
deba@339
   258
        }
deba@339
   259
deba@339
   260
        if (nca == INVALID) {
deba@339
   261
          if ((*_matching)[left] == INVALID) {
deba@339
   262
            nca = right;
deba@339
   263
            while (left_set.find(nca) == left_set.end()) {
deba@339
   264
              nca = _graph.target((*_matching)[nca]);
deba@339
   265
              nca =(*_blossom_rep)[_blossom_set->
deba@339
   266
                                   find(_graph.target((*_ear)[nca]))];
deba@339
   267
            }
deba@339
   268
          } else {
deba@339
   269
            nca = left;
deba@339
   270
            while (right_set.find(nca) == right_set.end()) {
deba@339
   271
              nca = _graph.target((*_matching)[nca]);
deba@339
   272
              nca = (*_blossom_rep)[_blossom_set->
deba@339
   273
                                   find(_graph.target((*_ear)[nca]))];
deba@339
   274
            }
deba@339
   275
          }
deba@339
   276
        }
deba@339
   277
      }
deba@339
   278
deba@339
   279
      {
deba@339
   280
deba@339
   281
        Node node = _graph.u(e);
deba@339
   282
        Arc arc = _graph.direct(e, true);
deba@339
   283
        Node base = (*_blossom_rep)[_blossom_set->find(node)];
deba@339
   284
deba@339
   285
        while (base != nca) {
deba@339
   286
          _ear->set(node, arc);
deba@339
   287
deba@339
   288
          Node n = node;
deba@339
   289
          while (n != base) {
deba@339
   290
            n = _graph.target((*_matching)[n]);
deba@339
   291
            Arc a = (*_ear)[n];
deba@339
   292
            n = _graph.target(a);
deba@339
   293
            _ear->set(n, _graph.oppositeArc(a));
deba@339
   294
          }
deba@339
   295
          node = _graph.target((*_matching)[base]);
deba@339
   296
          _tree_set->erase(base);
deba@339
   297
          _tree_set->erase(node);
deba@339
   298
          _blossom_set->insert(node, _blossom_set->find(base));
deba@339
   299
          _status->set(node, EVEN);
deba@339
   300
          _node_queue[_last++] = node;
deba@339
   301
          arc = _graph.oppositeArc((*_ear)[node]);
deba@339
   302
          node = _graph.target((*_ear)[node]);
deba@339
   303
          base = (*_blossom_rep)[_blossom_set->find(node)];
deba@339
   304
          _blossom_set->join(_graph.target(arc), base);
deba@339
   305
        }
deba@339
   306
      }
deba@339
   307
deba@339
   308
      _blossom_rep->set(_blossom_set->find(nca), nca);
deba@339
   309
deba@339
   310
      {
deba@339
   311
deba@339
   312
        Node node = _graph.v(e);
deba@339
   313
        Arc arc = _graph.direct(e, false);
deba@339
   314
        Node base = (*_blossom_rep)[_blossom_set->find(node)];
deba@339
   315
deba@339
   316
        while (base != nca) {
deba@339
   317
          _ear->set(node, arc);
deba@339
   318
deba@339
   319
          Node n = node;
deba@339
   320
          while (n != base) {
deba@339
   321
            n = _graph.target((*_matching)[n]);
deba@339
   322
            Arc a = (*_ear)[n];
deba@339
   323
            n = _graph.target(a);
deba@339
   324
            _ear->set(n, _graph.oppositeArc(a));
deba@339
   325
          }
deba@339
   326
          node = _graph.target((*_matching)[base]);
deba@339
   327
          _tree_set->erase(base);
deba@339
   328
          _tree_set->erase(node);
deba@339
   329
          _blossom_set->insert(node, _blossom_set->find(base));
deba@339
   330
          _status->set(node, EVEN);
deba@339
   331
          _node_queue[_last++] = node;
deba@339
   332
          arc = _graph.oppositeArc((*_ear)[node]);
deba@339
   333
          node = _graph.target((*_ear)[node]);
deba@339
   334
          base = (*_blossom_rep)[_blossom_set->find(node)];
deba@339
   335
          _blossom_set->join(_graph.target(arc), base);
deba@339
   336
        }
deba@339
   337
      }
deba@339
   338
deba@339
   339
      _blossom_rep->set(_blossom_set->find(nca), nca);
deba@339
   340
    }
deba@339
   341
deba@339
   342
deba@339
   343
deba@339
   344
    void extendOnArc(const Arc& a) {
deba@339
   345
      Node base = _graph.source(a);
deba@339
   346
      Node odd = _graph.target(a);
deba@339
   347
deba@339
   348
      _ear->set(odd, _graph.oppositeArc(a));
deba@339
   349
      Node even = _graph.target((*_matching)[odd]);
deba@339
   350
      _blossom_rep->set(_blossom_set->insert(even), even);
deba@339
   351
      _status->set(odd, ODD);
deba@339
   352
      _status->set(even, EVEN);
deba@339
   353
      int tree = _tree_set->find((*_blossom_rep)[_blossom_set->find(base)]);
deba@339
   354
      _tree_set->insert(odd, tree);
deba@339
   355
      _tree_set->insert(even, tree);
deba@339
   356
      _node_queue[_last++] = even;
deba@339
   357
deba@339
   358
    }
deba@339
   359
deba@339
   360
    void augmentOnArc(const Arc& a) {
deba@339
   361
      Node even = _graph.source(a);
deba@339
   362
      Node odd = _graph.target(a);
deba@339
   363
deba@339
   364
      int tree = _tree_set->find((*_blossom_rep)[_blossom_set->find(even)]);
deba@339
   365
deba@339
   366
      _matching->set(odd, _graph.oppositeArc(a));
deba@339
   367
      _status->set(odd, MATCHED);
deba@339
   368
deba@339
   369
      Arc arc = (*_matching)[even];
deba@339
   370
      _matching->set(even, a);
deba@339
   371
deba@339
   372
      while (arc != INVALID) {
deba@339
   373
        odd = _graph.target(arc);
deba@339
   374
        arc = (*_ear)[odd];
deba@339
   375
        even = _graph.target(arc);
deba@339
   376
        _matching->set(odd, arc);
deba@339
   377
        arc = (*_matching)[even];
deba@339
   378
        _matching->set(even, _graph.oppositeArc((*_matching)[odd]));
deba@339
   379
      }
deba@339
   380
deba@339
   381
      for (typename TreeSet::ItemIt it(*_tree_set, tree);
deba@339
   382
           it != INVALID; ++it) {
deba@339
   383
        if ((*_status)[it] == ODD) {
deba@339
   384
          _status->set(it, MATCHED);
deba@339
   385
        } else {
deba@339
   386
          int blossom = _blossom_set->find(it);
deba@339
   387
          for (typename BlossomSet::ItemIt jt(*_blossom_set, blossom);
deba@339
   388
               jt != INVALID; ++jt) {
deba@339
   389
            _status->set(jt, MATCHED);
deba@339
   390
          }
deba@339
   391
          _blossom_set->eraseClass(blossom);
deba@339
   392
        }
deba@339
   393
      }
deba@339
   394
      _tree_set->eraseClass(tree);
deba@339
   395
deba@339
   396
    }
deba@338
   397
deba@338
   398
  public:
deba@338
   399
deba@339
   400
    /// \brief Constructor
deba@338
   401
    ///
deba@339
   402
    /// Constructor.
deba@339
   403
    MaxMatching(const Graph& graph)
deba@339
   404
      : _graph(graph), _matching(0), _status(0), _ear(0),
deba@339
   405
        _blossom_set_index(0), _blossom_set(0), _blossom_rep(0),
deba@339
   406
        _tree_set_index(0), _tree_set(0) {}
deba@339
   407
deba@339
   408
    ~MaxMatching() {
deba@339
   409
      destroyStructures();
deba@339
   410
    }
deba@339
   411
deba@339
   412
    /// \name Execution control
deba@339
   413
    /// The simplest way to execute the algorithm is to use the member
deba@339
   414
    /// \c run() member function.
deba@339
   415
    /// \n
deba@339
   416
deba@339
   417
    /// If you need more control on the execution, first you must call
deba@339
   418
    /// \ref init(), \ref greedyInit() or \ref matchingInit()
deba@339
   419
    /// functions, then you can start the algorithm with the \ref
deba@339
   420
    /// startParse() or startDense() functions.
deba@339
   421
deba@339
   422
    ///@{
deba@339
   423
deba@339
   424
    /// \brief Sets the actual matching to the empty matching.
deba@338
   425
    ///
deba@339
   426
    /// Sets the actual matching to the empty matching.
deba@338
   427
    ///
deba@338
   428
    void init() {
deba@339
   429
      createStructures();
deba@339
   430
      for(NodeIt n(_graph); n != INVALID; ++n) {
deba@339
   431
        _matching->set(n, INVALID);
deba@339
   432
        _status->set(n, UNMATCHED);
deba@338
   433
      }
deba@338
   434
    }
deba@338
   435
deba@338
   436
    ///\brief Finds a greedy matching for initial matching.
deba@338
   437
    ///
deba@338
   438
    ///For initial matchig it finds a maximal greedy matching.
deba@338
   439
    void greedyInit() {
deba@339
   440
      createStructures();
deba@339
   441
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@339
   442
        _matching->set(n, INVALID);
deba@339
   443
        _status->set(n, UNMATCHED);
deba@338
   444
      }
deba@339
   445
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@339
   446
        if ((*_matching)[n] == INVALID) {
deba@339
   447
          for (OutArcIt a(_graph, n); a != INVALID ; ++a) {
deba@339
   448
            Node v = _graph.target(a);
deba@339
   449
            if ((*_matching)[v] == INVALID && v != n) {
deba@339
   450
              _matching->set(n, a);
deba@339
   451
              _status->set(n, MATCHED);
deba@339
   452
              _matching->set(v, _graph.oppositeArc(a));
deba@339
   453
              _status->set(v, MATCHED);
deba@338
   454
              break;
deba@338
   455
            }
deba@338
   456
          }
deba@338
   457
        }
deba@338
   458
      }
deba@338
   459
    }
deba@338
   460
deba@339
   461
deba@339
   462
    /// \brief Initialize the matching from the map containing a matching.
deba@338
   463
    ///
deba@339
   464
    /// Initialize the matching from a \c bool valued \c Edge map. This
deba@339
   465
    /// map must have the property that there are no two incident edges
deba@339
   466
    /// with true value, ie. it contains a matching.
deba@339
   467
    /// \return %True if the map contains a matching.
deba@339
   468
    template <typename MatchingMap>
deba@339
   469
    bool matchingInit(const MatchingMap& matching) {
deba@339
   470
      createStructures();
deba@339
   471
deba@339
   472
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@339
   473
        _matching->set(n, INVALID);
deba@339
   474
        _status->set(n, UNMATCHED);
deba@338
   475
      }
deba@339
   476
      for(EdgeIt e(_graph); e!=INVALID; ++e) {
deba@339
   477
        if (matching[e]) {
deba@339
   478
deba@339
   479
          Node u = _graph.u(e);
deba@339
   480
          if ((*_matching)[u] != INVALID) return false;
deba@339
   481
          _matching->set(u, _graph.direct(e, true));
deba@339
   482
          _status->set(u, MATCHED);
deba@339
   483
deba@339
   484
          Node v = _graph.v(e);
deba@339
   485
          if ((*_matching)[v] != INVALID) return false;
deba@339
   486
          _matching->set(v, _graph.direct(e, false));
deba@339
   487
          _status->set(v, MATCHED);
deba@339
   488
        }
deba@339
   489
      }
deba@339
   490
      return true;
deba@338
   491
    }
deba@338
   492
deba@339
   493
    /// \brief Starts Edmonds' algorithm
deba@338
   494
    ///
deba@339
   495
    /// If runs the original Edmonds' algorithm.
deba@339
   496
    void startSparse() {
deba@339
   497
      for(NodeIt n(_graph); n != INVALID; ++n) {
deba@339
   498
        if ((*_status)[n] == UNMATCHED) {
deba@339
   499
          (*_blossom_rep)[_blossom_set->insert(n)] = n;
deba@339
   500
          _tree_set->insert(n);
deba@339
   501
          _status->set(n, EVEN);
deba@339
   502
          processSparse(n);
deba@338
   503
        }
deba@338
   504
      }
deba@338
   505
    }
deba@338
   506
deba@339
   507
    /// \brief Starts Edmonds' algorithm.
deba@338
   508
    ///
deba@339
   509
    /// It runs Edmonds' algorithm with a heuristic of postponing
deba@339
   510
    /// shrinks, giving a faster algorithm for dense graphs.
deba@339
   511
    void startDense() {
deba@339
   512
      for(NodeIt n(_graph); n != INVALID; ++n) {
deba@339
   513
        if ((*_status)[n] == UNMATCHED) {
deba@339
   514
          (*_blossom_rep)[_blossom_set->insert(n)] = n;
deba@339
   515
          _tree_set->insert(n);
deba@339
   516
          _status->set(n, EVEN);
deba@339
   517
          processDense(n);
deba@339
   518
        }
deba@339
   519
      }
deba@339
   520
    }
deba@339
   521
deba@339
   522
deba@339
   523
    /// \brief Runs Edmonds' algorithm
deba@339
   524
    ///
deba@339
   525
    /// Runs Edmonds' algorithm for sparse graphs (<tt>m<2*n</tt>)
deba@339
   526
    /// or Edmonds' algorithm with a heuristic of
deba@339
   527
    /// postponing shrinks for dense graphs.
deba@338
   528
    void run() {
deba@339
   529
      if (countEdges(_graph) < 2 * countNodes(_graph)) {
deba@338
   530
        greedyInit();
deba@338
   531
        startSparse();
deba@338
   532
      } else {
deba@338
   533
        init();
deba@338
   534
        startDense();
deba@338
   535
      }
deba@338
   536
    }
deba@338
   537
deba@339
   538
    /// @}
deba@339
   539
deba@339
   540
    /// \name Primal solution
deba@339
   541
    /// Functions for get the primal solution, ie. the matching.
deba@339
   542
deba@339
   543
    /// @{
deba@338
   544
deba@338
   545
    ///\brief Returns the size of the actual matching stored.
deba@338
   546
    ///
deba@338
   547
    ///Returns the size of the actual matching stored. After \ref
deba@339
   548
    ///run() it returns the size of the maximum matching in the graph.
deba@339
   549
    int matchingSize() const {
deba@339
   550
      int size = 0;
deba@339
   551
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@339
   552
        if ((*_matching)[n] != INVALID) {
deba@339
   553
          ++size;
deba@338
   554
        }
deba@338
   555
      }
deba@339
   556
      return size / 2;
deba@338
   557
    }
deba@338
   558
deba@339
   559
    /// \brief Returns true when the edge is in the matching.
deba@339
   560
    ///
deba@339
   561
    /// Returns true when the edge is in the matching.
deba@339
   562
    bool matching(const Edge& edge) const {
deba@339
   563
      return edge == (*_matching)[_graph.u(edge)];
deba@339
   564
    }
deba@339
   565
deba@339
   566
    /// \brief Returns the matching edge incident to the given node.
deba@339
   567
    ///
deba@339
   568
    /// Returns the matching edge of a \c node in the actual matching or
deba@339
   569
    /// INVALID if the \c node is not covered by the actual matching.
deba@339
   570
    Arc matching(const Node& n) const {
deba@339
   571
      return (*_matching)[n];
deba@339
   572
    }
deba@338
   573
deba@338
   574
    ///\brief Returns the mate of a node in the actual matching.
deba@338
   575
    ///
deba@339
   576
    ///Returns the mate of a \c node in the actual matching or
deba@339
   577
    ///INVALID if the \c node is not covered by the actual matching.
deba@339
   578
    Node mate(const Node& n) const {
deba@339
   579
      return (*_matching)[n] != INVALID ?
deba@339
   580
        _graph.target((*_matching)[n]) : INVALID;
deba@338
   581
    }
deba@338
   582
deba@339
   583
    /// @}
deba@339
   584
deba@339
   585
    /// \name Dual solution
deba@339
   586
    /// Functions for get the dual solution, ie. the decomposition.
deba@339
   587
deba@339
   588
    /// @{
deba@338
   589
deba@338
   590
    /// \brief Returns the class of the node in the Edmonds-Gallai
deba@338
   591
    /// decomposition.
deba@338
   592
    ///
deba@338
   593
    /// Returns the class of the node in the Edmonds-Gallai
deba@338
   594
    /// decomposition.
deba@339
   595
    Status decomposition(const Node& n) const {
deba@339
   596
      return (*_status)[n];
deba@338
   597
    }
deba@338
   598
deba@338
   599
    /// \brief Returns true when the node is in the barrier.
deba@338
   600
    ///
deba@338
   601
    /// Returns true when the node is in the barrier.
deba@339
   602
    bool barrier(const Node& n) const {
deba@339
   603
      return (*_status)[n] == ODD;
deba@338
   604
    }
deba@338
   605
deba@339
   606
    /// @}
deba@338
   607
deba@338
   608
  };
deba@338
   609
deba@338
   610
  /// \ingroup matching
deba@338
   611
  ///
deba@338
   612
  /// \brief Weighted matching in general graphs
deba@338
   613
  ///
deba@338
   614
  /// This class provides an efficient implementation of Edmond's
deba@338
   615
  /// maximum weighted matching algorithm. The implementation is based
deba@338
   616
  /// on extensive use of priority queues and provides
deba@338
   617
  /// \f$O(nm\log(n))\f$ time complexity.
deba@338
   618
  ///
deba@338
   619
  /// The maximum weighted matching problem is to find undirected
deba@339
   620
  /// edges in the graph with maximum overall weight and no two of
deba@339
   621
  /// them shares their ends. The problem can be formulated with the
deba@339
   622
  /// following linear program.
deba@338
   623
  /// \f[ \sum_{e \in \delta(u)}x_e \le 1 \quad \forall u\in V\f]
deba@339
   624
  /** \f[ \sum_{e \in \gamma(B)}x_e \le \frac{\vert B \vert - 1}{2}
deba@339
   625
      \quad \forall B\in\mathcal{O}\f] */
deba@338
   626
  /// \f[x_e \ge 0\quad \forall e\in E\f]
deba@338
   627
  /// \f[\max \sum_{e\in E}x_ew_e\f]
deba@339
   628
  /// where \f$\delta(X)\f$ is the set of edges incident to a node in
deba@339
   629
  /// \f$X\f$, \f$\gamma(X)\f$ is the set of edges with both ends in
deba@339
   630
  /// \f$X\f$ and \f$\mathcal{O}\f$ is the set of odd cardinality
deba@339
   631
  /// subsets of the nodes.
deba@338
   632
  ///
deba@338
   633
  /// The algorithm calculates an optimal matching and a proof of the
deba@338
   634
  /// optimality. The solution of the dual problem can be used to check
deba@339
   635
  /// the result of the algorithm. The dual linear problem is the
deba@339
   636
  /** \f[ y_u + y_v + \sum_{B \in \mathcal{O}, uv \in \gamma(B)}
deba@339
   637
      z_B \ge w_{uv} \quad \forall uv\in E\f] */
deba@338
   638
  /// \f[y_u \ge 0 \quad \forall u \in V\f]
deba@338
   639
  /// \f[z_B \ge 0 \quad \forall B \in \mathcal{O}\f]
deba@339
   640
  /** \f[\min \sum_{u \in V}y_u + \sum_{B \in \mathcal{O}}
deba@339
   641
      \frac{\vert B \vert - 1}{2}z_B\f] */
deba@338
   642
  ///
deba@338
   643
  /// The algorithm can be executed with \c run() or the \c init() and
deba@338
   644
  /// then the \c start() member functions. After it the matching can
deba@338
   645
  /// be asked with \c matching() or mate() functions. The dual
deba@338
   646
  /// solution can be get with \c nodeValue(), \c blossomNum() and \c
deba@338
   647
  /// blossomValue() members and \ref MaxWeightedMatching::BlossomIt
deba@338
   648
  /// "BlossomIt" nested class which is able to iterate on the nodes
deba@338
   649
  /// of a blossom. If the value type is integral then the dual
deba@338
   650
  /// solution is multiplied by \ref MaxWeightedMatching::dualScale "4".
deba@338
   651
  template <typename _Graph,
deba@338
   652
            typename _WeightMap = typename _Graph::template EdgeMap<int> >
deba@338
   653
  class MaxWeightedMatching {
deba@338
   654
  public:
deba@338
   655
deba@338
   656
    typedef _Graph Graph;
deba@338
   657
    typedef _WeightMap WeightMap;
deba@338
   658
    typedef typename WeightMap::Value Value;
deba@338
   659
deba@338
   660
    /// \brief Scaling factor for dual solution
deba@338
   661
    ///
deba@338
   662
    /// Scaling factor for dual solution, it is equal to 4 or 1
deba@338
   663
    /// according to the value type.
deba@338
   664
    static const int dualScale =
deba@338
   665
      std::numeric_limits<Value>::is_integer ? 4 : 1;
deba@338
   666
deba@338
   667
    typedef typename Graph::template NodeMap<typename Graph::Arc>
deba@338
   668
    MatchingMap;
deba@338
   669
deba@338
   670
  private:
deba@338
   671
deba@338
   672
    TEMPLATE_GRAPH_TYPEDEFS(Graph);
deba@338
   673
deba@338
   674
    typedef typename Graph::template NodeMap<Value> NodePotential;
deba@338
   675
    typedef std::vector<Node> BlossomNodeList;
deba@338
   676
deba@338
   677
    struct BlossomVariable {
deba@338
   678
      int begin, end;
deba@338
   679
      Value value;
deba@338
   680
deba@338
   681
      BlossomVariable(int _begin, int _end, Value _value)
deba@338
   682
        : begin(_begin), end(_end), value(_value) {}
deba@338
   683
deba@338
   684
    };
deba@338
   685
deba@338
   686
    typedef std::vector<BlossomVariable> BlossomPotential;
deba@338
   687
deba@338
   688
    const Graph& _graph;
deba@338
   689
    const WeightMap& _weight;
deba@338
   690
deba@338
   691
    MatchingMap* _matching;
deba@338
   692
deba@338
   693
    NodePotential* _node_potential;
deba@338
   694
deba@338
   695
    BlossomPotential _blossom_potential;
deba@338
   696
    BlossomNodeList _blossom_node_list;
deba@338
   697
deba@338
   698
    int _node_num;
deba@338
   699
    int _blossom_num;
deba@338
   700
deba@338
   701
    typedef RangeMap<int> IntIntMap;
deba@338
   702
deba@338
   703
    enum Status {
deba@338
   704
      EVEN = -1, MATCHED = 0, ODD = 1, UNMATCHED = -2
deba@338
   705
    };
deba@338
   706
deba@339
   707
    typedef HeapUnionFind<Value, IntNodeMap> BlossomSet;
deba@338
   708
    struct BlossomData {
deba@338
   709
      int tree;
deba@338
   710
      Status status;
deba@338
   711
      Arc pred, next;
deba@338
   712
      Value pot, offset;
deba@338
   713
      Node base;
deba@338
   714
    };
deba@338
   715
deba@339
   716
    IntNodeMap *_blossom_index;
deba@338
   717
    BlossomSet *_blossom_set;
deba@338
   718
    RangeMap<BlossomData>* _blossom_data;
deba@338
   719
deba@339
   720
    IntNodeMap *_node_index;
deba@339
   721
    IntArcMap *_node_heap_index;
deba@338
   722
deba@338
   723
    struct NodeData {
deba@338
   724
deba@339
   725
      NodeData(IntArcMap& node_heap_index)
deba@338
   726
        : heap(node_heap_index) {}
deba@338
   727
deba@338
   728
      int blossom;
deba@338
   729
      Value pot;
deba@339
   730
      BinHeap<Value, IntArcMap> heap;
deba@338
   731
      std::map<int, Arc> heap_index;
deba@338
   732
deba@338
   733
      int tree;
deba@338
   734
    };
deba@338
   735
deba@338
   736
    RangeMap<NodeData>* _node_data;
deba@338
   737
deba@338
   738
    typedef ExtendFindEnum<IntIntMap> TreeSet;
deba@338
   739
deba@338
   740
    IntIntMap *_tree_set_index;
deba@338
   741
    TreeSet *_tree_set;
deba@338
   742
deba@339
   743
    IntNodeMap *_delta1_index;
deba@339
   744
    BinHeap<Value, IntNodeMap> *_delta1;
deba@338
   745
deba@338
   746
    IntIntMap *_delta2_index;
deba@338
   747
    BinHeap<Value, IntIntMap> *_delta2;
deba@338
   748
deba@339
   749
    IntEdgeMap *_delta3_index;
deba@339
   750
    BinHeap<Value, IntEdgeMap> *_delta3;
deba@338
   751
deba@338
   752
    IntIntMap *_delta4_index;
deba@338
   753
    BinHeap<Value, IntIntMap> *_delta4;
deba@338
   754
deba@338
   755
    Value _delta_sum;
deba@338
   756
deba@338
   757
    void createStructures() {
deba@338
   758
      _node_num = countNodes(_graph);
deba@338
   759
      _blossom_num = _node_num * 3 / 2;
deba@338
   760
deba@338
   761
      if (!_matching) {
deba@338
   762
        _matching = new MatchingMap(_graph);
deba@338
   763
      }
deba@338
   764
      if (!_node_potential) {
deba@338
   765
        _node_potential = new NodePotential(_graph);
deba@338
   766
      }
deba@338
   767
      if (!_blossom_set) {
deba@339
   768
        _blossom_index = new IntNodeMap(_graph);
deba@338
   769
        _blossom_set = new BlossomSet(*_blossom_index);
deba@338
   770
        _blossom_data = new RangeMap<BlossomData>(_blossom_num);
deba@338
   771
      }
deba@338
   772
deba@338
   773
      if (!_node_index) {
deba@339
   774
        _node_index = new IntNodeMap(_graph);
deba@339
   775
        _node_heap_index = new IntArcMap(_graph);
deba@338
   776
        _node_data = new RangeMap<NodeData>(_node_num,
deba@338
   777
                                              NodeData(*_node_heap_index));
deba@338
   778
      }
deba@338
   779
deba@338
   780
      if (!_tree_set) {
deba@338
   781
        _tree_set_index = new IntIntMap(_blossom_num);
deba@338
   782
        _tree_set = new TreeSet(*_tree_set_index);
deba@338
   783
      }
deba@338
   784
      if (!_delta1) {
deba@339
   785
        _delta1_index = new IntNodeMap(_graph);
deba@339
   786
        _delta1 = new BinHeap<Value, IntNodeMap>(*_delta1_index);
deba@338
   787
      }
deba@338
   788
      if (!_delta2) {
deba@338
   789
        _delta2_index = new IntIntMap(_blossom_num);
deba@338
   790
        _delta2 = new BinHeap<Value, IntIntMap>(*_delta2_index);
deba@338
   791
      }
deba@338
   792
      if (!_delta3) {
deba@339
   793
        _delta3_index = new IntEdgeMap(_graph);
deba@339
   794
        _delta3 = new BinHeap<Value, IntEdgeMap>(*_delta3_index);
deba@338
   795
      }
deba@338
   796
      if (!_delta4) {
deba@338
   797
        _delta4_index = new IntIntMap(_blossom_num);
deba@338
   798
        _delta4 = new BinHeap<Value, IntIntMap>(*_delta4_index);
deba@338
   799
      }
deba@338
   800
    }
deba@338
   801
deba@338
   802
    void destroyStructures() {
deba@338
   803
      _node_num = countNodes(_graph);
deba@338
   804
      _blossom_num = _node_num * 3 / 2;
deba@338
   805
deba@338
   806
      if (_matching) {
deba@338
   807
        delete _matching;
deba@338
   808
      }
deba@338
   809
      if (_node_potential) {
deba@338
   810
        delete _node_potential;
deba@338
   811
      }
deba@338
   812
      if (_blossom_set) {
deba@338
   813
        delete _blossom_index;
deba@338
   814
        delete _blossom_set;
deba@338
   815
        delete _blossom_data;
deba@338
   816
      }
deba@338
   817
deba@338
   818
      if (_node_index) {
deba@338
   819
        delete _node_index;
deba@338
   820
        delete _node_heap_index;
deba@338
   821
        delete _node_data;
deba@338
   822
      }
deba@338
   823
deba@338
   824
      if (_tree_set) {
deba@338
   825
        delete _tree_set_index;
deba@338
   826
        delete _tree_set;
deba@338
   827
      }
deba@338
   828
      if (_delta1) {
deba@338
   829
        delete _delta1_index;
deba@338
   830
        delete _delta1;
deba@338
   831
      }
deba@338
   832
      if (_delta2) {
deba@338
   833
        delete _delta2_index;
deba@338
   834
        delete _delta2;
deba@338
   835
      }
deba@338
   836
      if (_delta3) {
deba@338
   837
        delete _delta3_index;
deba@338
   838
        delete _delta3;
deba@338
   839
      }
deba@338
   840
      if (_delta4) {
deba@338
   841
        delete _delta4_index;
deba@338
   842
        delete _delta4;
deba@338
   843
      }
deba@338
   844
    }
deba@338
   845
deba@338
   846
    void matchedToEven(int blossom, int tree) {
deba@338
   847
      if (_delta2->state(blossom) == _delta2->IN_HEAP) {
deba@338
   848
        _delta2->erase(blossom);
deba@338
   849
      }
deba@338
   850
deba@338
   851
      if (!_blossom_set->trivial(blossom)) {
deba@338
   852
        (*_blossom_data)[blossom].pot -=
deba@338
   853
          2 * (_delta_sum - (*_blossom_data)[blossom].offset);
deba@338
   854
      }
deba@338
   855
deba@338
   856
      for (typename BlossomSet::ItemIt n(*_blossom_set, blossom);
deba@338
   857
           n != INVALID; ++n) {
deba@338
   858
deba@338
   859
        _blossom_set->increase(n, std::numeric_limits<Value>::max());
deba@338
   860
        int ni = (*_node_index)[n];
deba@338
   861
deba@338
   862
        (*_node_data)[ni].heap.clear();
deba@338
   863
        (*_node_data)[ni].heap_index.clear();
deba@338
   864
deba@338
   865
        (*_node_data)[ni].pot += _delta_sum - (*_blossom_data)[blossom].offset;
deba@338
   866
deba@338
   867
        _delta1->push(n, (*_node_data)[ni].pot);
deba@338
   868
deba@338
   869
        for (InArcIt e(_graph, n); e != INVALID; ++e) {
deba@338
   870
          Node v = _graph.source(e);
deba@338
   871
          int vb = _blossom_set->find(v);
deba@338
   872
          int vi = (*_node_index)[v];
deba@338
   873
deba@338
   874
          Value rw = (*_node_data)[ni].pot + (*_node_data)[vi].pot -
deba@338
   875
            dualScale * _weight[e];
deba@338
   876
deba@338
   877
          if ((*_blossom_data)[vb].status == EVEN) {
deba@338
   878
            if (_delta3->state(e) != _delta3->IN_HEAP && blossom != vb) {
deba@338
   879
              _delta3->push(e, rw / 2);
deba@338
   880
            }
deba@338
   881
          } else if ((*_blossom_data)[vb].status == UNMATCHED) {
deba@338
   882
            if (_delta3->state(e) != _delta3->IN_HEAP) {
deba@338
   883
              _delta3->push(e, rw);
deba@338
   884
            }
deba@338
   885
          } else {
deba@338
   886
            typename std::map<int, Arc>::iterator it =
deba@338
   887
              (*_node_data)[vi].heap_index.find(tree);
deba@338
   888
deba@338
   889
            if (it != (*_node_data)[vi].heap_index.end()) {
deba@338
   890
              if ((*_node_data)[vi].heap[it->second] > rw) {
deba@338
   891
                (*_node_data)[vi].heap.replace(it->second, e);
deba@338
   892
                (*_node_data)[vi].heap.decrease(e, rw);
deba@338
   893
                it->second = e;
deba@338
   894
              }
deba@338
   895
            } else {
deba@338
   896
              (*_node_data)[vi].heap.push(e, rw);
deba@338
   897
              (*_node_data)[vi].heap_index.insert(std::make_pair(tree, e));
deba@338
   898
            }
deba@338
   899
deba@338
   900
            if ((*_blossom_set)[v] > (*_node_data)[vi].heap.prio()) {
deba@338
   901
              _blossom_set->decrease(v, (*_node_data)[vi].heap.prio());
deba@338
   902
deba@338
   903
              if ((*_blossom_data)[vb].status == MATCHED) {
deba@338
   904
                if (_delta2->state(vb) != _delta2->IN_HEAP) {
deba@338
   905
                  _delta2->push(vb, _blossom_set->classPrio(vb) -
deba@338
   906
                               (*_blossom_data)[vb].offset);
deba@338
   907
                } else if ((*_delta2)[vb] > _blossom_set->classPrio(vb) -
deba@338
   908
                           (*_blossom_data)[vb].offset){
deba@338
   909
                  _delta2->decrease(vb, _blossom_set->classPrio(vb) -
deba@338
   910
                                   (*_blossom_data)[vb].offset);
deba@338
   911
                }
deba@338
   912
              }
deba@338
   913
            }
deba@338
   914
          }
deba@338
   915
        }
deba@338
   916
      }
deba@338
   917
      (*_blossom_data)[blossom].offset = 0;
deba@338
   918
    }
deba@338
   919
deba@338
   920
    void matchedToOdd(int blossom) {
deba@338
   921
      if (_delta2->state(blossom) == _delta2->IN_HEAP) {
deba@338
   922
        _delta2->erase(blossom);
deba@338
   923
      }
deba@338
   924
      (*_blossom_data)[blossom].offset += _delta_sum;
deba@338
   925
      if (!_blossom_set->trivial(blossom)) {
deba@338
   926
        _delta4->push(blossom, (*_blossom_data)[blossom].pot / 2 +
deba@338
   927
                     (*_blossom_data)[blossom].offset);
deba@338
   928
      }
deba@338
   929
    }
deba@338
   930
deba@338
   931
    void evenToMatched(int blossom, int tree) {
deba@338
   932
      if (!_blossom_set->trivial(blossom)) {
deba@338
   933
        (*_blossom_data)[blossom].pot += 2 * _delta_sum;
deba@338
   934
      }
deba@338
   935
deba@338
   936
      for (typename BlossomSet::ItemIt n(*_blossom_set, blossom);
deba@338
   937
           n != INVALID; ++n) {
deba@338
   938
        int ni = (*_node_index)[n];
deba@338
   939
        (*_node_data)[ni].pot -= _delta_sum;
deba@338
   940
deba@338
   941
        _delta1->erase(n);
deba@338
   942
deba@338
   943
        for (InArcIt e(_graph, n); e != INVALID; ++e) {
deba@338
   944
          Node v = _graph.source(e);
deba@338
   945
          int vb = _blossom_set->find(v);
deba@338
   946
          int vi = (*_node_index)[v];
deba@338
   947
deba@338
   948
          Value rw = (*_node_data)[ni].pot + (*_node_data)[vi].pot -
deba@338
   949
            dualScale * _weight[e];
deba@338
   950
deba@338
   951
          if (vb == blossom) {
deba@338
   952
            if (_delta3->state(e) == _delta3->IN_HEAP) {
deba@338
   953
              _delta3->erase(e);
deba@338
   954
            }
deba@338
   955
          } else if ((*_blossom_data)[vb].status == EVEN) {
deba@338
   956
deba@338
   957
            if (_delta3->state(e) == _delta3->IN_HEAP) {
deba@338
   958
              _delta3->erase(e);
deba@338
   959
            }
deba@338
   960
deba@338
   961
            int vt = _tree_set->find(vb);
deba@338
   962
deba@338
   963
            if (vt != tree) {
deba@338
   964
deba@338
   965
              Arc r = _graph.oppositeArc(e);
deba@338
   966
deba@338
   967
              typename std::map<int, Arc>::iterator it =
deba@338
   968
                (*_node_data)[ni].heap_index.find(vt);
deba@338
   969
deba@338
   970
              if (it != (*_node_data)[ni].heap_index.end()) {
deba@338
   971
                if ((*_node_data)[ni].heap[it->second] > rw) {
deba@338
   972
                  (*_node_data)[ni].heap.replace(it->second, r);
deba@338
   973
                  (*_node_data)[ni].heap.decrease(r, rw);
deba@338
   974
                  it->second = r;
deba@338
   975
                }
deba@338
   976
              } else {
deba@338
   977
                (*_node_data)[ni].heap.push(r, rw);
deba@338
   978
                (*_node_data)[ni].heap_index.insert(std::make_pair(vt, r));
deba@338
   979
              }
deba@338
   980
deba@338
   981
              if ((*_blossom_set)[n] > (*_node_data)[ni].heap.prio()) {
deba@338
   982
                _blossom_set->decrease(n, (*_node_data)[ni].heap.prio());
deba@338
   983
deba@338
   984
                if (_delta2->state(blossom) != _delta2->IN_HEAP) {
deba@338
   985
                  _delta2->push(blossom, _blossom_set->classPrio(blossom) -
deba@338
   986
                               (*_blossom_data)[blossom].offset);
deba@338
   987
                } else if ((*_delta2)[blossom] >
deba@338
   988
                           _blossom_set->classPrio(blossom) -
deba@338
   989
                           (*_blossom_data)[blossom].offset){
deba@338
   990
                  _delta2->decrease(blossom, _blossom_set->classPrio(blossom) -
deba@338
   991
                                   (*_blossom_data)[blossom].offset);
deba@338
   992
                }
deba@338
   993
              }
deba@338
   994
            }
deba@338
   995
deba@338
   996
          } else if ((*_blossom_data)[vb].status == UNMATCHED) {
deba@338
   997
            if (_delta3->state(e) == _delta3->IN_HEAP) {
deba@338
   998
              _delta3->erase(e);
deba@338
   999
            }
deba@338
  1000
          } else {
deba@338
  1001
deba@338
  1002
            typename std::map<int, Arc>::iterator it =
deba@338
  1003
              (*_node_data)[vi].heap_index.find(tree);
deba@338
  1004
deba@338
  1005
            if (it != (*_node_data)[vi].heap_index.end()) {
deba@338
  1006
              (*_node_data)[vi].heap.erase(it->second);
deba@338
  1007
              (*_node_data)[vi].heap_index.erase(it);
deba@338
  1008
              if ((*_node_data)[vi].heap.empty()) {
deba@338
  1009
                _blossom_set->increase(v, std::numeric_limits<Value>::max());
deba@338
  1010
              } else if ((*_blossom_set)[v] < (*_node_data)[vi].heap.prio()) {
deba@338
  1011
                _blossom_set->increase(v, (*_node_data)[vi].heap.prio());
deba@338
  1012
              }
deba@338
  1013
deba@338
  1014
              if ((*_blossom_data)[vb].status == MATCHED) {
deba@338
  1015
                if (_blossom_set->classPrio(vb) ==
deba@338
  1016
                    std::numeric_limits<Value>::max()) {
deba@338
  1017
                  _delta2->erase(vb);
deba@338
  1018
                } else if ((*_delta2)[vb] < _blossom_set->classPrio(vb) -
deba@338
  1019
                           (*_blossom_data)[vb].offset) {
deba@338
  1020
                  _delta2->increase(vb, _blossom_set->classPrio(vb) -
deba@338
  1021
                                   (*_blossom_data)[vb].offset);
deba@338
  1022
                }
deba@338
  1023
              }
deba@338
  1024
            }
deba@338
  1025
          }
deba@338
  1026
        }
deba@338
  1027
      }
deba@338
  1028
    }
deba@338
  1029
deba@338
  1030
    void oddToMatched(int blossom) {
deba@338
  1031
      (*_blossom_data)[blossom].offset -= _delta_sum;
deba@338
  1032
deba@338
  1033
      if (_blossom_set->classPrio(blossom) !=
deba@338
  1034
          std::numeric_limits<Value>::max()) {
deba@338
  1035
        _delta2->push(blossom, _blossom_set->classPrio(blossom) -
deba@338
  1036
                       (*_blossom_data)[blossom].offset);
deba@338
  1037
      }
deba@338
  1038
deba@338
  1039
      if (!_blossom_set->trivial(blossom)) {
deba@338
  1040
        _delta4->erase(blossom);
deba@338
  1041
      }
deba@338
  1042
    }
deba@338
  1043
deba@338
  1044
    void oddToEven(int blossom, int tree) {
deba@338
  1045
      if (!_blossom_set->trivial(blossom)) {
deba@338
  1046
        _delta4->erase(blossom);
deba@338
  1047
        (*_blossom_data)[blossom].pot -=
deba@338
  1048
          2 * (2 * _delta_sum - (*_blossom_data)[blossom].offset);
deba@338
  1049
      }
deba@338
  1050
deba@338
  1051
      for (typename BlossomSet::ItemIt n(*_blossom_set, blossom);
deba@338
  1052
           n != INVALID; ++n) {
deba@338
  1053
        int ni = (*_node_index)[n];
deba@338
  1054
deba@338
  1055
        _blossom_set->increase(n, std::numeric_limits<Value>::max());
deba@338
  1056
deba@338
  1057
        (*_node_data)[ni].heap.clear();
deba@338
  1058
        (*_node_data)[ni].heap_index.clear();
deba@338
  1059
        (*_node_data)[ni].pot +=
deba@338
  1060
          2 * _delta_sum - (*_blossom_data)[blossom].offset;
deba@338
  1061
deba@338
  1062
        _delta1->push(n, (*_node_data)[ni].pot);
deba@338
  1063
deba@338
  1064
        for (InArcIt e(_graph, n); e != INVALID; ++e) {
deba@338
  1065
          Node v = _graph.source(e);
deba@338
  1066
          int vb = _blossom_set->find(v);
deba@338
  1067
          int vi = (*_node_index)[v];
deba@338
  1068
deba@338
  1069
          Value rw = (*_node_data)[ni].pot + (*_node_data)[vi].pot -
deba@338
  1070
            dualScale * _weight[e];
deba@338
  1071
deba@338
  1072
          if ((*_blossom_data)[vb].status == EVEN) {
deba@338
  1073
            if (_delta3->state(e) != _delta3->IN_HEAP && blossom != vb) {
deba@338
  1074
              _delta3->push(e, rw / 2);
deba@338
  1075
            }
deba@338
  1076
          } else if ((*_blossom_data)[vb].status == UNMATCHED) {
deba@338
  1077
            if (_delta3->state(e) != _delta3->IN_HEAP) {
deba@338
  1078
              _delta3->push(e, rw);
deba@338
  1079
            }
deba@338
  1080
          } else {
deba@338
  1081
deba@338
  1082
            typename std::map<int, Arc>::iterator it =
deba@338
  1083
              (*_node_data)[vi].heap_index.find(tree);
deba@338
  1084
deba@338
  1085
            if (it != (*_node_data)[vi].heap_index.end()) {
deba@338
  1086
              if ((*_node_data)[vi].heap[it->second] > rw) {
deba@338
  1087
                (*_node_data)[vi].heap.replace(it->second, e);
deba@338
  1088
                (*_node_data)[vi].heap.decrease(e, rw);
deba@338
  1089
                it->second = e;
deba@338
  1090
              }
deba@338
  1091
            } else {
deba@338
  1092
              (*_node_data)[vi].heap.push(e, rw);
deba@338
  1093
              (*_node_data)[vi].heap_index.insert(std::make_pair(tree, e));
deba@338
  1094
            }
deba@338
  1095
deba@338
  1096
            if ((*_blossom_set)[v] > (*_node_data)[vi].heap.prio()) {
deba@338
  1097
              _blossom_set->decrease(v, (*_node_data)[vi].heap.prio());
deba@338
  1098
deba@338
  1099
              if ((*_blossom_data)[vb].status == MATCHED) {
deba@338
  1100
                if (_delta2->state(vb) != _delta2->IN_HEAP) {
deba@338
  1101
                  _delta2->push(vb, _blossom_set->classPrio(vb) -
deba@338
  1102
                               (*_blossom_data)[vb].offset);
deba@338
  1103
                } else if ((*_delta2)[vb] > _blossom_set->classPrio(vb) -
deba@338
  1104
                           (*_blossom_data)[vb].offset) {
deba@338
  1105
                  _delta2->decrease(vb, _blossom_set->classPrio(vb) -
deba@338
  1106
                                   (*_blossom_data)[vb].offset);
deba@338
  1107
                }
deba@338
  1108
              }
deba@338
  1109
            }
deba@338
  1110
          }
deba@338
  1111
        }
deba@338
  1112
      }
deba@338
  1113
      (*_blossom_data)[blossom].offset = 0;
deba@338
  1114
    }
deba@338
  1115
deba@338
  1116
deba@338
  1117
    void matchedToUnmatched(int blossom) {
deba@338
  1118
      if (_delta2->state(blossom) == _delta2->IN_HEAP) {
deba@338
  1119
        _delta2->erase(blossom);
deba@338
  1120
      }
deba@338
  1121
deba@338
  1122
      for (typename BlossomSet::ItemIt n(*_blossom_set, blossom);
deba@338
  1123
           n != INVALID; ++n) {
deba@338
  1124
        int ni = (*_node_index)[n];
deba@338
  1125
deba@338
  1126
        _blossom_set->increase(n, std::numeric_limits<Value>::max());
deba@338
  1127
deba@338
  1128
        (*_node_data)[ni].heap.clear();
deba@338
  1129
        (*_node_data)[ni].heap_index.clear();
deba@338
  1130
deba@338
  1131
        for (OutArcIt e(_graph, n); e != INVALID; ++e) {
deba@338
  1132
          Node v = _graph.target(e);
deba@338
  1133
          int vb = _blossom_set->find(v);
deba@338
  1134
          int vi = (*_node_index)[v];
deba@338
  1135
deba@338
  1136
          Value rw = (*_node_data)[ni].pot + (*_node_data)[vi].pot -
deba@338
  1137
            dualScale * _weight[e];
deba@338
  1138
deba@338
  1139
          if ((*_blossom_data)[vb].status == EVEN) {
deba@338
  1140
            if (_delta3->state(e) != _delta3->IN_HEAP) {
deba@338
  1141
              _delta3->push(e, rw);
deba@338
  1142
            }
deba@338
  1143
          }
deba@338
  1144
        }
deba@338
  1145
      }
deba@338
  1146
    }
deba@338
  1147
deba@338
  1148
    void unmatchedToMatched(int blossom) {
deba@338
  1149
      for (typename BlossomSet::ItemIt n(*_blossom_set, blossom);
deba@338
  1150
           n != INVALID; ++n) {
deba@338
  1151
        int ni = (*_node_index)[n];
deba@338
  1152
deba@338
  1153
        for (InArcIt e(_graph, n); e != INVALID; ++e) {
deba@338
  1154
          Node v = _graph.source(e);
deba@338
  1155
          int vb = _blossom_set->find(v);
deba@338
  1156
          int vi = (*_node_index)[v];
deba@338
  1157
deba@338
  1158
          Value rw = (*_node_data)[ni].pot + (*_node_data)[vi].pot -
deba@338
  1159
            dualScale * _weight[e];
deba@338
  1160
deba@338
  1161
          if (vb == blossom) {
deba@338
  1162
            if (_delta3->state(e) == _delta3->IN_HEAP) {
deba@338
  1163
              _delta3->erase(e);
deba@338
  1164
            }
deba@338
  1165
          } else if ((*_blossom_data)[vb].status == EVEN) {
deba@338
  1166
deba@338
  1167
            if (_delta3->state(e) == _delta3->IN_HEAP) {
deba@338
  1168
              _delta3->erase(e);
deba@338
  1169
            }
deba@338
  1170
deba@338
  1171
            int vt = _tree_set->find(vb);
deba@338
  1172
deba@338
  1173
            Arc r = _graph.oppositeArc(e);
deba@338
  1174
deba@338
  1175
            typename std::map<int, Arc>::iterator it =
deba@338
  1176
              (*_node_data)[ni].heap_index.find(vt);
deba@338
  1177
deba@338
  1178
            if (it != (*_node_data)[ni].heap_index.end()) {
deba@338
  1179
              if ((*_node_data)[ni].heap[it->second] > rw) {
deba@338
  1180
                (*_node_data)[ni].heap.replace(it->second, r);
deba@338
  1181
                (*_node_data)[ni].heap.decrease(r, rw);
deba@338
  1182
                it->second = r;
deba@338
  1183
              }
deba@338
  1184
            } else {
deba@338
  1185
              (*_node_data)[ni].heap.push(r, rw);
deba@338
  1186
              (*_node_data)[ni].heap_index.insert(std::make_pair(vt, r));
deba@338
  1187
            }
deba@338
  1188
deba@338
  1189
            if ((*_blossom_set)[n] > (*_node_data)[ni].heap.prio()) {
deba@338
  1190
              _blossom_set->decrease(n, (*_node_data)[ni].heap.prio());
deba@338
  1191
deba@338
  1192
              if (_delta2->state(blossom) != _delta2->IN_HEAP) {
deba@338
  1193
                _delta2->push(blossom, _blossom_set->classPrio(blossom) -
deba@338
  1194
                             (*_blossom_data)[blossom].offset);
deba@338
  1195
              } else if ((*_delta2)[blossom] > _blossom_set->classPrio(blossom)-
deba@338
  1196
                         (*_blossom_data)[blossom].offset){
deba@338
  1197
                _delta2->decrease(blossom, _blossom_set->classPrio(blossom) -
deba@338
  1198
                                 (*_blossom_data)[blossom].offset);
deba@338
  1199
              }
deba@338
  1200
            }
deba@338
  1201
deba@338
  1202
          } else if ((*_blossom_data)[vb].status == UNMATCHED) {
deba@338
  1203
            if (_delta3->state(e) == _delta3->IN_HEAP) {
deba@338
  1204
              _delta3->erase(e);
deba@338
  1205
            }
deba@338
  1206
          }
deba@338
  1207
        }
deba@338
  1208
      }
deba@338
  1209
    }
deba@338
  1210
deba@338
  1211
    void alternatePath(int even, int tree) {
deba@338
  1212
      int odd;
deba@338
  1213
deba@338
  1214
      evenToMatched(even, tree);
deba@338
  1215
      (*_blossom_data)[even].status = MATCHED;
deba@338
  1216
deba@338
  1217
      while ((*_blossom_data)[even].pred != INVALID) {
deba@338
  1218
        odd = _blossom_set->find(_graph.target((*_blossom_data)[even].pred));
deba@338
  1219
        (*_blossom_data)[odd].status = MATCHED;
deba@338
  1220
        oddToMatched(odd);
deba@338
  1221
        (*_blossom_data)[odd].next = (*_blossom_data)[odd].pred;
deba@338
  1222
deba@338
  1223
        even = _blossom_set->find(_graph.target((*_blossom_data)[odd].pred));
deba@338
  1224
        (*_blossom_data)[even].status = MATCHED;
deba@338
  1225
        evenToMatched(even, tree);
deba@338
  1226
        (*_blossom_data)[even].next =
deba@338
  1227
          _graph.oppositeArc((*_blossom_data)[odd].pred);
deba@338
  1228
      }
deba@338
  1229
deba@338
  1230
    }
deba@338
  1231
deba@338
  1232
    void destroyTree(int tree) {
deba@338
  1233
      for (TreeSet::ItemIt b(*_tree_set, tree); b != INVALID; ++b) {
deba@338
  1234
        if ((*_blossom_data)[b].status == EVEN) {
deba@338
  1235
          (*_blossom_data)[b].status = MATCHED;
deba@338
  1236
          evenToMatched(b, tree);
deba@338
  1237
        } else if ((*_blossom_data)[b].status == ODD) {
deba@338
  1238
          (*_blossom_data)[b].status = MATCHED;
deba@338
  1239
          oddToMatched(b);
deba@338
  1240
        }
deba@338
  1241
      }
deba@338
  1242
      _tree_set->eraseClass(tree);
deba@338
  1243
    }
deba@338
  1244
deba@338
  1245
deba@338
  1246
    void unmatchNode(const Node& node) {
deba@338
  1247
      int blossom = _blossom_set->find(node);
deba@338
  1248
      int tree = _tree_set->find(blossom);
deba@338
  1249
deba@338
  1250
      alternatePath(blossom, tree);
deba@338
  1251
      destroyTree(tree);
deba@338
  1252
deba@338
  1253
      (*_blossom_data)[blossom].status = UNMATCHED;
deba@338
  1254
      (*_blossom_data)[blossom].base = node;
deba@338
  1255
      matchedToUnmatched(blossom);
deba@338
  1256
    }
deba@338
  1257
deba@338
  1258
deba@339
  1259
    void augmentOnEdge(const Edge& edge) {
deba@339
  1260
deba@339
  1261
      int left = _blossom_set->find(_graph.u(edge));
deba@339
  1262
      int right = _blossom_set->find(_graph.v(edge));
deba@338
  1263
deba@338
  1264
      if ((*_blossom_data)[left].status == EVEN) {
deba@338
  1265
        int left_tree = _tree_set->find(left);
deba@338
  1266
        alternatePath(left, left_tree);
deba@338
  1267
        destroyTree(left_tree);
deba@338
  1268
      } else {
deba@338
  1269
        (*_blossom_data)[left].status = MATCHED;
deba@338
  1270
        unmatchedToMatched(left);
deba@338
  1271
      }
deba@338
  1272
deba@338
  1273
      if ((*_blossom_data)[right].status == EVEN) {
deba@338
  1274
        int right_tree = _tree_set->find(right);
deba@338
  1275
        alternatePath(right, right_tree);
deba@338
  1276
        destroyTree(right_tree);
deba@338
  1277
      } else {
deba@338
  1278
        (*_blossom_data)[right].status = MATCHED;
deba@338
  1279
        unmatchedToMatched(right);
deba@338
  1280
      }
deba@338
  1281
deba@339
  1282
      (*_blossom_data)[left].next = _graph.direct(edge, true);
deba@339
  1283
      (*_blossom_data)[right].next = _graph.direct(edge, false);
deba@338
  1284
    }
deba@338
  1285
deba@338
  1286
    void extendOnArc(const Arc& arc) {
deba@338
  1287
      int base = _blossom_set->find(_graph.target(arc));
deba@338
  1288
      int tree = _tree_set->find(base);
deba@338
  1289
deba@338
  1290
      int odd = _blossom_set->find(_graph.source(arc));
deba@338
  1291
      _tree_set->insert(odd, tree);
deba@338
  1292
      (*_blossom_data)[odd].status = ODD;
deba@338
  1293
      matchedToOdd(odd);
deba@338
  1294
      (*_blossom_data)[odd].pred = arc;
deba@338
  1295
deba@338
  1296
      int even = _blossom_set->find(_graph.target((*_blossom_data)[odd].next));
deba@338
  1297
      (*_blossom_data)[even].pred = (*_blossom_data)[even].next;
deba@338
  1298
      _tree_set->insert(even, tree);
deba@338
  1299
      (*_blossom_data)[even].status = EVEN;
deba@338
  1300
      matchedToEven(even, tree);
deba@338
  1301
    }
deba@338
  1302
deba@339
  1303
    void shrinkOnEdge(const Edge& edge, int tree) {
deba@338
  1304
      int nca = -1;
deba@338
  1305
      std::vector<int> left_path, right_path;
deba@338
  1306
deba@338
  1307
      {
deba@338
  1308
        std::set<int> left_set, right_set;
deba@338
  1309
        int left = _blossom_set->find(_graph.u(edge));
deba@338
  1310
        left_path.push_back(left);
deba@338
  1311
        left_set.insert(left);
deba@338
  1312
deba@338
  1313
        int right = _blossom_set->find(_graph.v(edge));
deba@338
  1314
        right_path.push_back(right);
deba@338
  1315
        right_set.insert(right);
deba@338
  1316
deba@338
  1317
        while (true) {
deba@338
  1318
deba@338
  1319
          if ((*_blossom_data)[left].pred == INVALID) break;
deba@338
  1320
deba@338
  1321
          left =
deba@338
  1322
            _blossom_set->find(_graph.target((*_blossom_data)[left].pred));
deba@338
  1323
          left_path.push_back(left);
deba@338
  1324
          left =
deba@338
  1325
            _blossom_set->find(_graph.target((*_blossom_data)[left].pred));
deba@338
  1326
          left_path.push_back(left);
deba@338
  1327
deba@338
  1328
          left_set.insert(left);
deba@338
  1329
deba@338
  1330
          if (right_set.find(left) != right_set.end()) {
deba@338
  1331
            nca = left;
deba@338
  1332
            break;
deba@338
  1333
          }
deba@338
  1334
deba@338
  1335
          if ((*_blossom_data)[right].pred == INVALID) break;
deba@338
  1336
deba@338
  1337
          right =
deba@338
  1338
            _blossom_set->find(_graph.target((*_blossom_data)[right].pred));
deba@338
  1339
          right_path.push_back(right);
deba@338
  1340
          right =
deba@338
  1341
            _blossom_set->find(_graph.target((*_blossom_data)[right].pred));
deba@338
  1342
          right_path.push_back(right);
deba@338
  1343
deba@338
  1344
          right_set.insert(right);
deba@338
  1345
deba@338
  1346
          if (left_set.find(right) != left_set.end()) {
deba@338
  1347
            nca = right;
deba@338
  1348
            break;
deba@338
  1349
          }
deba@338
  1350
deba@338
  1351
        }
deba@338
  1352
deba@338
  1353
        if (nca == -1) {
deba@338
  1354
          if ((*_blossom_data)[left].pred == INVALID) {
deba@338
  1355
            nca = right;
deba@338
  1356
            while (left_set.find(nca) == left_set.end()) {
deba@338
  1357
              nca =
deba@338
  1358
                _blossom_set->find(_graph.target((*_blossom_data)[nca].pred));
deba@338
  1359
              right_path.push_back(nca);
deba@338
  1360
              nca =
deba@338
  1361
                _blossom_set->find(_graph.target((*_blossom_data)[nca].pred));
deba@338
  1362
              right_path.push_back(nca);
deba@338
  1363
            }
deba@338
  1364
          } else {
deba@338
  1365
            nca = left;
deba@338
  1366
            while (right_set.find(nca) == right_set.end()) {
deba@338
  1367
              nca =
deba@338
  1368
                _blossom_set->find(_graph.target((*_blossom_data)[nca].pred));
deba@338
  1369
              left_path.push_back(nca);
deba@338
  1370
              nca =
deba@338
  1371
                _blossom_set->find(_graph.target((*_blossom_data)[nca].pred));
deba@338
  1372
              left_path.push_back(nca);
deba@338
  1373
            }
deba@338
  1374
          }
deba@338
  1375
        }
deba@338
  1376
      }
deba@338
  1377
deba@338
  1378
      std::vector<int> subblossoms;
deba@338
  1379
      Arc prev;
deba@338
  1380
deba@338
  1381
      prev = _graph.direct(edge, true);
deba@338
  1382
      for (int i = 0; left_path[i] != nca; i += 2) {
deba@338
  1383
        subblossoms.push_back(left_path[i]);
deba@338
  1384
        (*_blossom_data)[left_path[i]].next = prev;
deba@338
  1385
        _tree_set->erase(left_path[i]);
deba@338
  1386
deba@338
  1387
        subblossoms.push_back(left_path[i + 1]);
deba@338
  1388
        (*_blossom_data)[left_path[i + 1]].status = EVEN;
deba@338
  1389
        oddToEven(left_path[i + 1], tree);
deba@338
  1390
        _tree_set->erase(left_path[i + 1]);
deba@338
  1391
        prev = _graph.oppositeArc((*_blossom_data)[left_path[i + 1]].pred);
deba@338
  1392
      }
deba@338
  1393
deba@338
  1394
      int k = 0;
deba@338
  1395
      while (right_path[k] != nca) ++k;
deba@338
  1396
deba@338
  1397
      subblossoms.push_back(nca);
deba@338
  1398
      (*_blossom_data)[nca].next = prev;
deba@338
  1399
deba@338
  1400
      for (int i = k - 2; i >= 0; i -= 2) {
deba@338
  1401
        subblossoms.push_back(right_path[i + 1]);
deba@338
  1402
        (*_blossom_data)[right_path[i + 1]].status = EVEN;
deba@338
  1403
        oddToEven(right_path[i + 1], tree);
deba@338
  1404
        _tree_set->erase(right_path[i + 1]);
deba@338
  1405
deba@338
  1406
        (*_blossom_data)[right_path[i + 1]].next =
deba@338
  1407
          (*_blossom_data)[right_path[i + 1]].pred;
deba@338
  1408
deba@338
  1409
        subblossoms.push_back(right_path[i]);
deba@338
  1410
        _tree_set->erase(right_path[i]);
deba@338
  1411
      }
deba@338
  1412
deba@338
  1413
      int surface =
deba@338
  1414
        _blossom_set->join(subblossoms.begin(), subblossoms.end());
deba@338
  1415
deba@338
  1416
      for (int i = 0; i < int(subblossoms.size()); ++i) {
deba@338
  1417
        if (!_blossom_set->trivial(subblossoms[i])) {
deba@338
  1418
          (*_blossom_data)[subblossoms[i]].pot += 2 * _delta_sum;
deba@338
  1419
        }
deba@338
  1420
        (*_blossom_data)[subblossoms[i]].status = MATCHED;
deba@338
  1421
      }
deba@338
  1422
deba@338
  1423
      (*_blossom_data)[surface].pot = -2 * _delta_sum;
deba@338
  1424
      (*_blossom_data)[surface].offset = 0;
deba@338
  1425
      (*_blossom_data)[surface].status = EVEN;
deba@338
  1426
      (*_blossom_data)[surface].pred = (*_blossom_data)[nca].pred;
deba@338
  1427
      (*_blossom_data)[surface].next = (*_blossom_data)[nca].pred;
deba@338
  1428
deba@338
  1429
      _tree_set->insert(surface, tree);
deba@338
  1430
      _tree_set->erase(nca);
deba@338
  1431
    }
deba@338
  1432
deba@338
  1433
    void splitBlossom(int blossom) {
deba@338
  1434
      Arc next = (*_blossom_data)[blossom].next;
deba@338
  1435
      Arc pred = (*_blossom_data)[blossom].pred;
deba@338
  1436
deba@338
  1437
      int tree = _tree_set->find(blossom);
deba@338
  1438
deba@338
  1439
      (*_blossom_data)[blossom].status = MATCHED;
deba@338
  1440
      oddToMatched(blossom);
deba@338
  1441
      if (_delta2->state(blossom) == _delta2->IN_HEAP) {
deba@338
  1442
        _delta2->erase(blossom);
deba@338
  1443
      }
deba@338
  1444
deba@338
  1445
      std::vector<int> subblossoms;
deba@338
  1446
      _blossom_set->split(blossom, std::back_inserter(subblossoms));
deba@338
  1447
deba@338
  1448
      Value offset = (*_blossom_data)[blossom].offset;
deba@338
  1449
      int b = _blossom_set->find(_graph.source(pred));
deba@338
  1450
      int d = _blossom_set->find(_graph.source(next));
deba@338
  1451
deba@338
  1452
      int ib = -1, id = -1;
deba@338
  1453
      for (int i = 0; i < int(subblossoms.size()); ++i) {
deba@338
  1454
        if (subblossoms[i] == b) ib = i;
deba@338
  1455
        if (subblossoms[i] == d) id = i;
deba@338
  1456
deba@338
  1457
        (*_blossom_data)[subblossoms[i]].offset = offset;
deba@338
  1458
        if (!_blossom_set->trivial(subblossoms[i])) {
deba@338
  1459
          (*_blossom_data)[subblossoms[i]].pot -= 2 * offset;
deba@338
  1460
        }
deba@338
  1461
        if (_blossom_set->classPrio(subblossoms[i]) !=
deba@338
  1462
            std::numeric_limits<Value>::max()) {
deba@338
  1463
          _delta2->push(subblossoms[i],
deba@338
  1464
                        _blossom_set->classPrio(subblossoms[i]) -
deba@338
  1465
                        (*_blossom_data)[subblossoms[i]].offset);
deba@338
  1466
        }
deba@338
  1467
      }
deba@338
  1468
deba@338
  1469
      if (id > ib ? ((id - ib) % 2 == 0) : ((ib - id) % 2 == 1)) {
deba@338
  1470
        for (int i = (id + 1) % subblossoms.size();
deba@338
  1471
             i != ib; i = (i + 2) % subblossoms.size()) {
deba@338
  1472
          int sb = subblossoms[i];
deba@338
  1473
          int tb = subblossoms[(i + 1) % subblossoms.size()];
deba@338
  1474
          (*_blossom_data)[sb].next =
deba@338
  1475
            _graph.oppositeArc((*_blossom_data)[tb].next);
deba@338
  1476
        }
deba@338
  1477
deba@338
  1478
        for (int i = ib; i != id; i = (i + 2) % subblossoms.size()) {
deba@338
  1479
          int sb = subblossoms[i];
deba@338
  1480
          int tb = subblossoms[(i + 1) % subblossoms.size()];
deba@338
  1481
          int ub = subblossoms[(i + 2) % subblossoms.size()];
deba@338
  1482
deba@338
  1483
          (*_blossom_data)[sb].status = ODD;
deba@338
  1484
          matchedToOdd(sb);
deba@338
  1485
          _tree_set->insert(sb, tree);
deba@338
  1486
          (*_blossom_data)[sb].pred = pred;
deba@338
  1487
          (*_blossom_data)[sb].next =
deba@338
  1488
                           _graph.oppositeArc((*_blossom_data)[tb].next);
deba@338
  1489
deba@338
  1490
          pred = (*_blossom_data)[ub].next;
deba@338
  1491
deba@338
  1492
          (*_blossom_data)[tb].status = EVEN;
deba@338
  1493
          matchedToEven(tb, tree);
deba@338
  1494
          _tree_set->insert(tb, tree);
deba@338
  1495
          (*_blossom_data)[tb].pred = (*_blossom_data)[tb].next;
deba@338
  1496
        }
deba@338
  1497
deba@338
  1498
        (*_blossom_data)[subblossoms[id]].status = ODD;
deba@338
  1499
        matchedToOdd(subblossoms[id]);
deba@338
  1500
        _tree_set->insert(subblossoms[id], tree);
deba@338
  1501
        (*_blossom_data)[subblossoms[id]].next = next;
deba@338
  1502
        (*_blossom_data)[subblossoms[id]].pred = pred;
deba@338
  1503
deba@338
  1504
      } else {
deba@338
  1505
deba@338
  1506
        for (int i = (ib + 1) % subblossoms.size();
deba@338
  1507
             i != id; i = (i + 2) % subblossoms.size()) {
deba@338
  1508
          int sb = subblossoms[i];
deba@338
  1509
          int tb = subblossoms[(i + 1) % subblossoms.size()];
deba@338
  1510
          (*_blossom_data)[sb].next =
deba@338
  1511
            _graph.oppositeArc((*_blossom_data)[tb].next);
deba@338
  1512
        }
deba@338
  1513
deba@338
  1514
        for (int i = id; i != ib; i = (i + 2) % subblossoms.size()) {
deba@338
  1515
          int sb = subblossoms[i];
deba@338
  1516
          int tb = subblossoms[(i + 1) % subblossoms.size()];
deba@338
  1517
          int ub = subblossoms[(i + 2) % subblossoms.size()];
deba@338
  1518
deba@338
  1519
          (*_blossom_data)[sb].status = ODD;
deba@338
  1520
          matchedToOdd(sb);
deba@338
  1521
          _tree_set->insert(sb, tree);
deba@338
  1522
          (*_blossom_data)[sb].next = next;
deba@338
  1523
          (*_blossom_data)[sb].pred =
deba@338
  1524
            _graph.oppositeArc((*_blossom_data)[tb].next);
deba@338
  1525
deba@338
  1526
          (*_blossom_data)[tb].status = EVEN;
deba@338
  1527
          matchedToEven(tb, tree);
deba@338
  1528
          _tree_set->insert(tb, tree);
deba@338
  1529
          (*_blossom_data)[tb].pred =
deba@338
  1530
            (*_blossom_data)[tb].next =
deba@338
  1531
            _graph.oppositeArc((*_blossom_data)[ub].next);
deba@338
  1532
          next = (*_blossom_data)[ub].next;
deba@338
  1533
        }
deba@338
  1534
deba@338
  1535
        (*_blossom_data)[subblossoms[ib]].status = ODD;
deba@338
  1536
        matchedToOdd(subblossoms[ib]);
deba@338
  1537
        _tree_set->insert(subblossoms[ib], tree);
deba@338
  1538
        (*_blossom_data)[subblossoms[ib]].next = next;
deba@338
  1539
        (*_blossom_data)[subblossoms[ib]].pred = pred;
deba@338
  1540
      }
deba@338
  1541
      _tree_set->erase(blossom);
deba@338
  1542
    }
deba@338
  1543
deba@338
  1544
    void extractBlossom(int blossom, const Node& base, const Arc& matching) {
deba@338
  1545
      if (_blossom_set->trivial(blossom)) {
deba@338
  1546
        int bi = (*_node_index)[base];
deba@338
  1547
        Value pot = (*_node_data)[bi].pot;
deba@338
  1548
deba@338
  1549
        _matching->set(base, matching);
deba@338
  1550
        _blossom_node_list.push_back(base);
deba@338
  1551
        _node_potential->set(base, pot);
deba@338
  1552
      } else {
deba@338
  1553
deba@338
  1554
        Value pot = (*_blossom_data)[blossom].pot;
deba@338
  1555
        int bn = _blossom_node_list.size();
deba@338
  1556
deba@338
  1557
        std::vector<int> subblossoms;
deba@338
  1558
        _blossom_set->split(blossom, std::back_inserter(subblossoms));
deba@338
  1559
        int b = _blossom_set->find(base);
deba@338
  1560
        int ib = -1;
deba@338
  1561
        for (int i = 0; i < int(subblossoms.size()); ++i) {
deba@338
  1562
          if (subblossoms[i] == b) { ib = i; break; }
deba@338
  1563
        }
deba@338
  1564
deba@338
  1565
        for (int i = 1; i < int(subblossoms.size()); i += 2) {
deba@338
  1566
          int sb = subblossoms[(ib + i) % subblossoms.size()];
deba@338
  1567
          int tb = subblossoms[(ib + i + 1) % subblossoms.size()];
deba@338
  1568
deba@338
  1569
          Arc m = (*_blossom_data)[tb].next;
deba@338
  1570
          extractBlossom(sb, _graph.target(m), _graph.oppositeArc(m));
deba@338
  1571
          extractBlossom(tb, _graph.source(m), m);
deba@338
  1572
        }
deba@338
  1573
        extractBlossom(subblossoms[ib], base, matching);
deba@338
  1574
deba@338
  1575
        int en = _blossom_node_list.size();
deba@338
  1576
deba@338
  1577
        _blossom_potential.push_back(BlossomVariable(bn, en, pot));
deba@338
  1578
      }
deba@338
  1579
    }
deba@338
  1580
deba@338
  1581
    void extractMatching() {
deba@338
  1582
      std::vector<int> blossoms;
deba@338
  1583
      for (typename BlossomSet::ClassIt c(*_blossom_set); c != INVALID; ++c) {
deba@338
  1584
        blossoms.push_back(c);
deba@338
  1585
      }
deba@338
  1586
deba@338
  1587
      for (int i = 0; i < int(blossoms.size()); ++i) {
deba@338
  1588
        if ((*_blossom_data)[blossoms[i]].status == MATCHED) {
deba@338
  1589
deba@338
  1590
          Value offset = (*_blossom_data)[blossoms[i]].offset;
deba@338
  1591
          (*_blossom_data)[blossoms[i]].pot += 2 * offset;
deba@338
  1592
          for (typename BlossomSet::ItemIt n(*_blossom_set, blossoms[i]);
deba@338
  1593
               n != INVALID; ++n) {
deba@338
  1594
            (*_node_data)[(*_node_index)[n]].pot -= offset;
deba@338
  1595
          }
deba@338
  1596
deba@338
  1597
          Arc matching = (*_blossom_data)[blossoms[i]].next;
deba@338
  1598
          Node base = _graph.source(matching);
deba@338
  1599
          extractBlossom(blossoms[i], base, matching);
deba@338
  1600
        } else {
deba@338
  1601
          Node base = (*_blossom_data)[blossoms[i]].base;
deba@338
  1602
          extractBlossom(blossoms[i], base, INVALID);
deba@338
  1603
        }
deba@338
  1604
      }
deba@338
  1605
    }
deba@338
  1606
deba@338
  1607
  public:
deba@338
  1608
deba@338
  1609
    /// \brief Constructor
deba@338
  1610
    ///
deba@338
  1611
    /// Constructor.
deba@338
  1612
    MaxWeightedMatching(const Graph& graph, const WeightMap& weight)
deba@338
  1613
      : _graph(graph), _weight(weight), _matching(0),
deba@338
  1614
        _node_potential(0), _blossom_potential(), _blossom_node_list(),
deba@338
  1615
        _node_num(0), _blossom_num(0),
deba@338
  1616
deba@338
  1617
        _blossom_index(0), _blossom_set(0), _blossom_data(0),
deba@338
  1618
        _node_index(0), _node_heap_index(0), _node_data(0),
deba@338
  1619
        _tree_set_index(0), _tree_set(0),
deba@338
  1620
deba@338
  1621
        _delta1_index(0), _delta1(0),
deba@338
  1622
        _delta2_index(0), _delta2(0),
deba@338
  1623
        _delta3_index(0), _delta3(0),
deba@338
  1624
        _delta4_index(0), _delta4(0),
deba@338
  1625
deba@338
  1626
        _delta_sum() {}
deba@338
  1627
deba@338
  1628
    ~MaxWeightedMatching() {
deba@338
  1629
      destroyStructures();
deba@338
  1630
    }
deba@338
  1631
deba@338
  1632
    /// \name Execution control
deba@338
  1633
    /// The simplest way to execute the algorithm is to use the member
deba@338
  1634
    /// \c run() member function.
deba@338
  1635
deba@338
  1636
    ///@{
deba@338
  1637
deba@338
  1638
    /// \brief Initialize the algorithm
deba@338
  1639
    ///
deba@338
  1640
    /// Initialize the algorithm
deba@338
  1641
    void init() {
deba@338
  1642
      createStructures();
deba@338
  1643
deba@338
  1644
      for (ArcIt e(_graph); e != INVALID; ++e) {
deba@339
  1645
        _node_heap_index->set(e, BinHeap<Value, IntArcMap>::PRE_HEAP);
deba@338
  1646
      }
deba@338
  1647
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@338
  1648
        _delta1_index->set(n, _delta1->PRE_HEAP);
deba@338
  1649
      }
deba@338
  1650
      for (EdgeIt e(_graph); e != INVALID; ++e) {
deba@338
  1651
        _delta3_index->set(e, _delta3->PRE_HEAP);
deba@338
  1652
      }
deba@338
  1653
      for (int i = 0; i < _blossom_num; ++i) {
deba@338
  1654
        _delta2_index->set(i, _delta2->PRE_HEAP);
deba@338
  1655
        _delta4_index->set(i, _delta4->PRE_HEAP);
deba@338
  1656
      }
deba@338
  1657
deba@338
  1658
      int index = 0;
deba@338
  1659
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@338
  1660
        Value max = 0;
deba@338
  1661
        for (OutArcIt e(_graph, n); e != INVALID; ++e) {
deba@338
  1662
          if (_graph.target(e) == n) continue;
deba@338
  1663
          if ((dualScale * _weight[e]) / 2 > max) {
deba@338
  1664
            max = (dualScale * _weight[e]) / 2;
deba@338
  1665
          }
deba@338
  1666
        }
deba@338
  1667
        _node_index->set(n, index);
deba@338
  1668
        (*_node_data)[index].pot = max;
deba@338
  1669
        _delta1->push(n, max);
deba@338
  1670
        int blossom =
deba@338
  1671
          _blossom_set->insert(n, std::numeric_limits<Value>::max());
deba@338
  1672
deba@338
  1673
        _tree_set->insert(blossom);
deba@338
  1674
deba@338
  1675
        (*_blossom_data)[blossom].status = EVEN;
deba@338
  1676
        (*_blossom_data)[blossom].pred = INVALID;
deba@338
  1677
        (*_blossom_data)[blossom].next = INVALID;
deba@338
  1678
        (*_blossom_data)[blossom].pot = 0;
deba@338
  1679
        (*_blossom_data)[blossom].offset = 0;
deba@338
  1680
        ++index;
deba@338
  1681
      }
deba@338
  1682
      for (EdgeIt e(_graph); e != INVALID; ++e) {
deba@338
  1683
        int si = (*_node_index)[_graph.u(e)];
deba@338
  1684
        int ti = (*_node_index)[_graph.v(e)];
deba@338
  1685
        if (_graph.u(e) != _graph.v(e)) {
deba@338
  1686
          _delta3->push(e, ((*_node_data)[si].pot + (*_node_data)[ti].pot -
deba@338
  1687
                            dualScale * _weight[e]) / 2);
deba@338
  1688
        }
deba@338
  1689
      }
deba@338
  1690
    }
deba@338
  1691
deba@338
  1692
    /// \brief Starts the algorithm
deba@338
  1693
    ///
deba@338
  1694
    /// Starts the algorithm
deba@338
  1695
    void start() {
deba@338
  1696
      enum OpType {
deba@338
  1697
        D1, D2, D3, D4
deba@338
  1698
      };
deba@338
  1699
deba@338
  1700
      int unmatched = _node_num;
deba@338
  1701
      while (unmatched > 0) {
deba@338
  1702
        Value d1 = !_delta1->empty() ?
deba@338
  1703
          _delta1->prio() : std::numeric_limits<Value>::max();
deba@338
  1704
deba@338
  1705
        Value d2 = !_delta2->empty() ?
deba@338
  1706
          _delta2->prio() : std::numeric_limits<Value>::max();
deba@338
  1707
deba@338
  1708
        Value d3 = !_delta3->empty() ?
deba@338
  1709
          _delta3->prio() : std::numeric_limits<Value>::max();
deba@338
  1710
deba@338
  1711
        Value d4 = !_delta4->empty() ?
deba@338
  1712
          _delta4->prio() : std::numeric_limits<Value>::max();
deba@338
  1713
deba@338
  1714
        _delta_sum = d1; OpType ot = D1;
deba@338
  1715
        if (d2 < _delta_sum) { _delta_sum = d2; ot = D2; }
deba@338
  1716
        if (d3 < _delta_sum) { _delta_sum = d3; ot = D3; }
deba@338
  1717
        if (d4 < _delta_sum) { _delta_sum = d4; ot = D4; }
deba@338
  1718
deba@338
  1719
deba@338
  1720
        switch (ot) {
deba@338
  1721
        case D1:
deba@338
  1722
          {
deba@338
  1723
            Node n = _delta1->top();
deba@338
  1724
            unmatchNode(n);
deba@338
  1725
            --unmatched;
deba@338
  1726
          }
deba@338
  1727
          break;
deba@338
  1728
        case D2:
deba@338
  1729
          {
deba@338
  1730
            int blossom = _delta2->top();
deba@338
  1731
            Node n = _blossom_set->classTop(blossom);
deba@338
  1732
            Arc e = (*_node_data)[(*_node_index)[n]].heap.top();
deba@338
  1733
            extendOnArc(e);
deba@338
  1734
          }
deba@338
  1735
          break;
deba@338
  1736
        case D3:
deba@338
  1737
          {
deba@338
  1738
            Edge e = _delta3->top();
deba@338
  1739
deba@338
  1740
            int left_blossom = _blossom_set->find(_graph.u(e));
deba@338
  1741
            int right_blossom = _blossom_set->find(_graph.v(e));
deba@338
  1742
deba@338
  1743
            if (left_blossom == right_blossom) {
deba@338
  1744
              _delta3->pop();
deba@338
  1745
            } else {
deba@338
  1746
              int left_tree;
deba@338
  1747
              if ((*_blossom_data)[left_blossom].status == EVEN) {
deba@338
  1748
                left_tree = _tree_set->find(left_blossom);
deba@338
  1749
              } else {
deba@338
  1750
                left_tree = -1;
deba@338
  1751
                ++unmatched;
deba@338
  1752
              }
deba@338
  1753
              int right_tree;
deba@338
  1754
              if ((*_blossom_data)[right_blossom].status == EVEN) {
deba@338
  1755
                right_tree = _tree_set->find(right_blossom);
deba@338
  1756
              } else {
deba@338
  1757
                right_tree = -1;
deba@338
  1758
                ++unmatched;
deba@338
  1759
              }
deba@338
  1760
deba@338
  1761
              if (left_tree == right_tree) {
deba@339
  1762
                shrinkOnEdge(e, left_tree);
deba@338
  1763
              } else {
deba@339
  1764
                augmentOnEdge(e);
deba@338
  1765
                unmatched -= 2;
deba@338
  1766
              }
deba@338
  1767
            }
deba@338
  1768
          } break;
deba@338
  1769
        case D4:
deba@338
  1770
          splitBlossom(_delta4->top());
deba@338
  1771
          break;
deba@338
  1772
        }
deba@338
  1773
      }
deba@338
  1774
      extractMatching();
deba@338
  1775
    }
deba@338
  1776
deba@338
  1777
    /// \brief Runs %MaxWeightedMatching algorithm.
deba@338
  1778
    ///
deba@338
  1779
    /// This method runs the %MaxWeightedMatching algorithm.
deba@338
  1780
    ///
deba@338
  1781
    /// \note mwm.run() is just a shortcut of the following code.
deba@338
  1782
    /// \code
deba@338
  1783
    ///   mwm.init();
deba@338
  1784
    ///   mwm.start();
deba@338
  1785
    /// \endcode
deba@338
  1786
    void run() {
deba@338
  1787
      init();
deba@338
  1788
      start();
deba@338
  1789
    }
deba@338
  1790
deba@338
  1791
    /// @}
deba@338
  1792
deba@338
  1793
    /// \name Primal solution
deba@338
  1794
    /// Functions for get the primal solution, ie. the matching.
deba@338
  1795
deba@338
  1796
    /// @{
deba@338
  1797
deba@338
  1798
    /// \brief Returns the matching value.
deba@338
  1799
    ///
deba@338
  1800
    /// Returns the matching value.
deba@338
  1801
    Value matchingValue() const {
deba@338
  1802
      Value sum = 0;
deba@338
  1803
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@338
  1804
        if ((*_matching)[n] != INVALID) {
deba@338
  1805
          sum += _weight[(*_matching)[n]];
deba@338
  1806
        }
deba@338
  1807
      }
deba@338
  1808
      return sum /= 2;
deba@338
  1809
    }
deba@338
  1810
deba@339
  1811
    /// \brief Returns the cardinality of the matching.
deba@338
  1812
    ///
deba@339
  1813
    /// Returns the cardinality of the matching.
deba@339
  1814
    int matchingSize() const {
deba@339
  1815
      int num = 0;
deba@339
  1816
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@339
  1817
        if ((*_matching)[n] != INVALID) {
deba@339
  1818
          ++num;
deba@339
  1819
        }
deba@339
  1820
      }
deba@339
  1821
      return num /= 2;
deba@339
  1822
    }
deba@339
  1823
deba@339
  1824
    /// \brief Returns true when the edge is in the matching.
deba@339
  1825
    ///
deba@339
  1826
    /// Returns true when the edge is in the matching.
deba@339
  1827
    bool matching(const Edge& edge) const {
deba@339
  1828
      return edge == (*_matching)[_graph.u(edge)];
deba@338
  1829
    }
deba@338
  1830
deba@338
  1831
    /// \brief Returns the incident matching arc.
deba@338
  1832
    ///
deba@338
  1833
    /// Returns the incident matching arc from given node. If the
deba@338
  1834
    /// node is not matched then it gives back \c INVALID.
deba@338
  1835
    Arc matching(const Node& node) const {
deba@338
  1836
      return (*_matching)[node];
deba@338
  1837
    }
deba@338
  1838
deba@338
  1839
    /// \brief Returns the mate of the node.
deba@338
  1840
    ///
deba@338
  1841
    /// Returns the adjancent node in a mathcing arc. If the node is
deba@338
  1842
    /// not matched then it gives back \c INVALID.
deba@338
  1843
    Node mate(const Node& node) const {
deba@338
  1844
      return (*_matching)[node] != INVALID ?
deba@338
  1845
        _graph.target((*_matching)[node]) : INVALID;
deba@338
  1846
    }
deba@338
  1847
deba@338
  1848
    /// @}
deba@338
  1849
deba@338
  1850
    /// \name Dual solution
deba@338
  1851
    /// Functions for get the dual solution.
deba@338
  1852
deba@338
  1853
    /// @{
deba@338
  1854
deba@338
  1855
    /// \brief Returns the value of the dual solution.
deba@338
  1856
    ///
deba@338
  1857
    /// Returns the value of the dual solution. It should be equal to
deba@338
  1858
    /// the primal value scaled by \ref dualScale "dual scale".
deba@338
  1859
    Value dualValue() const {
deba@338
  1860
      Value sum = 0;
deba@338
  1861
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@338
  1862
        sum += nodeValue(n);
deba@338
  1863
      }
deba@338
  1864
      for (int i = 0; i < blossomNum(); ++i) {
deba@338
  1865
        sum += blossomValue(i) * (blossomSize(i) / 2);
deba@338
  1866
      }
deba@338
  1867
      return sum;
deba@338
  1868
    }
deba@338
  1869
deba@338
  1870
    /// \brief Returns the value of the node.
deba@338
  1871
    ///
deba@338
  1872
    /// Returns the the value of the node.
deba@338
  1873
    Value nodeValue(const Node& n) const {
deba@338
  1874
      return (*_node_potential)[n];
deba@338
  1875
    }
deba@338
  1876
deba@338
  1877
    /// \brief Returns the number of the blossoms in the basis.
deba@338
  1878
    ///
deba@338
  1879
    /// Returns the number of the blossoms in the basis.
deba@338
  1880
    /// \see BlossomIt
deba@338
  1881
    int blossomNum() const {
deba@338
  1882
      return _blossom_potential.size();
deba@338
  1883
    }
deba@338
  1884
deba@338
  1885
deba@338
  1886
    /// \brief Returns the number of the nodes in the blossom.
deba@338
  1887
    ///
deba@338
  1888
    /// Returns the number of the nodes in the blossom.
deba@338
  1889
    int blossomSize(int k) const {
deba@338
  1890
      return _blossom_potential[k].end - _blossom_potential[k].begin;
deba@338
  1891
    }
deba@338
  1892
deba@338
  1893
    /// \brief Returns the value of the blossom.
deba@338
  1894
    ///
deba@338
  1895
    /// Returns the the value of the blossom.
deba@338
  1896
    /// \see BlossomIt
deba@338
  1897
    Value blossomValue(int k) const {
deba@338
  1898
      return _blossom_potential[k].value;
deba@338
  1899
    }
deba@338
  1900
deba@338
  1901
    /// \brief Lemon iterator for get the items of the blossom.
deba@338
  1902
    ///
deba@338
  1903
    /// Lemon iterator for get the nodes of the blossom. This class
deba@338
  1904
    /// provides a common style lemon iterator which gives back a
deba@338
  1905
    /// subset of the nodes.
deba@338
  1906
    class BlossomIt {
deba@338
  1907
    public:
deba@338
  1908
deba@338
  1909
      /// \brief Constructor.
deba@338
  1910
      ///
deba@338
  1911
      /// Constructor for get the nodes of the variable.
deba@338
  1912
      BlossomIt(const MaxWeightedMatching& algorithm, int variable)
deba@338
  1913
        : _algorithm(&algorithm)
deba@338
  1914
      {
deba@338
  1915
        _index = _algorithm->_blossom_potential[variable].begin;
deba@338
  1916
        _last = _algorithm->_blossom_potential[variable].end;
deba@338
  1917
      }
deba@338
  1918
deba@338
  1919
      /// \brief Conversion to node.
deba@338
  1920
      ///
deba@338
  1921
      /// Conversion to node.
deba@338
  1922
      operator Node() const {
deba@339
  1923
        return _algorithm->_blossom_node_list[_index];
deba@338
  1924
      }
deba@338
  1925
deba@338
  1926
      /// \brief Increment operator.
deba@338
  1927
      ///
deba@338
  1928
      /// Increment operator.
deba@338
  1929
      BlossomIt& operator++() {
deba@338
  1930
        ++_index;
deba@338
  1931
        return *this;
deba@338
  1932
      }
deba@338
  1933
deba@339
  1934
      /// \brief Validity checking
deba@339
  1935
      ///
deba@339
  1936
      /// Checks whether the iterator is invalid.
deba@339
  1937
      bool operator==(Invalid) const { return _index == _last; }
deba@339
  1938
deba@339
  1939
      /// \brief Validity checking
deba@339
  1940
      ///
deba@339
  1941
      /// Checks whether the iterator is valid.
deba@339
  1942
      bool operator!=(Invalid) const { return _index != _last; }
deba@338
  1943
deba@338
  1944
    private:
deba@338
  1945
      const MaxWeightedMatching* _algorithm;
deba@338
  1946
      int _last;
deba@338
  1947
      int _index;
deba@338
  1948
    };
deba@338
  1949
deba@338
  1950
    /// @}
deba@338
  1951
deba@338
  1952
  };
deba@338
  1953
deba@338
  1954
  /// \ingroup matching
deba@338
  1955
  ///
deba@338
  1956
  /// \brief Weighted perfect matching in general graphs
deba@338
  1957
  ///
deba@338
  1958
  /// This class provides an efficient implementation of Edmond's
deba@339
  1959
  /// maximum weighted perfect matching algorithm. The implementation
deba@338
  1960
  /// is based on extensive use of priority queues and provides
deba@338
  1961
  /// \f$O(nm\log(n))\f$ time complexity.
deba@338
  1962
  ///
deba@338
  1963
  /// The maximum weighted matching problem is to find undirected
deba@339
  1964
  /// edges in the graph with maximum overall weight and no two of
deba@339
  1965
  /// them shares their ends and covers all nodes. The problem can be
deba@339
  1966
  /// formulated with the following linear program.
deba@338
  1967
  /// \f[ \sum_{e \in \delta(u)}x_e = 1 \quad \forall u\in V\f]
deba@339
  1968
  /** \f[ \sum_{e \in \gamma(B)}x_e \le \frac{\vert B \vert - 1}{2}
deba@339
  1969
      \quad \forall B\in\mathcal{O}\f] */
deba@338
  1970
  /// \f[x_e \ge 0\quad \forall e\in E\f]
deba@338
  1971
  /// \f[\max \sum_{e\in E}x_ew_e\f]
deba@339
  1972
  /// where \f$\delta(X)\f$ is the set of edges incident to a node in
deba@339
  1973
  /// \f$X\f$, \f$\gamma(X)\f$ is the set of edges with both ends in
deba@339
  1974
  /// \f$X\f$ and \f$\mathcal{O}\f$ is the set of odd cardinality
deba@339
  1975
  /// subsets of the nodes.
deba@338
  1976
  ///
deba@338
  1977
  /// The algorithm calculates an optimal matching and a proof of the
deba@338
  1978
  /// optimality. The solution of the dual problem can be used to check
deba@339
  1979
  /// the result of the algorithm. The dual linear problem is the
deba@339
  1980
  /** \f[ y_u + y_v + \sum_{B \in \mathcal{O}, uv \in \gamma(B)}z_B \ge
deba@339
  1981
      w_{uv} \quad \forall uv\in E\f] */
deba@338
  1982
  /// \f[z_B \ge 0 \quad \forall B \in \mathcal{O}\f]
deba@339
  1983
  /** \f[\min \sum_{u \in V}y_u + \sum_{B \in \mathcal{O}}
deba@339
  1984
      \frac{\vert B \vert - 1}{2}z_B\f] */
deba@338
  1985
  ///
deba@338
  1986
  /// The algorithm can be executed with \c run() or the \c init() and
deba@338
  1987
  /// then the \c start() member functions. After it the matching can
deba@338
  1988
  /// be asked with \c matching() or mate() functions. The dual
deba@338
  1989
  /// solution can be get with \c nodeValue(), \c blossomNum() and \c
deba@338
  1990
  /// blossomValue() members and \ref MaxWeightedMatching::BlossomIt
deba@338
  1991
  /// "BlossomIt" nested class which is able to iterate on the nodes
deba@338
  1992
  /// of a blossom. If the value type is integral then the dual
deba@338
  1993
  /// solution is multiplied by \ref MaxWeightedMatching::dualScale "4".
deba@338
  1994
  template <typename _Graph,
deba@338
  1995
            typename _WeightMap = typename _Graph::template EdgeMap<int> >
deba@338
  1996
  class MaxWeightedPerfectMatching {
deba@338
  1997
  public:
deba@338
  1998
deba@338
  1999
    typedef _Graph Graph;
deba@338
  2000
    typedef _WeightMap WeightMap;
deba@338
  2001
    typedef typename WeightMap::Value Value;
deba@338
  2002
deba@338
  2003
    /// \brief Scaling factor for dual solution
deba@338
  2004
    ///
deba@338
  2005
    /// Scaling factor for dual solution, it is equal to 4 or 1
deba@338
  2006
    /// according to the value type.
deba@338
  2007
    static const int dualScale =
deba@338
  2008
      std::numeric_limits<Value>::is_integer ? 4 : 1;
deba@338
  2009
deba@338
  2010
    typedef typename Graph::template NodeMap<typename Graph::Arc>
deba@338
  2011
    MatchingMap;
deba@338
  2012
deba@338
  2013
  private:
deba@338
  2014
deba@338
  2015
    TEMPLATE_GRAPH_TYPEDEFS(Graph);
deba@338
  2016
deba@338
  2017
    typedef typename Graph::template NodeMap<Value> NodePotential;
deba@338
  2018
    typedef std::vector<Node> BlossomNodeList;
deba@338
  2019
deba@338
  2020
    struct BlossomVariable {
deba@338
  2021
      int begin, end;
deba@338
  2022
      Value value;
deba@338
  2023
deba@338
  2024
      BlossomVariable(int _begin, int _end, Value _value)
deba@338
  2025
        : begin(_begin), end(_end), value(_value) {}
deba@338
  2026
deba@338
  2027
    };
deba@338
  2028
deba@338
  2029
    typedef std::vector<BlossomVariable> BlossomPotential;
deba@338
  2030
deba@338
  2031
    const Graph& _graph;
deba@338
  2032
    const WeightMap& _weight;
deba@338
  2033
deba@338
  2034
    MatchingMap* _matching;
deba@338
  2035
deba@338
  2036
    NodePotential* _node_potential;
deba@338
  2037
deba@338
  2038
    BlossomPotential _blossom_potential;
deba@338
  2039
    BlossomNodeList _blossom_node_list;
deba@338
  2040
deba@338
  2041
    int _node_num;
deba@338
  2042
    int _blossom_num;
deba@338
  2043
deba@338
  2044
    typedef RangeMap<int> IntIntMap;
deba@338
  2045
deba@338
  2046
    enum Status {
deba@338
  2047
      EVEN = -1, MATCHED = 0, ODD = 1
deba@338
  2048
    };
deba@338
  2049
deba@339
  2050
    typedef HeapUnionFind<Value, IntNodeMap> BlossomSet;
deba@338
  2051
    struct BlossomData {
deba@338
  2052
      int tree;
deba@338
  2053
      Status status;
deba@338
  2054
      Arc pred, next;
deba@338
  2055
      Value pot, offset;
deba@338
  2056
    };
deba@338
  2057
deba@339
  2058
    IntNodeMap *_blossom_index;
deba@338
  2059
    BlossomSet *_blossom_set;
deba@338
  2060
    RangeMap<BlossomData>* _blossom_data;
deba@338
  2061
deba@339
  2062
    IntNodeMap *_node_index;
deba@339
  2063
    IntArcMap *_node_heap_index;
deba@338
  2064
deba@338
  2065
    struct NodeData {
deba@338
  2066
deba@339
  2067
      NodeData(IntArcMap& node_heap_index)
deba@338
  2068
        : heap(node_heap_index) {}
deba@338
  2069
deba@338
  2070
      int blossom;
deba@338
  2071
      Value pot;
deba@339
  2072
      BinHeap<Value, IntArcMap> heap;
deba@338
  2073
      std::map<int, Arc> heap_index;
deba@338
  2074
deba@338
  2075
      int tree;
deba@338
  2076
    };
deba@338
  2077
deba@338
  2078
    RangeMap<NodeData>* _node_data;
deba@338
  2079
deba@338
  2080
    typedef ExtendFindEnum<IntIntMap> TreeSet;
deba@338
  2081
deba@338
  2082
    IntIntMap *_tree_set_index;
deba@338
  2083
    TreeSet *_tree_set;
deba@338
  2084
deba@338
  2085
    IntIntMap *_delta2_index;
deba@338
  2086
    BinHeap<Value, IntIntMap> *_delta2;
deba@338
  2087
deba@339
  2088
    IntEdgeMap *_delta3_index;
deba@339
  2089
    BinHeap<Value, IntEdgeMap> *_delta3;
deba@338
  2090
deba@338
  2091
    IntIntMap *_delta4_index;
deba@338
  2092
    BinHeap<Value, IntIntMap> *_delta4;
deba@338
  2093
deba@338
  2094
    Value _delta_sum;
deba@338
  2095
deba@338
  2096
    void createStructures() {
deba@338
  2097
      _node_num = countNodes(_graph);
deba@338
  2098
      _blossom_num = _node_num * 3 / 2;
deba@338
  2099
deba@338
  2100
      if (!_matching) {
deba@338
  2101
        _matching = new MatchingMap(_graph);
deba@338
  2102
      }
deba@338
  2103
      if (!_node_potential) {
deba@338
  2104
        _node_potential = new NodePotential(_graph);
deba@338
  2105
      }
deba@338
  2106
      if (!_blossom_set) {
deba@339
  2107
        _blossom_index = new IntNodeMap(_graph);
deba@338
  2108
        _blossom_set = new BlossomSet(*_blossom_index);
deba@338
  2109
        _blossom_data = new RangeMap<BlossomData>(_blossom_num);
deba@338
  2110
      }
deba@338
  2111
deba@338
  2112
      if (!_node_index) {
deba@339
  2113
        _node_index = new IntNodeMap(_graph);
deba@339
  2114
        _node_heap_index = new IntArcMap(_graph);
deba@338
  2115
        _node_data = new RangeMap<NodeData>(_node_num,
deba@339
  2116
                                            NodeData(*_node_heap_index));
deba@338
  2117
      }
deba@338
  2118
deba@338
  2119
      if (!_tree_set) {
deba@338
  2120
        _tree_set_index = new IntIntMap(_blossom_num);
deba@338
  2121
        _tree_set = new TreeSet(*_tree_set_index);
deba@338
  2122
      }
deba@338
  2123
      if (!_delta2) {
deba@338
  2124
        _delta2_index = new IntIntMap(_blossom_num);
deba@338
  2125
        _delta2 = new BinHeap<Value, IntIntMap>(*_delta2_index);
deba@338
  2126
      }
deba@338
  2127
      if (!_delta3) {
deba@339
  2128
        _delta3_index = new IntEdgeMap(_graph);
deba@339
  2129
        _delta3 = new BinHeap<Value, IntEdgeMap>(*_delta3_index);
deba@338
  2130
      }
deba@338
  2131
      if (!_delta4) {
deba@338
  2132
        _delta4_index = new IntIntMap(_blossom_num);
deba@338
  2133
        _delta4 = new BinHeap<Value, IntIntMap>(*_delta4_index);
deba@338
  2134
      }
deba@338
  2135
    }
deba@338
  2136
deba@338
  2137
    void destroyStructures() {
deba@338
  2138
      _node_num = countNodes(_graph);
deba@338
  2139
      _blossom_num = _node_num * 3 / 2;
deba@338
  2140
deba@338
  2141
      if (_matching) {
deba@338
  2142
        delete _matching;
deba@338
  2143
      }
deba@338
  2144
      if (_node_potential) {
deba@338
  2145
        delete _node_potential;
deba@338
  2146
      }
deba@338
  2147
      if (_blossom_set) {
deba@338
  2148
        delete _blossom_index;
deba@338
  2149
        delete _blossom_set;
deba@338
  2150
        delete _blossom_data;
deba@338
  2151
      }
deba@338
  2152
deba@338
  2153
      if (_node_index) {
deba@338
  2154
        delete _node_index;
deba@338
  2155
        delete _node_heap_index;
deba@338
  2156
        delete _node_data;
deba@338
  2157
      }
deba@338
  2158
deba@338
  2159
      if (_tree_set) {
deba@338
  2160
        delete _tree_set_index;
deba@338
  2161
        delete _tree_set;
deba@338
  2162
      }
deba@338
  2163
      if (_delta2) {
deba@338
  2164
        delete _delta2_index;
deba@338
  2165
        delete _delta2;
deba@338
  2166
      }
deba@338
  2167
      if (_delta3) {
deba@338
  2168
        delete _delta3_index;
deba@338
  2169
        delete _delta3;
deba@338
  2170
      }
deba@338
  2171
      if (_delta4) {
deba@338
  2172
        delete _delta4_index;
deba@338
  2173
        delete _delta4;
deba@338
  2174
      }
deba@338
  2175
    }
deba@338
  2176
deba@338
  2177
    void matchedToEven(int blossom, int tree) {
deba@338
  2178
      if (_delta2->state(blossom) == _delta2->IN_HEAP) {
deba@338
  2179
        _delta2->erase(blossom);
deba@338
  2180
      }
deba@338
  2181
deba@338
  2182
      if (!_blossom_set->trivial(blossom)) {
deba@338
  2183
        (*_blossom_data)[blossom].pot -=
deba@338
  2184
          2 * (_delta_sum - (*_blossom_data)[blossom].offset);
deba@338
  2185
      }
deba@338
  2186
deba@338
  2187
      for (typename BlossomSet::ItemIt n(*_blossom_set, blossom);
deba@338
  2188
           n != INVALID; ++n) {
deba@338
  2189
deba@338
  2190
        _blossom_set->increase(n, std::numeric_limits<Value>::max());
deba@338
  2191
        int ni = (*_node_index)[n];
deba@338
  2192
deba@338
  2193
        (*_node_data)[ni].heap.clear();
deba@338
  2194
        (*_node_data)[ni].heap_index.clear();
deba@338
  2195
deba@338
  2196
        (*_node_data)[ni].pot += _delta_sum - (*_blossom_data)[blossom].offset;
deba@338
  2197
deba@338
  2198
        for (InArcIt e(_graph, n); e != INVALID; ++e) {
deba@338
  2199
          Node v = _graph.source(e);
deba@338
  2200
          int vb = _blossom_set->find(v);
deba@338
  2201
          int vi = (*_node_index)[v];
deba@338
  2202
deba@338
  2203
          Value rw = (*_node_data)[ni].pot + (*_node_data)[vi].pot -
deba@338
  2204
            dualScale * _weight[e];
deba@338
  2205
deba@338
  2206
          if ((*_blossom_data)[vb].status == EVEN) {
deba@338
  2207
            if (_delta3->state(e) != _delta3->IN_HEAP && blossom != vb) {
deba@338
  2208
              _delta3->push(e, rw / 2);
deba@338
  2209
            }
deba@338
  2210
          } else {
deba@338
  2211
            typename std::map<int, Arc>::iterator it =
deba@338
  2212
              (*_node_data)[vi].heap_index.find(tree);
deba@338
  2213
deba@338
  2214
            if (it != (*_node_data)[vi].heap_index.end()) {
deba@338
  2215
              if ((*_node_data)[vi].heap[it->second] > rw) {
deba@338
  2216
                (*_node_data)[vi].heap.replace(it->second, e);
deba@338
  2217
                (*_node_data)[vi].heap.decrease(e, rw);
deba@338
  2218
                it->second = e;
deba@338
  2219
              }
deba@338
  2220
            } else {
deba@338
  2221
              (*_node_data)[vi].heap.push(e, rw);
deba@338
  2222
              (*_node_data)[vi].heap_index.insert(std::make_pair(tree, e));
deba@338
  2223
            }
deba@338
  2224
deba@338
  2225
            if ((*_blossom_set)[v] > (*_node_data)[vi].heap.prio()) {
deba@338
  2226
              _blossom_set->decrease(v, (*_node_data)[vi].heap.prio());
deba@338
  2227
deba@338
  2228
              if ((*_blossom_data)[vb].status == MATCHED) {
deba@338
  2229
                if (_delta2->state(vb) != _delta2->IN_HEAP) {
deba@338
  2230
                  _delta2->push(vb, _blossom_set->classPrio(vb) -
deba@338
  2231
                               (*_blossom_data)[vb].offset);
deba@338
  2232
                } else if ((*_delta2)[vb] > _blossom_set->classPrio(vb) -
deba@338
  2233
                           (*_blossom_data)[vb].offset){
deba@338
  2234
                  _delta2->decrease(vb, _blossom_set->classPrio(vb) -
deba@338
  2235
                                   (*_blossom_data)[vb].offset);
deba@338
  2236
                }
deba@338
  2237
              }
deba@338
  2238
            }
deba@338
  2239
          }
deba@338
  2240
        }
deba@338
  2241
      }
deba@338
  2242
      (*_blossom_data)[blossom].offset = 0;
deba@338
  2243
    }
deba@338
  2244
deba@338
  2245
    void matchedToOdd(int blossom) {
deba@338
  2246
      if (_delta2->state(blossom) == _delta2->IN_HEAP) {
deba@338
  2247
        _delta2->erase(blossom);
deba@338
  2248
      }
deba@338
  2249
      (*_blossom_data)[blossom].offset += _delta_sum;
deba@338
  2250
      if (!_blossom_set->trivial(blossom)) {
deba@338
  2251
        _delta4->push(blossom, (*_blossom_data)[blossom].pot / 2 +
deba@338
  2252
                     (*_blossom_data)[blossom].offset);
deba@338
  2253
      }
deba@338
  2254
    }
deba@338
  2255
deba@338
  2256
    void evenToMatched(int blossom, int tree) {
deba@338
  2257
      if (!_blossom_set->trivial(blossom)) {
deba@338
  2258
        (*_blossom_data)[blossom].pot += 2 * _delta_sum;
deba@338
  2259
      }
deba@338
  2260
deba@338
  2261
      for (typename BlossomSet::ItemIt n(*_blossom_set, blossom);
deba@338
  2262
           n != INVALID; ++n) {
deba@338
  2263
        int ni = (*_node_index)[n];
deba@338
  2264
        (*_node_data)[ni].pot -= _delta_sum;
deba@338
  2265
deba@338
  2266
        for (InArcIt e(_graph, n); e != INVALID; ++e) {
deba@338
  2267
          Node v = _graph.source(e);
deba@338
  2268
          int vb = _blossom_set->find(v);
deba@338
  2269
          int vi = (*_node_index)[v];
deba@338
  2270
deba@338
  2271
          Value rw = (*_node_data)[ni].pot + (*_node_data)[vi].pot -
deba@338
  2272
            dualScale * _weight[e];
deba@338
  2273
deba@338
  2274
          if (vb == blossom) {
deba@338
  2275
            if (_delta3->state(e) == _delta3->IN_HEAP) {
deba@338
  2276
              _delta3->erase(e);
deba@338
  2277
            }
deba@338
  2278
          } else if ((*_blossom_data)[vb].status == EVEN) {
deba@338
  2279
deba@338
  2280
            if (_delta3->state(e) == _delta3->IN_HEAP) {
deba@338
  2281
              _delta3->erase(e);
deba@338
  2282
            }
deba@338
  2283
deba@338
  2284
            int vt = _tree_set->find(vb);
deba@338
  2285
deba@338
  2286
            if (vt != tree) {
deba@338
  2287
deba@338
  2288
              Arc r = _graph.oppositeArc(e);
deba@338
  2289
deba@338
  2290
              typename std::map<int, Arc>::iterator it =
deba@338
  2291
                (*_node_data)[ni].heap_index.find(vt);
deba@338
  2292
deba@338
  2293
              if (it != (*_node_data)[ni].heap_index.end()) {
deba@338
  2294
                if ((*_node_data)[ni].heap[it->second] > rw) {
deba@338
  2295
                  (*_node_data)[ni].heap.replace(it->second, r);
deba@338
  2296
                  (*_node_data)[ni].heap.decrease(r, rw);
deba@338
  2297
                  it->second = r;
deba@338
  2298
                }
deba@338
  2299
              } else {
deba@338
  2300
                (*_node_data)[ni].heap.push(r, rw);
deba@338
  2301
                (*_node_data)[ni].heap_index.insert(std::make_pair(vt, r));
deba@338
  2302
              }
deba@338
  2303
deba@338
  2304
              if ((*_blossom_set)[n] > (*_node_data)[ni].heap.prio()) {
deba@338
  2305
                _blossom_set->decrease(n, (*_node_data)[ni].heap.prio());
deba@338
  2306
deba@338
  2307
                if (_delta2->state(blossom) != _delta2->IN_HEAP) {
deba@338
  2308
                  _delta2->push(blossom, _blossom_set->classPrio(blossom) -
deba@338
  2309
                               (*_blossom_data)[blossom].offset);
deba@338
  2310
                } else if ((*_delta2)[blossom] >
deba@338
  2311
                           _blossom_set->classPrio(blossom) -
deba@338
  2312
                           (*_blossom_data)[blossom].offset){
deba@338
  2313
                  _delta2->decrease(blossom, _blossom_set->classPrio(blossom) -
deba@338
  2314
                                   (*_blossom_data)[blossom].offset);
deba@338
  2315
                }
deba@338
  2316
              }
deba@338
  2317
            }
deba@338
  2318
          } else {
deba@338
  2319
deba@338
  2320
            typename std::map<int, Arc>::iterator it =
deba@338
  2321
              (*_node_data)[vi].heap_index.find(tree);
deba@338
  2322
deba@338
  2323
            if (it != (*_node_data)[vi].heap_index.end()) {
deba@338
  2324
              (*_node_data)[vi].heap.erase(it->second);
deba@338
  2325
              (*_node_data)[vi].heap_index.erase(it);
deba@338
  2326
              if ((*_node_data)[vi].heap.empty()) {
deba@338
  2327
                _blossom_set->increase(v, std::numeric_limits<Value>::max());
deba@338
  2328
              } else if ((*_blossom_set)[v] < (*_node_data)[vi].heap.prio()) {
deba@338
  2329
                _blossom_set->increase(v, (*_node_data)[vi].heap.prio());
deba@338
  2330
              }
deba@338
  2331
deba@338
  2332
              if ((*_blossom_data)[vb].status == MATCHED) {
deba@338
  2333
                if (_blossom_set->classPrio(vb) ==
deba@338
  2334
                    std::numeric_limits<Value>::max()) {
deba@338
  2335
                  _delta2->erase(vb);
deba@338
  2336
                } else if ((*_delta2)[vb] < _blossom_set->classPrio(vb) -
deba@338
  2337
                           (*_blossom_data)[vb].offset) {
deba@338
  2338
                  _delta2->increase(vb, _blossom_set->classPrio(vb) -
deba@338
  2339
                                   (*_blossom_data)[vb].offset);
deba@338
  2340
                }
deba@338
  2341
              }
deba@338
  2342
            }
deba@338
  2343
          }
deba@338
  2344
        }
deba@338
  2345
      }
deba@338
  2346
    }
deba@338
  2347
deba@338
  2348
    void oddToMatched(int blossom) {
deba@338
  2349
      (*_blossom_data)[blossom].offset -= _delta_sum;
deba@338
  2350
deba@338
  2351
      if (_blossom_set->classPrio(blossom) !=
deba@338
  2352
          std::numeric_limits<Value>::max()) {
deba@338
  2353
        _delta2->push(blossom, _blossom_set->classPrio(blossom) -
deba@338
  2354
                       (*_blossom_data)[blossom].offset);
deba@338
  2355
      }
deba@338
  2356
deba@338
  2357
      if (!_blossom_set->trivial(blossom)) {
deba@338
  2358
        _delta4->erase(blossom);
deba@338
  2359
      }
deba@338
  2360
    }
deba@338
  2361
deba@338
  2362
    void oddToEven(int blossom, int tree) {
deba@338
  2363
      if (!_blossom_set->trivial(blossom)) {
deba@338
  2364
        _delta4->erase(blossom);
deba@338
  2365
        (*_blossom_data)[blossom].pot -=
deba@338
  2366
          2 * (2 * _delta_sum - (*_blossom_data)[blossom].offset);
deba@338
  2367
      }
deba@338
  2368
deba@338
  2369
      for (typename BlossomSet::ItemIt n(*_blossom_set, blossom);
deba@338
  2370
           n != INVALID; ++n) {
deba@338
  2371
        int ni = (*_node_index)[n];
deba@338
  2372
deba@338
  2373
        _blossom_set->increase(n, std::numeric_limits<Value>::max());
deba@338
  2374
deba@338
  2375
        (*_node_data)[ni].heap.clear();
deba@338
  2376
        (*_node_data)[ni].heap_index.clear();
deba@338
  2377
        (*_node_data)[ni].pot +=
deba@338
  2378
          2 * _delta_sum - (*_blossom_data)[blossom].offset;
deba@338
  2379
deba@338
  2380
        for (InArcIt e(_graph, n); e != INVALID; ++e) {
deba@338
  2381
          Node v = _graph.source(e);
deba@338
  2382
          int vb = _blossom_set->find(v);
deba@338
  2383
          int vi = (*_node_index)[v];
deba@338
  2384
deba@338
  2385
          Value rw = (*_node_data)[ni].pot + (*_node_data)[vi].pot -
deba@338
  2386
            dualScale * _weight[e];
deba@338
  2387
deba@338
  2388
          if ((*_blossom_data)[vb].status == EVEN) {
deba@338
  2389
            if (_delta3->state(e) != _delta3->IN_HEAP && blossom != vb) {
deba@338
  2390
              _delta3->push(e, rw / 2);
deba@338
  2391
            }
deba@338
  2392
          } else {
deba@338
  2393
deba@338
  2394
            typename std::map<int, Arc>::iterator it =
deba@338
  2395
              (*_node_data)[vi].heap_index.find(tree);
deba@338
  2396
deba@338
  2397
            if (it != (*_node_data)[vi].heap_index.end()) {
deba@338
  2398
              if ((*_node_data)[vi].heap[it->second] > rw) {
deba@338
  2399
                (*_node_data)[vi].heap.replace(it->second, e);
deba@338
  2400
                (*_node_data)[vi].heap.decrease(e, rw);
deba@338
  2401
                it->second = e;
deba@338
  2402
              }
deba@338
  2403
            } else {
deba@338
  2404
              (*_node_data)[vi].heap.push(e, rw);
deba@338
  2405
              (*_node_data)[vi].heap_index.insert(std::make_pair(tree, e));
deba@338
  2406
            }
deba@338
  2407
deba@338
  2408
            if ((*_blossom_set)[v] > (*_node_data)[vi].heap.prio()) {
deba@338
  2409
              _blossom_set->decrease(v, (*_node_data)[vi].heap.prio());
deba@338
  2410
deba@338
  2411
              if ((*_blossom_data)[vb].status == MATCHED) {
deba@338
  2412
                if (_delta2->state(vb) != _delta2->IN_HEAP) {
deba@338
  2413
                  _delta2->push(vb, _blossom_set->classPrio(vb) -
deba@338
  2414
                               (*_blossom_data)[vb].offset);
deba@338
  2415
                } else if ((*_delta2)[vb] > _blossom_set->classPrio(vb) -
deba@338
  2416
                           (*_blossom_data)[vb].offset) {
deba@338
  2417
                  _delta2->decrease(vb, _blossom_set->classPrio(vb) -
deba@338
  2418
                                   (*_blossom_data)[vb].offset);
deba@338
  2419
                }
deba@338
  2420
              }
deba@338
  2421
            }
deba@338
  2422
          }
deba@338
  2423
        }
deba@338
  2424
      }
deba@338
  2425
      (*_blossom_data)[blossom].offset = 0;
deba@338
  2426
    }
deba@338
  2427
deba@338
  2428
    void alternatePath(int even, int tree) {
deba@338
  2429
      int odd;
deba@338
  2430
deba@338
  2431
      evenToMatched(even, tree);
deba@338
  2432
      (*_blossom_data)[even].status = MATCHED;
deba@338
  2433
deba@338
  2434
      while ((*_blossom_data)[even].pred != INVALID) {
deba@338
  2435
        odd = _blossom_set->find(_graph.target((*_blossom_data)[even].pred));
deba@338
  2436
        (*_blossom_data)[odd].status = MATCHED;
deba@338
  2437
        oddToMatched(odd);
deba@338
  2438
        (*_blossom_data)[odd].next = (*_blossom_data)[odd].pred;
deba@338
  2439
deba@338
  2440
        even = _blossom_set->find(_graph.target((*_blossom_data)[odd].pred));
deba@338
  2441
        (*_blossom_data)[even].status = MATCHED;
deba@338
  2442
        evenToMatched(even, tree);
deba@338
  2443
        (*_blossom_data)[even].next =
deba@338
  2444
          _graph.oppositeArc((*_blossom_data)[odd].pred);
deba@338
  2445
      }
deba@338
  2446
deba@338
  2447
    }
deba@338
  2448
deba@338
  2449
    void destroyTree(int tree) {
deba@338
  2450
      for (TreeSet::ItemIt b(*_tree_set, tree); b != INVALID; ++b) {
deba@338
  2451
        if ((*_blossom_data)[b].status == EVEN) {
deba@338
  2452
          (*_blossom_data)[b].status = MATCHED;
deba@338
  2453
          evenToMatched(b, tree);
deba@338
  2454
        } else if ((*_blossom_data)[b].status == ODD) {
deba@338
  2455
          (*_blossom_data)[b].status = MATCHED;
deba@338
  2456
          oddToMatched(b);
deba@338
  2457
        }
deba@338
  2458
      }
deba@338
  2459
      _tree_set->eraseClass(tree);
deba@338
  2460
    }
deba@338
  2461
deba@339
  2462
    void augmentOnEdge(const Edge& edge) {
deba@339
  2463
deba@339
  2464
      int left = _blossom_set->find(_graph.u(edge));
deba@339
  2465
      int right = _blossom_set->find(_graph.v(edge));
deba@338
  2466
deba@338
  2467
      int left_tree = _tree_set->find(left);
deba@338
  2468
      alternatePath(left, left_tree);
deba@338
  2469
      destroyTree(left_tree);
deba@338
  2470
deba@338
  2471
      int right_tree = _tree_set->find(right);
deba@338
  2472
      alternatePath(right, right_tree);
deba@338
  2473
      destroyTree(right_tree);
deba@338
  2474
deba@339
  2475
      (*_blossom_data)[left].next = _graph.direct(edge, true);
deba@339
  2476
      (*_blossom_data)[right].next = _graph.direct(edge, false);
deba@338
  2477
    }
deba@338
  2478
deba@338
  2479
    void extendOnArc(const Arc& arc) {
deba@338
  2480
      int base = _blossom_set->find(_graph.target(arc));
deba@338
  2481
      int tree = _tree_set->find(base);
deba@338
  2482
deba@338
  2483
      int odd = _blossom_set->find(_graph.source(arc));
deba@338
  2484
      _tree_set->insert(odd, tree);
deba@338
  2485
      (*_blossom_data)[odd].status = ODD;
deba@338
  2486
      matchedToOdd(odd);
deba@338
  2487
      (*_blossom_data)[odd].pred = arc;
deba@338
  2488
deba@338
  2489
      int even = _blossom_set->find(_graph.target((*_blossom_data)[odd].next));
deba@338
  2490
      (*_blossom_data)[even].pred = (*_blossom_data)[even].next;
deba@338
  2491
      _tree_set->insert(even, tree);
deba@338
  2492
      (*_blossom_data)[even].status = EVEN;
deba@338
  2493
      matchedToEven(even, tree);
deba@338
  2494
    }
deba@338
  2495
deba@339
  2496
    void shrinkOnEdge(const Edge& edge, int tree) {
deba@338
  2497
      int nca = -1;
deba@338
  2498
      std::vector<int> left_path, right_path;
deba@338
  2499
deba@338
  2500
      {
deba@338
  2501
        std::set<int> left_set, right_set;
deba@338
  2502
        int left = _blossom_set->find(_graph.u(edge));
deba@338
  2503
        left_path.push_back(left);
deba@338
  2504
        left_set.insert(left);
deba@338
  2505
deba@338
  2506
        int right = _blossom_set->find(_graph.v(edge));
deba@338
  2507
        right_path.push_back(right);
deba@338
  2508
        right_set.insert(right);
deba@338
  2509
deba@338
  2510
        while (true) {
deba@338
  2511
deba@338
  2512
          if ((*_blossom_data)[left].pred == INVALID) break;
deba@338
  2513
deba@338
  2514
          left =
deba@338
  2515
            _blossom_set->find(_graph.target((*_blossom_data)[left].pred));
deba@338
  2516
          left_path.push_back(left);
deba@338
  2517
          left =
deba@338
  2518
            _blossom_set->find(_graph.target((*_blossom_data)[left].pred));
deba@338
  2519
          left_path.push_back(left);
deba@338
  2520
deba@338
  2521
          left_set.insert(left);
deba@338
  2522
deba@338
  2523
          if (right_set.find(left) != right_set.end()) {
deba@338
  2524
            nca = left;
deba@338
  2525
            break;
deba@338
  2526
          }
deba@338
  2527
deba@338
  2528
          if ((*_blossom_data)[right].pred == INVALID) break;
deba@338
  2529
deba@338
  2530
          right =
deba@338
  2531
            _blossom_set->find(_graph.target((*_blossom_data)[right].pred));
deba@338
  2532
          right_path.push_back(right);
deba@338
  2533
          right =
deba@338
  2534
            _blossom_set->find(_graph.target((*_blossom_data)[right].pred));
deba@338
  2535
          right_path.push_back(right);
deba@338
  2536
deba@338
  2537
          right_set.insert(right);
deba@338
  2538
deba@338
  2539
          if (left_set.find(right) != left_set.end()) {
deba@338
  2540
            nca = right;
deba@338
  2541
            break;
deba@338
  2542
          }
deba@338
  2543
deba@338
  2544
        }
deba@338
  2545
deba@338
  2546
        if (nca == -1) {
deba@338
  2547
          if ((*_blossom_data)[left].pred == INVALID) {
deba@338
  2548
            nca = right;
deba@338
  2549
            while (left_set.find(nca) == left_set.end()) {
deba@338
  2550
              nca =
deba@338
  2551
                _blossom_set->find(_graph.target((*_blossom_data)[nca].pred));
deba@338
  2552
              right_path.push_back(nca);
deba@338
  2553
              nca =
deba@338
  2554
                _blossom_set->find(_graph.target((*_blossom_data)[nca].pred));
deba@338
  2555
              right_path.push_back(nca);
deba@338
  2556
            }
deba@338
  2557
          } else {
deba@338
  2558
            nca = left;
deba@338
  2559
            while (right_set.find(nca) == right_set.end()) {
deba@338
  2560
              nca =
deba@338
  2561
                _blossom_set->find(_graph.target((*_blossom_data)[nca].pred));
deba@338
  2562
              left_path.push_back(nca);
deba@338
  2563
              nca =
deba@338
  2564
                _blossom_set->find(_graph.target((*_blossom_data)[nca].pred));
deba@338
  2565
              left_path.push_back(nca);
deba@338
  2566
            }
deba@338
  2567
          }
deba@338
  2568
        }
deba@338
  2569
      }
deba@338
  2570
deba@338
  2571
      std::vector<int> subblossoms;
deba@338
  2572
      Arc prev;
deba@338
  2573
deba@338
  2574
      prev = _graph.direct(edge, true);
deba@338
  2575
      for (int i = 0; left_path[i] != nca; i += 2) {
deba@338
  2576
        subblossoms.push_back(left_path[i]);
deba@338
  2577
        (*_blossom_data)[left_path[i]].next = prev;
deba@338
  2578
        _tree_set->erase(left_path[i]);
deba@338
  2579
deba@338
  2580
        subblossoms.push_back(left_path[i + 1]);
deba@338
  2581
        (*_blossom_data)[left_path[i + 1]].status = EVEN;
deba@338
  2582
        oddToEven(left_path[i + 1], tree);
deba@338
  2583
        _tree_set->erase(left_path[i + 1]);
deba@338
  2584
        prev = _graph.oppositeArc((*_blossom_data)[left_path[i + 1]].pred);
deba@338
  2585
      }
deba@338
  2586
deba@338
  2587
      int k = 0;
deba@338
  2588
      while (right_path[k] != nca) ++k;
deba@338
  2589
deba@338
  2590
      subblossoms.push_back(nca);
deba@338
  2591
      (*_blossom_data)[nca].next = prev;
deba@338
  2592
deba@338
  2593
      for (int i = k - 2; i >= 0; i -= 2) {
deba@338
  2594
        subblossoms.push_back(right_path[i + 1]);
deba@338
  2595
        (*_blossom_data)[right_path[i + 1]].status = EVEN;
deba@338
  2596
        oddToEven(right_path[i + 1], tree);
deba@338
  2597
        _tree_set->erase(right_path[i + 1]);
deba@338
  2598
deba@338
  2599
        (*_blossom_data)[right_path[i + 1]].next =
deba@338
  2600
          (*_blossom_data)[right_path[i + 1]].pred;
deba@338
  2601
deba@338
  2602
        subblossoms.push_back(right_path[i]);
deba@338
  2603
        _tree_set->erase(right_path[i]);
deba@338
  2604
      }
deba@338
  2605
deba@338
  2606
      int surface =
deba@338
  2607
        _blossom_set->join(subblossoms.begin(), subblossoms.end());
deba@338
  2608
deba@338
  2609
      for (int i = 0; i < int(subblossoms.size()); ++i) {
deba@338
  2610
        if (!_blossom_set->trivial(subblossoms[i])) {
deba@338
  2611
          (*_blossom_data)[subblossoms[i]].pot += 2 * _delta_sum;
deba@338
  2612
        }
deba@338
  2613
        (*_blossom_data)[subblossoms[i]].status = MATCHED;
deba@338
  2614
      }
deba@338
  2615
deba@338
  2616
      (*_blossom_data)[surface].pot = -2 * _delta_sum;
deba@338
  2617
      (*_blossom_data)[surface].offset = 0;
deba@338
  2618
      (*_blossom_data)[surface].status = EVEN;
deba@338
  2619
      (*_blossom_data)[surface].pred = (*_blossom_data)[nca].pred;
deba@338
  2620
      (*_blossom_data)[surface].next = (*_blossom_data)[nca].pred;
deba@338
  2621
deba@338
  2622
      _tree_set->insert(surface, tree);
deba@338
  2623
      _tree_set->erase(nca);
deba@338
  2624
    }
deba@338
  2625
deba@338
  2626
    void splitBlossom(int blossom) {
deba@338
  2627
      Arc next = (*_blossom_data)[blossom].next;
deba@338
  2628
      Arc pred = (*_blossom_data)[blossom].pred;
deba@338
  2629
deba@338
  2630
      int tree = _tree_set->find(blossom);
deba@338
  2631
deba@338
  2632
      (*_blossom_data)[blossom].status = MATCHED;
deba@338
  2633
      oddToMatched(blossom);
deba@338
  2634
      if (_delta2->state(blossom) == _delta2->IN_HEAP) {
deba@338
  2635
        _delta2->erase(blossom);
deba@338
  2636
      }
deba@338
  2637
deba@338
  2638
      std::vector<int> subblossoms;
deba@338
  2639
      _blossom_set->split(blossom, std::back_inserter(subblossoms));
deba@338
  2640
deba@338
  2641
      Value offset = (*_blossom_data)[blossom].offset;
deba@338
  2642
      int b = _blossom_set->find(_graph.source(pred));
deba@338
  2643
      int d = _blossom_set->find(_graph.source(next));
deba@338
  2644
deba@338
  2645
      int ib = -1, id = -1;
deba@338
  2646
      for (int i = 0; i < int(subblossoms.size()); ++i) {
deba@338
  2647
        if (subblossoms[i] == b) ib = i;
deba@338
  2648
        if (subblossoms[i] == d) id = i;
deba@338
  2649
deba@338
  2650
        (*_blossom_data)[subblossoms[i]].offset = offset;
deba@338
  2651
        if (!_blossom_set->trivial(subblossoms[i])) {
deba@338
  2652
          (*_blossom_data)[subblossoms[i]].pot -= 2 * offset;
deba@338
  2653
        }
deba@338
  2654
        if (_blossom_set->classPrio(subblossoms[i]) !=
deba@338
  2655
            std::numeric_limits<Value>::max()) {
deba@338
  2656
          _delta2->push(subblossoms[i],
deba@338
  2657
                        _blossom_set->classPrio(subblossoms[i]) -
deba@338
  2658
                        (*_blossom_data)[subblossoms[i]].offset);
deba@338
  2659
        }
deba@338
  2660
      }
deba@338
  2661
deba@338
  2662
      if (id > ib ? ((id - ib) % 2 == 0) : ((ib - id) % 2 == 1)) {
deba@338
  2663
        for (int i = (id + 1) % subblossoms.size();
deba@338
  2664
             i != ib; i = (i + 2) % subblossoms.size()) {
deba@338
  2665
          int sb = subblossoms[i];
deba@338
  2666
          int tb = subblossoms[(i + 1) % subblossoms.size()];
deba@338
  2667
          (*_blossom_data)[sb].next =
deba@338
  2668
            _graph.oppositeArc((*_blossom_data)[tb].next);
deba@338
  2669
        }
deba@338
  2670
deba@338
  2671
        for (int i = ib; i != id; i = (i + 2) % subblossoms.size()) {
deba@338
  2672
          int sb = subblossoms[i];
deba@338
  2673
          int tb = subblossoms[(i + 1) % subblossoms.size()];
deba@338
  2674
          int ub = subblossoms[(i + 2) % subblossoms.size()];
deba@338
  2675
deba@338
  2676
          (*_blossom_data)[sb].status = ODD;
deba@338
  2677
          matchedToOdd(sb);
deba@338
  2678
          _tree_set->insert(sb, tree);
deba@338
  2679
          (*_blossom_data)[sb].pred = pred;
deba@338
  2680
          (*_blossom_data)[sb].next =
deba@338
  2681
                           _graph.oppositeArc((*_blossom_data)[tb].next);
deba@338
  2682
deba@338
  2683
          pred = (*_blossom_data)[ub].next;
deba@338
  2684
deba@338
  2685
          (*_blossom_data)[tb].status = EVEN;
deba@338
  2686
          matchedToEven(tb, tree);
deba@338
  2687
          _tree_set->insert(tb, tree);
deba@338
  2688
          (*_blossom_data)[tb].pred = (*_blossom_data)[tb].next;
deba@338
  2689
        }
deba@338
  2690
deba@338
  2691
        (*_blossom_data)[subblossoms[id]].status = ODD;
deba@338
  2692
        matchedToOdd(subblossoms[id]);
deba@338
  2693
        _tree_set->insert(subblossoms[id], tree);
deba@338
  2694
        (*_blossom_data)[subblossoms[id]].next = next;
deba@338
  2695
        (*_blossom_data)[subblossoms[id]].pred = pred;
deba@338
  2696
deba@338
  2697
      } else {
deba@338
  2698
deba@338
  2699
        for (int i = (ib + 1) % subblossoms.size();
deba@338
  2700
             i != id; i = (i + 2) % subblossoms.size()) {
deba@338
  2701
          int sb = subblossoms[i];
deba@338
  2702
          int tb = subblossoms[(i + 1) % subblossoms.size()];
deba@338
  2703
          (*_blossom_data)[sb].next =
deba@338
  2704
            _graph.oppositeArc((*_blossom_data)[tb].next);
deba@338
  2705
        }
deba@338
  2706
deba@338
  2707
        for (int i = id; i != ib; i = (i + 2) % subblossoms.size()) {
deba@338
  2708
          int sb = subblossoms[i];
deba@338
  2709
          int tb = subblossoms[(i + 1) % subblossoms.size()];
deba@338
  2710
          int ub = subblossoms[(i + 2) % subblossoms.size()];
deba@338
  2711
deba@338
  2712
          (*_blossom_data)[sb].status = ODD;
deba@338
  2713
          matchedToOdd(sb);
deba@338
  2714
          _tree_set->insert(sb, tree);
deba@338
  2715
          (*_blossom_data)[sb].next = next;
deba@338
  2716
          (*_blossom_data)[sb].pred =
deba@338
  2717
            _graph.oppositeArc((*_blossom_data)[tb].next);
deba@338
  2718
deba@338
  2719
          (*_blossom_data)[tb].status = EVEN;
deba@338
  2720
          matchedToEven(tb, tree);
deba@338
  2721
          _tree_set->insert(tb, tree);
deba@338
  2722
          (*_blossom_data)[tb].pred =
deba@338
  2723
            (*_blossom_data)[tb].next =
deba@338
  2724
            _graph.oppositeArc((*_blossom_data)[ub].next);
deba@338
  2725
          next = (*_blossom_data)[ub].next;
deba@338
  2726
        }
deba@338
  2727
deba@338
  2728
        (*_blossom_data)[subblossoms[ib]].status = ODD;
deba@338
  2729
        matchedToOdd(subblossoms[ib]);
deba@338
  2730
        _tree_set->insert(subblossoms[ib], tree);
deba@338
  2731
        (*_blossom_data)[subblossoms[ib]].next = next;
deba@338
  2732
        (*_blossom_data)[subblossoms[ib]].pred = pred;
deba@338
  2733
      }
deba@338
  2734
      _tree_set->erase(blossom);
deba@338
  2735
    }
deba@338
  2736
deba@338
  2737
    void extractBlossom(int blossom, const Node& base, const Arc& matching) {
deba@338
  2738
      if (_blossom_set->trivial(blossom)) {
deba@338
  2739
        int bi = (*_node_index)[base];
deba@338
  2740
        Value pot = (*_node_data)[bi].pot;
deba@338
  2741
deba@338
  2742
        _matching->set(base, matching);
deba@338
  2743
        _blossom_node_list.push_back(base);
deba@338
  2744
        _node_potential->set(base, pot);
deba@338
  2745
      } else {
deba@338
  2746
deba@338
  2747
        Value pot = (*_blossom_data)[blossom].pot;
deba@338
  2748
        int bn = _blossom_node_list.size();
deba@338
  2749
deba@338
  2750
        std::vector<int> subblossoms;
deba@338
  2751
        _blossom_set->split(blossom, std::back_inserter(subblossoms));
deba@338
  2752
        int b = _blossom_set->find(base);
deba@338
  2753
        int ib = -1;
deba@338
  2754
        for (int i = 0; i < int(subblossoms.size()); ++i) {
deba@338
  2755
          if (subblossoms[i] == b) { ib = i; break; }
deba@338
  2756
        }
deba@338
  2757
deba@338
  2758
        for (int i = 1; i < int(subblossoms.size()); i += 2) {
deba@338
  2759
          int sb = subblossoms[(ib + i) % subblossoms.size()];
deba@338
  2760
          int tb = subblossoms[(ib + i + 1) % subblossoms.size()];
deba@338
  2761
deba@338
  2762
          Arc m = (*_blossom_data)[tb].next;
deba@338
  2763
          extractBlossom(sb, _graph.target(m), _graph.oppositeArc(m));
deba@338
  2764
          extractBlossom(tb, _graph.source(m), m);
deba@338
  2765
        }
deba@338
  2766
        extractBlossom(subblossoms[ib], base, matching);
deba@338
  2767
deba@338
  2768
        int en = _blossom_node_list.size();
deba@338
  2769
deba@338
  2770
        _blossom_potential.push_back(BlossomVariable(bn, en, pot));
deba@338
  2771
      }
deba@338
  2772
    }
deba@338
  2773
deba@338
  2774
    void extractMatching() {
deba@338
  2775
      std::vector<int> blossoms;
deba@338
  2776
      for (typename BlossomSet::ClassIt c(*_blossom_set); c != INVALID; ++c) {
deba@338
  2777
        blossoms.push_back(c);
deba@338
  2778
      }
deba@338
  2779
deba@338
  2780
      for (int i = 0; i < int(blossoms.size()); ++i) {
deba@338
  2781
deba@338
  2782
        Value offset = (*_blossom_data)[blossoms[i]].offset;
deba@338
  2783
        (*_blossom_data)[blossoms[i]].pot += 2 * offset;
deba@338
  2784
        for (typename BlossomSet::ItemIt n(*_blossom_set, blossoms[i]);
deba@338
  2785
             n != INVALID; ++n) {
deba@338
  2786
          (*_node_data)[(*_node_index)[n]].pot -= offset;
deba@338
  2787
        }
deba@338
  2788
deba@338
  2789
        Arc matching = (*_blossom_data)[blossoms[i]].next;
deba@338
  2790
        Node base = _graph.source(matching);
deba@338
  2791
        extractBlossom(blossoms[i], base, matching);
deba@338
  2792
      }
deba@338
  2793
    }
deba@338
  2794
deba@338
  2795
  public:
deba@338
  2796
deba@338
  2797
    /// \brief Constructor
deba@338
  2798
    ///
deba@338
  2799
    /// Constructor.
deba@338
  2800
    MaxWeightedPerfectMatching(const Graph& graph, const WeightMap& weight)
deba@338
  2801
      : _graph(graph), _weight(weight), _matching(0),
deba@338
  2802
        _node_potential(0), _blossom_potential(), _blossom_node_list(),
deba@338
  2803
        _node_num(0), _blossom_num(0),
deba@338
  2804
deba@338
  2805
        _blossom_index(0), _blossom_set(0), _blossom_data(0),
deba@338
  2806
        _node_index(0), _node_heap_index(0), _node_data(0),
deba@338
  2807
        _tree_set_index(0), _tree_set(0),
deba@338
  2808
deba@338
  2809
        _delta2_index(0), _delta2(0),
deba@338
  2810
        _delta3_index(0), _delta3(0),
deba@338
  2811
        _delta4_index(0), _delta4(0),
deba@338
  2812
deba@338
  2813
        _delta_sum() {}
deba@338
  2814
deba@338
  2815
    ~MaxWeightedPerfectMatching() {
deba@338
  2816
      destroyStructures();
deba@338
  2817
    }
deba@338
  2818
deba@338
  2819
    /// \name Execution control
deba@338
  2820
    /// The simplest way to execute the algorithm is to use the member
deba@338
  2821
    /// \c run() member function.
deba@338
  2822
deba@338
  2823
    ///@{
deba@338
  2824
deba@338
  2825
    /// \brief Initialize the algorithm
deba@338
  2826
    ///
deba@338
  2827
    /// Initialize the algorithm
deba@338
  2828
    void init() {
deba@338
  2829
      createStructures();
deba@338
  2830
deba@338
  2831
      for (ArcIt e(_graph); e != INVALID; ++e) {
deba@339
  2832
        _node_heap_index->set(e, BinHeap<Value, IntArcMap>::PRE_HEAP);
deba@338
  2833
      }
deba@338
  2834
      for (EdgeIt e(_graph); e != INVALID; ++e) {
deba@338
  2835
        _delta3_index->set(e, _delta3->PRE_HEAP);
deba@338
  2836
      }
deba@338
  2837
      for (int i = 0; i < _blossom_num; ++i) {
deba@338
  2838
        _delta2_index->set(i, _delta2->PRE_HEAP);
deba@338
  2839
        _delta4_index->set(i, _delta4->PRE_HEAP);
deba@338
  2840
      }
deba@338
  2841
deba@338
  2842
      int index = 0;
deba@338
  2843
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@338
  2844
        Value max = - std::numeric_limits<Value>::max();
deba@338
  2845
        for (OutArcIt e(_graph, n); e != INVALID; ++e) {
deba@338
  2846
          if (_graph.target(e) == n) continue;
deba@338
  2847
          if ((dualScale * _weight[e]) / 2 > max) {
deba@338
  2848
            max = (dualScale * _weight[e]) / 2;
deba@338
  2849
          }
deba@338
  2850
        }
deba@338
  2851
        _node_index->set(n, index);
deba@338
  2852
        (*_node_data)[index].pot = max;
deba@338
  2853
        int blossom =
deba@338
  2854
          _blossom_set->insert(n, std::numeric_limits<Value>::max());
deba@338
  2855
deba@338
  2856
        _tree_set->insert(blossom);
deba@338
  2857
deba@338
  2858
        (*_blossom_data)[blossom].status = EVEN;
deba@338
  2859
        (*_blossom_data)[blossom].pred = INVALID;
deba@338
  2860
        (*_blossom_data)[blossom].next = INVALID;
deba@338
  2861
        (*_blossom_data)[blossom].pot = 0;
deba@338
  2862
        (*_blossom_data)[blossom].offset = 0;
deba@338
  2863
        ++index;
deba@338
  2864
      }
deba@338
  2865
      for (EdgeIt e(_graph); e != INVALID; ++e) {
deba@338
  2866
        int si = (*_node_index)[_graph.u(e)];
deba@338
  2867
        int ti = (*_node_index)[_graph.v(e)];
deba@338
  2868
        if (_graph.u(e) != _graph.v(e)) {
deba@338
  2869
          _delta3->push(e, ((*_node_data)[si].pot + (*_node_data)[ti].pot -
deba@338
  2870
                            dualScale * _weight[e]) / 2);
deba@338
  2871
        }
deba@338
  2872
      }
deba@338
  2873
    }
deba@338
  2874
deba@338
  2875
    /// \brief Starts the algorithm
deba@338
  2876
    ///
deba@338
  2877
    /// Starts the algorithm
deba@338
  2878
    bool start() {
deba@338
  2879
      enum OpType {
deba@338
  2880
        D2, D3, D4
deba@338
  2881
      };
deba@338
  2882
deba@338
  2883
      int unmatched = _node_num;
deba@338
  2884
      while (unmatched > 0) {
deba@338
  2885
        Value d2 = !_delta2->empty() ?
deba@338
  2886
          _delta2->prio() : std::numeric_limits<Value>::max();
deba@338
  2887
deba@338
  2888
        Value d3 = !_delta3->empty() ?
deba@338
  2889
          _delta3->prio() : std::numeric_limits<Value>::max();
deba@338
  2890
deba@338
  2891
        Value d4 = !_delta4->empty() ?
deba@338
  2892
          _delta4->prio() : std::numeric_limits<Value>::max();
deba@338
  2893
deba@338
  2894
        _delta_sum = d2; OpType ot = D2;
deba@338
  2895
        if (d3 < _delta_sum) { _delta_sum = d3; ot = D3; }
deba@338
  2896
        if (d4 < _delta_sum) { _delta_sum = d4; ot = D4; }
deba@338
  2897
deba@338
  2898
        if (_delta_sum == std::numeric_limits<Value>::max()) {
deba@338
  2899
          return false;
deba@338
  2900
        }
deba@338
  2901
deba@338
  2902
        switch (ot) {
deba@338
  2903
        case D2:
deba@338
  2904
          {
deba@338
  2905
            int blossom = _delta2->top();
deba@338
  2906
            Node n = _blossom_set->classTop(blossom);
deba@338
  2907
            Arc e = (*_node_data)[(*_node_index)[n]].heap.top();
deba@338
  2908
            extendOnArc(e);
deba@338
  2909
          }
deba@338
  2910
          break;
deba@338
  2911
        case D3:
deba@338
  2912
          {
deba@338
  2913
            Edge e = _delta3->top();
deba@338
  2914
deba@338
  2915
            int left_blossom = _blossom_set->find(_graph.u(e));
deba@338
  2916
            int right_blossom = _blossom_set->find(_graph.v(e));
deba@338
  2917
deba@338
  2918
            if (left_blossom == right_blossom) {
deba@338
  2919
              _delta3->pop();
deba@338
  2920
            } else {
deba@338
  2921
              int left_tree = _tree_set->find(left_blossom);
deba@338
  2922
              int right_tree = _tree_set->find(right_blossom);
deba@338
  2923
deba@338
  2924
              if (left_tree == right_tree) {
deba@339
  2925
                shrinkOnEdge(e, left_tree);
deba@338
  2926
              } else {
deba@339
  2927
                augmentOnEdge(e);
deba@338
  2928
                unmatched -= 2;
deba@338
  2929
              }
deba@338
  2930
            }
deba@338
  2931
          } break;
deba@338
  2932
        case D4:
deba@338
  2933
          splitBlossom(_delta4->top());
deba@338
  2934
          break;
deba@338
  2935
        }
deba@338
  2936
      }
deba@338
  2937
      extractMatching();
deba@338
  2938
      return true;
deba@338
  2939
    }
deba@338
  2940
deba@338
  2941
    /// \brief Runs %MaxWeightedPerfectMatching algorithm.
deba@338
  2942
    ///
deba@338
  2943
    /// This method runs the %MaxWeightedPerfectMatching algorithm.
deba@338
  2944
    ///
deba@338
  2945
    /// \note mwm.run() is just a shortcut of the following code.
deba@338
  2946
    /// \code
deba@338
  2947
    ///   mwm.init();
deba@338
  2948
    ///   mwm.start();
deba@338
  2949
    /// \endcode
deba@338
  2950
    bool run() {
deba@338
  2951
      init();
deba@338
  2952
      return start();
deba@338
  2953
    }
deba@338
  2954
deba@338
  2955
    /// @}
deba@338
  2956
deba@338
  2957
    /// \name Primal solution
deba@338
  2958
    /// Functions for get the primal solution, ie. the matching.
deba@338
  2959
deba@338
  2960
    /// @{
deba@338
  2961
deba@338
  2962
    /// \brief Returns the matching value.
deba@338
  2963
    ///
deba@338
  2964
    /// Returns the matching value.
deba@338
  2965
    Value matchingValue() const {
deba@338
  2966
      Value sum = 0;
deba@338
  2967
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@338
  2968
        if ((*_matching)[n] != INVALID) {
deba@338
  2969
          sum += _weight[(*_matching)[n]];
deba@338
  2970
        }
deba@338
  2971
      }
deba@338
  2972
      return sum /= 2;
deba@338
  2973
    }
deba@338
  2974
deba@339
  2975
    /// \brief Returns true when the edge is in the matching.
deba@338
  2976
    ///
deba@339
  2977
    /// Returns true when the edge is in the matching.
deba@339
  2978
    bool matching(const Edge& edge) const {
deba@339
  2979
      return static_cast<const Edge&>((*_matching)[_graph.u(edge)]) == edge;
deba@338
  2980
    }
deba@338
  2981
deba@339
  2982
    /// \brief Returns the incident matching edge.
deba@338
  2983
    ///
deba@339
  2984
    /// Returns the incident matching arc from given edge.
deba@338
  2985
    Arc matching(const Node& node) const {
deba@338
  2986
      return (*_matching)[node];
deba@338
  2987
    }
deba@338
  2988
deba@338
  2989
    /// \brief Returns the mate of the node.
deba@338
  2990
    ///
deba@338
  2991
    /// Returns the adjancent node in a mathcing arc.
deba@338
  2992
    Node mate(const Node& node) const {
deba@338
  2993
      return _graph.target((*_matching)[node]);
deba@338
  2994
    }
deba@338
  2995
deba@338
  2996
    /// @}
deba@338
  2997
deba@338
  2998
    /// \name Dual solution
deba@338
  2999
    /// Functions for get the dual solution.
deba@338
  3000
deba@338
  3001
    /// @{
deba@338
  3002
deba@338
  3003
    /// \brief Returns the value of the dual solution.
deba@338
  3004
    ///
deba@338
  3005
    /// Returns the value of the dual solution. It should be equal to
deba@338
  3006
    /// the primal value scaled by \ref dualScale "dual scale".
deba@338
  3007
    Value dualValue() const {
deba@338
  3008
      Value sum = 0;
deba@338
  3009
      for (NodeIt n(_graph); n != INVALID; ++n) {
deba@338
  3010
        sum += nodeValue(n);
deba@338
  3011
      }
deba@338
  3012
      for (int i = 0; i < blossomNum(); ++i) {
deba@338
  3013
        sum += blossomValue(i) * (blossomSize(i) / 2);
deba@338
  3014
      }
deba@338
  3015
      return sum;
deba@338
  3016
    }
deba@338
  3017
deba@338
  3018
    /// \brief Returns the value of the node.
deba@338
  3019
    ///
deba@338
  3020
    /// Returns the the value of the node.
deba@338
  3021
    Value nodeValue(const Node& n) const {
deba@338
  3022
      return (*_node_potential)[n];
deba@338
  3023
    }
deba@338
  3024
deba@338
  3025
    /// \brief Returns the number of the blossoms in the basis.
deba@338
  3026
    ///
deba@338
  3027
    /// Returns the number of the blossoms in the basis.
deba@338
  3028
    /// \see BlossomIt
deba@338
  3029
    int blossomNum() const {
deba@338
  3030
      return _blossom_potential.size();
deba@338
  3031
    }
deba@338
  3032
deba@338
  3033
deba@338
  3034
    /// \brief Returns the number of the nodes in the blossom.
deba@338
  3035
    ///
deba@338
  3036
    /// Returns the number of the nodes in the blossom.
deba@338
  3037
    int blossomSize(int k) const {
deba@338
  3038
      return _blossom_potential[k].end - _blossom_potential[k].begin;
deba@338
  3039
    }
deba@338
  3040
deba@338
  3041
    /// \brief Returns the value of the blossom.
deba@338
  3042
    ///
deba@338
  3043
    /// Returns the the value of the blossom.
deba@338
  3044
    /// \see BlossomIt
deba@338
  3045
    Value blossomValue(int k) const {
deba@338
  3046
      return _blossom_potential[k].value;
deba@338
  3047
    }
deba@338
  3048
deba@338
  3049
    /// \brief Lemon iterator for get the items of the blossom.
deba@338
  3050
    ///
deba@338
  3051
    /// Lemon iterator for get the nodes of the blossom. This class
deba@338
  3052
    /// provides a common style lemon iterator which gives back a
deba@338
  3053
    /// subset of the nodes.
deba@338
  3054
    class BlossomIt {
deba@338
  3055
    public:
deba@338
  3056
deba@338
  3057
      /// \brief Constructor.
deba@338
  3058
      ///
deba@338
  3059
      /// Constructor for get the nodes of the variable.
deba@338
  3060
      BlossomIt(const MaxWeightedPerfectMatching& algorithm, int variable)
deba@338
  3061
        : _algorithm(&algorithm)
deba@338
  3062
      {
deba@338
  3063
        _index = _algorithm->_blossom_potential[variable].begin;
deba@338
  3064
        _last = _algorithm->_blossom_potential[variable].end;
deba@338
  3065
      }
deba@338
  3066
deba@338
  3067
      /// \brief Conversion to node.
deba@338
  3068
      ///
deba@338
  3069
      /// Conversion to node.
deba@338
  3070
      operator Node() const {
deba@339
  3071
        return _algorithm->_blossom_node_list[_index];
deba@338
  3072
      }
deba@338
  3073
deba@338
  3074
      /// \brief Increment operator.
deba@338
  3075
      ///
deba@338
  3076
      /// Increment operator.
deba@338
  3077
      BlossomIt& operator++() {
deba@338
  3078
        ++_index;
deba@338
  3079
        return *this;
deba@338
  3080
      }
deba@338
  3081
deba@339
  3082
      /// \brief Validity checking
deba@339
  3083
      ///
deba@339
  3084
      /// Checks whether the iterator is invalid.
deba@339
  3085
      bool operator==(Invalid) const { return _index == _last; }
deba@339
  3086
deba@339
  3087
      /// \brief Validity checking
deba@339
  3088
      ///
deba@339
  3089
      /// Checks whether the iterator is valid.
deba@339
  3090
      bool operator!=(Invalid) const { return _index != _last; }
deba@338
  3091
deba@338
  3092
    private:
deba@338
  3093
      const MaxWeightedPerfectMatching* _algorithm;
deba@338
  3094
      int _last;
deba@338
  3095
      int _index;
deba@338
  3096
    };
deba@338
  3097
deba@338
  3098
    /// @}
deba@338
  3099
deba@338
  3100
  };
deba@338
  3101
deba@338
  3102
deba@338
  3103
} //END OF NAMESPACE LEMON
deba@338
  3104
deba@338
  3105
#endif //LEMON_MAX_MATCHING_H