Categorygithub.com/theodesp/go-heaps
modulepackage
0.0.0-20190520121037-88e35354fe0a
Repository: https://github.com/theodesp/go-heaps.git
Documentation: pkg.go.dev

# README

go-heaps All Contributors

GoDoc License

Reference implementations of heap data structures in Go

Installation

$ go get -u github.com/theodesp/go-heaps

Contents

Heaps

  • Pairing Heap: A pairing heap is a type of heap data structure with relatively simple implementation and excellent practical amortized performance.
  • Leftist Heap: a variant of a binary heap. Every node has an s-value which is the distance to the nearest leaf. In contrast to a binary heap, a leftist tree attempts to be very unbalanced.
  • Skew Heap: A skew heap (or self-adjusting heap) is a heap data structure implemented as a binary tree. Skew heaps are advantageous because of their ability to merge more quickly than binary heaps.
  • Fibonacci Heap: a Fibonacci heap is a data structure for priority queue operations, consisting of a collection of heap-ordered trees. It has a better amortized running time than many other priority queue data structures including the binary heap and binomial heap.
  • Binomial Heap: A Binomial Heap is a collection of Binomial Trees. A Binomial Heap is a set of Binomial Trees where each Binomial Tree follows Min Heap property. And there can be at most one Binomial Tree of any degree.
  • Treap Heap: A Treap and the randomized binary search tree are two closely related forms of binary search tree data structures that maintain a dynamic set of ordered keys and allow binary searches among the keys.
  • Rank Pairing Heap: A heap (priority queue) implementation that combines the asymptotic efficiency of Fibonacci heaps with much of the simplicity of pairing heaps

Usage

package main

import (
	"github.com/theodesp/go-heaps"
	pairingHeap "github.com/theodesp/go-heaps/pairing"
	"fmt"
)

func main()  {
	heap := pairingHeap.New()
	heap.Insert(go_heaps.Integer(4))
	heap.Insert(go_heaps.Integer(3))
	heap.Insert(go_heaps.Integer(2))
	heap.Insert(go_heaps.Integer(5))

	fmt.Println(heap.DeleteMin()) // 2
	fmt.Println(heap.DeleteMin()) // 3
	fmt.Println(heap.DeleteMin()) // 4
	fmt.Println(heap.DeleteMin()) // 5
}

Complexity

OperationPairingLeftistSkewFibonacciBinomialTreap
FindMinΘ(1)Θ(1)Θ(1)Θ(1)Θ(log n)O(n)
DeleteMinO(log n)O(log n)O(log n)O(log n)Θ(log n)O(n)
InsertΘ(1)O(log n)O(log n)Θ(1)Θ(1)O(n)
FindO(n)
DeleteO(n)O(log n)O(n)Θ(log n)O(n)
AdjustO(n)O(log n)O(n)Θ(log n)O(n)
MeldΘ(1)
OperationRank Pairing
FindMinΘ(1)
DeleteMinO(log n)
InsertΘ(1)
FindO(n)
DeleteO(n)
AdjustO(n)
MeldΘ(1)

Contributors

Thanks goes to these wonderful people (emoji key):

Miroojin Bakshi
Miroojin Bakshi

💻
Syfaro
Syfaro

💻
Theofanis Despoudis
Theofanis Despoudis

💻
Radliński Ignacy
Radliński Ignacy

💻
Don McNamara
Don McNamara

🚇
Afrizal Fikri
Afrizal Fikri

💻
Logan HAUSPIE
Logan HAUSPIE

💻
Song Guo
Song Guo

💻
Safwan Mohammed
Safwan Mohammed

⚠️ 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

LICENCE

Copyright © 2017 Theo Despoudis MIT license

# Packages

Package binomial implements a Binomial heap Data structure Structure is not thread safe.
No description provided by the author
Package fibonacci implements a Fibonacci FibonacciHeap Data structure Reference: https://en.wikipedia.org/wiki/Fibonacci_heap Implementation from Introduction to Algorithms by T.
No description provided by the author
Package pairing implements a Pairing heap Data structure Structure is not thread safe.
No description provided by the author
Package skew implements a Skew heap Data structure Structure is not thread safe.
No description provided by the author

# Constants

Version The main version number that is being run at the moment.

# Interfaces

Extended adds operations on heaps are often useful.
Interface is basic interface that all Heaps implement.
Item is the basic element that is inserted in a heap.

# Type aliases

Integer implements the Item interface.
ItemIterator allows callers of Do to iterate in-order over portions of the tree.
String implements the Item interface.