tiledbvcf

Ingest indexed VCF/BCF files into TileDB sparse arrays for region-based variant queries.

Updated May 24, 2026
One-click install
npx skills add https://github.com/Estrella-231/Mathematical_modeling_tongmeng --skill tiledbvcf-estrella-231
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tiledbvcf
Source: https://github.com/Estrella-231/Mathematical_modeling_tongmeng/tree/main/.agents/skills/tiledbvcf
Command: npx skills add https://github.com/Estrella-231/Mathematical_modeling_tongmeng --skill tiledbvcf-estrella-231

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

TileDB-VCF solves slow, storage-heavy handling of genomic variant data by providing an efficient way to ingest VCF/BCF inputs and perform fast region- and sample-based reads without expensive re-merging.

Core Features & Use Cases

  • Scalable VCF/BCF ingestion with incremental sample addition: ingest single-sample VCF/BCF files and add new samples later without rebuilding everything.
  • High-performance sparse-array querying: retrieve variants for specific genomic regions across selected samples and variant attributes (e.g., genotypes, QUAL, INFO/FORMAT fields).
  • Export for interoperability: export subsets back to VCF/BCF or other tabular formats for downstream pipelines and cohort studies.

Use case example: Build a cohort variant database where you initially ingest a set of single-sample, indexed VCFs, then repeatedly add new participants and quickly query variants in target loci (e.g., chr1:1,000,000-2,000,000) across the updated cohort.

Quick Start

Create a TileDB-VCF dataset at URI my_dataset, ingest indexed single-sample VCFs, then read selected regions for chosen samples into a dataframe using the tiledbvcf Python API.

Frequently Asked Questions about tiledbvcf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I store and query VCF files fast at a large scale?

To query and store VCFs fast at scale, use TileDB sparse arrays to ingest single-sample indexed VCF/BCF inputs and retrieve specific genomic regions without expensive re-merging. This enables high-performance retrieval for cohort and population genomics workflows.

Can I add new samples to an existing genomic variant database incrementally?

Yes, you can add new samples to an existing genomic variant database incrementally. The TileDB-VCF approach supports scalable VCF/BCF ingestion, allowing you to add new participants later without rebuilding the entire dataset from scratch.

How do I extract variants for specific genomic regions and samples from a VCF cohort?

To extract variants for specific genomic regions and samples, use high-performance sparse-array querying to define target loci and select samples. You can retrieve genotypes and variant attributes, then export subsets back to VCF/BCF or tabular formats for downstream pipelines.

What are the input requirements for ingesting VCF/BCF data into TileDB?

Ingesting VCF/BCF data into TileDB requires single-sample indexed VCF/BCF inputs with .tbi or .csi index files. It supports parallel ingestion and querying, and provides local or cloud-ready dataset URIs for flexible storage.

What is the best way to handle population genomics workflows without slow data re-merging?

The best way to handle population genomics workflows without slow data re-merging is storing variants in TileDB sparse arrays. This method avoids expensive re-merging by enabling direct region-based queries and sample selection across the cohort, accelerating subset exports.

Does TileDB-VCF work with Python for querying genomic variant data?

Yes, TileDB-VCF works with Python for querying genomic variant data. You can use the tiledbvcf Python API to read selected regions for chosen samples into a dataframe, supporting efficient variant querying and cohort analysis directly within your scripts.