Immune Repertoire and Expression Analysis from Clonotypes and Matrix
The workflow Immune Repertoire and Expression Analysis from Clonotypes and Matrix takes one or more Expression Matrix () / () and Cell Clonotypes () as input to jointly analyze scRNA-Seq and scTCR-Seq data originating from the same sample. The two types of inputs are sent on two different paths, for scRNA-Seq and scTCR-Seq data, respectively.
Note that the sample in the input elements (Expression Matrix and Cell Clonotypes) must be the same for the cells originating from the same sample. This can be achieved in different ways, depending on how the elements were generated:
- If the input elements were generated in the CLC Single Cell Analysis Module, the sample name can be set when running the Annotate Reads with Cell and UMI tool, see Setting the sample name.
- If the input elements were imported, the sample name in the Cell Clonotypes can be set to that from the Expression Matrix during import, see Import Cell Clonotypes.
- The tool Update to Common Sample Name () can be used for updating the sample name in either input element, see Update to Common Sample Name.
The scRNA-Seq path follows the same analysis described in Expression Analysis from Matrix, while scTCR-Seq path ensures that clonotypes are filtered accordingly.
The workflow uses iterate functionality and allows for a combined analysis of multiple samples to produce:
- a single, multi-sample, normalized Expression Matrix () / ();
- a single, multi-sample, filtered Cell Clonotypes ();
- a Dimensionality Reduction Plot () associated with the automated clusters, predicted cell types, identified clonotypes and additional cell annotations;
- a Heat Map (), a Dot Plot (), and a Violin Plot () with the predicted cell types as cell groups;
- a Cell Abundance Heat Map () with the automated clusters and predicted cell types as cell groups;
- a Phase Portrait Plot () with per gene information on the velocity dynamics;
- a Velocity Genes Scores () allowing identification of velocity genes driving the dynamics.
The workflow can be found in the Template Workflows section here:
Single Cell Workflows () | From Imported Data () | Immune Repertoire and Expression Analysis from Clonotypes and Matrix ()
If you are connected to a CLC Server via your Workbench, you will be asked where you would like to run the analysis. We recommend that you run the analysis on a CLC Server when possible.
Choose either one or more Expression Matrix () / () and Cell Clonotypes () or Select files for import and select the formats that are compatible with the selected inputs. Read more about the import options in Data import.
For the scRNA-Seq path, a number of options are customizable, see Expression Analysis from Matrix. For the scTCR-Seq path, only clonotype filtering is customizable, as described in Immune Repertoire Analysis from Reads (10xVDJ). Adjustments can be made in a workflow copy, see https://resources.qiagenbioinformatics.com/manuals/clcgenomicsworkbench/current/index.php?manual=Editing_existing_workflows.html.
The workflow can be run using Single Cell hg38 (Ensembl) or Single Cell Mouse (Ensembl) reference data sets (see The Reference Data Manager).
Note: Reference data elements cannot be configured during workflow execution. If other elements than those provided in the default reference data sets are needed a custom reference data set can be used, see https://resources.qiagenbioinformatics.com/manuals/clcgenomicsworkbench/current/index.php?manual=Custom_Sets.html. When creating custom reference data sets, the chosen gene track needs to match the gene annotations used for training the provided Cell Type Classifier (), see Features used for training and prediction. |
The workflow allows the analysis of multiple samples and you can specify metadata during workflow execution. This is converted to cell annotations and can be used for coloring the cells in the Dimensionality Reduction Plot. However, the workflow expects each sample to be present in just one Expression Matrix, and attempting to define batch units containing more than one Expression Matrix will lead to a failure during execution. Similarly, each sample is expected to be present in just one Cell Clonotypes element. For more details on configuring workflow execution with metadata, see https://resources.qiagenbioinformatics.com/manuals/clcgenomicsworkbench/current/index.php?manual=Batching_part_workflow.html. Make sure to inspect the batch overview to check that the analysis will be performed correctly.
Subsections