Skip to main content

An implementation of Fibonacci heap

Project description

Fibonacci Heap

Fibonacci Heap Overview

The data structure and its operations are described Cormen et al. (chapter 19) Fibonacci heap supports mergeable-heap operations, including make-heap, insert, minimum, extract-min, and union. The data structure also supports key-decrease and delete, although using these two operations requires users to create nodes for items themselves.



Each node has the following attributes:

  • left, right: the node’s adjacent siblings. The node and its siblings are doubly linked, so they form a circular loop. If x is an only child, it is its own left and right sibling.
  • child: the representative child of the node. To access all the children of the node, first access the representative child, then access all the representative child’s siblings through left and right attributes
  • parent
  • degree: the number of the node’s children
  • mark: (description by Cormen et al.) is either True or False, indicating whether the node has lost a child since the last time it was made the child of another node. Newly created nodes are unmarked. A node becomes unmarked whenever it is made the child of another node.

Fibonacci Heap

A heap has the following attributes:

  • min: points to the node that contains the minimum key
  • number of nodes currently in the heap
  • number of roots in the tree. A Fibonacci heap can contain many trees of min-ordered heap. The roots of these trees are doubly linked and form a circular loop as in the case with siblings. The number of trees of a Fibonacci heap is always the number of roots.
  • number of marked nodes in the heap

Operations Overview


Runs in worst-case time. Initializes an empty heap.


Runs in worst-case time. Adds the node as a root of the heap.


Runs in worst-case time. Returns the min attribute of the heap.


Runs in amortized time. Removes and returns the minimum node. This procedure moves each of the minimum node’s children to the root list, removes the minimum node itself from the root list, and consolidates the resulted tree to reduces the number of trees.


Runs in worst-case time. Makes and returns a union of two heaps. This procedure simply concatenates the two root lists.


Runs in amortized time. Decreases node x’s key to k.


Runs in amortized time. Remove x from the heap by first setting its key to minus infinity and extracting the heap’s min.


Installing using pip:

>>> pip install fibheap

Using mergable-heap operations:

>>> from fibheap import *
>>> heap1 = makefheap()
>>> heap2 = makefheap()
>>> num_list1 = [1,4,2]
>>> num_list2 = [6,-1,0]
>>> for num in num_list1:
...     fheappush(heap1, num)
>>> for num in num_list2:
...     fheappush(heap2, num)
>>> fheapunion(heap1, heap2)
>>> getfheapmin(heap1)
>>> sorted_list = []
>>> while heap1.num_nodes:
...     sorted_list.append(fheappop(heap1))
>>> sorted_list
[-1, 0, 1, 2, 4, 6]

When data contains more than numbers:

>>> item_list = [(3, 'a'),(0, 'z'), (2,'m'), (-2, 'r')]
>>> heap = makefheap()
>>> for item in item_list:
...     fheappush(heap, item)
>>> sorted_list = []
>>> while heap.num_nodes:
...     sorted_list.append(fheappop(heap))
>>> sorted_list
[(-2, 'r'), (0, 'z'), (2, 'm'), (3, 'a')]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fibheap-0.2.1.tar.gz (5.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page