Don't forget to mark the static binary executable:

chmod +x vg

Docker Image: quay.io/vgteam/vg:v1.67.0

Buildable Source Tarball: vg-v1.67.0.tar.gz

Includes source for vg and all submodules. Use this instead of Github's "Source Code" downloads; those will not build as they do not include code for bundled dependencies that the vg build process needs.

This release includes:

• GAF path end positions are calculated correctly in some edge cases.
• --keep-path can now be used multiple times in vg mod
• vg giraffe --track-correctness should no longer crash when read truth positions are on paths that exist in the graph, but are too short to reach where the read is.
• Bring vg cluster up-to-date: now accepts GBZ files, can do short-read or long-read giraffe, and allows --prefix for better compatibility with vg autoindex
• Add some options to vg cluster to help with chaining issue diagnosis: print out cyclic snarl sizes, seeds with high hit amounts
• Fix GFA haplotype sniffing for GFAs with P-lines
• Use graph metadata and not path name to determine reference/haplotype status for paths in vg call and vg deconstruct.
• Loading transcript files will now produce a human-readable error message when there are duplicate transcripts with the same ID on different paths.
• The GBWT built while sorting GAF with vg gamsort is now forward-only by default.
• vg sim now can output in FASTQ format via --fastq-out
• Make vg mod -t take an argument and stop -E from requiring one
• In vg chunk, fix the long names for -P, -c, -r, and -R, and make the latter two accept arguments.
• Register command line options correctly & put them under test (scripts/check_options.py). This involved a lot of minor bugfixes and helptext modifications, collected in a Google Doc.
• Manually wrap option helptext lines after 80 characters
• vg sim now works with sample name even when no GBWT is provided.
• CI now enforces the minimum required GCC version.
• vg now requires a minimum GCC version of 7, the oldest major version available in the Ubuntu releases we test on for CI.
• vg giraffe usage example now shows using a .zipcodes file and a .withzip.min file.
• vg can now be built with the mimalloc allocator (v3 beta)

Updated Submodules

• BBHash
• libbdsg
• libvgio
• sdsl-lite
• sparsepp
• vcflib

New Submodules

• mimalloc

Removed Submodules

• fastahack (now used via vcflib)

Don't forget to mark the static binary executable:

chmod +x vg

Docker Image: quay.io/vgteam/vg:v1.66.0

Buildable Source Tarball: vg-v1.66.0.tar.gz

Includes source for vg and all submodules. Use this instead of Github's "Source Code" downloads; those will not build as they do not include code for bundled dependencies that the vg build process needs.

This release includes:

• vg can build on CMake 4
• Mention the new wiki page about the --tsv-out option within its helptext
• Add transcript paths to spliced transcriptome graph before saving in autoindex
• Added -u/--cut-alignment option to vg chunk to allow cutting long alignments down to the portion(s) actually in the chunk.
• Renamed GAM-related vg chunk options to be about generic alignments (with fallback aliases of the old names).
• Change README and vg giraffe's helptext to indicate that it supports long reads as well as short reads
• vg giraffe no longer un-maps the read being used for rescue when no significant alignment is found for the read being rescued
• vg can now surject to CRAM. To use an external reference, you will need to pre-populate the reference cache (see REF_PATH and REF_CACHE documentation at https://www.htslib.org/workflow/cram.html).
• vg surject now slides by twice the anchor length looking for suspicious anchors
• vg surject now uses a slightly increased gap open penalty in DP to encourage idiomatic gaps.
• vg filter --progress now shows you the progress of reading through the input file.
• Standardize capitalization in helptext
• vg surject should no longer suffer from score overflows in tail alignment from the new higher gap open penalty.
• Fix broken link in README due to wiki page rename
• giraffe-facts.py script works again (with backported changes from the long read Giraffe experiments repo) and is now under CI test
• vg surject no longer increases the gap open penalty by default, but allows it to be adjusted with --extra-gap-cost/-E.
• vg giraffe will always assign MAPQ 0 to unmapped reads in pairs
• assertion error fixed in vg paths -n
• Add option to vg convert to promote generic-sense paths to haplotype-sense paths
• Old vg CI jobs will now be canceled automatically when a new commit is pushed to a branch
• Reads fetched from indexed GAF files are now deduplicated because one read might intersect multiple ID ranges
• Reads fetched from indexed GAF files are now parsed and checked for actual intersection with the query range
• snarl clipping options in vg clip expanded and refined
• vg giraffe now admits to taking FASTA input with -f
• Add a CIGAR option to --tsv-out
• Add new option --track-last to track either last correct alignment (current/default) or last existing alignment in scripts/giraffe-facts.py
• vg construct progress bars should fit longer PanSN contig names
• Zip code tree iterator no longer tries to handle a stack depth that can't occur in S_SKIP_CHAIN
• Option to output the GBWT of the paths when sorting GAF with vg gamsort.
• vg clip -d and -D can now be used together (depth threshold applied to edge clipping)

Updated Submodules

• DYNAMIC
• atomic_queue
• gbwtgraph
• libbdsg
• sdsl-lite

Don't forget to mark the static binary executable:

chmod +x vg

Docker Image: quay.io/vgteam/vg:v1.65.0

Buildable Source Tarball: vg-v1.65.0.tar.gz

Includes source for vg and all submodules. Use this instead of Github's "Source Code" downloads; those will not build as they do not include code for bundled dependencies that the vg build process needs.

This release includes:

• Fix call -v to use consistent ref traversals (resulting in more accurate coverage info)
• Fixed a few minor typos in comments

Updated Submodules

N/A

Don't forget to mark the static binary executable:

chmod +x vg

Docker Image: quay.io/vgteam/vg:v1.64.1

Buildable Source Tarball: vg-v1.64.1.tar.gz

Includes source for vg and all submodules. Use this instead of Github's "Source Code" downloads; those will not build as they do not include code for bundled dependencies that the vg build process needs.

This release includes:

• Giraffe will no longer cut nodes wrong when anchoring an extracted subgraph's end on the reverse strand of the same node as its start
• Giraffe will make fewer tips, by enforcing path length strictly for connecting subgraph extraction. Dagification will still produce tips that will still be trimmed.
• vg giraffe will no longer confuse the two orientations of single bounding nodes when aligning between positions, a source of invalid alignments.
• New vg align --between POS,POS feature for manually exercisign the align-between-positions code used by vg giraffe.
• vg now only builds required parts of vcflib
• vgmanmd.py now properly handles --help failures

Updated Submodules

The gbwtgraph, gcsa2, libhandlegraph, and libvgio submodules have been updated.

Don't forget to mark the static binary executable:

chmod +x vg

Docker Image: quay.io/vgteam/vg:v1.64.0

Buildable Source Tarball: vg-v1.64.0.tar.gz

Includes source for vg and all submodules. Use this instead of Github's "Source Code" downloads; those will not build as they do not include code for bundled dependencies that the vg build process needs.

This release includes:

• vg giraffe logs now include more information about candidate chains.
• vg find -r will no longer include empty nodes for nonexistent node IDs in the range being extracted.
• TLEN for read 1 starting inside read 2 will no longer be shorter than the union of the reads in vg surject.
• TLEN computation handles more CIGAR operations in case we decide to use them.
• vg chunk now outputs and accepts base path ranges.
• vg giraffe has new hifi and r10 preset parameters that improve speed, are mostly neutral on calling accuracy, but add more wrong MAPQ 60 HiFi reads.
• Zip code ancestor orientation bugfix for vg giraffe: all minimizer and zipcode files will need to be re-generated to take advantage of it.
• GFA L-lines now written before P/W lines when converting to GFA (using vg's own implementation). The main upshot is that paths in the output of vg convert -fW can now be viewed in BandageNG.
• Giraffe now rebuilds both the minimizers and zipcodes if either needs to be rebuilt
• Loading an old minimizer file now fails
• Haplotype sampling can sample fragmented haplotypes in large snarls.
• vg man page now includes options hidden behind --help.
• Wiki pages for long-read Giraffe are now under CI testing
• vg giraffe should no longer produce final mappings with nonzero offsets or other wrong answers when a read tail doubles back on itself.
• GBWTGraph GFA parsing algorithm can handle missing SeqStart/SeqEnd fields in W-lines.
• Reference samples for haplotype sampling can be selected with --set-reference in vg haplotypes and vg giraffe.
• vg giraffe can now handle self-loop cycles that happen to fall exactly where it wants to put an all-insertion edit.
• vg giraffe allows multiple tips for anchor nodes if they are the same length and back-translation can work.
• vg giraffe should no longer find and be very confident in obviously insignificant rescue alignments for paired reads.

Updated Submodules

The gbwt and gbwtgraph submodules have been updated.

Don't forget to mark the static binary executable:

chmod +x vg

Docker Image: quay.io/vgteam/vg:v1.63.1

Buildable Source Tarball: vg-v1.63.1.tar.gz

Includes source for vg and all submodules. Use this instead of Github's "Source Code" downloads; those will not build as they do not include code for bundled dependencies that the vg build process needs.

This release includes:

• Removed unit tests for primer filtering that require the source tree

Don't forget to mark the static binary executable:

chmod +x vg

Docker Image: quay.io/vgteam/vg:v1.63.0

Buildable Source Tarball: vg-v1.63.0.tar.gz

Includes source for vg and all submodules. Use this instead of Github's "Source Code" downloads; those will not build as they do not include code for bundled dependencies that the vg build process needs.

This release includes:

• Add a man page (make doc/man/vg.1, https://github.com/vgteam/vg/wiki/vg-manpage)
• Better description of how to use input options for types of JSONs in vg view
• Since vg rna can't parse .gz files, have it give a useful error for those inputs
• Long Read Giraffe is now in vg. The vg giraffe subcommand now supports long reads.
  • vg giraffe now has --parameter-preset hifi and --parameter-preset r10 for using a new chaining-based algorithm to map long reads. --parameter-preset chaining-sr uses the new algorithm for single-ended short reads; the old --parameter-preset default and --parameter-preset fast remain available with the old non-chaining algorithm for short reads or paired-end inputs.
  • giraffe-facts.py script now knows how to read GAM files internally and no longer needs JSON preprocessing.
  • The vg giraffe minimizer file format has changed.
  • There is also a new .zipcodes index file used in vg giraffe mapping.
  • Improvements have been made to the distance index format used in vg giraffe.
• Haplotype information files used in haplotype sampling are a bit smaller. Existing files can still be used.
• Allow selecting the identity field in vg filter --tsv-out
• vg giraffe, vg mpmap, and vg map will now fail early with an error when encountering a read with a quality string of the wrong length (as from a truncated FASTQ)
• vg now tries to limit itself to a good number of threads for the number of CPUs in any enclosing Slurm job, via SLURM_JOB_CPUS_PER_NODE and CPU affinity masks.
• vg chunk can now properly take a chunk of a path that already has a subrange
• vg inject now has --add-identity to calculate 'identity' statistic (e.g. for linear mapper output BAMs)
• Add vg primers to get stats about variants in PCR primers from primer3
• Stop identity() from penalizing soft clips (insertions at start/end of path) as part of the total length
  • Note that this changes calculation used for the identity field in GAM files!
• vg autoindex will no longer duplicate input gbz as .giraffe.gbz when indexing for Giraffe.
• GAF sorting with vg gamsort is much faster than before.

Updated Submodules

The dozeu, gbwt, gbwtgraph, libbdsg, libhandlegraph, libvgio, and sublinear-Li-Stephens submodules have been updated.

Don't forget to mark the static binary executable:

chmod +x vg

Docker Image: quay.io/vgteam/vg:v1.62.0

Buildable Source Tarball: vg-v1.62.0.tar.gz

Includes source for vg and all submodules. Use this instead of Github's "Source Code" downloads; those will not build as they do not include code for bundled dependencies that the vg build process needs.

This release includes:

• GBWT construction from a GAM/GAF file now uses parallel construction jobs.
• vg chunk and vg find now generate subpaths with subrange metadata when cutting up paths.
• vg gbwt will accept subranges on fragment 0 and discard the fragment number.
• vg map, vg mpmap, and vg giraffe can now annotate output with SAM-style flags from FASTQ comments with --comments-as-tags
• vg surject now detects when multipath alignments obviously don't belong to the graph they are being surjected to.
• Updated libbdsg to check if a distance index actually has distances and to improve memory use of distance indexing when not including distances
• vg index now includes include flag --no-nested-distance to build a distance index with distances only on the top-level chain
• Add --snarl-sample to vg stats -R. This adds BED-style reference coordinates to the front of each row in the snarl output table, using the input sample to select reference paths. If no selected path is found .'s are written. If multiple paths / intervals find (in case of cyclces), the first one found is printed.
• vg deconstruct -n bug that bypassed some nested sites fixed.
• When reading a .gff3 file with vg rna, validate exon ordering by base-pair position instead of number attribute. This allows reverse-strand exons to be numbered either by base-pair order or transcription order.
• Have vg rna gracefully ignore features with bad chromosome names if they're not included in --feature-type and thus won't be parsed anyways

Updated Submodules

The gbwt, gbwtgraph, gcsa2, libbdsg, libvgio, sdsl-lite, and sublinear-Li-Stephens submodules have been updated.

Don't forget to mark the static binary executable:

chmod +x vg

Docker Image: quay.io/vgteam/vg:v1.61.0

Buildable Source Tarball: vg-v1.61.0.tar.gz

Includes source for vg and all submodules. Use this instead of Github's "Source Code" downloads; those will not build as they do not include code for bundled dependencies that the vg build process needs.

This release includes:

• Changed the protocol of the elfutils submodule from git:// to https://
• Set snarl distance to 0 in path normalizer now that distance index is fixed.
• GCSA indexing now checks for I/O errors on temporary kmer files.
• make get-deps can no longer demand you set a timezone even when DEBIAN_FRONTEND=noninteractive in the calling shell.
• vg chunk can now reference-index particular haplotype paths when requested.
• vg paths -o added to apply a ReferencePathOverlayHelper before looking at the paths.
• Mac CI now uses macOS 15 base image.
• source_me.sh is no longer needed.
• fix validate bug on protobuf graphs
• vg surject --prune-low-cplx should no longer assess different contexts for different orientations of the same read, and should properly detect short tail anchors.
• sublinear-Li-Stephens now builds with the same compiler as the rest of the vg build
• vg rna can now output a haplotypes GBWT with node IDs matching the spliced graph

Updated Submodules

The libbdsg, sdsl-lite, and sublinear-Li-Stephens submodules have been updated.

The elfutils submodule URL has changed; make sure to git submodule sync.

Don't forget to mark the static binary executable:

chmod +x vg

Docker Image: quay.io/vgteam/vg:v1.60.0

Buildable Source Tarball: vg-v1.60.0.tar.gz

Includes source for vg and all submodules. Use this instead of Github's "Source Code" downloads; those will not build as they do not include code for bundled dependencies that the vg build process needs.

This release includes:

• vg's self-reported version information should no longer be able to lag behind the actual Git revision checked out
• vg stats --snarl-contents added to print a table of snarl / depth / parent / nested node ids
• vg inject can now handle reads that softclip after the end of the target path
• vg paths -n option added to normalize graphs using path information to "snap together" redundant paths through snarls. After running, no two path traversals through a snarl will ever produce the same sequence string without the traversals themselves being identical.
• vg build system no longer patches kff-cpp-api CMakeLists.txt.

Updated Submodules

The kff-cpp-api, libbdsg and sublinear-Li-Stephens submodules have been updated.