How the experiment-wide compensation works in Cytobank

Background 

When you have selected an experiment compensation matrix in the Compensation Editor on the Cytobank platform, it will be used as an experiment-wide compensation for all other parts of your data analysis including GatesIllustrations, and the Advanced analyses. In this article, we will discuss how the experiment-wide compensation behaves with each analysis part and how to change it.  

How to set an experiment-wide compensation 

How the experiment-wide compensation behaves within different parts of the analysis  

Gates 

Illustrations 

Advanced analyses 

Others 

 

How to set an experiment-wide compensation   

Access the Compensation page by clicking the Compensation link on the experiment level navigation bar. If the navigation bar doesn’t contain Compensation, please click Actions -> Edit Compensation to access the Compensation page.  

  blobid0.png

Select the matrix you would like to use from the Compensation Editor to be the experiment-wide compensation. If the compensation option you’d like to select isn’t present, generate a new compensation matrix first.  

   blobid1.png

 

The impacts of changing the experiment-wide compensation on the analysis can be found here on How to modify a File-Internal Compensation matrix 

Also, check out all articles on compensation

How the experiment-wide compensation behaves within different parts of the analysis 

Gates 

 If you have set the experiment-wide compensation prior to gating, it will be the default selected compensation under the Active Compensation. If you need to change the experiment-wide compensation for gating, within the Gating Editor, click on the edit pen from the left pane to go to the Compensation Editor to change the experiment-wide compensation matrix there.  

 

  blobid2.png

If you changed the experiment-wide compensation after creating gates, those gates will be hidden. When you click on the hidden gates, an error message will show up under the Active Compensation showing the name of the compensation that was used to draw the gates. You may either go to the Compensation Editor to change the compensation back or re-draw the gates with the new compensation selected.  

 blobid3.png

When importing gates from another experiment, the current experiment-wide compensation will apply to the imported gates. If the imported gates were drawn with different compensation other than the experiment-wide compensation in the experiment, the imported gates will be hidden

When importing gates via GatingML into an experiment with existing gates, the current experiment-wide compensation will apply to the imported gates.  

When importing gates via GatingML into an experiment with no gates, the experiment-wide 

compensation will be set to the most commonly used compensation among gates imported.  

The experiment-wide compensation will also be applied to the cluster gates.  

 

Illustration 

 The Illustration will automatically use the experiment-wide compensation. The compensation setting can be accessed from Plots > More plot settings in the Compensation section at the bottom. If the illustration has compensation set differently from the experiment-wide compensation, it will display a warning message. By clicking the red warning, users can decide whether to apply the updated experiment-wide compensation settings to the existing illustrations created with the old setting. By default, the previously saved illustration will keep the old compensation unless users explicitly choose to match the new experiment-wide compensation. All new illustrations made after the experiment wide change compensation will use the current compensation setting. 

 blobid4.png

When importing an illustration from another experiment, it will try to match the compensation by name, if there is no match, it will default to the experiment-wide compensation of the target experiment receiving the import.  

 

Advanced analyses 

 The experiment-wide compensation will be the default compensation selection for all advanced analysis algorithms.  

You will be able to change the selected compensation to a different compensation at the SPADE and viSNE setup pages directly. In order to change the compensation setting for FlowSOM and CITRUS, you will need to change the experiment-wide compensation from the Compensation Editor.  

 

Others 

The experiment-wide compensation will be the default compensation selection when performing these tasks: 

Export stats 

Export events 

Scales editor 

Experiment Manager: Expanded Detail View 

 



Have more questions? Submit a request