For faster navigation, this Iframe is preloading the Wikiwand page for CRAM (file format).

CRAM (file format)

Filename extension
Developed byMarkus Hsi-Yang Fritz et al; Vadim Zalunin; James Bonfield
Type of formatBioinformatics
Open format?yes,

Compressed Reference-oriented Alignment Map (CRAM) is a compressed columnar file format for storing biological sequences aligned to a reference sequence, initially devised by Markus Hsi-Yang Fritz et al.[1]

CRAM was designed to be an efficient reference-based alternative to the Sequence Alignment Map (SAM) and Binary Alignment Map (BAM) file formats. It optionally uses a genomic reference to describe differences between the aligned sequence fragments and the reference sequence, reducing storage costs. Additionally each column in the SAM format is separated into its own blocks, improving compression ratio. CRAM files typically vary from 30 to 60% smaller than BAM, depending on the data held within them.

Implementations of CRAM exist in htsjdk,[2] htslib,[3] JBrowse,[4] and Scramble.[5]

The file format specification is maintained by the Global Alliance for Genomics and Health (GA4GH)[6] with the specification document available from the EBI cram toolkit page.[7]

File format

The basic structure of a CRAM file is a series of containers, the first of which holds a compressed copy of the SAM header. Subsequent containers consist of a container Compression Header followed by a series of slices which in turn hold the alignment records themselves, formatted as a series of blocks.

CRAM file:

Magic number Container
(SAM header)
... Container


Slice ... Slice


Block Block ... Block

CRAM constructs records from a set of data series, describing the components of an alignment. The container Compression Header specifies which data series is encoded in which block, what codec will be used, and any codec specific meta-data (for example a table of Huffman symbol code lengths). While data series can be mixed together within the same block, keeping them separate usually improves compression and provides the opportunity for efficient selective decoding where only some data types are required.

Selective access to a CRAM file is granted via the index (with file-name suffix ".crai"). On chromosome and position sorted data this indicates which region is covered by each slice. On unsorted data the index may be used to simply fetch the Nth container. Selective decoding may also be achieved using the Compression Header to skip specified data series if partial records are required.


Year Version(s) Notes
2010-11 pre-CRAM Initial paper describing the reference based format. This did not use the name CRAM, but called it mzip. This software was implemented in Python as a prototype and demonstration of the basic concepts.[1]
2011-12 0.3–0.86 Vadim Zalunin of the European Bioinformatics Institute (EBI) produced the first implementation named CRAM as a package called CRAMtools,[8] written in the Java programming language.
2012 1.0[9] Implemented in Java CRAMtools.[10]
2013 C implementation added to the Scramble[11][5] tool, by James Bonfield of the Wellcome Sanger Institute.
2013 2.0 Changes included support for more than one reference per slice (useful with highly fragmented assemblies), better encoding of SAM auxiliary tags, splitting soft-clip and inserted bases into their own data-series, meta-data to track the number of records and bases per slice, and corrections to the BF (BAM flag) data-series.
2013 Added to htslib (0.2.0).
2014 2.1[12] Added EOF blocks, to help identify truncated files.
2014 Added to htsjdk (1.127).
2014 3.0[13] Inclusion of lzma and rANS codecs for block compression, along with multiple checksums for ensuring data integrity
2018 JavaScript implementation as part of JBrowse[4] (1.15.0), by Rob Buels.
2021 Rust implementation in Noodles[14]
2023 3.1[15] Officially adopted. (Draft from 2019)

CRAM version 4.0 exists as a prototype in Scramble,[5] initially demonstrated in 2015, but has yet to be adopted as a standard.

See also


  1. ^ a b Hsi-Yang Fritz, Markus; Leinonen, Rasko; Cochrane, Guy; Birney, Ewan (May 2011). "Efficient storage of high throughput DNA sequencing data using reference-based compression". Genome Research. 21 (5): 734–740. doi:10.1101/gr.114819.110. ISSN 1549-5469. PMC 3083090. PMID 21245279.
  2. ^ "Htsjdk by Broad Institute". Retrieved 2018-10-14.
  3. ^ "Samtools". Retrieved 2018-10-14.
  4. ^ a b "JBrowse · A fast, embeddable genome browser built with HTML5 and JavaScript". Retrieved 2018-10-14.
  5. ^ a b c Bonfield, James K. (2014-06-14). "The Scramble conversion tool". Bioinformatics. 30 (19): 2818–2819. doi:10.1093/bioinformatics/btu390. ISSN 1460-2059. PMC 4173023. PMID 24930138.
  6. ^ "GA4GH". Retrieved 2018-10-14.
  7. ^ EMBL-EBI. "CRAM toolkit < Software < European Nucleotide Archive < EMBL-EBI". Retrieved 2018-10-14.
  8. ^ "vadimzalunin/crammer". GitHub. 2017-08-08. Retrieved 2018-10-14.
  9. ^ "CRAM 1.0 Specification" (PDF).
  10. ^ "enasequence/cramtools". GitHub. 2018-10-02. Retrieved 2018-10-14.
  11. ^ "jkbonfield/io_lib". GitHub. 2018-10-16. Retrieved 2018-10-14.
  12. ^ "CRAM 2.1 Specification" (PDF).
  13. ^ "CRAM 3.0 Specification" (PDF).
  14. ^
  15. ^ "CRAM 3.1 Specification" (PDF).
{{bottomLinkPreText}} {{bottomLinkText}}
CRAM (file format)
Listen to this article

This browser is not supported by Wikiwand :(
Wikiwand requires a browser with modern capabilities in order to provide you with the best reading experience.
Please download and use one of the following browsers:

This article was just edited, click to reload
This article has been deleted on Wikipedia (Why?)

Back to homepage

Please click Add in the dialog above
Please click Allow in the top-left corner,
then click Install Now in the dialog
Please click Open in the download dialog,
then click Install
Please click the "Downloads" icon in the Safari toolbar, open the first download in the list,
then click Install

Install Wikiwand

Install on Chrome Install on Firefox
Don't forget to rate us

Tell your friends about Wikiwand!

Gmail Facebook Twitter Link

Enjoying Wikiwand?

Tell your friends and spread the love:
Share on Gmail Share on Facebook Share on Twitter Share on Buffer

Our magic isn't perfect

You can help our automatic cover photo selection by reporting an unsuitable photo.

This photo is visually disturbing This photo is not a good choice

Thank you for helping!

Your input will affect cover photo selection, along with input from other users.


Get ready for Wikiwand 2.0 🎉! the new version arrives on September 1st! Don't want to wait?