[Previous: Extending Retrieval] [Contents] [Next: Non English language support]

Pluggable Compression

Introduction

The inverted index data structure contains a collection of postings lists, a data structure which maintains information about the occurrence of terms in documents. These are represented within Terrier as implementations of two specific interfaces, namely Posting and IterablePosting. Terrier supports four different types of payload contained within each Posting (or children interfaces): By default, Terrier compresses posting lists as a stream of postings. It uses Elias' Gamma compression schema (codec) to compress doc ids and term positions; it uses Unary codec to compress term and field frequencies. The particular compression configuration is defined by the CompressionConfiguration class. For more information, please refer to org.terrier.structures.bit.DirectInvertedOutputStream (and children) for documentation on postings compression, and org.terrier.structures.postings.bit.BasicIterablePosting (and children) documentation for postings decompression. New in version 4.0, Terrier now supports more modern compression codecs, such as the state-of-the-art PForDelta codec. In particular, a new integer compression layer allows the transparent use of compression schemes from Java_FastPFOR by Daniel Lemire, and Kamikaze by LinkedIn. Indeed, the new integer compression layer defines a new CompressionConfiguration (namely IntegerCodecCompressionConfiguration, which can be configured to use various codecs for each compression payload (document ids, term frequencies, field frequencies, term positions):
NameDescriptionCodec Class name (in org.terrier.compression.integer.codec)
VIntHadoop's Variable byte [1] implementationVIntCodec
Simple16JavaFastPFOR's Simple16 [2,3] implementationLemireSimple16Codec
Frame-of-Reference (FOR)JavaFastPFOR's Frame-of-Reference [4] implementationLemireFORVBCodec
NewPFDJavaFastPFOR's NewPFD [5] implementationLemireNewPFDVBCodec
OptPFDJavaFastPFOR's OptPFD [5] implementation LemireOptPFDVBCodec
FastPFORJavaFastPFOR's FastPFOR [6] implementation - NB: A larger chunk-size is recommended for this codec.LemireFastPFORVBCodec
PForDeltaLinkedin's Kamikaze PForDelta [3,5]KamikazePForDeltaVBCodec
When using these codecs, the Terrier infrastructure (de)compresses postings in chunks. The size of these chunks can be set at indexing time using the properties index.inverted.compression.integer.chunk.size for the direct index, and index.inverted.compression.integer.chunk.size for the inverted index.

Indexing

Terrier 4.0 can perform classical two-pass indexing (i.e. bin/trec_terrier.sh -i), using the aforementioned codecs. To do so, some properties have to be set. For instance, to store the direct and inverted index compressed in blocks of 1024 posting using NewPFD codec:
index.direct.compression.integer.chunk.size=1024
indexing.direct.compression.configuration=org.terrier.structures.indexing.IntegerCodecCompressionConfiguration
index.direct.compression.integer.chunk.size=1024
index.direct.compression.integer.ids.codec=LemireNewPFDVBCodec
index.direct.compression.integer.tfs.codec=LemireNewPFDVBCodec
indexing.inverted.compression.configuration=org.terrier.structures.indexing.IntegerCodecCompressionConfiguration
index.inverted.compression.integer.chunk.size=1024
index.inverted.compression.integer.ids.codec=LemireNewPFDVBCodec
index.inverted.compression.integer.tfs.codec=LemireNewPFDVBCodec
index.inverted.compression.integer.fields.codec=LemireNewPFDVBCodec
index.inverted.compression.integer.blocks.codec=LemireNewPFDVBCodec
You can also plug into Terrier a new compression schema by implementing your own CompressionConfiguration. If IntegerCodec meets your requirements, you can implement it, and directly use IntegerCodecCompressionConfiguration. List of properties for indexing:
NameDescriptionValues
indexing.inverted.compression.configuration
indexing.direct.compression.configuration
The class that defines the compression configuration to be used on the inverted (direct) index at indexing time. Only classical indexing supports pluggable compression.org.terrier.structures.indexing.CompressionFactory$BitCompressionConfiguration (default); org.terrier.structures.indexing.IntegerCodecCompressionConfiguration
index.inverted.compression.integer.chunk.size
index.direct.compression.integer.chunk.size
Number of postings to be compressed at a time (used only w/ IntegerCodecCompressionConfiguration)integer (default: 1024)
index.inverted.compression.integer.ids.codec
index.direct.compression.integer.ids.codec
The codec to be used to compress document identifiers in the inverted index (used only w/ IntegerCodecCompressionConfiguration). For the direct index, the codec to be used for the term identifiers.See codecs table
index.inverted.compression.integer.tfs.codec
index.direct.compression.integer.tfs.codec
The codec to be used to compress term frequencies in the inverted (direct) index (used only w/ IntegerCodecCompressionConfiguration)"
index.inverted.compression.integer.fields.codec
index.direct.compression.integer.fields.codec
The codec to be used to compress field frequencies in the inverted (direct) index (used only w/ IntegerCodecCompressionConfiguration, optional)"
index.inverted.compression.integer.blocks.codec
index.direct.compression.integer.blocks.codec
The codec to be used to compress term positions in the inverted (direct) index (used only w/ IntegerCodecCompressionConfiguration, optional)"

Recompression

Inverted indices built by single-pass (i.e. bin/trec_terrier.sh -i -j) or MapReduce (i.e. bin/trec_terrier.sh -i -H) indexing can be re-compressed using the InvertedIndexRecompresser class. For example, one can re-compress an inverted index using the OptPFD codec. This can be performed using InvertedIndexRecompresser with the following properties:
indexing.tmp-inverted.compression.configuration=org.terrier.structures.indexing.IntegerCodecCompressionConfiguration
index.tmp-inverted.compression.integer.chunk.size=1024
index.tmp-inverted.compression.integer.ids.codec=LemireOptPFDVBCodec
index.tmp-inverted.compression.integer.tfs.codec=LemireOptPFDVBCodec
index.tmp-inverted.compression.integer.fields.codec=LemireOptPFDVBCodec
index.tmp-inverted.compression.integer.blocks.codec=LemireOptPFDVBCodec
Please notice that InvertedIndexRecompresser overwrites the original inverted index with the re-compressed one. Be sure to have one backup copy of the inverted index before using InvertedIndexRecompresser. Different codecs have different effects on index size and query response time. When storage space is a concern, it is suggested to use Terrier's default compression configuration (Simple16 and OptPFD are options too). Instead, when the inverted index can fit in main memory, the best practices derived in [7] recommend to use the FOR codec to reduce the query response time, as follows:
index.direct.compression.integer.chunk.size=1024
indexing.direct.compression.configuration=org.terrier.structures.indexing.IntegerCodecCompressionConfiguration
compression.direct.integer.ids.codec=LemireFORVBCodec
compression.direct.integer.tfs.codec=LemireFORVBCodec
indexing.inverted.compression.configuration=org.terrier.structures.indexing.IntegerCodecCompressionConfiguration
compression.inverted.integer.ids.codec=LemireFORVBCodec
compression.inverted.integer.tfs.codec=LemireFORVBCodec
compression.inverted.integer.fields.codec=LemireFORVBCodec
compression.inverted.integer.blocks.codec=LemireFORVBCodec

Citation Policy

If you make use of this package for efficient research, please cite: Catena, M., Macdonald, C., Ounis, I.: On Inverted Index Compression for Search Engine Efficiency. In: Proceedings of ECIR 2014. [PDF]

References

  1. Williams, H.E., Zobel, J.: Compressing integers for fast file access. The Computer Journal 42 (1999)
  2. Anh, V.N., Moffat, A.: Inverted index compression using word-aligned binary codes. Inf.Retr. 8 (1) (2005)
  3. Zhang, J., Long, X., Suel, T.: Performance of compressed inverted list caching in search engines. In: Proc. WWW ’08. (2008)
  4. Goldstein, J., Ramakrishnan, R., Shaft, U.: Compressing relations and indexes. In: Proc. ICDE ’98. (1998)
  5. Yan, H., Ding, S., Suel, T.: Inverted index compression and query processing with optimized document ordering. In: Proc. WWW ’09. (2009)
  6. Lemire, D., Boytsov, L.: Decoding billions of integers per second through vectorization. Software: Practice and Experience (2013)
  7. Catena, M., Macdonald, C., Ounis, I.: On Inverted Index Compression for Search Engine Efficiency. In: Proc. ECIR '14 (2014) [PDF]
  8. Elias, P.: Universal codeword sets and representations of the integers. Trans. Info. Theory 21 (2) (1975)
  9. Zukowski, M., Heman, S., Nes, N., Boncz, P.: Super-scalar RAM-CPU cache compression. In: Proc. ICDE ’06. (2006)
[Previous: Extending Retrieval] [Contents] [Next: Non English language support]