fgbio

Tools for working with genomic and high throughput sequencing data.

View the Project on GitHub

Build Status codecov Maven Central Bioconda Javadocs License Language

fgbio

fgbio is a command line toolkit for working with genomic and particularly next generation sequencing data.

See the latest available tools here.

Quick Installation

The conda package manager (configured with bioconda channels) can be used to quickly install fgbio:

conda install fgbio

To install fgbio without extra dependencies (e.g. R), use the command:

conda install fgbio-minimal

Using the Project Jar File Directly

Releases of fgbio are available from the GitHub Releases page for the project. Start by downloading the .jar file for the latest release.

To run fgbio you will need Java 8 (aka Java 1.8) or later installed. To see the version of Java currently installed run the following in a terminal:

java -version

If the reported version on the first line starts with 1.8 or higher, you are all set.

Once you have Java installed and a release downloaded you can run:

When running tools we recommend the following set of Java options as a starting point though individual tools may need more or less memory depending on the input data:

java -Xmx4g -XX:+AggressiveOpts -XX:+AggressiveHeap -jar fgbio.jar ...

To save typing this every time you may wish to setup a shell alias, for example:

alias fgbio="java -Xmx4g -XX:+AggressiveOpts -XX:+AggressiveHeap -jar /path/to/fgbio.jar

Documentation

Each tool has detailed usage and argument documentation that can be viewed at the command line by running the tool in question with no arguments.

Documentation is also available online:

Getting Help

The primary mechanism for getting help is to log an issue on the project’s GitHub Issues page.

Before Logging An Issue

When Logging An Issue

If requesting help with a tool that is failing or producing undesirable results, please include:

License

fgbio is open source software released under the MIT License.