# Re-Pair

Re-Pair (short for recursive pairing) is a grammar-based compression algorithm that, given an input text, builds a straight-line program, i.e. a context-free grammar generating a single string: the input text. In order to perform the compression in linear time, it consumes the amount of memory that is approximately five times the size of its input.
The grammar is built by recursively replacing the most frequent pair of characters occurring in the text. Once there is no pair of characters occurring twice, the resulting string is used as the axiom of the grammar. Therefore, the output grammar is such that all rules but the axiom have two symbols on the right-hand side.

## How it works

Re-Pair was first introduced by NJ. Larsson and A. Moffat in 1999.
In their paper the algorithm is presented together with a detailed description of the data structures required to implement it with linear time and space complexity. The experiments showed that Re-Pair achieves high compression ratios and offers good performance for decompression. However, the major drawback of the algorithm is its memory consumption, which is approximately 5 times the size of the input. Such memory usage is required in order to perform the compression in linear time but makes the algorithm impractical for compressing large files.
The image on the right shows how the algorithm works compresses the string $w=xabcabcy123123zabc$.
During the first iteration, the pair $ab$, which occurs three times in $w$, is replaced by a new symbol $R_{1}$. On the second iteration, the most frequent pair in the string $w=xR_{1}cR_{1}cy123123zR_{1}c$, which is $R_{1}c$, is replaced by a new symbol $R_{2}$. Thus, at the end of the second iteration, the remaining string is $w=xR_{2}R_{2}y123123zR_{2}$. In the next two iterations, the pairs $12$ and $R_{3}3$ are replaced by symbols $R_{3}$ and $R_{4}$ respectively. Finally, the string $w=xR_{2}R_{2}yR_{4}R_{4}zR_{2}$ contains no repeated pair and therefore it is used as the axiom of the output grammar.

## Data structures

In order to achieve linear time complexity, Re-Pair requires the following data structures
* A sequence representing the input string. Position $i$ of the sequence contains the i-th symbol of the input string plus two references to other positions in the sequence. These references point to the next/previous positions, say $k$ and $m$, such that the same substring begins at $w[i]$, $w[k]$ and $w[m]$ and all three occurrences are captured by the same reference (i.e. there is a variable in the grammar generating the string).
* A priority queue. Each element of the queue is a pair of symbols (terminals or previously defined pairs) that occur consecutively in the sequence. The priority of a pair is given by the number of occurrences of the pair in the remaining sequence. Each time a new pair is created, the priority queue is updated.
* A hash table to keep track of already defined pairs. This table is updated each time a new pair is created or removed.
Since the hash table and the priority queue refer to the same elements (pairs), they can be implemented by a common data structure called PAIR with pointers for the hash table (h_next) and the priority queue (p_next and p_prev). Furthermore, each PAIR points to the beginning of the first (f_pos) and the last (b_pos) occurrences of the string represented by the PAIR in the sequence. The following picture shows an overview of this data structure.
The following two pictures show an example of how these data structures look after the initialization and after applying one step of the pairing process (pointers to NULL are not displayed):

### Encoding the grammar

Once the grammar has been built for a given input string, in order to achieve effective compression, this grammar has to be encoded efficiently. One of the simplest methods for encoding the grammar is the implicit encoding, which consists on invoking function encodeCFG(X), described below, sequentially on all the axiom's symbols. Intuitively, rules are encoded as they are visited in a depth-first traversal of the grammar. The first time a rule is visited, its right hand side is encoded recursively and a new code is assigned to the rule. From that point, whenever the rule is reached, the assigned value is written.
Another possibility is to separate the rules of the grammar into generations such that a rule $X\to YZ$ belongs to generation $i$ iff at least one of $Y$ or $Z$ belongs to generation $i-1$ and the other belongs to generation $j$ with $j\leq i-1$. Then these generations are encoded subsequently starting from generation $0$. This was the method proposed originally when Re-Pair was first introduced. However, most implementations of Re-Pair use the implicit encoding method due to its simplicity and good performance. Furthermore, it allows on-the-fly decompression.

## Versions

There exists a number of different implementations of Re-Pair. Each of these versions aims at improving one specific aspect of the algorithm, such as reducing the runtime, reducing the space consumption or increasing the compression ratio.
| Improvement | Year | Description |
| Phrase Browsing | 2003 | Instead of manipulating the input string as a sequence of characters, this tool first groups the characters into phrases (for instance, words). The compression algorithm works as Re-Pair but considering the identified phrases as the terminals of the grammar. The tool accepts different options to decide which sort of phrases are considered and encodes the resulting grammar into separated files: one containing the axiom and one with the rest of the rules. |
| Original | 2011 | This is one of the most popular implementations of Re-Pair. It uses the data structures described here (the ones proposed when it was originally published) and encodes the resulting grammar using the implicit encoding method. Most later versions of Re-Pair are implemented starting from this one. |
| Encoding | 2013 | Instead of the implicit encoding method, this implementation uses a Variable Length to Fixed Length method, in which each rule (represented with a string of Variable Length) is encoded using a code of Fixed Length. |
| Memory usage | 2017 | The algorithm performs in two phases. During the first phase, it considers the high frequency pairs, i.e. those occurring more than $\lceil {\sqrt {n}}/3\rceil$ times, while the low frequency pairs are considered in the second. The main difference between the two phases is the implementation of the corresponding priority queues. |
| Compression | 2017 | This version modifies the way the next pair to be replaced is chosen. Instead of simply considering the most frequent pair, it employs a heuristic which penalizes pairs that are not coherent with a Lempel–Ziv factorisation of the input string. |
| Compression | 2018 | This algorithm reduces the size of the grammar generated by Re-Pair by replacing maximal repeats first. When a pair is identified as the most frequent pair, i.e. the one to be replaced in the current step of the algorithm, MR-repair extends the pair to find the longest string that occurs the same number of times as the pair to be replaced. The provided implementation encodes the grammar by simply listing the rules in text, hence this tool is purely for research purposes and cannot be used for compression as it is. |