frequently asked questions
Login & Technical Issues
-
I am unable to load Analyzer from my workplace.
Try using Chrome or Firefox as your browser and check to be sure your institution’s firewall isn’t blocking ports necessary for the Analyzer to function. This can be tested by trying to access the Analyzer from home or another location.
-
I have missed the window of time acknowledge data shared with me on the Analyzer. Can you please re-send this share request?
Contact your collaborator and request the data be shared again.
-
I am unable to see shared data from my colleague.
Verify that your collaborators are using the exact email associated with your Analyzer account and request they re-share the data with you.
-
I am unable to load Analyzer from my workplace.
Try using Chrome or Firefox as your browser and check to be sure your institution’s firewall isn’t blocking ports necessary for the Analyzer to function. This can be tested by trying to access the Analyzer from home or another location.
-
I have missed the window of time acknowledge data shared with me on the Analyzer. Can you please re-send this share request?
Contact your collaborator and request the data be shared again.
-
I am unable to see shared data from my colleague.
Verify that your collaborators are using the exact email associated with your Analyzer account and request they re-share the data with you.
-
I have missed the window of time to validate my credentials for my Analyzer account.
Click on the Forgot Password link at the login prompt. This will re-initiate the validation email for your account.
-
I am unable to login to the Analyzer.
First, verify that you are using the same email address that you used to set up your account, then try resetting your password. Click on the Forgot Password link at the login prompt. This will re-initiate the validation email for your account.
Features & Functionality
-
How can I tell who has access to my data?
Contact our Customer Care team at customercare@adaptivebiotech.com. They will be happy to provide you with a list of people who have access your workspace.
-
What do you mean by “rearrangement” and “template”? Are these sequencing reads? Are they clones?
Rearrangements and template counts are the basic metrics of immunosequencing.
A "rearrangement" is a unique nucleotide sequence resulting from V, D, and J gene rearrangement.
A "template" refers to a single input molecule that acts as a template for PCR amplification and sequencing.
The total number of sequencing reads found for each rearrangement is used to infer the number of input molecules or templates with that sequence. For data from genomic DNA, each productive template corresponds to a single immune cell, and each rearrangement from genomic DNA will have a template count of 1 or more, depending on how many immune cells carry that rearrangement. We avoid the term "clone" as it is often ambiguous whether a clone refers to a unique rearrangement or the number of cells carrying that rearrangement.
Visit our Glossary for explanations of other immunosequencing terms.
Platform Video link http://www.adaptivebiotech.com/immunoseq/knowledge-center/videos
-
How long will version 2.0 of the Analyzer be accessible?
Currently, we don't have a date set for the discontinuation of version 2.0. We will provide email notification and place a message on your workspace homepage prior to such a change.
-
What do you mean by “rearrangement” and “template”? Are these sequencing reads? Are they clones?
Rearrangements and template counts are the basic metrics of immunosequencing.
A "rearrangement" is a unique nucleotide sequence resulting from V, D, and J gene rearrangement.
A "template" refers to a single input molecule that acts as a template for PCR amplification and sequencing.
The total number of sequencing reads found for each rearrangement is used to infer the number of input molecules or templates with that sequence. For data from genomic DNA, each productive template corresponds to a single immune cell, and each rearrangement from genomic DNA will have a template count of 1 or more, depending on how many immune cells carry that rearrangement. We avoid the term "clone" as it is often ambiguous whether a clone refers to a unique rearrangement or the number of cells carrying that rearrangement.
Visit our Glossary for explanations of other immunosequencing terms.
Platform Video link http://www.adaptivebiotech.com/immunoseq/knowledge-center/videos
-
How can I tell who has access to my data?
Contact our Customer Care team at customercare@adaptivebiotech.com. They will be happy to provide you with a list of people who have access your workspace.
-
How long will version 2.0 of the Analyzer be accessible?
Currently, we don't have a date set for the discontinuation of version 2.0. We will provide email notification and place a message on your workspace homepage prior to such a change.
-
How can I reduce the load time for my data?
Immunosequencing datasets are inherently very large and projects with a large number of samples will take longer to load. You can reduce the load time by including only the samples you need to compare side-by-side within a project. Another way to reduce load times is to take advantage of the filter feature and include only the relevant samples for any given analysis view.
-
How can I see overlap between samples?
To visually demonstrate overlap between two samples, use the Pair-wise Scatter Plot analysis. Different types of scatter plots may be selected via the Edit link, and there is also an option to display the Pearson coefficient between the two samples.
To demonstrate overlap between multiple pairs of samples at once, use the Sample Overlap Tool. The Sample Overlap Tool measures the extent to which rearrangements are shared between samples. This tool supports several estimation techniques including TCR Overlap, Pearson's Correlation (r2), Jaccard Index, and Morisita Index. The tool will compute the specified overlap measure between all selected samples and generate a TSV file for the raw overlap data, and a PDF illustrating a heatmap of the overlap data. Finally, for all selected samples a scatterplot matrix will be generated.
Scatter plot matrixHeatmapThe Venn Diagram Tool is another way to visualize overlap between multiple samples.
To obtain a list of which rearrangements overlap between samples, use the Combined Rearrangements analysis.
Watch Analyzer video tutorials
-
How do I remove someone from my Analyzer workspace?
Contact our Customer Care team at customercare@adaptivebiotech.com. They will be happy to update the list of people approved to access your workspace.
-
How do I look for a specific sequence within my data or other samples?
Using filters is an easy way to search for a specific sequence in your own data. To do this, initiate a new analysis, then click on "Filters" in the upper right of your screen. Click the Add New Filter drop down menu and scroll down. To match a nucleotide sequence, click on "Rearrangement," and to match an Amino Acid sequence click "Amino Acid". Enter the sequence of interest in the value field. Use dropdown menus above the value field to adjust the search logic. Click the "ADD FILTER" button. The matching sequence(s) can be viewed most clearly in the Rearrangement Details View.
To search for a specific sequence within publicly available samples, first navigate to immuneACCESS™ using the main menu in the upper left corner of the page. Entering the amino acid or nucleotide sequence of interest in the immuneACCESS search bar will return any exact matches in the entire database. These samples can then be added to your workspace for analysis.
-
I have a feature request for the Analyzer. Whom should I contact?
We regularly update our Analyzer software based on user feedback and we’re always interested in hearing your ideas. Please send your suggestion to techsupport@adaptivebiotech.com.
-
How do I move data from one workspace to another?
Start by creating a new project, then add the samples you wish to move. Navigate to your project dashboard and locate the new project. Click “Edit” and then click the Move tab. Fill in the email address for the person you’d like to move the project to.
-
I have a suggestion to improve the Analyzer functionality. Whom should I contact?
We regularly update our Analyzer software based on user feedback and we’re always interested in hearing your ideas. Please send your suggestion to techsupport@adaptivebiotech.com.
-
What’s the best way to organize samples for analysis?
Use projects to organize your samples and analyses. For example, if you have 300 samples in your workspace, but only want to analyze ten specific samples from Subject 321, it's very cumbersome to repeatedly find and select these ten samples for each new analysis. It's also difficult to locate any past analyses that you've saved since they will be mixed in with the saved analyses of other samples.
A better approach is to create a new project using just the ten samples of interest from Subject 321. It's easy to navigate to a project, and any analyses you do on these samples can be saved within the project. If your colleague also wants to analyze the same sub-set of samples, you can each make your own projects with the same set of ten samples, but your work will be saved individually as part of your respective projects.
-
How do I share my data with colleagues?
Sharing projects with colleagues is easy. Using the "PROJECTS" link in the menu on the upper left of the Analyzer 3.0 page, select a project to share with a colleague. All Samples and analyses associated with the project will be shared. In the "ACTIONS" column, select "SHARE" and enter your colleague's email address. If your colleague already has an immunoSEQ Analyzer account, please use the email address they have associated with their account. Click "ADD" and then "SAVE PROJECT.”
Alternatively, if you wish to share only certain samples from a project, create a new project that contains only those samples. Use the "Share" tab in the Create Project window to enter your colleague's information.
-
Where can I find definitions of the terminology used in the Analyzer?
Click on the column headers in the Analyzer to reveal term definitions. In the Analysis views, look for the "About this view" link. Similarly, for tools, click on the "! Learn more about..." links for more information. Use the question mark at the upper right corner of the screen to access the Help page. Please refer to our Glossary for a full list of immunosequencing terminology.
-
I believe I've found a bug in the Analyzer. How do I report it?
We appreciate knowing about bugs you may have discovered through your use of our software. Please send a screenshot and details of the error you are observing such as what workspace you are in, the samples involved, the name of the analysis and the full text from the error dialog window to techsupport@adaptivebiotech.com.
-
Can I change the color, font, or scale in the charts before exporting them?
Analyzer 3.0 gives you the option to select logarithmic or linear scale in the 'Edit' menu of each visualization. To change the color and font, you will need to use Analyzer 2.0 or export the data and customize your chart using another program.
immuneACCESSTM
-
What is immuneACCES?
immuneACCESS is the largest open-access database of TCR and BCR sequences in the world. You can explore, analyze, and export these data to use in your own research projects. If you are interested in adding your own project to immuneACCESS we’re happy to help. Just email immuneaccess@adaptivebiotech.com.
-
Can I make changes or add tags after my immuneACCESS project is made public?
Projects can be altered after publication.
We’re happy to help you with any changes you need to make to your immuneACCESS Project, just email us at immuneaccess@adaptivebiotech.com.
-
Will my analysis tabs be saved for an immuneACCESS project?
Analysis tabs are not saved for default projects within immuneACCESS. To save analysis of immuneACCESS data, first “Follow” the project of interest, and then create a new project using the immuneACCESS samples. Now that the samples are in your own project, you’ll be able to save your analyses.
-
What is immuneACCES?
immuneACCESS is the largest open-access database of TCR and BCR sequences in the world. You can explore, analyze, and export these data to use in your own research projects. If you are interested in adding your own project to immuneACCESS we’re happy to help. Just email immuneaccess@adaptivebiotech.com.
-
Can I make changes or add tags after my immuneACCESS project is made public?
Projects can be altered after publication.
We’re happy to help you with any changes you need to make to your immuneACCESS Project, just email us at immuneaccess@adaptivebiotech.com.
-
Will my analysis tabs be saved for an immuneACCESS project?
Analysis tabs are not saved for default projects within immuneACCESS. To save analysis of immuneACCESS data, first “Follow” the project of interest, and then create a new project using the immuneACCESS samples. Now that the samples are in your own project, you’ll be able to save your analyses.
-
Can I analyze immuneACCESS Data with my own data?
Yes. You can add samples from one or more immuneACCESS projects to your own projects and analyze the data together. To find samples of interest, search the database by project, disease state, or even search for specific sequences. The samples can be added to your own projects from right from the search results page by selecting the samples and clicking “Add to project.”
If you’re interested in samples from a particular project you can also select them using the project specific interface. You’ll need to be following the immuneACCESS Project, then navigate to your projects page and click on the “New Project” button. Click the Samples tab of the Create Project window. Scroll through the list of samples and click on those that you’d like to add to your new project. -
Can I share my data with reviewers before making my project public?
Yes, we can set up a password protected login that will allow reviewers to access only the data used in the manuscript. Email us at immuneaccess@adaptivebiotech.com and we’ll happily assist you.
-
How do I create a public immuneACCESS™ project?
From within your Analyzer workspace navigate to your projects page and click the “New Project” button. Complete the project details information, select the samples you’d like to include, and then follow the instructions on the “immuneACCESS” tab. Click the “Save Project” button to submit your project.
We will review your submission and then publish it on immuneACCESS so it’s available to everyone.
If you have questions or would like assistance with this process, please contact immuneaccess@adaptivebiotech.com.
-
Can I publish a dataset even if it isn't a published journal article?
Yes. We ask that you include an overview of the samples and experiment as well as your contact information so users know what the samples are, and how to contact you with any questions.
Data Analysis
-
What do you mean by "productive?"
We identify a rearrangement as productive if it is in-frame and does not contain a stop codon. For the CDR3, the rearrangement must be in-frame relative to the conserved cysteine and phenylalanine even if changes to the N-D-N region no longer code for these amino acids.
In the Analyzer, the data column, "frame_type," identifies each rearrangement as:
"In" for in-frame sequences
"Out" for out of frame sequences
"Stop" for sequences containing the stop codon
Visit our Glossary for explanations of other immunosequencing terms.
-
What do you mean by "productive?"
We identify a rearrangement as productive if it is in-frame and does not contain a stop codon. For the CDR3, the rearrangement must be in-frame relative to the conserved cysteine and phenylalanine even if changes to the N-D-N region no longer code for these amino acids.
In the Analyzer, the data column, "frame_type," identifies each rearrangement as:
"In" for in-frame sequences
"Out" for out of frame sequences
"Stop" for sequences containing the stop codon
Visit our Glossary for explanations of other immunosequencing terms.
Analysis Guidance
-
What will my data look like?
The raw output of the assay is contained in downloadable tab-separated-value files that contain each observed nucleotide sequence, corresponding CDR3 amino acid sequence, template copy numbers for each sequence, as well as gene annotations. These data and summary data for all samples are accessible in the cloud-based immunoSEQ Analyzer.
The Analyzer is a powerful and easy-to-use software solution designed specifically for working with immunosequencing data sets. We have a library of tutorial videos to quickly get you up to speed on the features and functionalities of the software. We also have an online Demo available if you'd like to see some sample datasets. Another great way to see exactly what immunoSEQ Data looks like is to explore the open-access immunoSEQ Projects that have been shared in immuneACCESS.
Go to the Analyzer video tutorials
Go to the Analyzer Demo
Go to immuneACCESS
-
What will my data look like?
The raw output of the assay is contained in downloadable tab-separated-value files that contain each observed nucleotide sequence, corresponding CDR3 amino acid sequence, template copy numbers for each sequence, as well as gene annotations. These data and summary data for all samples are accessible in the cloud-based immunoSEQ Analyzer.
The Analyzer is a powerful and easy-to-use software solution designed specifically for working with immunosequencing data sets. We have a library of tutorial videos to quickly get you up to speed on the features and functionalities of the software. We also have an online Demo available if you'd like to see some sample datasets. Another great way to see exactly what immunoSEQ Data looks like is to explore the open-access immunoSEQ Projects that have been shared in immuneACCESS.
Go to the Analyzer video tutorials
Go to the Analyzer Demo
Go to immuneACCESS
What is the Analyzer
The immunoSEQ Analyzer - 2:11 minutes
Immunosequencing is revolutionizing our understanding of the immune system. The immunosequencing experts at Adaptive have created the immunoSEQ Analyzer® to help you work with these vast data sets. See how the Analyzer will support your experimental design and help you get to discoveries faster. At Adaptive Biotechnologies, we know it’s not just about generating a rich trove of data. It’s about getting answers to your experimental questions - quickly and easily.
How to use the Analyzer
Getting Started with immunoSEQ Analyzer - 3:40 minutes
Learn how to get started with the immunoSEQ Analyzer.
Analysis View: Rearrangement Details - 2:47 minutes
Learn how to use the Rearrangement Details feature in the immunoSEQ Analyzer.
Analysis View: Top Rearrangements - 2:33 minutes
Learn how to use the Top Rearrangements feature in the immunoSEQ Analyzer.
Analysis View: Track Rearrangements
Learn how to use the Track Rearrangements feature in the immunoSEQ Analyzer.
Analysis View: Combined Rearrangements - 1:57 minutes
Learn how to use the Combined Rearrangements feature in the immunoSEQ Analyzer.
Analysis View: CDR3 Length - 1:53 minutes
Learn how to use the CDR3 Length feature in the immunoSEQ Analyzer.
Analysis View: Gene Usage - 2:20 minutes
Learn how to use the Gene Usage feature in the immunoSEQ Analyzer.
Analysis View: Pair-wise Scatter Plot - 2:17 minutes
Learn how to use the Pair-wise Scatter Plot feature in the immunoSEQ Analyzer.
Analysis View: Pivot Table - 1:48 minutes
Learn how to use the CDR3 Length feature in the immunoSEQ Analyzer.
Analysis View: Advanced Query - 1:32 minutes
Learn how to use the Advanced Query feature in the immunoSEQ Analyzer.
Analyzer Tools: Diversity Metrics - 1:19 minutes
Learn how to use the Diversity Metric Tool in the immunoSEQ Analyzer.
Analyzer Tools: FASTA Conversion - 1:16 minutes
Learn how to use the FASTA Conversion Tool in the immunoSEQ Analyzer.
Analyzer Tools: Sample Overlap - 2:01 minutes
Learn how to use the Sample Overlap Tool in the immunoSEQ Analyzer.
Analyzer Tools: Venn Diagram - 1:48 minutes
Learn how to use the Venn Diagram Tool in the immunoSEQ Analyzer.
Webinars
Data Analysis Demo and Hands-on Exercises using the immunoSEQ Analyzer - 40:24 minutes
Data Analysis Workshop (Video 3 of 4) - Tina Bose, PhD, teaches how to leverage the power of the immunoSEQ® Analyzer for data analysis. You'll find the full series of Data Analysis Workshop videos on the Videos page of our Knowledge Center.


