Datastructures tutorial



datastructures implements various data structures that are frequently used in computer science. Among these are for example Fibonacci heaps, stacks, queues or hashmaps. Advanced data structures are essential in many computer science and statistics problems, for example graph algorithms or string analysis. The package uses Boost and STL data types and extends these to R with Rcpp modules.

Fibonacci and binomial heaps

Fibonacci and binomial heaps are priority queue data structures using the minimum heap property. They can be represented using collections of trees or linked lists consisting of nodes of elements. Every node is a pair of keys and values, where the key decides the priority of the node in the heap. Fibonacci heaps have various applications, one of the most famous being in efficiently finding shortest paths using Dijkstra's algorithm. Fibonacci heaps can add values in amortized $\mathcal{O}(1)$ time and remove the minimum value in $\mathcal{O}(log \, n)$ time making them a good choice in many real world scenarios. Binomial heaps have in general slightly worse asymptotic bounds. However, removing the minimum element (pop) has an asymptotically tight bound of $\Theta(log \, n)$. The two classes have the exact same methods, so every method explained here is available for the other class, too.

You can create a heap like this:

  fheap <- fibonacci_heap("numeric", "character")
  bheap <- binomial_heap("numeric", "character")

This gives us heaps with numeric keys and character values. You can pick from either integer, numeric or character keys and values. So if we insert several key-value pairs, the pair with the minimum key would have the highest priority. Let's insert some values and have a look:

  keys   <- sample(seq(0, 1, by=.2))
  values <- paste0("V", keys)
  fheap  <- insert(fheap, keys, values)

Since Fibonacci and binomial heaps use the minimum heap property the first element in the heap should be 0 -> V0 even though we inserted the pairs in a random fashion.


That worked nicely. peek gives us the first element from the heap without removing it. If we want to have it removed we call the pop function. Of course this changes the priority of the heap:


You can alternatively insert values like this:

  fheap[-1] <- "V-1"

Hashmaps and bimaps

Hashmaps and bimaps use hash functions to store key-value pairs. Given a key, the hash function computes a bucket where the value is stored, making lookup, insertion and deletion on average possible in $\mathcal{O}(1)$ time. In the worst case these runtimes decrease to $\mathcal{O}(n)$ time, where $n$ is the number of entries in a bucket. The difference between the two classes is that hashmaps compute a mapping from keys to values (the hash function) $$ \, f: \mathcal{K} \rightarrow \mathcal{V} \, $$ in 'one direction', while bimaps also compute a mapping $$ \, f: \mathcal{V} \rightarrow \mathcal{K} \, $$ in the 'other direction'. So a bimap is essentially a combination of two hashmaps.

Hashmaps and bimaps can get created like this, this time we use <character, integer> pairs:

  hash  <- hashmap("character", "integer")
  bimap <- bimap("character", "integer")

Insertion to maps works just like before, by calling the insert function:

  keys   <- paste0("V", 1:5)
  values <- 1:5
  hash   <- insert(hash, keys[1:4], values[1:4])
  bimap  <- insert(bimap, keys[1:4], values[1:4])
  hash[keys[5]]  <- values[5]
  bimap[keys[5]] <- values[5]

Values (and keys in the case of bimaps) can then be accessed like this:

  get(hash, keys[1])

  get(bimap, keys[1], "values")
  get(bimap, values[2], "keys")
  get(bimap, keys[1])

For hashmaps the subset-operator [ is also supported for accessing elements. This does not make so much sense for bimaps, because here we have to choose whether we want to access keys or values. In the example on the top we showed how both is possible by either providing keys or values as third argument to the get function. If you leave it out, then the third argument defaults to values.

If you want to directly access keys or values as vectors or have a look at a few random elements, you would call:


Queues and stacks

Queues and stackes are two list datastructures using the STL's std::deque in the backend, i.e. insertion at the end and getting the first element can be done in constant time $\mathcal{O}(1)$ . Queues and stacks are for example used in depths-first-search and breadth-first-search making them versatile datastructures. While queues use the first-in-first-out principle, stacks use the last-in-first-out principle.

The two datatypes use the exact same methods. You can instantiate a stack or a queue using:

  qu <- queue("numeric")
  st <- stack("numeric")

As before, you can pick either numeric, integer or character keys. Now, let's again insert some data:

  keys <- seq(0, 1, by=.2)
  qu <- insert(qu, keys)
  st <- insert(st, keys)

This is fairly similar. The difference between the two becomes obvious when we access the data, i.e. either call peek or pop functions:


In both cases we inserted a vector of values raning from 0 to 1. Also, in both cases the first value that got inserted was 0 and the last value was 1. If we now peek onto the datastructures the queue returns the first element that got inserted, while the stack returns the last element that was inserted.

Both datastructures also offer the other functions from before, for example:



Try the datastructures package in your browser

Any scripts or data that you put into this service are public.

datastructures documentation built on July 16, 2017, 1:03 a.m.