Skip to main content

VSTOL

VSTOL (Variant Standardization, Tabulation, and Operations Library) is a toolkit that standardizes smalll and structural DNA variants from VCF files into the Occam's Variant Grammar TSV files. It also supports list operations (annotate, diff, intersect, merge, overlap) on variant lists.

build License

01. Installation

vstol is available on pypi:

pip install vstol

02. Dependencies

  • python>=3.10
  • pandas>=2.0.3
  • numpy>=1.22.3
  • networkx>=3.4.2
  • intervaltree>=3.1.0

03. Usage

vstol [-h] [--version] {annotate,diff,intersect,merge,overlap,vcf2tsv}

04. Available Commands

Command Description
annotate Annotate variants.
diff Diff target variants from query variants.
intersect Identify intersecting variants.
merge Merge multiple variant lists into one list.
overlap Identify variants that overlap with a list of genomic regions.
vcf2tsv Convert a VCF file (see below for supported variant callers) to the Occam's Variant Grammar TSV file.

05. TSV File Headers

vstol vcf2tsv outputs each variant callset as a tab-separated values (TSV) file with the following columns:

  • id
  • source_id
  • sample_id
  • platform
  • method
  • chromosome_1
  • position_1
  • strand_1
  • operation_1
  • chromosome_2
  • position_2
  • strand_2
  • operation_2
  • sequence

Additional columns from the VCF file will be included.

06. Supported Variant Callers

To use VSTOL, we recommend that you first convert a VCF file to a TSV file using the vcf2tsv command in VSTOL. The following variant callers are currently supported:

Metadata

Release files for vstol 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vstol 0.4.1
File Size Uploaded
vstol-0.4.1.tar.gz 27.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for vstol 0.4.1
File Interpreter ABI Platform
vstol-0.4.1-py3-none-any.whl Python 3 none any Details

Total release size: 96.8 kB

Release files / vstol-0.4.1.tar.gz

Download URL vstol-0.4.1.tar.gz
Size 27.8 kB
Tags Source
SHA-256 checksum
How to use checksums
1efa27780405329194e82270199e23fe7aceda6c61a92e31a04c253994465eaa
BLAKE2b-256 checksum
How to use checksums
be35a4709e76ac74813c59528f867eee4b520f50e7290440e6e9e25c6d08015b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 28, 2025.

Transparency log

Release files / vstol-0.4.1-py3-none-any.whl

Download URL vstol-0.4.1-py3-none-any.whl
Size 69.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2025727515b507d5a289f7c7980a4c08904b1bcefe7d612806992194a51b30c1
BLAKE2b-256 checksum
How to use checksums
5f5a64859f9bf377eb6b898342d31b1b1cf1c53b656d4a3f54e063ba4ddf2fc6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 28, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.4.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page