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.
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)
| File | Size | Uploaded | |
|---|---|---|---|
| vstol-0.4.1.tar.gz | 27.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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