tiledb/tiledbvcf-cli repository overview

⁠TileDB-VCF Command Line Interface

TileDB-VCF is a C++ library for efficient storage and retrieval of genomic variant-call data using TileDB Embedded⁠.

⁠Quick reference

• TileDB-VCF docs⁠
• TileDB-VCF repo⁠

⁠Images

Pre-built images for all variants are available on Docker Hub⁠.

⁠Variants

• tiledbvcf-cli⁠ for the command line interface (CLI)
• tiledbvcf-py⁠ for the Python module

⁠Supported tags

• latest: latest stable release (recommended)
• dev: development version
• v0.x.x for a specific version

⁠Parameters

• AWS_EC2_METADATA_DISABLED Disable the EC2 metadata service (default true). This avoids unnecessary API calls when querying S3-hosted arrays from non-EC2 clients. If you are on an EC2 instance this service can be enabled with -e AWS_EC2_METADATA_DISABLED=false.

⁠Building locally

To build the Dockerfile locally you need to clone the TileDB-VCF⁠ repository from GitHub and run docker build from within the local repo's root directory.

git clone https://github.com/TileDB-Inc/TileDB-VCF.git
cd TileDB-VCF

docker build -f docker/Dockerfile-cli .

⁠Usage

The following examples are meant to provide a quick overview of how to use these containers. See our docs⁠ for more comprehensive introductions to TileDB-VCF's functionality.

Here, we're using a publicly accessible TileDB-VCF dataset⁠ hosted on S3 that contains genome-wide variants for 20 synthetic samples. To pass in a local array or save exported files you will need to bind a local directory to the container's /data directory.

You can use the tiledbvcf-cli image to run any of the CLI's available commands⁠.

List all samples in the dataset:

docker run --rm tiledb/tiledbvcf-cli list \
  --uri s3://tiledb-inc-demo-data/tiledbvcf-arrays/v4/vcf-samples-20

Create a table of all variants within a region of interest for sample v2-WpXCYApL

docker run --rm -v $PWD:/data tiledb/tiledbvcf-cli export \
  --uri s3://tiledb-inc-demo-data/tiledbvcf-arrays/v4/vcf-samples-20 \
  -Ot --tsv-fields "CHR,POS,REF,S:GT" \
  --regions chr7:144000320-144008793 \
  --sample-names v2-WpXCYApL

⁠Want to learn more?

Check out TileDB-VCF's docs⁠ for installation instructions, detailed descriptions of the data format and algorithms, and in-depth tutorials.

⁠License

This project is licensed under the MIT License - see the LICENSE.md⁠ file for details.