Skip to content
ADAM is a genomics analysis platform with specialized file formats built using Apache Avro, Apache Spark, and Apache Parquet. Apache 2 licensed.
Scala Python R Java Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
adam-apis Rename AlignmentRecord to Alignment. Oct 1, 2019
adam-assembly Modifying pom.xml files for new development after 0.29.0 release. Sep 18, 2019
adam-cli
adam-codegen Modifying pom.xml files for new development after 0.29.0 release. Sep 18, 2019
adam-core Complete refactoring of compressionCodec for named parameter. Oct 29, 2019
adam-distribution Modifying pom.xml files for new development after 0.29.0 release. Sep 18, 2019
adam-python Rename AlignmentRecord to Alignment. Oct 1, 2019
adam-r Rename AlignmentRecord to Alignment. Oct 1, 2019
adam-shade Modifying pom.xml files for new development after 0.29.0 release. Sep 18, 2019
bin [ADAM-1882] Don't abort adam-submit if ADAM_HOME is set. Feb 6, 2018
docs Rename AlignmentRecord to Alignment. Oct 1, 2019
scripts
.gitignore Make GenomicRDD.toXxx method names consistent. Sep 22, 2017
.travis.yml Update hadoop-bam dependency version to 7.5.0, htsjdk to 2.3.0 and mi… May 18, 2016
CHANGES.md Modifying changelog. Sep 18, 2019
CODE_OF_CONDUCT.md Adding code of contact adapted from the Contributor Convenant, versio… Oct 25, 2017
CONTRIBUTING.md
KEYS Adding public key for artifacts signed by @fnothaft. Jun 27, 2016
LICENSE.txt Improved build, added license, file converters, module framework and … Apr 21, 2013
LICENSE_header.txt Use maven license plugin to ensure source has correct license Jun 25, 2014
README.md Remove coveralls badge. Aug 10, 2019
SUPPORT.md Add SUPPORT.md file to complement CONTRIBUTING.md. Oct 25, 2017
pom.xml Update maven plugin dependency versions. Nov 4, 2019

README.md

ADAM

Build Status Maven Central API Documentation

Introduction

ADAM is a library and command line tool that enables the use of Apache Spark to parallelize genomic data analysis across cluster/cloud computing environments. ADAM uses a set of schemas to describe genomic sequences, reads, variants/genotypes, and features, and can be used with data in legacy genomic file formats such as SAM/BAM/CRAM, BED/GFF3/GTF, and VCF, as well as data stored in the columnar Apache Parquet format. On a single node, ADAM provides competitive performance to optimized multi-threaded tools, while enabling scale out to clusters with more than a thousand cores. ADAM's APIs can be used from Scala, Java, Python, R, and SQL.

Why ADAM?

Over the last decade, DNA and RNA sequencing has evolved from an expensive, labor intensive method to a cheap commodity. The consequence of this is generation of massive amounts of genomic and transcriptomic data. Typically, tools to process and interpret these data are developed with a focus on excellence of the results generated, not on scalability and interoperability. A typical sequencing workflow consists of a suite of tools from quality control, mapping, mapped read preprocessing, to variant calling or quantification, depending on the application at hand. Concretely, this usually means that such a workflow is implemented as tools glued together by scripts or workflow descriptions, with data written to files at each step. This approach entails three main bottlenecks:

  1. scaling the workflow comes down to scaling each of the individual tools,
  2. the stability of the workflow heavily depends on the consistency of intermediate file formats, and
  3. writing to and reading from disk is a major slow-down.

We propose here a transformative solution for these problems, by replacing ad-hoc workflows by the ADAM framework, developed in the Apache Spark ecosystem.

ADAM enables the high performance in-memory cluster computing functionality of Apache Spark on genomic data, ensuring efficient and fault-tolerant distribution based on data parallelism, without the intermediate disk operations required in traditional distributed approaches.

Furthermore, the ADAM and Apache Spark approach comes with an additional benefit. Typically, the endpoint of a sequencing pipeline is a file with processed data for a single sample: e.g. variants for DNA sequencing, read counts for RNA sequencing, etc. The real endpoint, however, of a sequencing experiment initiated by an investigator is interpretation of these data in a certain context. This usually translates into (statistical) analysis of multiple samples, connection with (clinical) metadata, and interactive visualization, using data science tools such as R, Python, Tableau and Spotfire. In addition to scalable distributed processing, Apache Spark also allows interactive data analysis in the form of analysis notebooks (Spark Notebook, Jupyter, or Zeppelin), or direct connection to the data in R and Python.

Getting Started

Building from Source

You will need to have Apache Maven version 3.3.9 or later installed in order to build ADAM.

Note: The default configuration is for Hadoop 2.7.5. If building against a different version of Hadoop, please pass -Dhadoop.version=<HADOOP_VERSION> to the Maven command.

$ git clone https://github.com/bigdatagenomics/adam.git
$ cd adam
$ mvn install

Installing Spark

You'll need to have a Spark release on your system and the $SPARK_HOME environment variable pointing at it; prebuilt binaries can be downloaded from the Spark website.

Documentation

ADAM's documentation is available at http://adam.readthedocs.io.

ADAM's core API documentation is available at http://javadoc.io/doc/org.bdgenomics.adam/adam-core-spark2_2.11.

The ADAM/Big Data Genomics Ecosystem

ADAM builds upon the open source Apache Spark, Apache Avro, and Apache Parquet projects. Additionally, ADAM can be deployed for both interactive and production workflows using a variety of platforms.

There are a number of tools built using ADAM's core APIs:

  • Avocado - Avocado is a distributed variant caller built on top of ADAM for germline and somatic calling.
  • Cannoli - ADAM Pipe API wrappers for bioinformatics tools, (e.g., BWA, bowtie2, FreeBayes)
  • DECA - DECA is a reimplementation of the XHMM copy number variant caller on top of ADAM.
  • Gnocchi - Gnocchi provides primitives for running GWAS/eQTL tests on large genotype/phenotype datasets using ADAM.
  • Lime - Lime provides a parallel implementation of genomic set theoretic primitives using the ADAM region join API.
  • Mango - Mango is a library for visualizing large scale genomics data with interactive latencies.

For more, please see our awesome list of applications that extend ADAM.

Connecting with the ADAM team

The best way to reach the ADAM team is to post in our Gitter channel or to open an issue on our Github repository. For more contact methods, please see our support page.

License

ADAM is released under the Apache License, Version 2.0.

Citing ADAM

ADAM has been described in two manuscripts. The first, a tech report, came out in 2013 and described the rationale behind using schemas for genomics, and presented an early implementation of some of the preprocessing algorithms. To cite this paper, please cite:

@techreport{massie13,
  title={{ADAM}: Genomics Formats and Processing Patterns for Cloud Scale Computing},
  author={Massie, Matt and Nothaft, Frank and Hartl, Christopher and Kozanitis, Christos and Schumacher, Andr{\'e} and Joseph, Anthony D and Patterson, David A},
  year={2013},
  institution={UCB/EECS-2013-207, EECS Department, University of California, Berkeley}
}

The second, a conference paper, appeared in the SIGMOD 2015 Industrial Track. This paper described how ADAM's design was influenced by database systems, expanded upon the concept of a stack architecture for scientific analyses, presented more results comparing ADAM to state-of-the-art single node genomics tools, and demonstrated how the architecture generalized beyond genomics. To cite this paper, please cite:

@inproceedings{nothaft15,
  title={Rethinking Data-Intensive Science Using Scalable Analytics Systems},
  author={Nothaft, Frank A and Massie, Matt and Danford, Timothy and Zhang, Zhao and Laserson, Uri and Yeksigian, Carl and Kottalam, Jey and Ahuja, Arun and Hammerbacher, Jeff and Linderman, Michael and Franklin, Michael and Joseph, Anthony D. and Patterson, David A.},
  booktitle={Proceedings of the 2015 International Conference on Management of Data (SIGMOD '15)},
  year={2015},
  organization={ACM}
}

We prefer that you cite both papers, but if you can only cite one paper, we prefer that you cite the SIGMOD 2015 manuscript.

You can’t perform that action at this time.