src/include/fib_heap.h
author alpar
Thu, 29 Apr 2004 08:33:16 +0000
changeset 463 7f3ef3009dd3
parent 387 4406c93c862b
child 477 02b8ddcb207a
permissions -rw-r--r--
doc
alpar@255
     1
// -*- C++ -*-
alpar@255
     2
jacint@373
     3
#ifndef HUGO_FIB_HEAP_H
jacint@373
     4
#define HUGO_FIB_HEAP_H
alpar@255
     5
alpar@430
     6
///ingroup auxdat
alpar@255
     7
///\file
alpar@255
     8
///\brief Fibonacci Heap implementation.
alpar@255
     9
alpar@255
    10
#include <vector>
alpar@255
    11
#include <functional>
alpar@255
    12
#include <math.h>
alpar@255
    13
alpar@255
    14
namespace hugo {
alpar@255
    15
  
alpar@430
    16
  /// \addtogroup auxdat
alpar@430
    17
  /// @{
alpar@430
    18
jacint@373
    19
  /// An implementation of the Fibonacci Heap.
jacint@373
    20
jacint@373
    21
  /**
jacint@387
    22
     This class implements the \e Fibonacci \e heap data structure. A \e heap
jacint@387
    23
     is a data structure for storing items with specified values called \e
jacint@387
    24
     priorities, such that finding the item with minimum priority with respect
jacint@387
    25
     to \e Compare is efficient. In a heap one can change the priority of an
jacint@387
    26
     item, add or erase an item, etc.
jacint@373
    27
jacint@387
    28
     The methods \ref increase and \ref erase are not efficient in a Fibonacci
jacint@387
    29
     heap. In case of many calls to these operations, it is better to use a
jacint@387
    30
     \e binary \e heap.
jacint@373
    31
     
jacint@387
    32
     \param Item The type of the items to be stored.  
jacint@387
    33
     \param Prio The type of the priority of the items.
jacint@387
    34
     \param ItemIntMap A read and writable Item int map, for the usage of
jacint@373
    35
     the heap.
jacint@387
    36
     \param Compare A class for the comparison of the priorities. The
jacint@373
    37
     default is \c std::less<Prio>.
jacint@373
    38
jacint@373
    39
  */
jacint@373
    40
jacint@373
    41
#ifdef DOXYGEN
jacint@373
    42
  template <typename Item, 
jacint@373
    43
	    typename Prio, 
jacint@373
    44
	    typename ItemIntMap, 
jacint@373
    45
	    typename Compare>
jacint@373
    46
#else
jacint@373
    47
  template <typename Item, 
jacint@373
    48
	    typename Prio, 
jacint@373
    49
	    typename ItemIntMap, 
alpar@255
    50
	    typename Compare = std::less<Prio> >
jacint@373
    51
#endif
alpar@255
    52
  class FibHeap {
jacint@387
    53
  public:     
alpar@255
    54
    typedef Prio PrioType;
alpar@255
    55
    
jacint@373
    56
  private:
alpar@255
    57
    class store;
alpar@255
    58
    
alpar@255
    59
    std::vector<store> container;
alpar@255
    60
    int minimum;
alpar@255
    61
    ItemIntMap &iimap;
alpar@255
    62
    Compare comp;
alpar@255
    63
    int num_items;
jacint@373
    64
    
alpar@255
    65
    ///\todo It is use nowhere
alpar@255
    66
    ///\todo It doesn't conform to the naming conventions.
alpar@255
    67
  public:
alpar@255
    68
    enum state_enum {
alpar@255
    69
      IN_HEAP = 0,
alpar@255
    70
      PRE_HEAP = -1,
alpar@255
    71
      POST_HEAP = -2
alpar@255
    72
    };
alpar@255
    73
    
jacint@373
    74
    FibHeap(ItemIntMap &_iimap) : minimum(0), iimap(_iimap), num_items() {} 
jacint@373
    75
    FibHeap(ItemIntMap &_iimap, const Compare &_comp) : minimum(0), 
alpar@255
    76
      iimap(_iimap), comp(_comp), num_items() {}
alpar@255
    77
    
jacint@373
    78
    ///The number of items stored in the heap.
jacint@373
    79
jacint@373
    80
    /**
jacint@387
    81
       Returns the number of items stored in the heap.
jacint@373
    82
    */
jacint@373
    83
    int size() const { return num_items; }
jacint@373
    84
jacint@373
    85
    ///Checks if the heap stores no items.
alpar@255
    86
    
jacint@373
    87
    /**
jacint@387
    88
       Returns \c true iff the heap stores no items.
jacint@373
    89
    */
jacint@373
    90
    bool empty() const { return num_items==0; }
jacint@373
    91
jacint@387
    92
    ///\c item gets to the heap with priority \c value independently if \c item was already there.
jacint@373
    93
jacint@373
    94
    /**
jacint@387
    95
       This method calls \ref push(\c item, \c value) if \c item is not
jacint@387
    96
       stored in the heap and it calls \ref decrease(\c item, \c value) or
jacint@387
    97
       \ref increase(\c item, \c value) otherwise.
jacint@373
    98
    */
jacint@387
    99
    void set (Item const item, PrioType const value); 
jacint@373
   100
    
jacint@373
   101
    ///Adds \c item to the heap with priority \c value. 
jacint@373
   102
    
jacint@373
   103
    /**
jacint@373
   104
       Adds \c item to the heap with priority \c value. 
jacint@373
   105
       \pre \c item must not be stored in the heap. 
jacint@373
   106
    */
jacint@387
   107
    void push (Item const item, PrioType const value);
jacint@373
   108
    
jacint@373
   109
    
jacint@373
   110
    ///Returns the item having the minimum priority w.r.t.  Compare.
jacint@373
   111
    
jacint@373
   112
    /**
jacint@373
   113
       This method returns the item having the minimum priority w.r.t.  Compare. 
jacint@373
   114
       \pre The heap must be nonempty.
jacint@373
   115
    */
jacint@373
   116
    Item top() const { return container[minimum].name; }
jacint@373
   117
    
jacint@373
   118
jacint@373
   119
    ///Returns the minimum priority w.r.t.  Compare.
jacint@373
   120
jacint@373
   121
    /**
jacint@373
   122
       It returns the minimum priority w.r.t.  Compare.
jacint@373
   123
       \pre The heap must be nonempty.
jacint@373
   124
    */
jacint@373
   125
    PrioType prio() const { return container[minimum].prio; }
jacint@373
   126
    
jacint@373
   127
jacint@373
   128
    ///Returns the priority of \c item.
jacint@373
   129
jacint@373
   130
    /**
jacint@373
   131
       It returns the priority of \c item.
jacint@373
   132
       \pre \c item must be in the heap.
jacint@373
   133
    */
jacint@387
   134
    PrioType& operator[](const Item& item) { 
jacint@387
   135
      return container[iimap[item]].prio; 
jacint@387
   136
    }
jacint@373
   137
    
jacint@373
   138
    ///Returns the priority of \c item.
jacint@373
   139
    
jacint@373
   140
    /**
jacint@373
   141
       It returns the priority of \c item.
jacint@373
   142
       \pre \c item must be in the heap.
jacint@373
   143
    */
jacint@387
   144
    const PrioType& operator[](const Item& item) const { 
jacint@387
   145
      return container[iimap[item]].prio; 
alpar@255
   146
    }
alpar@255
   147
alpar@255
   148
jacint@373
   149
    ///Deletes the item with minimum priority w.r.t.  Compare.
alpar@255
   150
jacint@373
   151
    /**
jacint@373
   152
    This method deletes the item with minimum priority w.r.t. 
jacint@373
   153
    Compare from the heap.
jacint@373
   154
    \pre The heap must be non-empty.
jacint@373
   155
    */
jacint@373
   156
    void pop();
jacint@373
   157
jacint@373
   158
    ///Deletes \c item from the heap.
jacint@373
   159
jacint@373
   160
    /**
jacint@373
   161
       This method deletes \c item from the heap, if \c item was already
jacint@373
   162
       stored in the heap. It is quite inefficient in Fibonacci heaps.
jacint@373
   163
    */
jacint@387
   164
    void erase (const Item& item); 
jacint@373
   165
jacint@373
   166
    ///Decreases the priority of \c item to \c value.
jacint@373
   167
jacint@373
   168
    /**
jacint@373
   169
       This method decreases the priority of \c item to \c value.
jacint@373
   170
       \pre \c item must be stored in the heap with priority at least \c
jacint@373
   171
       value w.r.t.  Compare.
jacint@373
   172
    */
jacint@387
   173
    void decrease (Item item, PrioType const value); 
jacint@373
   174
jacint@373
   175
jacint@373
   176
    ///Increases the priority of \c item to \c value.
jacint@373
   177
jacint@373
   178
    /**
jacint@373
   179
       This method sets the priority of \c item to \c value. Though
jacint@373
   180
       there is no precondition on the priority of \c item, this
jacint@387
   181
       method should be used only if there is a need to really \e increase
jacint@373
   182
       (w.r.t.  Compare) the priority of \c item, because this
jacint@373
   183
       method is inefficient.
jacint@373
   184
    */
jacint@387
   185
    void increase (Item item, PrioType const value) {
jacint@387
   186
      erase(item);
jacint@387
   187
      push(item, value);
jacint@373
   188
    }
jacint@373
   189
jacint@373
   190
jacint@387
   191
    ///Tells if \c item is in, was already in, or has never been in the heap.
jacint@373
   192
jacint@373
   193
    /**
jacint@373
   194
       This method returns PRE_HEAP if \c item has never been in the
jacint@373
   195
       heap, IN_HEAP if it is in the heap at the moment, and POST_HEAP
jacint@373
   196
       otherwise. In the latter case it is possible that \c item will
jacint@373
   197
       get back to the heap again.
jacint@373
   198
    */
jacint@387
   199
    state_enum state(const Item &item) const {
jacint@387
   200
      int i=iimap[item];
jacint@387
   201
      if( i>=0 ) {
jacint@387
   202
	if ( container[i].in ) i=0;
jacint@387
   203
	else i=-2; 
jacint@387
   204
      }
jacint@387
   205
      return state_enum(i);
jacint@387
   206
    }    
jacint@387
   207
    
jacint@387
   208
  private:
jacint@387
   209
    
jacint@387
   210
    void balance();
jacint@387
   211
    void makeroot(int c);
jacint@387
   212
    void cut(int a, int b);
jacint@387
   213
    void cascade(int a);
jacint@387
   214
    void fuse(int a, int b);
jacint@387
   215
    void unlace(int a);
jacint@373
   216
jacint@373
   217
jacint@387
   218
    class store {
jacint@387
   219
      friend class FibHeap;
jacint@387
   220
      
jacint@387
   221
      Item name;
jacint@387
   222
      int parent;
jacint@387
   223
      int left_neighbor;
jacint@387
   224
      int right_neighbor;
jacint@387
   225
      int child;
jacint@387
   226
      int degree;  
jacint@387
   227
      bool marked;
jacint@387
   228
      bool in;
jacint@387
   229
      PrioType prio;
jacint@387
   230
      
jacint@387
   231
      store() : parent(-1), child(-1), degree(), marked(false), in(true) {} 
jacint@387
   232
    };
jacint@387
   233
  };    
jacint@387
   234
 
jacint@387
   235
jacint@373
   236
jacint@373
   237
    // **********************************************************************
jacint@373
   238
    //  IMPLEMENTATIONS
jacint@373
   239
    // **********************************************************************
jacint@373
   240
    
jacint@387
   241
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   242
    typename Compare>
jacint@387
   243
  void FibHeap<Item, Prio, ItemIntMap, Compare>::set 
jacint@387
   244
  (Item const item, PrioType const value) 
jacint@387
   245
  {
jacint@387
   246
    int i=iimap[item];
jacint@387
   247
    if ( i >= 0 && container[i].in ) {
jacint@387
   248
      if ( comp(value, container[i].prio) ) decrease(item, value); 
jacint@387
   249
      if ( comp(container[i].prio, value) ) increase(item, value); 
jacint@387
   250
    } else push(item, value);
jacint@387
   251
  }
alpar@255
   252
    
jacint@387
   253
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   254
    typename Compare>
jacint@387
   255
  void FibHeap<Item, Prio, ItemIntMap, Compare>::push 
jacint@387
   256
  (Item const item, PrioType const value) {
jacint@387
   257
      int i=iimap[item];      
alpar@255
   258
      if ( i < 0 ) {
alpar@255
   259
	int s=container.size();
jacint@387
   260
	iimap.set( item, s );	
alpar@255
   261
	store st;
jacint@387
   262
	st.name=item;
alpar@255
   263
	container.push_back(st);
alpar@255
   264
	i=s;
alpar@255
   265
      } else {
alpar@255
   266
	container[i].parent=container[i].child=-1;
alpar@255
   267
	container[i].degree=0;
alpar@255
   268
	container[i].in=true;
alpar@255
   269
	container[i].marked=false;
alpar@255
   270
      }
alpar@255
   271
alpar@255
   272
      if ( num_items ) {
alpar@255
   273
	container[container[minimum].right_neighbor].left_neighbor=i;
alpar@255
   274
	container[i].right_neighbor=container[minimum].right_neighbor;
alpar@255
   275
	container[minimum].right_neighbor=i;
alpar@255
   276
	container[i].left_neighbor=minimum;
alpar@255
   277
	if ( comp( value, container[minimum].prio) ) minimum=i; 
alpar@255
   278
      } else {
alpar@255
   279
	container[i].right_neighbor=container[i].left_neighbor=i;
alpar@255
   280
	minimum=i;	
alpar@255
   281
      }
alpar@255
   282
      container[i].prio=value;
alpar@255
   283
      ++num_items;
alpar@255
   284
    }
alpar@255
   285
    
jacint@387
   286
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   287
    typename Compare>
jacint@387
   288
  void FibHeap<Item, Prio, ItemIntMap, Compare>::pop() {
alpar@255
   289
      /*The first case is that there are only one root.*/
alpar@255
   290
      if ( container[minimum].left_neighbor==minimum ) {
alpar@255
   291
	container[minimum].in=false;
alpar@255
   292
	if ( container[minimum].degree!=0 ) { 
alpar@255
   293
	  makeroot(container[minimum].child);
alpar@255
   294
	  minimum=container[minimum].child;
alpar@255
   295
	  balance();
alpar@255
   296
	}
alpar@255
   297
      } else {
alpar@255
   298
	int right=container[minimum].right_neighbor;
alpar@255
   299
	unlace(minimum);
alpar@255
   300
	container[minimum].in=false;
alpar@255
   301
	if ( container[minimum].degree > 0 ) {
alpar@255
   302
	  int left=container[minimum].left_neighbor;
alpar@255
   303
	  int child=container[minimum].child;
alpar@255
   304
	  int last_child=container[child].left_neighbor;
alpar@255
   305
	
alpar@255
   306
	  makeroot(child);
alpar@255
   307
	  
alpar@255
   308
	  container[left].right_neighbor=child;
alpar@255
   309
	  container[child].left_neighbor=left;
alpar@255
   310
	  container[right].left_neighbor=last_child;
alpar@255
   311
	  container[last_child].right_neighbor=right;
alpar@255
   312
	}
alpar@255
   313
	minimum=right;
alpar@255
   314
	balance();
alpar@255
   315
      } // the case where there are more roots
alpar@255
   316
      --num_items;   
alpar@255
   317
    }
alpar@255
   318
jacint@387
   319
jacint@387
   320
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   321
    typename Compare>
jacint@387
   322
  void FibHeap<Item, Prio, ItemIntMap, Compare>::erase 
jacint@387
   323
  (const Item& item) {
jacint@387
   324
      int i=iimap[item];
alpar@255
   325
      
alpar@255
   326
      if ( i >= 0 && container[i].in ) { 	
alpar@255
   327
	if ( container[i].parent!=-1 ) {
alpar@255
   328
	  int p=container[i].parent;
alpar@255
   329
	  cut(i,p);	    
alpar@255
   330
	  cascade(p);
alpar@255
   331
	}
alpar@255
   332
	minimum=i;     //As if its prio would be -infinity
alpar@255
   333
	pop();
alpar@255
   334
      }
jacint@387
   335
  }
alpar@255
   336
    
jacint@387
   337
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   338
    typename Compare>
jacint@387
   339
  void FibHeap<Item, Prio, ItemIntMap, Compare>::decrease 
jacint@387
   340
  (Item item, PrioType const value) {
jacint@387
   341
      int i=iimap[item];
alpar@255
   342
      container[i].prio=value;
alpar@255
   343
      int p=container[i].parent;
alpar@255
   344
      
alpar@255
   345
      if ( p!=-1 && comp(value, container[p].prio) ) {
alpar@255
   346
	cut(i,p);	    
alpar@255
   347
	cascade(p);
alpar@255
   348
      }      
alpar@255
   349
      if ( comp(value, container[minimum].prio) ) minimum=i; 
jacint@387
   350
  }
jacint@387
   351
 
alpar@255
   352
jacint@387
   353
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   354
    typename Compare>
jacint@387
   355
  void FibHeap<Item, Prio, ItemIntMap, Compare>::balance() {      
alpar@255
   356
alpar@255
   357
    int maxdeg=int( floor( 2.08*log(double(container.size()))))+1;
alpar@255
   358
  
alpar@255
   359
    std::vector<int> A(maxdeg,-1); 
alpar@255
   360
    
alpar@255
   361
    /*
alpar@255
   362
     *Recall that now minimum does not point to the minimum prio element.
alpar@255
   363
     *We set minimum to this during balance().
alpar@255
   364
     */
alpar@255
   365
    int anchor=container[minimum].left_neighbor; 
alpar@255
   366
    int next=minimum; 
alpar@255
   367
    bool end=false; 
alpar@255
   368
    	
alpar@255
   369
       do {
alpar@255
   370
	int active=next;
alpar@255
   371
	if ( anchor==active ) end=true;
alpar@255
   372
	int d=container[active].degree;
alpar@255
   373
	next=container[active].right_neighbor;
alpar@255
   374
alpar@255
   375
	while (A[d]!=-1) {	  
alpar@255
   376
	  if( comp(container[active].prio, container[A[d]].prio) ) {
alpar@255
   377
	    fuse(active,A[d]); 
alpar@255
   378
	  } else { 
alpar@255
   379
	    fuse(A[d],active);
alpar@255
   380
	    active=A[d];
alpar@255
   381
	  } 
alpar@255
   382
	  A[d]=-1;
alpar@255
   383
	  ++d;
alpar@255
   384
	}	
alpar@255
   385
	A[d]=active;
alpar@255
   386
       } while ( !end );
alpar@255
   387
alpar@255
   388
alpar@255
   389
       while ( container[minimum].parent >=0 ) minimum=container[minimum].parent;
alpar@255
   390
       int s=minimum;
alpar@255
   391
       int m=minimum;
alpar@255
   392
       do {  
alpar@255
   393
	 if ( comp(container[s].prio, container[minimum].prio) ) minimum=s;
alpar@255
   394
	 s=container[s].right_neighbor;
alpar@255
   395
       } while ( s != m );
alpar@255
   396
    }
alpar@255
   397
jacint@387
   398
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   399
    typename Compare>
jacint@387
   400
  void FibHeap<Item, Prio, ItemIntMap, Compare>::makeroot 
jacint@387
   401
  (int c) {
alpar@255
   402
      int s=c;
alpar@255
   403
      do {  
alpar@255
   404
	container[s].parent=-1;
alpar@255
   405
	s=container[s].right_neighbor;
alpar@255
   406
      } while ( s != c );
alpar@255
   407
    }
jacint@387
   408
  
jacint@387
   409
  
jacint@387
   410
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   411
    typename Compare>
jacint@387
   412
  void FibHeap<Item, Prio, ItemIntMap, Compare>::cut 
jacint@387
   413
  (int a, int b) {    
jacint@387
   414
    /*
jacint@387
   415
     *Replacing a from the children of b.
jacint@387
   416
     */
jacint@387
   417
    --container[b].degree;
alpar@255
   418
    
jacint@387
   419
    if ( container[b].degree !=0 ) {
jacint@387
   420
      int child=container[b].child;
jacint@387
   421
      if ( child==a ) 
jacint@387
   422
	container[b].child=container[child].right_neighbor;
jacint@387
   423
      unlace(a);
jacint@387
   424
    }
jacint@387
   425
    
jacint@387
   426
    
jacint@387
   427
    /*Lacing a to the roots.*/
jacint@387
   428
    int right=container[minimum].right_neighbor;
jacint@387
   429
    container[minimum].right_neighbor=a;
jacint@387
   430
    container[a].left_neighbor=minimum;
jacint@387
   431
    container[a].right_neighbor=right;
jacint@387
   432
    container[right].left_neighbor=a;
jacint@387
   433
    
jacint@387
   434
    container[a].parent=-1;
jacint@387
   435
    container[a].marked=false;
jacint@387
   436
  }
jacint@387
   437
  
alpar@255
   438
jacint@387
   439
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   440
    typename Compare>
jacint@387
   441
  void FibHeap<Item, Prio, ItemIntMap, Compare>::cascade 
jacint@387
   442
  (int a) 
alpar@255
   443
    {
alpar@255
   444
      if ( container[a].parent!=-1 ) {
alpar@255
   445
	int p=container[a].parent;
alpar@255
   446
	
alpar@255
   447
	if ( container[a].marked==false ) container[a].marked=true;
alpar@255
   448
	else {
alpar@255
   449
	  cut(a,p);
alpar@255
   450
	  cascade(p);
alpar@255
   451
	}
alpar@255
   452
      }
alpar@255
   453
    }
alpar@255
   454
alpar@255
   455
jacint@387
   456
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   457
    typename Compare>
jacint@387
   458
  void FibHeap<Item, Prio, ItemIntMap, Compare>::fuse 
jacint@387
   459
  (int a, int b) {
alpar@255
   460
      unlace(b);
alpar@255
   461
      
alpar@255
   462
      /*Lacing b under a.*/
alpar@255
   463
      container[b].parent=a;
alpar@255
   464
alpar@255
   465
      if (container[a].degree==0) {
alpar@255
   466
	container[b].left_neighbor=b;
alpar@255
   467
	container[b].right_neighbor=b;
alpar@255
   468
	container[a].child=b;	
alpar@255
   469
      } else {
alpar@255
   470
	int child=container[a].child;
alpar@255
   471
	int last_child=container[child].left_neighbor;
alpar@255
   472
	container[child].left_neighbor=b;
alpar@255
   473
	container[b].right_neighbor=child;
alpar@255
   474
	container[last_child].right_neighbor=b;
alpar@255
   475
	container[b].left_neighbor=last_child;
alpar@255
   476
      }
alpar@255
   477
alpar@255
   478
      ++container[a].degree;
alpar@255
   479
      
alpar@255
   480
      container[b].marked=false;
alpar@255
   481
    }
alpar@255
   482
jacint@387
   483
  
jacint@387
   484
  /*
jacint@387
   485
   *It is invoked only if a has siblings.
jacint@387
   486
   */
jacint@387
   487
  template <typename Item, typename Prio, typename ItemIntMap, 
jacint@387
   488
    typename Compare>
jacint@387
   489
  void FibHeap<Item, Prio, ItemIntMap, Compare>::unlace 
jacint@387
   490
  (int a) {      
alpar@255
   491
      int leftn=container[a].left_neighbor;
alpar@255
   492
      int rightn=container[a].right_neighbor;
alpar@255
   493
      container[leftn].right_neighbor=rightn;
alpar@255
   494
      container[rightn].left_neighbor=leftn;
jacint@387
   495
  }
alpar@255
   496
  
alpar@430
   497
  ///@}
alpar@430
   498
alpar@255
   499
} //namespace hugo
alpar@255
   500
#endif