FlowJo Tutorial
FlowJo Tutorial
Basic Tutorial
FlowJo was written by Adam Treister and Mario Roederer beginning in 1996, based on concepts developed at the
Herzenberg Laboratory at Stanford. We are indebted to our active and enthusiastic users worldwide for their ideas,
discussions and tireless testing of new versions.
FlowJo, its tutorials, documentation and web site are copyright © Tree Star, Inc. 1997-2013. All rights reserved.
• Basic Tutorial •
• © MMXIII •
i
Table of Contents
Introduction............................................................................................iii
Getting Started.......................................................................................1
Lesson 1 - The Workspace..................................................................3
Lesson 2 - Gating...................................................................................7
Lesson 3 - Statistics...............................................................................10
Lesson 4 - Batching in the Workspace...........................................12
Lesson 5 - Basic Table Editor Functionality...............................14
Lesson 6 - Basic Layout Editor Functionality............................18
Saving.........................................................................................................25
ii
Introduction - FlowJo Basic Tutorial
FlowJo is an integrated environment for viewing and analyzing flow cytometric data, presented in the form of a
Workspace. The Workspace contains a list of all of the data samples that you load, the gates, statistics and other
analyses that you apply, and the table and graphical layout that you design. The Workspace is saved as a FlowJo
document on your hard disk; when you reopen the document, you will see the status of your analysis as it was
when it was last saved.
This tutorial is designed to introduce you to the basics of the program. Reading through it, you will learn how
to operate FlowJo. Run the program as you perform the steps in the tutorial so that you can get the best feel for
how the program works. As you watch FlowJo perform various operations such as creating new graphs, statistics,
tables, or graphical layouts, you will see how fast and easy FlowJo is to use.
This tutorial is designed as an introduction to FlowJo. The 8-color PBMC Advanced Tutorial provides more detail
on functionality. Furthermore, FlowJo is capable of much more that simply can’t be covered in an introduction
such as this (for example, there are analysis platforms to perform DNA/Cell Cycle analysis, Kinetics analysis,
Proliferation and Population Comparison). You can learn more about FlowJo through the online help tool.
Whenever you ask for help from FlowJo by pressing the question mark button in the interface of any window, it
launches a web browser and accesses help pages about the part of the program you are using. You can navigate
through the help pages to find out more about all of the aspects of FlowJo. In addition, FlowJo.com contains a
page of FAQ’s (Frequently Asked Questions), tutorial videos on many FlowJo topics, and the Daily Dongle, a
searchable blog discussing all things FlowJo.
As a note, we are pleased to be able to frequently update FlowJo to provide new features and analysis capabilities.
Therefore, it is possible that the graphics shown in this tutorial may not exactly match the windows that you see
when you run the most recent version of FlowJo. You can always download the most recent version of FlowJo
from: http://flowjo.com/download/index.html
iii
Getting Started
To begin this tutorial you will first need to install FlowJo. The easiest way to do this is to download the installer
from our website: http://www.FlowJo.com/download/index.html
You can select your platform (Mac or PC) at the top of the page. For a PC, download the installer.exe file and open
it to install the program. Choose to place a shortcut on the desktop, and when the installer finishes, double click
on the FlowJo shortcut icon to launch the program.
For a Mac, download the installer.zip file and double click it to extract the program. Once the zip file is extracted,
double click on the icon to launch FlowJo.
You can download the tutorial and Sample Data here : http://flowjo.com/home/tutorials
You have downloaded the full version of FlowJo, however, until a serial number is provided, FlowJo will only load
specially enabled demonstration data files, such as those provided for this tutorial. To obtain a trial 30-day serial
number so that you can try FlowJo using your own data simply fill out the form at:
http://www.FlowJo.com/FLS/registration/trial.html
When you launch FlowJo for the first time, the FlowJo license information window will pop up. In the welcome
tab (see screenshot below), you must agree to the license terms and click next.
1
If you have an individual license that you would like to use, you can input your serial number in the window
(below left). If you have a dongle (a physical thumb drive that has a license key on it) plugged into your computer,
FlowJo will detect it automatically and allow you to activate the program. If you have an enterprise group license,
you can configure the connection here as well (below right).
For more information about licenses, visit www.flowjo.com/home/licenseoptions.html
The next tab is “Cytometry” (below left), which allows you to fill out a little information about the type of
experiments and analysis you do so FlowJo can automatically tune your default settings. For the purpose of this
tutorial, you can leave this as is for now and click next.
The last tab titled “You” asks a little more about your FlowJo usage. Make sure ‘Experienced’ is selected under
FlowJo Knowledge section so you will have access to all options in the tutorial. Click done. FlowJo has now
successfully launched and you can begin the tutorial.
Following this link will bring you to a page where you can download the Basic Tutorial zip file with FCS
(flow cytometric standard) files and a PDF of the tutorial. Save these files to disk and double-click on the
compressed file to extract it on a Mac and right click to extract them on a PC.
2
Lesson 1 - The Workspace
The data we are using for this tutorial are from a basic antibody titration experiment. There are five samples with
varying dilutions of PerCP-Cy5.5 anti-CD8 antibody from 1:100 to 1:1600. When you open FlowJo, you will first
be presented with the Workspace, which is your starting point in FlowJo. The ribbons contain tabbed bands, such
as the FlowJo band above, and scrolling through the various bands will display the different tasks in each band.
Each band can be customized with your preferred tasks which is a great way to customize any band with features
you most commonly use.
This is a great dataset, not only to explore the basic functionality of FlowJo, but to also begin to understand how
to properly titrate antibodies (a necessity for ensuring proper results and preventing waste).
To add a band, click on the Ribbon Configuration icon and simply drag the
icon to your ribbon.
3
2) The Group section:
4
You can explore the keyword values of your file in this interface and we are particularly interested in a specific
keyword we entered during acquisition of these data called ‘TUBE NAME’.
Let’s add this TUBE NAME keyword to our workspace so we can quickly reference the dilution used in each sample.
5
Because FlowJo does not know
a ratio formula as a keyword, we
need to add a keyword for the
antibody concentration. Click on
the Workspace tab and select the
Keywords band, click the button to Lesson 1 Fig.12 - tube name column
Add Keyword.
6
Lesson 2 - Gating
You can start this lesson (skipping lesson 1) by opening the Lesson 2.acs file.
Gating is the process of subsetting collected events for further analysis. Subsets can be gated to generate further
subsets, until a collection has only the cells for which a graphic display or analysed statistics are desired. FlowJo
offers a whole set of gating and advanced gating tools to facilitate this process.
To begin creating gates, we must first open the graph window for the first sample. To do this, double click on the
sample A01. This will open the graph window:
Gating options are in the top left hand corner. We are interested
in examining lymphocytes, so lets create a polygon gate on the
lymphocytes. Select the polygon gating tool:
7
Change x and y axis parameters to match the picture below on the right (fig.4).
*FlowJo applies a biexponential transformation automatically to digital (fcs3.0) data. There is a preference to turn this off, but
it is actually a preferable way to display digital data. The T button also allows you to customize the axis to adjust the transform
or convert the axis to log or linear.
*The parameters say comp-parameter name because these are digital data (fcs3.0) files that were acquired with a compensation
matrix. FlowJo applies the compensation matrix generated by acquisition software automatically upon loading data. If you
did not compensate on the machine or use fcs2.0 data, the parameters will not have the comp-prefix. Compensation is
described in more detail in the 8 color PBMC tutorial.
8
To set a gate on the negative and positive populations, let’s select the bisector gate tool and draw a range gate on the
negative and positive populations. FlowJo will name each gate accordingly.
9
Lesson 3 - Statistics
You can start this lesson (skipping lessons 1 and 2) by opening the Lesson 3.acs file.
In version 10 of FlowJo, there is now a ‘quick statistic’ option to calculate the median, CV and Freq. of from the
Statistics band. Since flow cytometry data is typically NOT normally distributed, we refer to the Median as a MFI.
To add the MFI (Median Fluorescence Intensity), CV (Coefficient of Variation) or Freq. of … (Frequency of a
population), these ‘quick statistic’ options can be used.
MFI technically stands for Mean Fluorescence Intensity, but a mean assumes a normal distribution. Since flow
cytometry data is typically NOT normally distributed, in flow cytometry, we refer to the Median as a MFI.
In this experiment, we want to know the CD8a MFI, or CD8a expression level, of the CD8a+ and CD8a-
populations. Therefore, all you need to do is select the CD8a+ population in your workspace.
The MFI is a measure of the expression profile of a particular parameter. Typically, MFI is used when looking at up- or
down-regulation of a marker, or fluorophore expression like GFP. In this experiment, we use the MFI to calculate the
separation/staining/sensitivity index. There are many formulas to calculate these different indices, but a very simple
way to do it is to take the MFI of the positive and divide it by the MFI of the negative. For titration experiments, this
basic formula is sufficient and will be described in more detail in a later lesson.
10
We will now go to the quick statistic interface and choose Median>Comp-PerCP-Cy5.5:: CD8a
Now, do the same thing to the CD8a-population. Lesson 3 Fig.4 - median statistic applied to CD8a+ population
You can also drag and drop the MFI for CD8a
from the CD8a+ to the CD8a- too.
Count is a bit redundant since it is in the workspace already, but if looking to export the count of population(s) out of
FlowJo, adding the statistic to the workspace allows for drag and drop to the Table or Layout Editor.
11
Lesson 4 - Batching in the Workspace
To skip to lesson 4, open the Lesson 4.acs file.
Batching is a process that performs an operation automatically for a group of files, rather than having to manipulate
one file (or sample) at a time. Almost everything in FlowJo can be batched because batching saves you time! As
FlowJo is developed by leaders in the field, any feature to save time has likely been implemented. In this Lesson,
we will discuss batching in the workspace before we discuss batching to outputs using the Table Editor (Lesson 5)
and Layout Editor (Lesson 6). In Lesson 4, we’ll discuss batching in the workspace.
A single gate, a single statistic or an entire gating tree can be batched. In this experiment, we want to batch our
entire tree to the group so that the gates and statistics we added to sample 1 are present in every sample. To do this,
select the Lymphocytes population in the workspace, hold down shift on your keyboard and select the bottom
statistic. You should have the entire gating tree highlighted now:
12
Use the arrow keys in the graph window to scroll through plots
and check gates.
Alternately, with two or more graph windows open, you can hold
down the shift key on the PC or the control key on the Mac and
scroll through more than one Graph Window at once. This allows
you to check multiple gates simultaneously.
Any gate that is modified will turn black and unbold. Group
owned gates/statistics receive the formatting of the group to which
they have been applied. Here you’ll notice all gates/statistics are
black and bold because the ‘All Samples’ group is black and bold.
If the group was a different color, the group-applied gates/statistics
would inherit that different color. Modifying gates after they have
been applied to a group is acceptable in many circumstances
depending on your analysis. FlowJo notifies you of the change by
turning the population black and unbold.
Lesson 4 Fig.3 - graph window navigation
13
Lesson 5 - Basic Table Editor Functionality
To skip to lesson 5, open the Lesson 5.acs file.
The Table Editor in FlowJo allows you to quickly create tables for export into a spreadsheet program like Excel
or to a database. The Table Editor is solely for creating statistic tables and does not manage graphics. Exporting
graphics will be discussed in Lesson 6.
14
Next, we want to add a keyword to the table, click on the Edit tab then click on the Add Column button. Next, the
Column Information dialog window will appear. Here you will select the Keyword Tab, and scroll down until you
find the Antibody Concentration Keyword from the column on the left. Now type Antibody Concentration in
the column heading field and click OK. This adds a keyword to your table so you have the concentration for each
sample upon batching and creating a line plot.
15
Your formula should look like this:
Click OK and you will see the formula in the Table Editor.
You can batch now to generate the table for every sample in your group or you can explore the data a bit more.
To set your batch output, go to the Table Editor tab. You can batch to clipboard, to printer, directly to the Layout
Editor, or to a file. The option most users prefer is to batch to FlowJo first. Batching to FlowJo first will allow you to
check the table over before export and then, from the created table, you have all the options of where to export the
table. So, there is no disadvantage to batching to FlowJo first.
Click the orange sprocket icon in the upper right hand corner to start the batch:
16
You may choose to “export” or “save” your table data to Excel and write and apply your formulas there. That is fine,
but hopefully you now understand how to do it in FlowJo as well!
17
Lesson 6 - Basic Layout Editor Functionality
To skip to Lesson 6, open the Lesson 6.acs file.
The Layout Editor in FlowJo is one of the most feature rich areas in the program. In version 10, it has much of the
functionality that any graphics program has, such as rich text, shading, opacity, rotation, gradient fill, and various
shapes.
The 8 color PBMC tutorial goes into further detail on the Layout Editor and there is a Batching and Iteration
Tutorial available for advanced batching in the Layout Editor.
To make a report in the Layout Editor, you need only to create a report for one sample and then when you batch
it, the same layout of the initial report will be generated for every sample in the group.
To begin making a report for our first sample, open the Layout Editor and drag the Lymphocytes gate from the
first sample from the workspace to the Layout Editor.
When you drag a population to the Layout Editor, you will get a graph:
18
When you drag a statistic to the Layout Editor, you will get a text box of that statistic. Drag the Median CD8a
statistic from the CD8a+ population of sample A01 to the Layout Editor Workspace.
To edit the graph, simply double click on it. The resulting graph
definition window will allow you to edit any of the properties of the
graph in the Layout Editor.
For example, lets edit the x-axis. Go to the Annotate tab of the ‘Graph
Definition’ window and under the ‘X Axis’ section, enter CD8a as the Label.
19
Uncheck show frequencies, then click Apply and you will observe that the label and annotation change:
Now, to finish this report, place the CD8a- MFI statistic in the Layout Editor as
well and create a ratio formula right in the Layout Editor.
20
To create the equation, highlight the text, right click and select “Equation from Selection”.
Then change the line style formatting to bold and text formatting
size to 18 point in the Layout Editor to get this:
*Text within a text box must be highlighted for changes to take effect.
One last thing we may want to do is to get rid of the sample annotation.
To do this, you can simply select it and hit delete.
You are able to reorganize the layout to how you prefer it and then we’ll batch!
1) Return to the Layout Editor Tab to batch these graphs and statistics, you can select any group you want, but in this
experiment, you want group All Samples.
2) The iterator is off, so it will batch by sample by default. This is what we want. It could also be set to sample with
the same effect. Advanced iteration can be learned in the Batching and Iteration tutorial.
3) We will batch to a new layout, but many other options are available.
FlowJo will generate the batch report for all the samples in the selected group. Arrange them on five pages so you can see
the results in this document (Obviously, you can also see the results on your screen).
21
As you can see, everything batches. Graphs, statistics, text boxes or other objects will all batch. Batching can save you
an extraordinary amount of time. By setting up the prototypical report for your first sample, you can quickly generate
a report and get every object present for ALL samples by batching.
Overlays
Creating an overlay is simple. First, add a new layout by clicking the plus
button in the upper left hand corner of the Layout Editor Band.
22
Now, drag the lymphocyte population from sample A02 onto the existing graph of Sample A01 in the Layout
Editor. When you do that and drop the population, an overlay will be created. You will notice that the graph
border also turns blue, this is to let you know that you are creating an overlay. When you do that and drop the
population, an overlay will be created.
23
Now, hold down the alt key on the keyboard, right click on the color boxes of the legend and select ‘filled’.
24
Saving
*If hard drive space is a concern, these files will take up a lot more memory due to the fact that the file is duplicating the .fcs
file information. Most of the time this is not a concern, but if these files are 100MB each and you only have 10GB of space
on your hard drive, you can see how this could be a problem! Luckily, most people have 500GB or more and don’t work with
such large data sets.
3) The other option is to save as a Template (.WSPT). If you will run this experiment again, save the analysis as a
template so all of the analysis is ready for the next experiment. A template will preserve your analysis structure, but
remove the data files. When you run your new data, open the template, drop in your new files and presto, all of your
new files are analyzed! You may have to adjust the gates a little, but everything else will be ready for you.
Thank you for taking the time to learn the fundamentals of FlowJo. Our goal is to produce software that is easy to
use, easy to learn and scientifically accurate. This tutorial has only scratched the surface of FlowJo’s powerful features
and functions. Here are a few more things FlowJo can do, which were not covered in this tutorial:
• Compensation - Corrects for overlap from the emission spectra of fluorochromes. As your experiments
become more complex, the importance of accurate and automated compensation becomes more pronounced.
• Transformation - Uses custom biexponential functions to include zero and negative value events on scale,
maintaining a logarithmic distribution of positive cells.
• Derived Parameters - Supports the creation of new parameters through the algebraic combination of
others, including a wide variety of functions and formula structures, analogous to computed columns in a
spreadsheet.
• Calibrated Parameters - Calculate the quantitation of absolute molecules per cell (MESF) using reference
markers with known calibration values.
• Kinetic Analysis - Measure the change in signal of dyes, or ratios of dyes, over time. Generate statistics and
subpopulations based on the subset of cells that have responded to stimulation.
• Cell Cycle Analysis - Computes the percentage of cells in each phase of the cell cycle, based on a dye
measuring the amount of DNA present in the cells (eg. 7AAD, PI, DAPI) FlowJo is the first package to
integrate multidimensional cell cycle analysis, using BrdU or similar markers to differentiate S phase cells.
• Proliferation Studies - Model the frequency of successive generations, and gate cells by the number of
divisions undergone, as measured by intensity of CFSE, or other intracellular dye.
Help menus from any FlowJo window launch a web browser to access a web page describing that topic, giving you
context sensitive help.
25
You can learn more about FlowJo at the links below.
For a more in depth tutorial, download the 8 Color PBMC Analysis at:
http://www.flowjo.com/home/tutorials/eightcolor.html
26