
<LinkableSection id={"5-2-0"} title={"5.2.0"}>
- The Clonotype Distribution plot now supports coloring clonotypes by sample or metadata provided in the Cell Ranger `aggr` input CSV, offering more customizable visualizations. For details, refer to the [Comparing Multiple Samples](/support/software/loupe-vdj-browser/latest/tutorials/lvb-comparing-multiple-samples) tutorial. 
- Exported sequences for selected clonotypes now include their associated Sample ID(s), improving traceability and facilitating downstream data analysis.
- The honeycomb plot can now be exported as a CSV file, containing the X and Y coordinates for all barcodes, allowing for detailed examination and further analysis.
- Clonotype IDs are now displayed in the clonotype filter list, enabling easier tracking of clonotypes across both the web summary and output files.
- Fixed a bug that prevented imported Loupe files from being removed from the workspace.
- Fixed a bug that caused inconsistencies in clonotype numbering across pipeline outputs and the Loupe (VDJ) Browser.


</LinkableSection>

<LinkableSection id={"5-1-0"} title={"5.1.0"}>

- Introduces ability to visualize (Comparison tab) BEAM (Antigen Capture) libraries aggregated with `cellranger aggr`.

</LinkableSection>

<LinkableSection id={"5-0-1"} title={"5.0.1"}>

- Bug fix to display the correct consensus sequence under the “Align Contigs to Consensus and Reference” option.

</LinkableSection>

<LinkableSection id={"5-0-0"} title={"5.0.0"}>

- New and improved user interface that allows for rapid filtering and exploration of V(D)J datasets!
- Supports data analysis for [Antigen Capture (BEAM)](/support/software/cell-ranger/latest/getting-started/cr-5p-what-is-antigen-capture) with new visualization and filtering tools that enable users to rapidly explore the relationships between clonotypes and antigens.
- Immune cell clonotypes can now be visualized through the Clonotype Distribution plot.
- Updated Sequences view for improved visualization of paired BCR or TCR receptor chains along with receptor nucleotide sequences for exact subclonotypes within a clonotype and their associated [antigen specificity score](/support/software/cell-ranger/latest/algorithms-overview/cr-5p-antigen-algorithm#ag-spc-score).

</LinkableSection>

<LinkableSection id={"4-0-0"} title={"4.0.0"}>

- Supports changes to Cell Ranger v5.0, including V(D)J `aggr` and the new clonotype grouping algorithm.
- Required upgrade for processing data generated by the Cell Ranger v5.0 pipeline. Due to extensive changes to the underlying infrastructure, `.vloupe` files generated by Cell Ranger 4.0 and earlier Cell Ranger versions cannot be read into Loupe V(D)J Browser 4.0 or Loupe Browser 5.0.

Comparison Mode:

<Image src={"https://cdn.10xgenomics.com/image/upload/v1705533322/software-support/Loupe/loupe-vdj/clonotype-frequency.png"} />

Loupe V(D)J Browser 4.0 now allows for comparison of samples in files generated by the V(D)J `aggr` pipeline. Data can be divided into samples based on the columns in the aggregation CSV provided to the `aggr` pipeline, such as donor, origin, library ID, and any custom columns. A sample group dropdown has been added to all comparison mode charts, allowing for quick navigation.

For `.vloupe` files with a large number of samples, a new selection option will appear to enable displaying a subset of samples in a single view.

The clonotype frequency view is no longer accessible via a button in the sample table, but can still be found in the chart type dropdown. Selectors have now been added to the clonotype frequency chart to allow for quick switching between samples.

Clonotype Table Filtering:

<Image src={"https://cdn.10xgenomics.com/image/upload/v1705533443/software-support/Loupe/loupe-vdj/inkt-mait.png"} />

Identify potential invariant natural killer T (iNKT) cells and mucosal-associated invariant T (MAIT) cells with a new clonotype table filter. The iNKT/MAIT evidence filter can be used to view clonotypes that contain any cells with supporting evidence in any of the TRA genes, TRA junctions, TRB genes, or TRB junctions of being an iNKT or MAIT cell. This filter is only visible for T cell datasets.

There are a number of other powerful filtering options added in this release:

- The clonotype table can now be filtered by sample for `.vloupe` files generated by `aggr`.
- Clonotypes in B cell datasets can be filtered by light or heavy chain isotype.
- Graph-based clusters generated by the new reclustering feature in Loupe Browser v5.0 can now be used to filter the clonotype table as part of the existing cluster filter.

Chain View Updates:

<Image src={"https://cdn.10xgenomics.com/image/upload/v1705533513/software-support/Loupe/loupe-vdj/chains-diff.png"} />

It is now easier than ever to gain insights from the chain view. Rows in the chain view now represent exact subclonotypes instead of individual cells, meaning cells with identical immune receptor nucleotide sequences are now collapsed into a single row in the table. A Download Barcode List option is available when hovering over an exact subclonotype to see the full list of barcodes included in the row. Additionally, a donor reference is now visible between the universal reference and consensus. The donor reference only spans the length of the V gene.

Additional Features:

- Improved performance across the application on datasets with a high number of cells.
- Refreshed appearance for several features.

Removed Feature:

- The IGV plugin view has been removed from Loupe V(D)J Browser v4.0.

</LinkableSection>

<LinkableSection id={"3-0-0"} title={"3.0.0"}>

- Loupe V(D)J Browser v3.x is a required upgrade for processing data generated by the Cell Ranger v3.0 pipeline.
- Same UI features as Loupe V(D)J Browser v2.1.0.
- Import `.cloupe` files generated by Cell Ranger v3.0.

</LinkableSection>

<LinkableSection id={"2-1-0"} title={"2.1.0"}>

- Better support for allele-aware references.
- New B cell paired and unpaired isotype summary charts.
- Convert all proportions to percentage.
- Clarify help clonotype list, comparison, and bug report text.

</LinkableSection>

<LinkableSection id={"2-0-1"} title={"2.0.1"}>

- Renames Multi-Sample Comparison to Comparison Mode
- Fixes Sample Overlap single-chain counting bug, simplifies similarity metric options
- Prevents click event from comparison mode selector from propagating to the chart underneath and hiding a sample
- Comparison Mode documentation update

</LinkableSection>

<LinkableSection id={"2-0-0"} title={"2.0.0"}>

B Cell Support:

- The Chromium™ Single Cell V(D)J Solution now offers comprehensive, scalable profiling of both 5′ gene expression transcripts and full-length, paired T Cell Receptor and B cell immunoglobulin transcripts. Loupe V(D)J Browser has added a few additional features especially designed to help with analyzing B Cell samples.
  - In chain view, indicate Isotype Switching alongside the barcode labels.
  - All existing features in Loupe V(D)J browser are compatible with B cells.

Comparison Mode:

Loupe V(D)J Browser v2.0 allows you to load multiple samples into the same workspace and includes powerful plots, metrics, and statistics to compare multiple samples. You can also quickly switch between multiple samples a single workspace. New features include:

- Clonotype Comparison - Compare the relative abundance of clonotypes between two samples and find the clonotypes that have the greatest difference
- Sample Overlap - Determine sample similarity between paired clonotypes or unpaired chains
- Top Clonotype Overlap - Determine which top clonotypes are shared between multiple samples
- Clonotype Frequency - Plot and compare the clonotype abundances between two samples.
- Sample Table - Quickly compare high level metrics between multiple samples
- Gene Usage - Plot the gene usage of the V, D, J, and C genes accross multiple samples.

You can also export any of these charts to an image or the underlying data to a CSV.

Integrated V(D)J Clonotype + Gene Expression Analysis:

When using the combined 5′ Gene Expression and T-Cell and B cell enrichment kits, it is now possible to measure whole transcriptome gene expression and V(D)J repertoire diversity from the same sample. To facilitate this analysis, Loupe V(D)J Browser 2.0 allows you to combine the V(D)J and gene expression data with a few clicks.

To find out more about how to conduct an integrated experiment, consult the Single Cell V(D)J + Gene Expression page. For a complete Loupe how-to including some example data, go to [Integrated V(D)J and Gene Expression Analysis in Loupe V(D)J Browser](/support/software/loupe-vdj-browser/latest/tutorials/lvb-integrated-analysis-loupe-vdj-browser).

The complete list of gene expression features in Loupe V(D)J Browser include:

- Import `.cloupe` gene expression files into a single `.vloupe` workspace
  Compare clonotypes identified in gene expression clusters within one or between two samples and find clonotypes that have the greatest difference
- Filter the clonotype list for clonotypes that only exist within one gene expression cluster
- On import, detect whether a V(D)J dataset is associated with the loaded gene expression data

Additional Features:

- Summary Charts
  - Added new CDR3 bar graph
  - Added D Gene and C Gene Usage Charts
  - Export all summary charts as SVG
  - Export summary chart data as CSV
  - View help text for each chart by hovering over the question mark
- Export Clonotype List as clonotypes or single chains
- Support for soft-clipped alignments generated from Cell Ranger
- Added color legend for chain view variants
- Support native macOS window switching
- Augment all inputs by allowing the select all hotkey

</LinkableSection>

<LinkableSection id={"1-0-2"} title={"1.0.2"}>

- Fixes issue that may block file opening and bug reporting when an HTTP proxy is active on a user's system.

</LinkableSection>

<LinkableSection id={"1-0-1"} title={"1.0.1"}>

- Corrects title of tutorial dataset.

</LinkableSection>

<LinkableSection id={"1-0-0"} title={"1.0.0"}>

- Initial release.

</LinkableSection>


Release Notes for Loupe V(D)J Browser

Loupe V(D)J Browser is a desktop application for Windows and macOS that allows the user to analyze, search, and visualize V(D)J sequences and clonotypes from 5' Chromium Single Cell Immune Profiling data.

Overview

Download Center

Getting Started

Tutorials

Release Notes

Loupe Browser

Datasets

Analysis Guides

Loupe V(D)J Browser

Interface and Features

Learn about Loupe V(D)J Browser and get oriented with its interface and features.

Clonotype Distribution and Sequence

Summary Plots

Exploring Clonotypes

Isotype Switching in B Cells

Comparing Multiple Samples

Analysis of each of the sequenced libraries (5′ Gene Expression, V(D)J, Antibody Capture, and Antigen Capture), alone or in combination with other library types, can be performed using the latest versions of Cell Ranger, Loupe Browser, and Loupe V(D)J Browser.

Integrated Analysis

Integrated Analysis in Loupe Browser

Integrated V(D)J + 5’ Gene Expression Analysis in Loupe Browser

Integrated Analysis in Loupe V(D)J Browser

Integrated V(D)J + 5’ Gene Expression Analysis in Loupe V(D)J Browser

Integrated Analysis with Feature Barcoding

Integrated V(D)J + 5’ Gene Expression + Cell Surface Protein Analysis in Loupe V(D)J Browser

Other Analysis

Characterize Tumor Cells

What is Loupe V(D)J Browser?

View the latest updates to Loupe V(D)J Browser.

Browse Q&As from the 10x Genomics support team.

Access free, publicly available data from 10x Genomics.

A collection of introductions, tutorials, and blogs for data analysis beyond software.