BD FACSDiva Software V 8.0 Manual
BD FACSDiva Software V 8.0 Manual
BD FACSDiva Software V 8.0 Manual
Software Reference
Manual
bdbiosciences.com
23-14523-00
4/2013
Becton, Dickinson and Company EC REP BENEX Limited Becton Dickinson Pty Ltd,
BD Biosciences Pottery Road, Dun Laoghaire, 4 Research Park Drive,
2350 Qume Dr. Co. Dublin, Ireland Macquarie University Research Park,
San Jose, CA 95131 USA Tel +353.1.202.5222 North Ryde NSW 2113, Australia
Tel 877.232.8995 Fax +353.1.202.5388
Fax 408.954.2347 Becton Dickinson Limited,
[email protected] BD Biosciences 8 Pacific Rise, Mt. Wellington,
European Customer Support Auckland, New Zealand
Tel +32.2.400.98.95
Fax +32.2.401.70.94
[email protected]
Copyrights
© 2013, Becton, Dickinson and Company. All rights reserved. No part of this publication may be reproduced,
transmitted, transcribed, stored in retrieval systems, or translated into any language or computer language, in any
form or by any means: electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without prior
written permission from BD Biosciences.
The information in this guide is subject to change without notice. BD Biosciences reserves the right to change its
products and services at any time to incorporate the latest technological developments. Although this guide has been
prepared with every precaution to ensure accuracy, BD Biosciences assumes no liability for any errors or omissions,
nor for any damages resulting from the application or use of this information. BD Biosciences welcomes customer
input on corrections and suggestions for improvement.
BD FACSDiva software © Becton, Dickinson and Company. This software is the property of Becton, Dickinson and
Company. Each sale of a stored unit of this software grants the purchaser a nontransferable, nonexclusive, personal
license. This software may not be duplicated, reproduced, or copied in any form or by any means whatsoever, except
as otherwise permitted by law.
Trademarks
This product includes software developed by the Apache Software Foundation (apache.org).
Adobe, Acrobat, and Reader are registered trademarks of Adobe Systems Incorporated.
Diskeeper is a registered trademark of Diskeeper Corporation.
FlowJo is a trademark of Tree Star, Inc.
Intel is a trademark of Intel Corporation in the US and/or other countries.
Java is a trademark of Sun Microsystems, Inc. in the US and other countries.
Microsoft, Windows, and Excel are registered trademarks of Microsoft Corporation.
Modfit LT is a trademark of Verity Software House, Inc.
Sentinel System Driver is a trademark of Rainbow Technologies, Inc.
Sybase Adaptive Server Anywhere is a registered trademark of Sybase, Inc. or its subsidiaries.
BD, BD Logo and all other trademarks are property of Becton, Dickinson and Company. © 2013 BD
Notice to Customers
BD Biosciences delivers software and workstations that are intended for running the instruments supplied by
BD Biosciences. It is the responsibility of the buyer/user to ensure that all added electronic files including software
and transport media are virus free. If the workstation is used for Internet access or purposes other than those specified
by BD Biosciences, it is the buyer/user’s responsibility to install and maintain up-to-date virus protection software.
BD Biosciences does not make any warranty with respect to the workstation remaining virus free after installation.
BD Biosciences is not liable for any claims related to or resulting from buyer/user's failure to install and maintain
virus protection.
BD FACSDiva software contains VxWorks as embedded software (“Run-Time Module”). The Run-Time Module
was developed by a third party and we are obligated to notify our customers about the limitations for use.
Regarding this Run-Time Module, you are prohibited from: (i) copying the Run-Time Module contained herein,
except for archive purposes consistent with your archive procedures; (ii) transferring the Run-Time Module to a third
party; (iii) modifying, decompiling, disassembling, reverse engineering or otherwise attempting to derive the Source
Code of the Run-Time Module; (iv) exporting the Run-Time Module or underlying technology in contravention of
applicable US and foreign export laws and regulations; and (v) using the Run-Time Module other than in connection
with operation of BD instrumentation. The Run-Time Module is licensed, not sold and BD and its licensors retain
ownership of all copies of the Run-Time Module. BD expressly disclaims all implied warranties, including without
limitation the implied warranties of merchantability, fitness for particular purpose, title and noninfringement. Under
no event shall BD or its licensors be subject to any liability for any special, indirect punitive incidental or
consequential damages. Any further distribution of the Run-Time Module shall be subject to the same restrictions set
forth herein.
History
23-11219-00 Rev. 01 5/2012 Initial release for BD FACSDiva software version 7.0.
v
Importing User Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Disabling Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Deleting Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Quitting the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Contents vii
Cytometer Status Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Standby and Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Acquisition Dashboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Current Activity and Basic Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Acquisition Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Acquisition Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Current Tube Pointer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Cytometer Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Adjusting Cytometer Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Creating Specimen- or Tube-Specific Settings . . . . . . . . . . . . . . . . . . . . . . . 132
Using Global Cytometer Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Printing Cytometer Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Exporting Cytometer Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Compensation Correction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Using Compensation Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Using Compensation Setups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Contents ix
Exporting and Importing FCS Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Exporting FCS Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Importing FCS Files from BD Biosciences Applications . . . . . . . . . . . . . . . . 256
Importing FCS Files from Other Applications . . . . . . . . . . . . . . . . . . . . . . . 258
Important Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Exporting and Importing Experiments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Exporting Experiments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Exporting an Experiment Without Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Importing Experiments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Using the Data Manager Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Backing Up the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Restoring a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Glossary 287
Index 293
The BD FACSDiva Software Reference Manual assumes that you have a working
knowledge of basic Microsoft® Windows® operation. If you are not familiar
with the Windows operating system, see the documentation provided with your
computer.
• Chapter 4 to learn about analysis tools like worksheets, plots, gates, and
statistics
• Chapter 5 to learn how to manage data and import and export files
xi
Conventions
The following tables list conventions used throughout this manual. Table 1 lists
symbols that are used to alert you to a potential hazard. Text and keyboard
conventions are shown in Table 2.
Symbol Meaning
Caution: hazard or unsafe practice that could result in material damage, data
loss, minor or severe injury, or death
Convention Use
Bold Bold text indicates software elements such as windows, menus, buttons,
and tabs that are used to complete tasks.
> The arrow indicates a menu choice. For example, “select File > Print”
means to select Print from the File menu.
Ctrl+X When used with key names, a plus sign means to press two keys
simultaneously. For example, Ctrl+P means to hold down the Control key
while pressing the letter p.
• In BD FACSDiva software, select Help > FACSDiva Help. Locate and read
the related topics.
• Product name, part number, and serial number; software version and
computer system specifications
BD Biosciences might also request the console.log and LogFile.xml files located
in D:\BD\FACSDiva\log, as well as your exported experiment file.
Preface xiii
Limitations
For In Vitro Diagnostic Use (IVD) when used with IVD reagents and cytometers.
See the information supplied by the manufacturer for application-specific
limitations.
Software Setup
The following topics are covered in this chapter:
15
About BD FACSDiva Software
BD FACSDiva software is a flexible data acquisition and analysis package
designed for BD FACS™ brand digital flow cytometers. The software uses
flexible features to simplify acquisition, including experiment templates and
automated compensation calculation. The unique software also provides
powerful analysis features including one-click snap-to gating tools, hierarchical
gating, the ability to copy and paste gates, and biexponential display.
What’s Included
The BD FACSDiva installer includes the following applications:
The changes in the newer version are the default locations where some of the
output files are saved. The basic functionality of the application remains the same
as in the previous version.
BD FACSDiva software version 8.0 includes all of the new functions that were
added to version 7.0. See the next section.
Browser Functions
The following functions have been added to improve the experiment Browser.
• Drag and Drop. In the Browser, drag and drop specimens, tubes, cytometer
settings, and analysis settings within open or closed experiments and
folders, as long as the items are of the same object type. See Dragging and
Dropping Elements in the Browser on page 47.
• FCS 3.1 File Format. Import and export FCS 3.1 files.
• Save Settings to Profile. When editing the statistics view, save your changes
by selecting the Save Settings to Profile checkbox. See Selecting Statistics to
Display on page 233.
Worksheet Functions
The following functions have been added to improve use and flexibility of
worksheet elements.
• Copy and Paste Multiple Worksheet Elements. Cut, copy, and paste
multiple worksheet elements to an external application in one operation.
See Copying Worksheet Elements on page 171.
• Dot Size Customizing. In the Inspector, change the dot size displayed for a
population. See Population Attributes on page 226.
• Overlay Plots. Compare tubes by creating overlay plots for histograms, dot
plots, contour plots, or density plots. See Overlay Plots for Tube Data on
page 197.
• Export XML File During Batch Analysis. Export the worksheet elements in
XML format during a batch analysis.
Two new functions are noted here and discussed in detail in specific user’s guides:
Installation
See the BD FACSDiva Software Installation Guide for instructions on installing
or upgrading BD FACSDiva software.
To access the PDF file, select Help > Documentation > Reference Manual or
double-click the shortcut icon on the desktop.
To access the online help, select Help > FACSDiva Help within
BD FACSDiva software.
Hardware
• BD FACS brand digital flow cytometer: BD FACSCanto™,
BD FACSCanto™ II, and BD FACSCanto™ 10-color configuration.
See the user’s guides for other cytometers that use BD FACSDiva software
for research use only (RUO) purposes (BD FACSAria™ II,
BD FACSAria™ III, BD FACSAria™ Fusion, BD™ LSR II, or
BD LSRFortessa™).
NOTE If a workstation does not have a D drive, then the default locations
for output files will be created on the C drive.
Compatibility
• Importing. BD FACSDiva software can import data files in FCS 2.0 or 3.0
format including files generated by BD CellQuest™, BD CellQuest™ Pro,
or BD FACSDiva software, version 6.x or earlier.
• Exporting. BD FACSDiva software can export data files in FCS 2.0, 3.0, or
3.1 formats. The software defaults to version FCS 3.0 for data file
exporting. FCS files can be analyzed by other software applications such as
BD CellQuest, BD CellQuest Pro, FlowJo™, or ModFit LT™.
Before starting the software for the first time, review the BD FACSDiva ReadMe
file. A shortcut is copied to the Windows desktop during installation.
Adding Users
To add a user:
The Account Administration dialog opens. In this dialog you can add or
modify the attributes of a user, enable or disable users, or grant
administrative access.
3 Click Add.
User names must consist of 4–20 alphanumeric characters. Spaces are not
allowed.
To create multiple new users quickly, click the Add button once for each
new user, then select each new user and enter a name in the User Name
field.
a Press the Tab key or click in the Password field and enter a password, if
needed.
6 (Optional) Enter the user’s full name, initials, and institution in the
remaining fields.
• To delete an institution, select a name from the list and click Delete.
Click OK to close the dialog.
Once you click OK, all listed institutions can be selected from the
Institution menu in the Account Administration dialog.
7 Make selections under Access Type, Access Privileges, and Account Access.
• Account Access. Select Disabled only when you want to disable a user.
Otherwise, select Enabled. See Disabling Users on page 35.
• Access Privileges. Select the checkbox next to each setting the user is
allowed to edit.
• Select the Edit Diva Setups checkbox to allow a user access to modify
the setups saved in the Setup Catalog.
• Use current CS&T settings. Select this checkbox to always update the
cytometer settings to the latest performance check.
A new menu is displayed under the Institution field with the custom field
name you entered. We recommend providing this information so it can be
used in keywords and in the User Tracking Log file.
9 In the Custom Field Default field, enter the value associated with the
custom field name you entered (for example, 10-21A or Finance
Department).
The value you entered is displayed in the new custom field you created in
step 8.
If the custom field name is changed, the User Tracking Log header will not
be updated until the new tracking log is created for the next month.
The Account Administration dialog appears showing only your user name
(unless you have administrative access).
5 Click Save.
Logs are named yyyy Month.csv (for example, 2011 February.csv). Logs can be
opened in a spreadsheet application such as Microsoft Excel®.
• User name
• Full name
• Institution
• Build version
• Cytometer type
• Serial number
• Custom field
• User
• Experiment
• Specimen
• Tube
• File Name
• File Size
• Date Modified
3 From the list of user names, select those you want to export, and click
Export.
• To select multiple contiguous names, click the first name in the series,
then hold down the Shift key as you click the last name.
• To select multiple noncontiguous names, hold down the Ctrl key as you
click each name.
1 Transfer the electronic file containing the user profiles to the secondary
computer.
4 Click Import.
5 In the Import window, select the file containing the names you want to
import.
User names must be unique. If the file you are importing contains a
duplicate of any existing user names, an error message appears displaying
the names that are duplicates. Close the message, and either delete the
duplicate user names from the file or select a different file to import.
6 Click Import.
5 Click Save.
Deleting Users
You must have administrative access to delete a user.
1 Export and then delete the user’s experiments from the Browser.
4 Click Save.
• Click the Close button in the upper-right corner of the workspace window.
All Browser and worksheet elements are automatically saved when you quit the
software.
BD FACSDiva Workspace
This chapter describes the following BD FACSDiva workspace elements.
• Inspector on page 42
• Browser on page 43
• Experiments on page 49
• Specimens on page 68
• Tubes on page 75
• Keywords on page 83
37
Workspace Components
When you start BD FACSDiva software, the workspace appears, as shown in the
following figure. Hide or show windows by clicking buttons on the Workspace
toolbar.
Workspace
toolbar
Toolbar in
Browser
Current
tube
pointer
Inspector
Acquisition
dashboard
Status bar
• Use the menu bar at the top of the workspace and the toolbars to control
most software functions.
• Use the current tube pointer or buttons within the Acquisition Dashboard
to control acquisition and data loading.
• Use the status bar at the bottom of the workspace to review cytometer
connection status, fluidics information, and more.
The display of the status bar is selected by default. To close the status bar, clear
the Status Bar option in the View menu at the top of the workspace.
Workspace Toolbar
The Workspace toolbar appears near the top of the application window. It
includes the Save button and View/Hide buttons that show or hide various
windows within the application window.
The following buttons are displayed on the Workspace toolbar. Note that some
buttons are shown only for certain cytometers. See your cytometer manual for
details.
Automation
Turns the automation server connection on or off.
Server
View Options
The BD FACSDiva workspace can be resized to suit your needs, and you can
reposition or resize windows within the workspace. Changes are user-specific,
and are saved from one login session to the next.
1 Click the Restore button in the upper right corner of the workspace to
reduce it.
Whether viewed on one monitor or two, workspace windows can be resized and
repositioned for the most efficient operator workflow.
• To move a window, drag the title bar to a new position on the screen.
• To resize a window, position the cursor on the border. When the cursor
changes to a double-headed arrow, drag the border.
Double-headed arrow
• To view or hide workspace windows, select an option from the View menu,
or click the corresponding button on the Workspace toolbar.
• To restore windows to their default position and size, select View > Reset
Positions.
To display the Inspector, click the Inspector button on the Workspace toolbar.
The contents of the Inspector vary depending on the object selected.
Column divider
Browser toolbar
Search field
Column header
User icon
Open experiment
Current tube
pointer
Closed experiment
Create and access database elements in the Browser. Data is listed by login name
in a hierarchical view. Hide or display the Browser by clicking the Browser
button on the Workspace toolbar.
Users with administrative access can view all experiments in the database. Those
without administrative access can only view their own experiments and any
experiments that have been designated as shared. For more information, see
Making Experiments Shared or Private on page 57.
- Use the search field above the Browser to find experiments or show
fewer experiments in the Browser. See Using the Search Field on
page 45.
You must select elements in the Browser to activate certain buttons. For
example, you must select a specimen or tube to activate the New Tube
button. See Adding New Elements to the Browser on page 46.
- Use the current tube pointer to start and stop data acquisition and
recording and to load data. See Current Tube Pointer on page 123.
You can use the arrow keys on your keyboard to move between elements in the
Browser. Use the right arrow key to expand an element, or the left arrow key to
collapse it.
NOTE You cannot use the find function to locate a folder. If a folder contains an
experiment that meets the search criteria, it will have a plus sign (+) next to it.
• To locate experiments by name, enter the name, and click the Find button.
The Browser lists only experiments with that name, along with the
currently open experiment. Click the plus sign (+) next to a folder or user
icon to view any hidden experiments.
NOTE You can customize the Browser toolbar buttons to add a predefined
template to the Browser. See Template Preferences on page 100 for instructions.
Tool- Name
New
bar (Icon or Description
Element
Icon option)
1 Select an item in the Browser, or hold down the Ctrl key to select multiple
items of the same type, such as specimens or tubes.
3 Drop the items by releasing the mouse button and the items will appear in
the new location.
The drag and drop rules for folders, experiments, specimens, and tubes are as
follows:
- Tubes can only be moved within the specimen where they were created.
• You can select multiple elements to drag and drop, but they must be the
same object type (experiments, specimens, or tubes).
Current tube
For more detailed information on current tube pointers and pointer states, see
Current Tube Pointer on page 123.
When the software is connected to the cytometer, a gray pointer icon is displayed
next to tubes in the open experiment. Click the gray pointer icon to select the
next tube for acquisition or data display. The pointer turns green to indicate the
currently selected tube. Acquisition starts if specified in User Preferences. The
name of the current tube is displayed on the Acquisition Dashboard.
Offline
Current tube
pointer
Experiments
An experiment is a group of elements used to record and analyze data from the
flow cytometer. Experiments can include global worksheets, specimens (material
to be analyzed), tubes (acquisition data and reagents used to analyze the
specimen), analysis objects (plots, gates, and statistics views), and sort layouts or
plates (if applicable). Cytometer settings can be applied at the experiment,
specimen, or tube level.
You build experiments as you record and analyze data. Each new experiment
adds another group of objects to the Browser. Experiments can be private or
shared, and can be exported with data for archival purposes or exported without
data for use as a template.
To create a new experiment, click the New Experiment button on the Browser
toolbar. The currently open experiment closes and a new, open experiment is
added to the Browser.
NOTE If your cytometer configuration does not have a valid performance check,
a warning from the software is displayed. Either click OK in the warning to
continue, or run a performance check.
You can duplicate an experiment by selecting Edit > Duplicate without data. The
experiment is duplicated, but no data is saved and information about the
application settings is not included. Application settings are associated with a
cytometer configuration and include the parameters needed for the application,
area scaling values, PMT voltages, and threshold values, but not compensation.
Template
type Details
To view the experiment layout associated with the experiment template, click the
Details button. The Experiment Layout opens, showing the specimens and tubes
in the experiment, and any defined labels, keywords, and acquisition criteria. See
Using the Experiment Layout on page 60.
Importing an Experiment
• The column headers across the top must be BD system defined keywords,
starting with specimen name. See Keywords on page 83.
3 Navigate to the files you want to import in the dialog that opens.
Opening Experiments
You can edit elements and record data only within an open experiment. Only one
experiment can be open at a time. An open experiment is indicated by an open-
book icon. You cannot close an open experiment during acquisition.
There might be a short delay while the software retrieves the experiment from the
database.
• Specify the number of logs to display for all plots in the experiment (see
Changing Log Display on page 181)
You can locate saved data more easily by naming experiments and experiment
elements with meaningful names.
• Specimen names
• Keywords
• Acquisition criteria
The Export Wizard dialog opens, with steps that show you how to create
and export a template.
• Type. Templates can be grouped by type so they are easier to find later.
To add a type to the Type menu, enter a value in the Type field. Your
new type will be available from the menu the next time you create a
template. Note that types cannot include any of the following
characters: \ / : * ? " < > | , .
3 Click Next.
4 (Optional) Enter study details in the next window and click Next.
Study details are not required, but they can be used to distinguish between
experiment templates with similar names when you have a lot of templates.
6 Click Finish.
Editing Templates
Template files are stored on your computer as XML files. They are organized in
folders by type within BDExport\Templates. The name of each template file
consists of the template name followed by the XML extension.
Template file
Type
folder
To rename a template type, rename the folder the template is stored in.
- To delete a template type and all associated templates, delete the folder
in the Templates\template type folder.
Shared icon
When other users log in to the software, they can add or delete elements within
shared experiments under the Shared View icon in the Browser.
You can view just your experiments (that is, hide all shared experiments) by
clicking the View Own button in the Browser. (All experiments must be closed to
enable the button.) Click the View Shared button to see all experiments again.
View View
Own Shared
Experiment data can be exported in FCS 2.0, 3.0, or 3.1 file format. You can also
import FCS files from another BD application. See Exporting FCS Files on
page 253 and Importing FCS Files from BD Biosciences Applications on
page 256.
To use the Find Experiments function, select Edit > Find. The Find Experiments
dialog opens.
• Find menu and text field. Search for a text string in a particular attribute of
the experiment, such as fluorochrome label or keyword. Select a category
from the menu, then enter specific information in the text field next to the
menu. For example, select Fluorochrome Label and enter CD4 in the text
field.
• Search menu. Select a menu item other than All Elements to restrict the
search to a certain type of data element (experiments, specimens, or tubes).
NOTE You cannot use the find function to locate a folder. However, if a folder
contains an experiment that meets the search criteria, that folder is displayed
with a plus sign (+) next to it, indicating that experiments are inside the folder.
If no experiments contain the requested information, the Browser will list only
the currently open experiment along with any existing folders. To display all
Browser elements again, click Display All.
All labels, keywords, and events to record that you create in a list are entered
under your login name. You can only delete items that you created. However, you
can view and assign labels, keywords, and events to record that other users on
your workstation have entered in their lists.
The Labels and Events to Record lists also display BD-defined labels and events
to record. BD-defined labels and events to record cannot be deleted from the lists.
For details on how to use the lists, see Using the Labels Tab on page 61, Using the
Keywords Tab on page 63, and Using the Acquisition Criteria Tab on page 66.
1 Select any element in the Name column under any of the tabs in
Experiment Layout, such as experiment, specimen, or tube.
You can use the Experiment Layout table to modify labels in the following ways:
If a label has been previously defined, select it from the Label menu. (The
menu is blank until you have defined at least one label.)
You can click the column or row header to select and label multiple cells at
a time. For example, if all samples in the experiment were stained with
CD3 FITC, select the column header for all the FITC parameters in the
table, and then enter CD3 or select CD3 from the Label menu. All selected
cells are labeled with CD3 at once.
Multiple labels can also be entered by selecting the column or row header
and using copy (Ctrl+C) and paste (Ctrl+V). In addition, copy and paste
can be used to copy one label value to multiple label cells or to copy
multiple label values to multiple label cells. Note that if you are copying
multiple values, the number of cells copied must be the same as the number
of cells that are pasted.
• Delete labels. To delete a label, click the label cell and press the Delete key.
Alternatively, click the Label menu and select the blank label field at the top
of the list, then press Enter.
Blank label
field
You can use the Experiment Layout list to modify or apply labels as follows:
• Add a label. Type a label in the Name field and click the Add to List
button. (Labels are case sensitive.)
• Delete a label. Click the Delete from List button. Clicking OK saves labels
to the database.
• Apply a label. Select a label field in the Experiment Layout table, select the
label from the list, and click Assign. Click Remove to clear the label from
the field.
You can also double-click a list item to quickly apply it to a selected field.
For example, select the FITC parameter in the Label column, then double-
click CD3 in the Labels list to apply CD3 to FITC.
Labels can also be entered for individual tubes on the Labels tab of the Tube
Inspector. See Using the Tube Inspector on page 75.
Select the System Defined Keywords checkbox to display the keywords that are
automatically generated.
Enter a keyword value by selecting a cell and then entering a value in the
Value field or directly in the selected cell. If the keyword was set up with
selectable choices, the Value field changes to a menu where you can select
an available value. You can also select a keyword, right-click, and select
Copy Keyword Data from the menu. Then select an element name, right-
click, and select Paste Keyword Data to paste in the keyword. Keyword
changes are automatically updated in the Keywords tab of the
corresponding Inspector.
You can use the Keywords list to add keywords to one or more elements.
Select an element (experiment, specimen, or tube) by clicking the element
name in the table, then select the keyword from the list and click Assign.
The keyword is added to the selected element(s) in any available column or
in a new column to the right. Keywords are case sensitive. Click Remove to
clear the keyword from the element.
Another way to add a new keyword is to select a keyword from the list,
select the specimen or tube name in the Name column, and click Assign. If
more than one cell is selected, the change is made in all selected cells at the
same time. Keywords must be of the same type (such as all numeric or all
string type) and range of values to be included in a multiple selection.
- Hold down the Shift key, then click on the first and last fields in a
range. You can also click in a cell and press Shift+Ctrl+End to select the
rest of the cells in the column.
• Select a cell in the column or row to select the keyword type, then click the
column or row header to select multiple keyword cells of that type. Enter a
keyword or select a keyword from the Value menu to change the selected
cells.
Cancel a value entered in a field or text box by pressing the Esc key before
you click OK. This restores the previous value.
Events to Record
Change the events to record by selecting one or more fields and then entering a
new number. You can also select a value from the Events to Record menu or the
Events to Record list. If more than one cell is selected, the change is made in all
selected cells at the same time.
To use the Events to Record list, type a number in the Number field and click the
Add to List button to add the new item to the list.
Delete an item from the list by clicking the Delete from List button. Click OK to
save items to the database.
Another way to add an events-to-record number using the list is to select the field
you want to change and double-click the item in the list to apply it to the field.
For example, select the Events to Record field for a particular tube, then double-
click 50,000 in the Events to Record list to apply 50,000 to the selected tube. To
change multiple cells at once, click the column header to select the entire column
and assign values (of the same type) in the Events to Record, Global Worksheet,
Stopping/Storage Gates, and Stopping Time fields.
Values can also be entered by selecting the column header or row button and
using copy (Ctrl+C) and paste (Ctrl+V). In addition, copy and paste can be used
to copy one value to multiple cells or to copy multiple values to multiple cells.
Note that if you are copying multiple values, the number of cells copied must be
the same as the number of cells that are pasted.
To assign a preferred global worksheet, select the tube, specimen, or well in the
Global Worksheet column, and then select the desired worksheet from the menu
in the column or in the Global Worksheet field in the Quick Entry area. The
menu displays the global worksheets that are in the currently open experiment.
To assign a storage or a stopping gate, select the tube, specimen, or well in the
Storage or Stopping Gate column and select the desired gate from the menu in the
column or the field in the Quick Entry area. The storage and stopping gates in the
menus are based on the global worksheet that is selected.
If there is no preferred storage gate or stopping gate set for a tube, the gates in the
Tube Inspector are based on the selected global worksheet. If changes are made
to the storage and stopping gates, be sure to have the correct global worksheet
open when checking the gates in the Tube Inspector.
When you set the current tube pointer to a tube, the global worksheet tab
changes to the preferred global worksheet, and the preferred stopping and
storage gates are applied. You can then change those stopping and storage gates,
but not the preferred stopping and storage gates (because preferred gates can
only be changed in the Experiment Layout). If a global worksheet is changed
when a stopping gate or storage gate other than All Events is specified, then the
gate selection is reset to All Events, provided that the selected gate name and type
(for example, rectangle or polygon) drawn on the same coordinate system (for
example, log, linear, or biexponential), using the same parameters, do not appear
in the new global worksheet.
Stopping Time
To assign a stopping time to a tube, select the tube, and in the Stopping Time
column, click the arrows to increase or decrease the values in small increments,
or click the pointer in the slider bar and drag it to a new value. You can define the
stopping time in the same way using the Stopping Time field in the Quick Entry
area at the top of the window.
Specimens
A specimen consists of the name of the material to be analyzed and a list of the
tubes. Specimens can also contain cytometer settings (see Creating Specimen- or
Tube-Specific Settings on page 132).
• Enter the specimen name or sample type. Specimen names cannot contain
commas or periods. Spaces at the beginning or end of the name are
automatically removed.
• Select a default global worksheet for the specimen. The menu lists all global
worksheets in your experiment. The selected worksheet is displayed
automatically when you select a tube below this specimen.
• Click the Keywords tab to view or edit keywords stored with the specimen.
For more information, see Keywords on page 83.
• Specimen name
• Keywords
• Acquisition criteria
Panels are stored outside the Browser to simplify the display. Note that specimens
can be exported as templates only from open experiments.
1 Set up your specimen with a list of tubes, define labels for each tube, and
create analysis objects on a global worksheet.
The Export Panel Template Wizard dialog opens, and provides steps that
show you how to export a template.
4 Select the Export checkbox next to each global worksheet you want to
include, then click Next.
The Select Template Type and enter a Template name dialog opens.
• Type field. Panels can be grouped by type (category) so they are easier
to find. To add a category to the Type menu, enter a name in the Type
field. Your new type will be available from the menu the next time you
create a panel. Note that types cannot include any of the following
characters: \ / : * ? " < > | , .
• Name field. The panel name is based on the name of the specimen in
the Browser. To change the name, enter a new name in the Name field.
Note that panel names cannot include periods or commas.
5 Click Next.
6 (Optional) Enter comments for the panel template in the Study Template
dialog.
Comments can be viewed when you are importing a panel template. See
Importing a Panel Template on page 72.
7 Click Finish.
The Panel Templates dialog opens. Select a panel to import. If any comments
were saved with the panel, they are shown in the box next to the list of panel
templates.
To view details about the panel template, click the Details button. The
Experiment Layout appears showing a list of tubes in the panel, any defined
labels, keywords, and acquisition criteria. You can view but not edit elements in
Experiment Layout when importing a template. See Using the Experiment Layout
on page 60.
You can import up to 50 copies of a panel at a time. Each panel will be imported
as a single specimen. To change the number of copies, click the up arrow next to
the Copies field.
Panel templates can also be used as panel analysis templates. See Exporting a
Specimen as a Panel Template on page 70. When applied to a specimen, a new
normal worksheet is created containing all of its associated analysis objects and
worksheet elements.
The Panel Template dialog opens, displaying the panel templates available
in the application.
• The target specimen must have the same number of tubes as the panel
analysis being applied.
• If panel analysis tube names do not match the tube names in the
Browser, click Continue to apply the analysis. If the tubes in the
specimen already have existing analyses (gates and worksheet
elements), you can overwrite the previous analysis or exit without
overwriting.
• If a panel analysis has only global worksheets, the elements are not
imported.
• To create a new tube, see Adding New Elements to the Browser on page 46.
• To duplicate a tube, right-click the tube and select Duplicate Without Data,
use the Copy and Paste commands, or click Next in the Acquisition
Dashboard.
• Use the Tube tab to name the tube and to view certain keywords and
settings saved with recorded data.
Tube names cannot contain periods. Spaces at the beginning or end of the
name are automatically removed. Note that keyword fields in the Tube tab
cannot be edited.
• Use the Labels tab to enter parameter labels for each fluorochrome. Labels
are displayed on plot axes and in statistics views.
• Use the Acq. (acquisition) tab to specify the following acquisition criteria:
- The number of events to record. Select the number from the menu or
enter a value in the field.
The stopping gate and storage gate settings control the number of events
collected and saved to the database. Any population can be used for a
stopping or storage gate except if it is defined by a snap-to gate or a
tethered gate. For example, if you were performing an immunophenotyping
experiment and wanted to collect data only for the lymphocytes, you could
direct the software to collect 10,000 T-cell events for the stopping gate and
record only events in the Lymphocyte storage gate.
You can also specify the number of events to record, the stopping gate, and
the storage gate using the menus in the Acquisition Setup section of the
Dashboard (see Acquisition Dashboard on page 117) or the Experiment
Layout (see Using the Experiment Layout on page 60). Inspector values are
updated if you change the settings from these menus.
• When available, use the Cytometer Settings tab to view or edit tube-specific
cytometer settings.
While working offline, you can use the Inspector to edit global cytometer
settings or tubes with cytometer settings. (Cytometer settings for recorded
tubes cannot be edited.) While connected to the cytometer, you can change
voltages, thresholds, and ratios for tubes only in the Cytometer window.
The Inspector shows a report of the settings for a selected tube. For more
information, see Cytometer Settings on page 125.
Cytometer settings can apply at the tube, specimen, or experiment level. See
Creating Specimen- or Tube-Specific Settings on page 132 for details.
• When available, use the Keywords tab to view or edit keywords stored with
the tube. See Keywords on page 83.
If any comments were saved with the template, they are shown in the box
next to the list of templates.
Comments
Analysis Objects
An analysis icon in the Browser represents elements that were created to analyze
data. The icon appears under a global sheet when you create a plot, statistics
view, population hierarchy, text box, line, or arrow on a global worksheet. It
appears under a tube after you create any of these items on a normal worksheet.
• Type field. Templates can be grouped by type so they are easier to find
later. To add a new category to the menu, enter a name in the Type
field. Your new category will be available from the menu the next time
you create a template. Types cannot include any of the following
characters: \ / : * ? " < > | , .
• Name field. The template name is based on the name of the worksheet
in the Browser. To change the name, enter a new name in the Name
field. Template names cannot include periods or commas.
3 Click Next.
5 Click Finish.
Copying Analyses
When you copy and paste an analysis icon or duplicate a tube with an analysis,
the duplicated worksheet elements are added to the available space on the
existing worksheet. To make sure the duplicated analysis starts a new page, move
or edit worksheet elements so they fit a full page before you duplicate the
analysis.
Use the arrow keys on your keyboard to access and expand Browser
elements. Use the down arrow key to locate an element, and use the right
arrow key to expand it.
3 Select the tubes or global worksheets where you want to apply the analysis
and press Ctrl+V.
You can also right-click the selected icons and select Paste.
To select noncontiguous icons in the Browser, hold down the Ctrl key while
clicking each icon.
Keywords
Keywords are used to annotate files or sets of statistics. Keywords can be defined
and saved in the database with experiments, specimens, or tubes. Experiment-
and specimen-level keywords are also saved with tubes. When you export FCS
data, these keywords are included in the header of exported FCS files.
• Attach labels to data, making it easier to locate. See Using the Find
Experiments Function on page 58.
• Share keywords with other cytometer users by adding them to the global
keyword list.
2 Click Edit.
Select the generic name in the Name field and enter a new name. Each
name must be unique. Use the suffix to define values, such as units of
measure.
• Boolean. Use for keywords that require a true or false answer. Select
true or false from the Value menu in the dialog or the Keyword
Inspector.
Use the Decimal Places field to specify the number of digits to the right
of the decimal place (maximum of 14).
7 (Optional) Select the keyword and click the Add to Global Keywords List
button to add the keyword to the global list as displayed in the Experiment
Layout. This allows other cytometer users to view and use those keywords.
View and maintain global keywords in the Keywords list on the right side
of the dialog.
Deleting Keywords
Only custom keywords can be deleted. BD-defined keywords (such as $OP for
operator or $CYT for the name of the cytometer used to collect data) cannot be
edited or deleted.
To delete a keyword:
1 In an open experiment, select the Browser item containing the keyword you
want to delete. Click the Keywords tab in the Inspector and click Edit.
Alternatively, open the Experiment Layout, click the Keywords tab, select
the experiment element containing the keyword you want to delete, then
click Edit.
- Duplicate the tube without data. (See Using the Duplicate without Data
Function on page 50.)
• Load data after recording. Data is loaded into plots automatically when
recording is finished. By default, this preference is selected.
Clear the checkbox to not load data into plots when recording is done. If
the checkbox is not selected and you want to load data for a tube, set the
current tube pointer to load the data. The background of the tube pointer
changes from black to gray, indicating the data is loading.
NOTE Enabling the display of the size column will noticeably slow down
Browser performance.
• Quadrant Gate Default Color. Select one of the three options to specify
how populations defined by quadrant gates should be colored:
- Same color for each quadrant. All quadrants (gated populations) are
assigned the same color.
Cumulative Display. This option enables display of all events from the
beginning of acquisition or recording.
- When selected, any new plot or statistics views you create will remain
in cumulative display mode.
- When a gate is deleted, all data is removed from the statistics views and
population hierarchy.
This option can also be accessed from the Plot and Statistics Inspectors.
• Show Worksheet Grid. Select this checkbox to have the grid displayed on
the worksheets. This option is selected by default.
If the Show Worksheet Grid checkbox is selected, a default grid size of 1/8
inch is displayed. Use the grid size menu to change the size to 1/4 inch, 1/2
inch, or 1 inch. If the Show Worksheet Grid checkbox is not selected, the
grid size menu is unavailable.
• Snap-To Worksheet Grid. Select to make all worksheet elements that are
added, moved, or resized snap to the grid. By default, this option is not
selected.
NOTE The worksheet grid does not appear in printouts or in PDF files.
In the Headers and Footers section of the Worksheet tab, you can designate the
information to be displayed on worksheet printouts or PDF files. Cytometer
Name, Experiment Name, User Name, Date Time, and Printed by User Name are
useful to identify and keep track of worksheets. Show and Print Page Numbers
and Print Headers and Footers are selected by default.
Define worksheet title, headers, and footers by selecting from the menus or
typing a custom word in the menu field. Select None Selected to leave blank.
Click Preview to see your selections displayed on a worksheet and make any
changes needed. Worksheet title and header and footer information can also be
entered, edited, and previewed in the Worksheet Inspector. The selections made
in the Worksheet Inspector take precedence over those in User Preferences. See
Using the Worksheet Inspector on page 165.
By default, plots are created with a white background. To change the default
background color, click the color box on the Plot preference tab. A palette
appears from which you can select a new color.
If you set the default background to black, select the checkbox to print plots with
a white background. White gates and populations are then automatically printed
in black.
If you select the checkbox to show an overlay indicator on the plot, the indicator
appears as a green O in the top left corner. This indicates that the plot contains
overlay data from another tube.
When you select an export format, worksheet elements such as plots, statistics,
and population hierarchies can be saved in PNG, TIFF, JPEG, and BMP image
formats.
FCS Preferences
FCS preferences allow you to specify FCS file export and naming options.
• Export FCS after recording. An FCS 3.0 file is automatically exported after
each tube is recorded. For FCS 3.1 or 2.0 data, a manual export is required.
See Exporting FCS Files on page 253 for more information.
Before exporting FCS files, you can define how the files will be named. Naming
files prior to exporting prevents confusion when examining the data at a later
time. The name of an FCS file can contain significant information that provides
information about what is in the file without opening it.
In the FCS Naming Format section, you can specify the following FCS file names:
• Experiment Name. The name of the experiment is included in the FCS file
name when exported.
• Specimen Name. The name of the specimen is included when the FCS file is
exported.
• Tube Name. The name of the tube is included when the FCS file is
exported.
• Custom Text. Allows you to enter a unique name as part of the FCS file
name.
• Auto Increment. Makes file names unique while also indicating the order of
FCS file processing. When processing multiple files with unique, derived
names (for example, tube name), the auto increment function helps indicate
NOTE You can use these options in any combination for naming FCS files. All
exported FCS files, whether by manual export, auto-export, or exported as part
of an experiment, follow the defined format.
Template Preferences
Template preferences allow you to select which template opens when you click
the corresponding button on the Browser toolbar. By default, the Experiment,
Specimen, Tube, and Global Worksheet buttons create a blank experiment, panel
(specimen), tube, and worksheet, respectively.
Statistics Preferences
Statistics preferences determine the format of exported statistics files. The
statistics tab contains two sub-tabs: the General tab and the Export tab.
• Show FCS File Header Keywords. Select this option to show the FCS file
keywords associated with the tube in the Edit Statistics View header tab.
• Export Format. Specifies the file type of exported statistics, including those
generated during carousel auto-export or batch analysis. Select either CSV
format or XML format. For more information, see Exporting Statistics on
page 241.
• Manual Export Format. Specifies the format of exported files when you
select one or more statistics views and select File > Export > Statistics.
Select from the default worksheet format, row, or column. For each option,
an example of the exported file is shown.
Biexponential Preferences
The Biexponential tab enables you to configure the biexponential display of
experiments in the Browser.
To disable biexponential display for all experiments in the Browser, disable the
biexponential scaling preference. Disabling the preference allows more events to
be recorded per experiment. However, large data files can be truncated when you
re-enable it.
Carousel Preferences
If your cytometer uses a carousel and you select the carousel option upon starting
the software, the Carousel tab appears under User Preferences. The Carousel tab
contains two sub-tabs: the General tab and the Save Options tab.
The General tab under Carousel preferences has the following options:
The Save Options tab under Carousel preferences has the following options:
• Statistics results. Select this option to save the statistics data to the folder
you have indicated. You can also select the Date folder checkbox so that
the statistics file will be saved in a folder labeled with the current date.
• Carousel report. Select this option to save the carousel report to the folder
you have indicated. You can also select the Date folder checkbox so that
the carousel report will be saved in a folder labeled with the current date.
Cytometer and
Acquisition Controls
BD FACSDiva software supports several different cytometers. This chapter
contains information about cytometer and acquisition controls that are common
to all cytometers. For cytometer-specific controls, consult your cytometer
manual.
107
Cytometer Controls
Cytometer controls are accessed from the Cytometer menu or the Cytometer
window. To display the Cytometer window, click the Cytometer button on the
Workspace toolbar or select Cytometer from the View menu.
Cytometer Configurations
The physical configuration of a cytometer is the combination of lasers, detector
arrays, filters, and dichroic mirrors inside the cytometer. This is referred to as the
base configuration. A configuration matching your cytometer must be created
within the software. This is typically done by the BD Biosciences field service
engineer during installation. This base configuration serves as the template from
which other configurations can be created.
Status Messages
The Status tab of the Cytometer window lists status messages specific to your
cytometer such as communication or fluidics errors. Messages are listed next to
the time the event occurred. To view the whole message, resize the Cytometer
window.
If the Status tab is hidden by another tab, it turns red to alert you when a message
is sent from the cytometer. If the Status tab or Cytometer window is hidden when
a message is sent, the window icon appears at the top of the workspace with a
message alerting you to check the Status tab.
Laser Controls
Lasers are cytometer-specific. Therefore, laser controls for your cytometer might
be different from those shown in this section. If the following controls do not
apply, consult your cytometer user’s guide.
NOTE Access to laser delay, window extension, and FSC area scaling settings are
set by your administrator. See Adding Users on page 25. To adjust a setting that is
disabled, consult your administrator.
Values entered in the Laser tab apply globally to BD FACSDiva software. They
are not saved with experiments or tubes. The values at startup are the last entered
values.
• Delay. Adjusts the amount of time between signals from different laser
intercepts, from –200 to 200 µsec, to align signals from multiple lasers.
Laser delay values are applied to all parameters detected from their
respective lasers, as specified in the current cytometer configuration.
• BD Defaults. Click to restore all values in the Laser tab to their default
settings as set by BD Field Service during installation or service.
By default, area scaling is set to 1. Notice how different scaling values affect the
data display in the following plots. In this example, an area scaling value of 0.75
best matches the magnitude of the height (fourth plot).
0.75
1.00
1.25
N/A
NOTE Area scaling does not change the height measurements in any way, nor
does it affect the threshold.
The window extension extends the detection time to allow a more complete
recording of the pulse. When you increase the window extension (up to 25 µsec),
half of the setting is applied to each side of the pulse so the entire pulse area is
inside the gate (Figure 3-1).
NOTE If the window extension is too wide, more noise is included and the
coefficients of variation (CVs) increase. If the window is too narrow, pulses might
be measured incompletely.
Threshold
• Cytometer information
• Cytometer settings
• Parameter labels
Report Description
• The User Access Privileges section lists access settings for the current user.
• The Cytometer Info section lists values for laser delay, area scaling, window
extension, and FSC area scaling. (These values are described in Laser
Controls on page 111.) Some cytometers will show additional information.
See your cytometer manual for details.
• The Sorting Settings section contains a list of all sort settings (if applicable
on your cytometer). See your cytometer manual for more information.
• To print the report, select File > Print Report in the Cytometer Status
Report window. Preview the printed report or set up the page for printing
by selecting the corresponding selections from the File menu.
NOTE If your cytometer has software-controlled fluidics, you cannot operate the
fluidics when the cytometer is in standby.
Acquisition Dashboard
The Acquisition Dashboard contains controls for setting up, starting, and
monitoring data acquisition and recording. See Figure 3-2 on page 118.
NOTE Your Dashboard might contain more controls than those shown
depending on the options installed on your cytometer. See your cytometer manual
for details.
Progress bar
• Threshold Rate. Events per second for events that trigger the system
threshold.
• Elapsed Time. Amount of time passed since the Acquire, Record, or Restart
button was clicked.
If your Dashboard contains additional controls, see your cytometer manual for
information. Acquisition controls are as follows:
• Next Tube. Sets the current tube pointer to the next tube in the Browser. If
no tube exists, clicking Next Tube creates a new tube by duplicating the
previous tube without data.
• Acquire Data. Starts acquisition for the active tube/well. Events are
displayed in plots but data is not saved to the database. Statistics are
displayed in statistics views and the values are updated in accordance with
the events to display setting.
NOTE You can also use the current tube pointer in the Browser to control
acquisition and recording. See Current Tube Pointer on page 123.
• Record Data. Starts recording data for the active tube/well. The acquisition
timer and all counters reset to zero when this button is clicked (except
during a sort, if applicable on your cytometer). Events are recorded until
the requested number of events to record has been saved or the stopping
time (if entered) has elapsed, whichever comes first. The resulting data is
saved in the database.
NOTE Use the Stopping Gate Events counter to view the number of events
saved to the data file as you record data.
NOTE If you click Record Data for a tube that already has data, you can
select to Append (add the data in Events to Record to the original file),
Overwrite, or Cancel. Data is appended only if the current cytometer
settings are identical to the settings saved with the recorded tube. If the
settings were changed, you can only overwrite or cancel.
• Restart. Clears data from plots, resets the timer and counters to zero
(except during a sort, if applicable on your cytometer), and restarts
statistics. You can restart during acquisition or recording.
Acquisition Setup
Use the Acquisition Setup fields to control the number of events to record and
display.
Recording stops when the Stopping Gate Events counter reaches the
entered value. If a stopping gate other than All Events is specified,
recording stops when the number of events within that gate reaches the
entered value. If a stopping time is entered, recording stops after the
Use the Experiment Layout to set events to record for multiple tubes in an
experiment. Also use the Experiment Layout to set storage gate, stopping
gate, stopping time, and global worksheet values. See Using the Experiment
Layout on page 60. You can also set events to record, storage gate, and
stopping gate values in the Acquisition tab of the Tube Inspector. See Using
the Tube Inspector on page 75.
NOTE You have the option to not load data into plots when recording is
finished. To use this option, select Edit > User Preferences and clear the
Load data after recording checkbox in the General tab. If you want to load
data for a tube, set the current tube pointer to load the data. The
background of the tube pointer changes from black to gray, indicating that
the data is loading.
- Click the pointer on the slider bar and drag it to a new value.
- Hold down the Ctrl key while clicking the arrows or pressing the keys
to increase stepped values in increments of 10.
Acquisition Status
Use Acquisition Status fields for ongoing status during acquisition or recording.
Show or hide acquisition status information by right-clicking in the Acquisition
Dashboard (in any blank area except for Basic Controls). A menu is displayed
where you can select to show or hide different sections of the dashboard. These
fields cannot be edited.
• Threshold Count. Cumulative count of all events that trigger the system
threshold (events that pass through the laser beam).
NOTE Verify that the current tube pointer is set to the appropriate tube before
you record data.
• To start acquisition, click the green pointer. The pointer changes to yellow,
indicating that acquisition is in progress. Click the pointer again to stop
acquiring.
NOTE In User Preferences, you can specify that acquisition will begin
automatically every time the current tube pointer is set to a new tube. See
General Preferences on page 90 for more information.
• To start recording data, hold down the Alt key while clicking the pointer.
The pointer changes to orange, indicating that recording is in progress.
While recording, Alt+click the pointer to switch from recording to
acquisition. Click the pointer without holding down the Alt key to stop
acquisition and recording.
The pointer does not automatically advance to the next tube after data has
been recorded. To record the next tube, click the gray pointer for the
subsequent tube in the Browser, or click Next Tube in the Acquisition
Dashboard.
During offline use, cytometer settings for tubes are edited in the Inspector. When
you are connected to the cytometer, you can change voltages, thresholds, and
ratios for tubes only in the Cytometer window. The Inspector shows a report of
the settings for a selected tube. You can use this feature to compare settings for
the current tube with those from another tube or experiment (Figure 3-3).
Cytometer
window:
Cytometer
settings editor
Inspector:
Cytometer
settings report
To adjust a setting, select the field containing the value you want to change.
Software controls, consisting of up and down arrows and a slider bar, appear
next to the value as shown in Figure 3-4.
Pointer in
slider bar
• Click the pointer on the slider bar and drag it to a new value.
• Use the mouse to click the up and down arrows or press the arrow keys on
your keyboard to increase or decrease the values in small increments.
• Hold down the Ctrl key while clicking the arrows or pressing the keys to
increase stepped values in increments of 10.
Use the Parameters tab to specify which parameter data should be sent and
stored, to apply PMT amplification (or electronic gain for FSC), and to convert
the parameter display to log scaling.
Parameters are listed in the order they are defined in the Cytometer
Configuration dialog. When more than one fluorophore is defined for a
given channel, the first listed fluorophore is added by default.
Menu
• Delete parameters by clicking the selection button next to the row to delete,
and then clicking the Delete button. Select multiple contiguous rows by
holding down the Shift key as you click. Select multiple non-contiguous
rows by holding down the Ctrl key as you click.
NOTE To reduce FCS file size and save space in the database, delete
parameters that are not applicable for the corresponding tube.
• Measure signal height or width along with area by selecting the appropriate
checkboxes. To measure height only, select Height and then clear Area.
(Either Area or Height must be selected for all listed parameters.) When
Area or Height is selected, it will be measured for all fluorescent
parameters.
• Adjust the signal for events displayed in plots by changing PMT voltages
(electronic gain for FSC). Higher voltages increase detector sensitivity,
resulting in increased signal, lower voltages decrease detector sensitivity,
resulting in decreased signal.
Voltages can be adjusted from 0–1,000 V. To use the controls, see Adjusting
Cytometer Settings on page 126.
• For any listed parameter, select the Log checkbox to convert the parameter
display to a log scale.
NOTE Select multiple rows before clicking the checkbox to turn log on or
off for multiple parameters at once.
Data Display
All data originating from the digital electronics is linear data from 0–262,143
(218 – 1). BD FACSDiva software does not use log values. It uses linear values
that can be displayed on a linear, log, or biexponential scale. Changing the data
display does not affect statistics because statistics are always calculated on linear
data. You can alter the display at any time.
Linear plots have tickmarks at 0, 10,000, 20,000, and so on. Logarithmic plots
show a range of 26–262,143 (four-log decades) or 2.6–262,143 (five-log
decades). In order to display all height measurements on a similar scale,
BD FACSDiva software multiplies height values by 16.
Use the threshold tab to specify a boundary below which data will not be
processed. Threshold values can be adjusted from 200 to approximately
262,143.
Menu
When more than one parameter is listed, select Or or And to define combined
threshold values.
• Or. Signals must be equal to or greater than any one of the listed threshold
values to be processed and displayed.
• And. Signals must be equal to or greater than all listed threshold values to
be processed and displayed.
The Compensation tab displays spectral overlap values for all parameter
combinations in the experiment. For general information about compensation,
see Compensation Correction on page 138.
If you are adjusting compensation manually, click in the Spectral Overlap field to
access controls to adjust the values, or click to select the value in the field and
enter a new value. To clear one or more values, select one or more rows and click
Clear.
Ratios are most commonly used for calcium flux experiments. Ratios are
calculated by dividing the signal from one fluorescence detector by the signal
from another fluorescence detector and then multiplying by a percentage of the
total resolution, which is 262,143 (eg, 25% of 262,143 = 64,000).
• Adjust the ratio scaling factor by entering a value in the Scaling % column,
from 0–200%.
• Delete a ratio calculation by clicking the selection button next to the row to
delete, and clicking the Delete button.
Do one of the following to add cytometer settings at the specimen or tube level:
• Select the tube or specimen in the Browser, then click the New Cytometer
Settings button on the Browser toolbar.
• Right-click the specimen or tube icon in the Browser and select New
Cytometer Settings.
When you create new settings, initial values are copied from the closest parent
settings. Further adjustments apply to the experiment-level settings only when the
Use global cytometer settings preference is enabled (selected by default).
If you want to create specimens or tubes with varying settings that do not update
with the latest settings changes in the experiment, clear the preference. For more
information, see Using Global Cytometer Settings.
For example, if you disable the option and make changes to tube-specific settings
in the Cytometer window, the global settings in the Inspector do not change.
When stored outside the BD FACSDiva database, settings are not modified by the
Use global cytometer settings feature or by updates to the setup catalog. (See
Using Global Cytometer Settings on page 133 or Using Compensation Setups on
page 150.) Also, you can manually edit compensation and voltage settings while
keeping a copy of your original settings outside the Browser.
NOTE You can export global cytometer settings that contain label-specific
compensation values. However, the exported file will only contain the generic
compensation values for that fluorochrome, not the label-specific compensation
values in the compensation matrix.
1 Right-click the Cytometer Settings icon in the Browser and select Export.
Importing Settings
3 Select the settings file you want to import and click Import.
Spectral overlap
Spillover emission
Compensation is the correction applied to the raw data to remove the effects of
this spillover emission (ie, fluorescence). For example, when you are measuring
Once you have created your experiment, you are ready to create compensation
controls.
NOTE In the Create Compensation Controls dialog, you can add only
parameters that are listed in the Parameters tab. To change to another
fluorophore for any parameter, edit cytometer settings in the Cytometer window
or Inspector before you create compensation controls.
• Clear the checkbox when you are including unstained sample in each of
your stained control tubes or wells. In this case, you will need to gate the
unstained population in each fluorescence histogram before you calculate
compensation.
When you click OK, a new specimen named Compensation Controls is added to
the open experiment in the Browser, with tubes for each specified parameter. A
tube-specific normal worksheet is added for each specificity of a given
fluorophore, along with an unstained control worksheet if the checkbox was
selected (Figure 3-6 on page 141). The experiment’s cytometer settings are copied
to the controls, all compensation values are set to zero, and the Enable
Compensation checkbox is cleared.
Some of the parameters may already contain labels. If a label has already
been created in the Experiment Layout or the Inspector, the software
automatically assigns the label to the corresponding compensation control.
2 To add a generic control or a control with a different label, click Add and
do the following:
b Use the selection button next to the fluorophore name to drag the new
fluorophore to the required position in the list.
c Enter a label.
Generic control
Labeled control
4 To delete a control, click the selection button next to the fluorophore and
click Delete.
The Labels dialog opens. The software displays a list of default labels
and any other labels. Any label from this list can be added to or
removed from compensation controls, whether used in an experiment
or not. Use the Shift or Ctrl keys to select multiple labels at once.
c Select the appropriate label either from the custom BD Defined labels
list or from the labels you defined in the Experiment Layout.
d Click the right arrow (>) to move the label into the appropriate
fluorophore folder. To delete a label from a fluorophore folder, click
the left arrow (<).
e Click OK.
The Labels dialog closes and the newly labeled fluorophore is displayed
in the Create (or Modify) Compensation Controls dialog.
The labels appear in the Browser, the Labels tab of the Inspector, and on
associated worksheets.
Before or after you calculate compensation and create a compensation setup, you
can add a new compensation control, record and gate the newly added control,
and then recalculate compensation to create a new setup.
1 Verify that the parameter(s) you want to add to the compensation controls
are listed on the Parameters tab in the Cytometer window for the
experiment’s cytometer settings.
NOTE In the Modify Compensation Controls dialog, you can add only
parameters that are listed in the Parameters tab. To change to another
fluorophore for any parameter, edit cytometer settings in the Cytometer
window or Inspector before you modify compensation controls.
4 Click the fluorophore that was added, and select the appropriate parameter
from the menu.
8 Enter a compensation setup name, click Link and Save, and click OK.
After you record the appropriate compensation controls, you need to verify the
gates before you calculate compensation. Gates in the software-defined analysis
objects are snap-to gates. Therefore, minimal editing is required.
If the gate does not contain all required events, edit the gate or right-click it
and select Recalculate. Do not delete the P1 gate.
If needed, edit the gate or right-click the gate and select Recalculate.
If you have an unstained control tube (or well), you can skip this step.
After data has been recorded and gates have been adjusted, you are ready to
calculate compensation. Select Experiment > Compensation Setup > Calculate
Compensation. The software calculates the overlap as the median fluorescence
intensity (MFI) of the positive stained control minus the MFI of the negative
stained control for each control in all channels. If there is a gated unstained
population in the unstained control tube and a gated unstained population in the
stained control tube, the population in the stained control tube will be used in the
calculation.
• Link & Save. Links cytometer settings to the experiment and saves the
setup to the compensation setup catalog.
NOTE Include the experiment name or date when saving to keep track of
compensation setups.
2 Click OK.
If Link & Save is selected, all of the cytometer settings associated with the
compensation calculation are saved as a compensation setup. A compensation
setup contains parameter and label information, threshold and PMT voltages for
each parameter, and calculated spectral overlap values in the form of an MFI
table.
View a list of all saved compensation setups by selecting Cytometer > Catalogs
and clicking the Compensation Setup tab. The tab lists all saved BD FACSDiva
compensation setups, as well as compensation setups from BD FACSCanto
clinical software (if applicable). BD FACSDiva compensation setups are always
shown in bold. Compensation setups from BD FACSCanto software that are >24
hours old or did not pass quality control checks are shown in red with a yellow
triangle. See Figure 3-8 on page 147.
Figure 3-8 Compensation Setup catalog with BD FACSDiva and BD FACSCanto setups
BD FACSDiva
setup
BD FACSCanto
setup that has
expired or did
not pass QC
- Click the Spectral Overlap tab to edit calculated overlap values in the
form of a table.
- Click the Cytometer tab to view the laser delay setting, window
extension, and area scaling values in effect at the time the
compensation setup was created. (These settings are not downloaded
when you apply the setup.)
- Click Save to save the edits and then Cancel to exit the dialog.
When the Use global cytometer settings preference is enabled for the experiment,
the setup is applied to unrecorded tubes as the current tube pointer is set. To
change voltages without triggering the error message, you can unlink from the
setup. See Unlinking a Setup from Cytometer Settings on page 150.
2 Click OK.
Saved compensation setup values (spectral overlap, threshold, and PMT voltages)
can be applied to an experiment, specimen, or tube, and spectral overlap values
in a compensation setup can be applied to a recorded tube.
• To apply a setup, right-click the Cytometer Settings icon in the Browser and
select Link Setup.
In either case, the Compensation Setup catalog opens where you select a setup to
link.
• For BD FACSDiva setups, select the setup and click Edit to edit values
associated with the compensation setup.
• For BD FACSCanto software setups, select the setup and click View to view
values associated with the compensation setup.
- Click Overwrite to replace the existing settings with settings from the
setup. Parameters that did not match are removed.
NOTE If the setup or cytometer settings contain label-specific controls, you are
prompted to select which spectral overlap value to use. For more information, see
Applying Label-Specific Compensation Settings to Tubes on page 152.
Once cytometer settings have been linked to a setup, you cannot edit
compensation values manually. The compensation editor of the cytometer
settings is locked, and the Clear button and Paste Spectral Overlap commands
are unavailable.
• Use the Experiment Layout to label all tubes in the experiment at once.
• Use the Labels tab in the Inspector to label one tube at a time.
Labeled Generic
Label-specific Not labeled Label must be selected in the dialog that opens.
After you select a control, spectral overlap values are applied using the value for
the selected label.
NOTE If you click Cancel and close the dialog without selecting a control, the
software does not apply a complete compensation matrix, which results in
uncompensated channels.
155
Worksheets
A worksheet is the main work area of BD FACSDiva software. It is where you
create plots, define gates, show statistics views and population hierarchies, and
enter custom text. You can use multiple worksheets to organize your workflow.
For example, use one worksheet for sample optimization, and use a second
worksheet for analysis. Two types of worksheets can be shown in the Worksheet
window: normal and global.
Normal worksheets have white tabs and contain tube-specific analysis elements,
while global worksheets have green tabs and contain elements that show data
from any tube. You display a tube’s data in a global worksheet by clicking to set
the current tube pointer.
Some worksheet elements have an undo/redo function that allows you to revert
back to a previous version of an edited worksheet, but only if you haven’t already
saved the changes. If you change your mind after undoing the edit, you can also
redo the edit if you haven’t already saved the change.
To display the Worksheet window, click the Worksheet button on the Workspace
toolbar. To toggle between the normal and global worksheet view, click the
Worksheets View button on the Worksheet toolbar.
Worksheet icons
‘
General Icons
Use plot icons to create plots, zoom in and out on plot data, and resize plots.
Plot Create dot (D), contour (C), or histogram (H) plots. For a
normal worksheet, select a tube, click a plot button, and then
D C H
click in the worksheet to create a plot of a default size. For a
global worksheet, click a plot button and click in the
worksheet. For other options, see Creating Plots on
page 177.
Zoom- Reverses the last zoom-in action. Click the button and click
Out once in the plot. Each click with the button undoes the last
zoom-in action. To return to the originally sized plot in one
click, hold down the Ctrl key while clicking in the plot.
Increase Increases the size of plots by two on the worksheet. Click the
Plot Size button and click once in a plot. The length of the x- and y-
axes doubles each time you use the button.
Gate Icons
Use gate icons to define population subsets on plots. The Interval Gate icons are
the only buttons that can be used to gate data on a histogram. For more
Quadrant Divides a plot into four quadrants. Each quadrant has its
Gate own population statistics.
Show Grid Makes a grid display in a worksheet. The grid does not
display in printed worksheets or in PDF files.
The following functions are not supported by the undo and redo functions.
Normal Worksheets
Normal worksheets display analysis elements such as plots, gates, statistics, and
custom text from multiple tubes. The analysis elements are tube-specific. Once a
plot or statistics view is created for a tube, an analysis object is associated with
the tube in the Browser.
• To delete a worksheet, click the worksheet tab and select Worksheet >
Delete Worksheet. A worksheet is automatically deleted if its analysis
objects are deleted.
Switch between multiple worksheets by clicking the tabs at the top of the
worksheets (see the following figure). You can work within only one worksheet,
the active worksheet, at a time. The active worksheet is indicated by an icon next
to the worksheet name.
A maximum of 50 global worksheets can be set up for each experiment, and each
global worksheet can contain up to 10 pages. When the first global worksheet is
added to an experiment, a Global Worksheets folder is created in which all global
worksheets for that experiment are stored. Global worksheets are displayed in
this folder in the order they are created.
All data analysis and worksheet tools can be used on both normal and global
worksheets. To move objects between worksheets, use the copy and paste
functions. Objects cannot be dragged.
NOTE If you copy an analysis object that spans more than 10 pages from a
normal worksheet to a global worksheet, only objects that fit on the first 10
pages will be copied.
Differentiate a normal worksheet from a global worksheet by the color and title
of the worksheet tabs. Normal worksheets are titled SheetN by default, and they
have white tabs. Global worksheets are titled Global SheetN, and have green
tabs.
Analysis objects on global worksheets derive their titles and headers from the
current tube. Sort layouts (if applicable on your cytometer) on global worksheets
use the population hierarchy of the global worksheet, not the tube. Tube-specific
plots cannot be made on a global worksheet, and non–tube-specific plots cannot
be made on a normal worksheet.
The following example shows one way in which global worksheets can be used.
For more examples, see your cytometer manual.
2 Set the current tube pointer to the first tube for which you are acquiring
data.
5 Set the current tube pointer to the next tube and acquire or record data.
Data appears on the global worksheet using the gates created in step 4. If
the new tube uses fewer parameters than the previous tube, data might not
be displayed in all plots. Any plots that use a missing parameter appear
grayed out (the missing parameter is crossed out).
6 Edit the gates to reflect the data from the second tube.
Once edited, the gates remain as edited, even if you return to the first tube
by moving the current tube pointer. Gates are global and attached to the
global worksheet, not to the tube.
To save the analysis with a normal worksheet, copy the analysis object to a
tube.
You can also enable the user preference to automatically save a copy after
recording. See General Preferences on page 90.
• To change the name of the worksheet, select the text in the Name field,
enter the new name, and press Enter.
• To show page numbers, select the Show and Print Page Numbers checkbox.
Pages are numbered in the order in which they are printed and numbers
appear on each printed page.
• To print headers and footers, select the Print Headers and Footers
checkbox.
• For the worksheet title, select from the choices in the menu or type a
custom title. To leave the title blank, select None Selected.
• Under Headers and Footers, select what you want to display on the left and
right sides of the worksheet page from the menus, or type a custom header
or footer. To leave the headers or footers blank, select None Selected.
Click the Preview button to see the selections made. Worksheet grid, title,
and header and footer information can be entered, changed, and previewed
in User Preferences. However, selections made in the Worksheet Inspector
take precedence over selections in User Preferences. See Headers and
Footers on page 95.
• To show the grid on the worksheet, select the Show Worksheet Grid
checkbox. By default, this checkbox is selected. To change the spacing
between bars of the worksheet grid, select a value from the Worksheet Grid
Size menu.
• To make elements in the worksheet that are added, moved, or resized snap
to the worksheet grid, select the Snap-To Worksheet Grid checkbox. By
default, this checkbox is not selected.
• Another way to select the worksheet grid or the snap-to grid is by using the
Worksheet menu in the menu bar at the top of the workspace.
Editing Worksheets
Worksheets can display plots, gates, population hierarchies, and statistics views.
Additionally, worksheets can be customized with lines, arrows, and text.
Worksheet elements have an undo/redo function that allows you to revert back to
a previous version of an edited worksheet if you haven’t already saved the
changes. If you change your mind and haven’t already saved your changes, you
can redo the edit.
Use lines to separate header information from the rest of your worksheet, or to
delineate areas of your worksheet. Use arrows to point to an area of interest.
To add a line or arrow, select the Line button or Arrow button and click in the
worksheet. Use the Inspector to change the properties of the line or arrow.
The appropriate Inspector is displayed when the line or arrow is selected in the
worksheet. A selected object is highlighted in yellow (Figure 4-1).
Figure 4-1 Rule Inspector for selected line (left) and Arrow Inspector for selected arrow (right)
• Specify the line style, direction, and color by making appropriate selections
in the Rule Inspector. Resize a line on the worksheet by dragging one of the
black handles on either end of the selected line. Move the line by selecting
the line and dragging.
• Change the size of the arrowhead and the color of the arrow in the Arrow
Inspector. Change the length or angle of the arrow by dragging one of the
black handles on either end of the selected arrow. Move the arrow by
selecting the arrow and dragging.
To insert a text box on a worksheet, click the Text button and click in the
worksheet. Use the Inspector to change the text properties.
• Edit the text in a text box by selecting the current text, then entering new
text. Click anywhere outside the text box to complete the entry.
• Change the text properties by making selections in the Text Inspector (text
does not need to be selected). Changes apply to all text within the selected
text box.
• For a text box with an opaque background, select the Opaque Background
checkbox. For a transparent text box (with grid lines showing), leave this
checkbox cleared.
• Move a text box by selecting it and dragging the border to a new location.
• Resize a text box by selecting it and dragging one of the selection handles in
or out.
Worksheet elements such as plots, population hierarchies, and statistics views can
be duplicated within a worksheet or copied to any Microsoft Office application
by the following methods.
NOTE You must scroll through the entire worksheet to view all of the elements
before copying and pasting.
• Hold down the Ctrl key and drag one or more worksheet elements within a
worksheet to an open Microsoft Office document. The elements are
duplicated when the mouse button is released.
• Press Ctrl+C to copy elements and press Ctrl+V to paste them in a new
location, such as on another worksheet or to any Microsoft Office
document.
Plots or other worksheet elements can be exported for use in other applications.
Prior to exporting worksheet elements as images, you can define the file type for
export in User Preferences. These worksheet elements can be saved as PNG, TIFF,
JPEG, and BMP file types. For more information, see Export Image Format on
page 97.
Worksheet elements can also be exported as XML files. In addition, file names
can display a prefix useful for identifying a group of elements as part of a specific
worksheet (for example, 3-color).
3 Specify the Directory Path (folder) where the elements will be stored. By
default, elements are stored in D:\BDExport\Worksheet.
The prefix is displayed at the beginning of each element file name that is
exported.
5 Select the Include XML File checkbox to export the worksheet in XML
format.
The worksheet file includes all the selected elements. The prefix that was
entered is displayed as the XML worksheet name.
On export, if an XML file of the same name already exists, a dialog opens
with the option to overwrite the file, append (add the file using the next
sequential number to name it), or to cancel the export.
Each selected element will be stored as a separate file of the type you
selected. File names are determined by the type of object selected (for
example, DOTPLOT_1.jpeg, HISTOGRAM_1.jpeg, or Worksheet.xml).
• To move a selected object, position the cursor on the border of the object.
When the cursor changes to two double-headed arrows, drag the object to
move it. See Figure 4-2.
• To make objects the same size, hold down the Shift key while selecting two
or more objects on a worksheet. The object selected last becomes the main
selected object, indicated by yellow selection handles (Figure 4-2). Click the
Make Same Size button ( ). All objects are resized to the same size as the
main selected object.
Selection handles
on selected
histogram (main
selected object)
• To align multiple objects, select two or more objects, and click the
appropriate button ( ). Use these buttons to align to the left,
right, top, and bottom edges, respectively. Objects are aligned in relation to
the last selected object.
• To increase the size of a plot, click the Increase Plot Size button ( ) and
then click a plot on the worksheet. The length of the x- and y-axes doubles
each time you click the button. Click the Decrease Plot Size button ( ) to
return the plot to its previous size. Plots cannot be reduced below their
original size.
NOTE You can also use the Zoom In button to magnify an area in a plot.
Printing Worksheets
Designate the information to print in the worksheet headers and footers, either in
the Worksheet Inspector or User Preferences. Then select one of the following
commands from the File menu to set up for printing or to print worksheets.
• Select File > Page Setup to set the size of the printed page (for example, A4
or letter), the orientation (portrait or landscape), and the margin size. Your
options will vary depending on the printer configured with your
workstation.
• Select File > Print Preview to view a thumbnail of all printable pages at 10,
30, 50, or 100%. Click to return to the worksheet.
• Select File > Print to print the active worksheet. You can also click the
printer button on the worksheet toolbar to print the active worksheet.
NOTE Do not place worksheet elements on the dotted line representing a page
break. Objects that straddle a page break are split between two printed sheets.
To append a worksheet PDF file to an existing PDF file, select the file you want to
append to in the Save as PDF dialog and click Save.
A new dialog opens where you can select Append (or Overwrite to replace the
existing PDF file).
NOTE To view the worksheet you are saving as a PDF file, select the View PDF
checkbox, then click Save, and the PDF is displayed.
• To create a plot using a plot button, click the appropriate button on the
Worksheet toolbar, and click once on the worksheet to draw a plot of
default size.
NOTE To create multiple plots, double-click the Plot button. The button
will remain selected until another button is selected, or until you press the
Esc key. You can then repeatedly click in the worksheet and the same plot
type will be created each time.
Define the gated populations. Then use the drill-down function to create a new
plot showing data from one population.
If the gate border is not shown, right-click the plot border, select Show
Gate, and select the appropriate gate.
A new plot appears with the same plot parameters and axis scale settings,
showing data only from the selected population.
Duplicating Plots
• While holding down the Ctrl key, drag the plot to a new location. The plot
is duplicated when you release the mouse button.
• Press Ctrl+C to copy a plot and press Ctrl+V to paste it in a new location,
such as on another worksheet.
• Duplicate a plot on the same worksheet. See Duplicating Plots on page 178.
• Zoom in and out on plot data, or alter plot size. See Plot Icons on page 158
or Resizing Plots on page 180.
• Change between four- and five-log decade displays for a plot. See Changing
Log Display on page 181.
• Show or hide plot grids, outlines, tick marks, and tick labels. See
Formatting Plots on page 184.
• Add, remove, or change plot titles and axis labels. See Editing Plot Titles
and Axis Labels on page 187.
For each type of plot (dot, contour, density, and histogram), specific formatting
and editing features are available. See Using the Plot Inspector on page 183.
To resize a plot, select it and drag one of its selection handles. See Aligning and
Resizing Worksheet Elements on page 173. You can also use the Increase Plot
Size button to double the size of a plot on a worksheet, and the Decrease Plot Size
button to return the plot to its original size.
To increase the plot size, click the Increase Plot Size button ( ) and click a plot
on the worksheet.
The size of the plot doubles, making it easier to view individual events.
To decrease the plot size, click the Decrease Plot Size button ( ) and click the
doubled plot.
The plot returns to its original size. Plots cannot be reduced below their original
size.
To change plot parameters, click the axis label in a plot and select a parameter
from the menu that appears (Figure 4-3). You can also change plot parameters
using the Plot Inspector.
Parameter menu
All parameters specified in the Parameters tab are available. Depending on which
checkboxes are selected in the Parameters tab, parameters will be listed as
parameter-A, parameter-H, or parameter-W.
Log data is displayed in four- or five-log decade plots. To change the display,
select the experiment in the Browser and make the appropriate selection in the
Experiment Inspector. Log display properties apply to all plots in the experiment.
Four-log plots display values from 26–262,143. Five-log plots display values
from 2.6–262,143. Thus, the first log decade ranges from 2.6–26 or 26–262,
depending on the selected scale.
NOTE Select the Grid checkbox in the Plot Inspector to delineate log decades on
plots.
Right-click the border of any plot to access a menu where you can select from the
following.
Show Population Displays the population hierarchy for the associated tube. See
Hierarchy Using the Population Hierarchy on page 223.
Create Statistics Displays statistics for populations in the plot. See Statistics on
View page 231.
Show Gate Shows or hides the gate outline for selected populations in the
plot. See Hiding and Showing Gates on page 219. This option
appears only after a gate has been created.
Bring to Front Allows you to specify which population to display in front of the
other populations (useful when the events of interest are obscured
behind another population).
NOTE Select multiple plots to make Inspector selections apply to all plots at
once. Only options available to all selected plots are enabled.
There are four components to the Plot Inspector, accessed by clicking the tabs at
the top of the Inspector: Plot, Title, Labels, and Dot Plot (or Histogram or
Contour, depending on the type of plot selected).
Use the Plot tab of the Inspector to view or change plot parameters, turn on
biexponential scaling, edit the plot appearance, and specify populations to show.
• Turn on biexponential scaling for the x-axis, y-axis, or both by selecting the
corresponding checkbox(es). For more information, see Using
Biexponential Display on page 201.
• Select the Grid checkbox to show gridlines at each log decade in a log plot,
or to show the zero point for biexponential scaling.
Gridlines are shown only if the Log checkbox in the Parameter tab of the
Cytometer window is selected for the parameter displayed in the plot.
NOTE Use Plot Preferences to change the default background color for all
new plots. See Plot Preferences on page 96.
- Plot outline. Hides the black line around the outside of a plot.
- Tick labels. Hides tick numbers. (To hide axis labels, click the Labels
tab.)
Grid outline
Tick mark
Tick label
Full Half
• Select the checkbox for each population to be displayed in the plot. Clear a
checkbox to hide the population.
• Change the population drawing order by clearing all populations, and then
reselecting them in the reverse order of how you want them displayed.
Populations with a drawing order of 1 are displayed in front of populations
with a higher drawing order.
Use the Title tab of the Plot Inspector to specify and format the plot title. Use the
Labels tab to hide, show, or format axis labels.
Figure 4-5 Inspector tabs for formatting plot titles and labels
• Within the Title tab, select the Title Content checkboxes to add specimen,
tube, or population names to the plot title. Each selected field will appear
in the plot title separated by a hyphen (for example, Specimen Name-
Tube_003).
To create a custom title, select the Custom Title checkbox and enter a title.
• Within the Labels tab, show or hide x- and y-axis labels by selecting or
clearing the appropriate checkbox.
• Within the Title and Labels tabs, format the plot title, axis labels, and tick-
mark labels in the Font formatting boxes.
Use the Acquisition tab of the Plot Inspector to specify the number of events to
display during acquisition, on a per plot basis.
• Select the Cumulative Display option to show all events from the beginning
of acquisition, recording, restarting, or the addition, movement, or deletion
of a gate.
Since cumulative event display only applies to events during acquisition and
recording, when acquisition stops, the plot or histogram shows the number
of events selected in the Acquisition Dashboard.
NOTE If a dot plot is not visible during acquisition, the plot is not
updated. So if a cumulative plot is scrolled into view, the plot displays as
much data as possible, up to the last 250,000 events.
The time parameter can be used to show how events change over time. (Note that
this is a research use only (RUO) function.) In calcium flux experiments, the time
parameter is used to display the rate at which the cells in the sample respond to a
stimulus.
You might want to enable cumulative display for plots when using the auto-
scaling time parameter function. See Setting Acquisition Display Options on
page 188.
Manual zoom in and zoom out features are retained during autoscaling. The
auto-scaling value is placed within the zoom history so that it can be reinstated
by the user.
If manual zooming or auto-scaling have caused gates on the plot to become odd
shapes or disappear, reselect the gates from the Show Gate menu item. See Hiding
and Showing Gates on page 219.
The time parameter is displayed on a fixed scale of 0–262,143, where each tick
represents 10 ms. Thus, an event that appears at position 50,000 on the time
scale is equal to 8 min 20 sec, and an event that appears at 60,000 is equal to
10 minutes. A plot can display up to 43 minutes of time data.
When you append data to a recorded tube, time is added to the existing data set.
Therefore, after appending 5 minutes of data to a 10-minute data set, the time
parameter of the last event would appear at 90,000.
Use the Dot Plot tab of the Inspector to specify how many events to show in the
plot during analysis. Select from the following:
• Select the upper option under Analysis Data Shown and enter any number
of events, from 1% of the total events to the total number of events
acquired. When fewer than the total number of events is shown, the plot
shows the last recorded events (for example, if 1,000 is selected, it will
show the last 1,000 events recorded).
• Select the lower option and select a percentage of the total events from the
menu, or enter a percentage value in the field. The percentage is determined
from the total number of events (eg, displaying 25% of events for a 4,000-
event file will show every fourth event, not the last 1,000 events).
Use the Contour tab of the Plot Inspector to specify the type, scale, and
appearance of the Contour plot.
NOTE During acquisition, data in a contour plot is shown in density mode, but
reverts to contour data when acquisition is paused or data is recorded.
• Select a scale method from the menu. The default method is probability.
Figure 4-6 Contour plot at 20% probability (left), linear density (middle), log density (right)
• Select the Show Outliers checkbox to display data (points) that fall outside
the lowest contour level.
• Select the appropriate option under Fill & Lines to change the look of the
contour plot using contour lines only (in their population colors), fill color
only, or contour lines and fill color. When fill color is used, color shading
lightens as contour levels increase (Figure 4-7).
Select the Density option in the Contour tab of the Plot Inspector to change a
contour plot to a density plot.
• Select the plot resolution: from 128, 256, or 512 bins. Data from adjacent
bins is added to condense higher resolution data (more bins) into the
selected number of bins.
• Select a scale method from the menu. The default method is probability.
For an example showing each scale method, see the following figure.
Figure 4-8 Density plots at 5% probability, linear density, and log density
Formatting Histograms
Use the Histogram tab of the Inspector to format histograms. The y-axis scale
shows either event counts or percentage of events in the histogram. For either
method, set the maximum value or have it automatically calculated by the
software.
A high number of events at either end of the x-axis can skew the maximum
value. When a value is specified, the software disregards the selected
percentage of bins at each end of the x-axis when automatically calculating
the y-axis scale.
• Fill Histogram. Select to fill in the area between histogram peaks. Clearing
the checkbox will show the individual bins. (Individual channel bins are
more apparent on a zoomed-in histogram.) See Histogram Attributes on
page 226 for more information.
• Using any tube as a data overlay, provided it is part of the open experiment
and contains recorded data.
1 Open an experiment.
2 Select and drag one or more tubes from the Browser and release them over
an existing plot in a normal worksheet.
The data appears in a different color and line style. The overlay indicator, a
green O, appears in the top left corner indicating that the plot contains
data from another tube. The newly added overlay is added to all plots
associated with the specified target tubes.
NOTE To delete a gated population from an overlaid tube, you have to select the
population hierarchy for the specific tube and delete it there.
1 Select Edit > User Preferences and click the Plots tab.
Any overlay plots created after that will not display the green O.
• Select the overlay name in the population hierarchy, then modify the name
or color in the Plot Inspector.
• Modify new display options such as dot size (dot plots and contour plots),
line style, and line size (for histogram plots) by selecting the overlay name
in the population hierarchy, then making modifications in the Plot
Inspector.
• Select Remove Overlay, then select the name of the overlay to remove.
Or
You can display a legend on a plot to show the tube with overlaid data. This
function is turned off by default.
1 Right-click in a plot.
2 Select Show Legend, then select the tube that you want to display in the
legend.
The linear range of the biexponential scale is determined by the extent of negative
data for each parameter. During acquisition, data is periodically sampled to
determine the scaling point. Once recording begins, periodic sampling stops if
scales have already been determined, or after the first time the scaling point is
determined during recording. Scales are recalculated after recording is finished,
and any time cytometer settings are changed. If you change a compensation
coefficient, new scales are calculated.
Width, ratios, and time are always shown on a linear scale. Biexponential display
does not apply for these parameters. In addition, original event data is
maintained as the basis for statistical calculation and FCS export regardless of
the data display.
• Hiding and Showing Gates on page 219 for potential gating limitations.
• Batch Analysis on page 242 to batch-analyze data files using the same
biexponential scales.
• To adjust scales manually, select the Manual option. The Below Zero fields
are enabled for all listed fluorescence parameters. Click in any field to
change the below zero value. Manual scaling values are saved with
cytometer settings.
To change values, enter a new value, click the up or down arrows, or drag
the slider control.
Along with manual scaling, use the Biexponential Editor to export and import
scale values, and apply values to other elements in an experiment.
Enter the file name and specify the saving location in the dialog that opens.
By default, files are saved in BDExport\Biexponential.
Navigate to the XML file you want to import in the dialog that appears
and click Import.
Scaling to a Population
The scale to population function allows you to adjust biexponential scaling to fit
a selected population. To use the feature:
2 Select Scale to Population, and select the population you want to scale to.
All of the plot’s scaling adjusts to fit the selected population. The gate label
is marked with two vertical bars (P4, in this example), indicating that it is
the population for which scaling is in effect.
In User Preferences, you can elect to disable biexponential display by clearing the
Allow biexponential acquisition and display checkbox. Disabling scaling allows
more events to be recorded per experiment. However, large data files can be
truncated when you re-enable it.
When you click OK, a message appears reminding you to restart BD FACSDiva
software to make the change effective.
After you restart, plots that were set to biexponential switch to log, and
biexponential functions such as the Biexponential Editor and scale to population
are no longer available.
Worksheet elements have an undo/redo function that allows you to revert back to
a previous version of an edited worksheet if you haven’t already saved the
changes. If you change your mind and haven’t already saved your changes, you
can redo the edit.
• If you change the number of log decades for an experiment after gates have
been defined, gated populations might be affected.
• Because of the way digital data is displayed on a log scale, populations can
be split or events can be hidden next to the plot axis. When you are
drawing a gate, make sure to include all events. When events are on the
axis, extend the gate boundary past the axis to capture all events, or use
biexponential scaling to view all events.
When a gate crosses the axis on a log or linear plot, all events below zero (to
negative infinity) will be part of the population it identifies. When a gate crosses
an axis, the gate color turns orange to indicate that all events below the axis are
included in the gate.
Gray gate
A gate created on a log plot can now be shown on a biexponential plot and vice
versa. Because gate geometry and movement might be different for a gate out of
its home coordinates, this gate is indicated in gray.
Editing a gray gate will change it to black, indicating that it has switched home
coordinate systems.
Note that populations defined by intervals and quadrants retain the color of their
parent unless you have specified otherwise in User Preferences (see Gate
Preferences on page 92). You can also change the color of a population using the
Population Hierarchy Inspector. See Changing the Color of Populations on
page 226.
Use the Polygon Gate button to create a polygon gate on a dot, density, or
contour plot.
1 Click the button and click in the plot to establish the starting point (first
vertex).
2 Move the cursor to create the next vertex and click.
3 Continue moving the cursor and setting vertices.
4 Double-click the last vertex to complete the gate.
Use the Rectangle Gate button to create a rectangle gate on a dot, density, or
contour plot.
1 Click the button.
2 Click and hold in the plot to position the gate.
3 Drag diagonally until the gate outline is the required size.
Use the Interval Gate button to select a range of events in a plot. Interval
gates can be used on dot, density, or contour plots, as well as histograms.
1 Click the button.
2 Click and hold in the plot to position the left edge of the interval.
3 Drag the mouse to position the right edge.
Use the Quadrant Gate button to divide a dot or contour plot into four
separate populations. Each quadrant population can be named and colored
individually. Quadrant populations can be used for subsetting or sorting.
1 Click the button and click in the plot.
2 Drag the intersection of the quadrant markers to position the gate. The
cursor location is indicated by the coordinates at the bottom of the plot
(Figure 4-13 on page 211).
3 (Optional) Drag a pivot point to rotate the top or right segment, or drag
an offset handle to offset a segment from the center point.
For pivoted or offset segments, Shift+click the quadrant boundary to return
the gate to its rectilinear form.
Examples of polygon, rectangle, and interval gates are shown in the following
figure. The histogram shows events from the polygon gate. Notice how the
population color does not change when you draw an interval gate.
Figure 4-12 Polygon (P1), rectangle (P2), and interval (P3) gates
Examples of each type of quadrant gate are shown in the following figure. Each
plot shows events from the polygon gate in the previous example. Notice how
population color does not change when you draw a quadrant gate.
Always inspect populations defined by automatic gates to ensure that all required
events have been included.
Figure 4-14 illustrates the difference between an autopolygon gate and a snap-to
polygon gate. Notice that the snap-to gate outline appears thicker to differentiate
the snap-to function. The snap-to gate changes after data is recorded while the
autopolygon gate remains the same.
• After recording data, if the snap-to gate was created during live acquisition
or on a plot without any data displayed
NOTE After moving a vertex, the snap-to gate does not re-adjust automatically.
To force the gate to re-adjust, right-click the gate boundary or population name
in the population hierarchy (see Using the Population Hierarchy on page 223),
and select Recalculate from the menu.
A snap-to gate is automatically redrawn when the data in the plot changes, such
as when live acquisition is finished or new data is read into the plot. When
updating, the snap-to gate searches for a cluster closest to where it was originally
placed. If no cluster is found, the system beeps and the snap-to gate maintains its
original position.
You can change how far the gate moves to find a new cluster by adjusting the
Auto Movement value in the Inspector. The auto movement range is a percentage
of the plot width, or resolution, from 0–100%. A higher auto movement value
allows the snap-to gate to travel greater distances to locate a cluster. The snap-to
gate retains this setting if another data file is read into the plot or the gate is
applied to a new data file.
3 Adjust the slider control toward the right until the gate encompasses the
population of interest.
Slider control
3 Adjust the slider control toward the right until the gate encompasses the
entire population.
Display the statistics view to see the effects of the gate changes.
The following figure shows how adjusting the size affects the snap-to gate
in the plot.
Figure 4-15 Snap-to gate with automatic sizing (left) and user-adjusted sizing (right)
This function is useful when you expect changes in the population of interest in
relation to another population. You can use tethered gates to help automate rare
• For snap-to polygon gates, only interval gates with the same X parameter,
or two-dimensional gates with the same X and Y parameters, can be
tethered. For snap-to interval gates, only one-dimensional gates with the
same X parameter can be tethered.
• Only one snap-to gate can be tethered to a manual gate. However, one
snap-to gate can be tethered to many manually drawn gates.
• If you move, resize, or reshape the snap-to gate, the tethered gates remain
the same. When you read in the next or previous file, the snap-to gate
reverts to its previous position, size, or shape.
• If you move the tethered gate, the relative position is stored and used when
reading in the next or previous file.
The menu lists all snap-to gates in the current plot and other plots that
share the current plot’s parameters.
When the gate is tethered, its boundary changes and a chain-link icon
appears next to the gate label, as shown in the previous figure. Note that a
tethered gate has a bold outline similar to a snap-to gate.
Editing Gates
Any gate can be moved or resized, but you cannot add a vertex to or delete a
vertex from an existing gate. Statistics are automatically updated after a gate is
edited. Changes to a parent gate will affect all populations derived from that gate
(see Population Hierarchies on page 222).
2 Make changes to the selected gate, then click outside the plot to deselect it.
• To delete a gate, select the gate and select Edit > Delete.
Alternatively, right-click the gate and select Delete from the menu.
Gates derived from a deleted gate are also removed. For snap-to gates,
any gates tethered to a deleted gate are untethered.
NOTE To avoid confusion, keep gate labels close to the populations they
identify. Labels for quadrant gates in rectilinear or offset mode cannot be
moved outside their respective quadrants; however, labels for pivoted
quadrant gates can be moved past their respective segments.
Use the proportional resize feature to resize all types of gates except quadrant
gates. This feature only works on one gate at a time. There are two ways to
proportionally resize a gate:
Select a gate boundary from a plot, hold down the Shift key, and drag the
vertex of the gate boundary. The gate boundary is resized proportionally
according to the direction in which it is dragged.
Select a gate boundary from a plot, hold down both the Ctrl and Shift keys,
and drag the vertex of the gate boundary. The gate boundary is resized
proportionally according to its original shape.
NOTE Proportional resizing does not allow dragging the vertex you’ve
selected outside of the plot area. When the vertex reaches the edge of a plot,
the gate boundary retains that shape and cannot be enlarged beyond the
plot.
• If the gate boundary and label are currently showing, they are hidden.
• If the gate boundary and label are currently hidden, they are shown.
NOTE When you create a gate on a log plot and show it in a biexponential plot
(or vice versa), the gate geometry can change. In addition, when you adjust
biexponential scaling, gates might move in unexpected ways if they were created
on a log plot.
To remind you that a gate was created on a log plot when it is shown in
biexponential, the gate changes color when you drag it.
A gate can be pasted on plots with the same or different parameters. The pasted
gate takes on the parameters of the destination plot and is proportionally resized
based on the destination plot size and coordinate system.
Another way to create a copy of a gate is to use the drag and drop feature. Gates
can be dragged and dropped in the same plot or to a different plot within the
same worksheet. A gate can be pasted on plots with the same or different
parameters. The pasted gate takes on the parameters of the destination plot and
is proportionally resized based on the destination plot size and coordinate
system. Drag and drop can also be used to drag gates into the population
hierarchy. See Applying Gate Coordinates on page 230.
1 Select a gate.
2 Hold down the Ctrl key, then select and drag the gate to the new
destination.
A dialog opens if the same gate color exists in the new destination.
If a tethered gate is dropped onto a new area or plot, the copy is not tethered. All
types of interval gates can be dragged and dropped to histograms.
2 Hold down the Ctrl key and drag the gate under another gate in the same
or a different population hierarchy.
A dialog opens if the same gate color exists in the new destination.
You can only drag and drop one gate at a time. Dragging and dropping has the
following conditions:
• Copying a tethered gate creates a tethered copy only if its source is copied
at the same time.
Population Hierarchies
All gates and their defined populations can be shown in a population hierarchy.
Use the population hierarchy to see all populations defined for a tube and to view
the relationship between gated populations.
whole blood
lymphocytes
T cells NK cells
B cells
CD4+ CD8+
NOTE To avoid errors when subsetting populations, always keep the population
hierarchy in view. The last-selected population remains highlighted in the view,
indicating that it will be the parent population of the next subset defined. Make
sure the appropriate population is highlighted before you create a gate.
• Select a tube or plot and select Populations > Show Population Hierarchy.
• Rename populations. Select any population and enter text to change its
name. The new name will appear on all plots displaying that population.
• Change the color of defined populations. Double-click the color box next
to the population name and select a new color from the menu. See
Changing the Color of Populations on page 226.
• View gate properties for any population. Place your cursor over any
population to see the plot parameters its gate was drawn on, or its
relationship to other gated populations.
Gate properties
• Delete gates. Right-click any population and select Delete, or select the
population and press the Delete key.
Population
Hierarchy
Inspector
Gate Inspector
Gate Inspector
Gate Inspector
Use the Gate Inspector to change the population name and color, change dot size
and line attributes, and show the population label.
You can also change a population name or population color directly in the
population hierarchy.
Select the checkbox under Population Label to show the population label on the
plot.
Population Attributes
You can customize the dot size that is displayed on dot and contour plots. If the
individual cells are low in volume, you can increase the size of the dots within a
gate to obtain a viewable result.
Histogram Attributes
Use the Histogram Attributes field to select a line style and thickness for a
population when you are not using the fill histogram function or adding overlay
information to an overlaid section of the plot:
1 Double-click the color box in a population hierarchy or click the color box
in the Gate Inspector.
2 Select a new color from the palette that appears or click the No Color box
( ) to leave the gated events uncolored.
Alternatively:
1 Create a new plot, then select Show Population and select the appropriate
population (Figure 4-18).
In either case, the new population appears indented below the selected
population in the population hierarchy (Figure 4-18).
T-cell subsets
• Inverted gates use the NOT operator to select events outside a defined gate.
Any event outside the specified gate satisfies the inverted gate.
Inverted gate
• Intersected gates use the AND operator to combine two or more individual
gates. Only events that are in all of the specified gates satisfy an intersected
gate.
Intersected gate
• Joined gates use the OR operator to combine two or more individual gates.
An event that falls in any of the specified gates satisfies the joined gate.
Joined gate
• Rest of gates select all remaining events that do not fall into any of the child
gates of a parent gate. Thus, you can only access the Rest of option when
you select a gate that already has subsets (children).
NOTE The apply gate coordinates function is not available for snap-to gates or
snap-to interval gates. This function can be used for normal worksheets as well as
preferred global worksheets. This function cannot be used for a global worksheet
unless it is the preferred global worksheet of the specimen or tubes of the target
selection.
Statistics
BD FACSDiva software generates statistics from the linear values of acquired
events. Statistics can be displayed for any parameter and calculated for any
defined population. Statistics are displayed on the worksheet, like a plot, and can
be exported to a file.
NOTE During acquisition, statistics are calculated for the number of currently
displayed events and are updated as the display changes. For this reason,
responsiveness can decline as more statistics are calculated on a greater number
of displayed events. After recording, statistics are recalculated on the total
number of recorded events.
• Right-click any plot and select Create Statistics View. The resulting
statistics view lists the number of events, %Parent, and means of the plot
parameters for all populations displayed in the plot.
Select the Acquisition tab, then select the Cumulative Display option to display
the median values in the statistic view from the beginning of acquisition,
recording, restarting, or the addition, movement, or deletion of a gate. Because
adding, moving, or deleting a gate impacts the display through the different gate
structure, the cumulative values in the display are replaced by #### until the
acquisition is completed.
• Right-click a statistics view and select Edit Statistics View from the menu.
Select the Save settings to profile checkbox in the lower left-hand corner of the
Edit Statistics View dialog to save updated or new settings as the default settings.
After you click OK, changes are saved upon login, and are retained from one
session to the next.
There are three components to the dialog, accessed by clicking the tabs labeled
Header, Populations, and Statistics. See Figure 4-19 on page 234.
Use the Header tab to specify information to be included in the header of the
statistics view, and to reorder headers and available keywords.
• Display a header item by selecting its checkbox. Delete an item from the
header by clearing its checkbox.
To ensure that statistics views include a tube identifier, always include the
GUID (globally unique identifier) in the header of statistics views.
Use the Populations tab to select the populations and types of population
statistics to be displayed in each row of the statistics view.
Use the Statistics tab to specify which parameter statistics are to be calculated
and displayed in each column of the statistics view. Note that responsiveness can
decline as you calculate more statistics on a greater number of displayed events.
• Within each row, select checkboxes for each statistic to display for that
parameter, or select the All checkbox to display all statistics for that
parameter.
• Within each column, select the checkbox in a column header to display that
statistic for all parameters.
• In the All column, select the checkbox above the column header to display
all statistics for all parameters.
• At the bottom of the editor, select the Display Range checkbox to provide
cross-matching scaling. In the menu, select the scaling.
When Display Range is selected and the statistics view has two populations
displayed (selected under the Populations tab in the Edit Statistics View
dialog), delta values are displayed. The delta values show the absolute
difference between two statistics (for example, between the P1 mean and P2
mean.)
NOTE Statistics can be displayed for any tube parameter, as well as for the
time parameter. If a label has been specified for a parameter, it appears
before the parameter name.
Calculating Statistics
During acquisition, statistics are calculated on the number of currently displayed
events. Recorded statistics are calculated on the total number of recorded events.
All data originating from the digital electronics is linear, and statistics are always
calculated on linear data. When compensation is turned on, statistics are
calculated on the compensated data.
NOTE Event data can be out of range when the compensation matrix is applied.
In plots, the out-of-range data stacks at the margins of the plot but statistics are
calculated on the out-of-range data.
• Mean. Average linear value for events in the defined population, defined as:
This mean is less sensitive to outliers than the regular mean. The geometric
mean is defined as:
n
log X n
i Where n = number of events in the population, and Xi
Xgeo = 10 i=1
is a value for a particular parameter, where i = 1 to n
NOTE The geometric mean cannot be calculated for events with negative
values. If you include the geometric mean for populations with negative
values, the resulting statistics will be invalid (####).
• Median. Linear value with an equal number of values above and below it.
If the median of the data occurs between two values, those two values are
added and divided by two to get the median.
• Standard deviation (SD). A measure of the spread around the mean for
events within a defined population, defined as:
median = med i x i
Percent CV = SD X 100
1 Select Edit > User Preferences and select a manual export format.
• Use XML for text that can be used on any platform, including the
Internet.
4 Enter a name for the statistics file and specify a storage location in the
dialog that opens (Figure 4-20).
To append statistics to an existing file, locate and select the file, and click
Save. When prompted, click Append. Results will be appended to the
selected file.
5 Click Save.
Batch Analysis
Use the batch analysis function to automatically advance a selected set of tube
data through an analysis on a global worksheet.
NOTE If you plan to export statistics during the batch analysis, select your
preferred auto export format in User Preferences before you begin. See Statistics
Preferences on page 101 for more information.
2 Right-click the selected item(s) in the browser and select Batch Analysis.
• Select Manual to pause the batch after data is loaded for each tube.
Click the Continue button to proceed with analysis of the next tube.
The View Time field is disabled when you select manual analysis.
NOTE If you make changes to the analysis during a pause, the changes
remain in effect for the remainder of the tubes in the batch.
4 For an automatic batch analysis, select the amount of time to pause (0–60
seconds) after each tube’s data is loaded.
Select zero only if you want to process the batch without reviewing the data
between tubes.
5 Specify whether to print worksheets or export statistics before data for the
next tube is loaded.
6 To save the worksheet as a PDF file, select the Save as PDF checkbox.
• When you select Save as PDF, the Add Report and View PDF
checkboxes are selected by default.
• If you keep Add Report selected, the batch analysis report is added at
the top of the worksheet’s PDF file.
7 To save the worksheet as an XML file, select the Save as XML checkbox.
8 For exported statistics, specify the file name and storage location in the
Export Filename field or click Browse to select the location.
To append data to an existing file, select the file in the export file dialog
and click Save. When prompted, click Append. Results will be appended to
the selected file.
When the checkbox is cleared, all tubes will be processed using the same
global worksheet even if different worksheets were assigned.
A progress bar appears in the Status field showing the batch progress as a
percentage (number of tubes completed vs total number of tubes in the
batch). A message informs you when batch analysis is complete.
• An experiment listed in the Browser, the report will include data on all
specimens.
• A specimen listed in the Browser, the report will include data on only that
specimen.
• A tube listed in the Browser, the report will include data on the specimen
associated with that tube.
• One PDF report that contains all worksheet elements from either the
preferred global worksheet or the active global worksheet (if the preferred
worksheet is not specified), for all tubes in that specimen.
• One CSV file that contains statistics for all the tubes of all the specimens
selected. The CSV report file name consists of the specimen name and a
date time stamp of the file creation.
Working Offline
When using BD FACSDiva software for offline analysis (the software is not
connected to a cytometer), most cytometer, acquisition, and sorting controls are
unavailable.
During offline operation, you can set up experiments or analyze recorded data.
Display data for a recorded tube by clicking the current tube pointer in an open
experiment. See Current Tube Pointer on page 123. Analysis objects can be
edited, moved, copied, and fine-tuned using gates and the drill-down function.
Population hierarchies can be derived and statistics can be calculated and
exported based on data previously recorded.
When you set up an experiment offline, you might need to create tube-specific
cytometer settings and disable the Use global cytometer settings preference in the
Experiment Inspector to maintain the settings when you connect to the
cytometer. For example, when setting up an experiment for cytometer
optimization, if your first tube uses a different set of parameters than your second
tube and the global cytometer settings option is selected, experiment-level
cytometer settings will be updated to match the first set of parameters when that
tube is recorded, and these settings will remain in effect when you record the next
tube. By disabling the preference, individual tube-specific settings are maintained.
Data Management
The following topics are covered in this chapter:
247
Working with BD FACSDiva Data
BD FACSDiva software stores and accesses all experiment data from a single
database. As you create experiments in the Browser, the software writes
experiment components to the database.
Recorded event data is saved separately in FCS 3.0 floating-point format. A disk
icon is added to a tube in the Browser when data has been saved for that tube. To
analyze data in another software application or on a different BD FACSDiva
workstation, data must be exported using the FCS export option in the software
(see Exporting FCS Files on page 253).
To ensure that data can be accessed by the software, do not move, rename,
or delete the BDFACS.db file, BDFACS.log file, or BDData folder inside the
BDDatabase folder. Do not change the name of any file or folder within the
BDData folder.
Maintaining Data
Because all data is saved in a database, the database can fill up the hard drive. It
is important to maintain the database by keeping the size below recommended
limits, exporting and archiving data from the Browser on a regular basis, and
deleting experiments, specimens, or tubes that are no longer needed.
• The number of events that can be recorded for a single tube varies inversely
with the number of gates and parameters (scatter parameters, fluorophores,
area, height, width, and ratios). For optimal performance, limit the number
of parameters to only those that are required.
• The software allows the administrator to view and manage disk space
usage for each experiment and each user on the system. See Viewing Disk
Space Usage on page 32.
• Defragment the hard disk on a regular basis (for example, weekly). Use the
defragmentation program in Windows. To run the program, select Start >
Programs > Accessories > System Tools > Disk Defragmenter.
The following table summarizes the options for maintaining the BD FACSDiva
database using the tools provided with the software. Follow the procedures
established in your laboratory for scheduling data backups. General guidelines
are provided in the table and a recommended weekly maintenance procedure is
also provided.
Export FCS Exports FCS 2.0, 3.0, or • After each significant Exporting FCS
filesa 3.1 list-mode data files experiment Files on
page 253
• For analysis in other
software analysis
applications, such as
BD CellQuest Pro
• After each recording,
if selected in User
Preferences, FCS tab
2 Select the BDData folder, the BDFACS.db file, and the BDFACS.log file.
If the sum of all data files is approaching 40–45% of the available disk
space, delete or archive (export and delete) experiments to free up space on
the drive.
NOTE Another way to determine the amount of disk space being used is to
open My Computer and select the disk in Windows Explorer. The total size
and amount of free space are shown.
Deleting Experiments
NOTE When you delete a folder, you delete all experiments within the
folder.
Alternatively, right-click the selected elements and select Delete from the
menu.
Cytometer settings are written to the FCS file but cannot be opened as a separate
file in BD CellQuest or BD CellQuest Pro software or any other software
application. Cytometer settings are not transferable between different
cytometers.
NOTE The FCS 2.0 standard limits the size of the data section to 99,999,999
bytes (roughly 2.5 million events with 7 parameters at 4 bytes per parameter per
event). To export larger files, export as FCS 3.0 or limit the file size by exporting
fewer parameters.
Follow the steps in this section to export FCS files when the automatic export
preference is disabled.
When you export compensated data with negative values (see Using the
Compensation Tab on page 131) as FCS 2.0, the negative values are set to
zero in the exported file. When the file is imported and analyzed in another
software application or in BD FACSDiva software, statistical results can be
different from the original file.
Data can be exported from closed or open experiments. Multiple items can
be selected for exporting at one time. Individual FCS files will be generated
for each tube in a selected specimen or experiment.
Alternatively, right-click the selected item(s) and select Export > FCS files.
3 Specify the FCS file version: FCS 2.0, FCS 3.0, or FCS 3.1.
When multiple files are selected, options apply to all exported files.
• Select Linear or Log for each parameter to be included in the data file.
Click None to exclude a parameter. (Log is available only for FCS 2.0
files.)
FCS 2.0 log data is always exported in four decades. If the data spans
five decades, only the upper four decades are included. You cannot
select log for the time parameter. It is always exported as linear.
5 Click OK.
Drive\folder\subfolder
• Click the Browse button to change the file storage location. Navigate
to a different directory in the dialog that opens.
• Click the Details button to view the relative directory path and file
name for each exported tube. Note that the file names are taken from
the specimen_tube names in the Browser and cannot be changed.
Gated events can be exported as FCS files. Keywords are created for the tubes, as
well as a keyword that gives the full gate name of the selected gate. For exporting
multiple FCS files, a menu of common gates in the selected tube is displayed in
the Export FCS Files dialog.
Common gates are gates with the same name (for example, P1) and type
(rectangle, polygon, etc) that are drawn on the same coordinate system (log,
linear, biexponential) in the selected tubes.
NOTE If a gate is the same name but not the same type (for example, events are
all P1 gates in rectangles except for a P1 in a polygon), the gate that is a different
type is not displayed in the menu of common gates.
The default FCS file includes the specimen name, the tube name, and the gate
name.
1 Select the gated events for export either by clicking on the gate in the plots
or by selecting the gate in the population hierarchy (you can only export
one).
3 Specify the FCS file version and parameters to export in the dialog that
opens.
4 Click OK.
2 Under Gated Events, select from the menu of common gates to export.
When importing any FCS file that was exported using this function, only the
gated area of events is displayed, with the drawn gate no longer shown.
NOTE Since exported gated events are no longer linked to the original file, if the
file is deleted, events outside the gate are no longer accessible.
3 Locate the files you want to import in the dialog that opens.
Details
• Select multiple files by holding down the Ctrl key as you click the file
names.
To order imported files by date in the Browser, click the Details icon in the
dialog and select the files in the date order you want. You can select any
type of file, but only those files saved in a valid FCS 2.0, 3.0, or 3.1 format
will be imported.
4 Click Import.
For each valid FCS file, a tube is created in a specimen in the open
experiment. The specimen name is determined by keywords in the FCS file.
In the following example, the new specimen is appended with _001 since
the experiment already contains a specimen with the same name.
If the FCS file contains the TUBE NAME keyword, the value for that
keyword is used as the tube name. If no TUBE NAME keyword exists, the
FCS file name is used as the tube name.
NOTE Linear data imported from other applications in FCS 2.0 or FCS 3.0 file
format is normalized to the range of BD FACSDiva linear data. The conversion
of 256 or 1,024 resolution data to 262,144 resolutions causes a binning effect in
the plot displays.
18
2
X LIN = X FCS ----------------------
resolution
Where XLIN = linear BD FACSDiva data, XFCS = linear data in the FCS file,
resolution = resolution in the FCS file (256, 1,024, or 262,144)
x FCS #dec 18
-------------------------- 2
X LIN = 10 res -------------
#dec
-
10
Where XLIN = linear BD FACSDiva data, XFCS = log data in the FCS file,
#dec = number of decades in the FCS file (usually four), res = resolution in
the FCS file (256 or 1,024)
This places the data on the same scale as BD FACSDiva four-log data, from 26–
262,144.
Important Considerations
Note the following behavior when exporting or importing FCS files:
• FCS files that begin with a space cannot be imported. Remove any leading
spaces before importing FCS files.
• Any plots, gates, and statistics views associated with a tube are not
included with an FCS file. To include analysis objects, export or import the
experiment rather than the FCS file.
• While importing an FCS file, if the software determines that the file is too
large to fit into memory, the data will be truncated and a warning message
displayed.
When you import FCS 2.0 files, the files cannot subsequently be
uncompensated after importing if the files were exported as compensated
data (the Enable Compensation checkbox is selected). Compensation
values will be set to zero in the Inspector although the data appears
compensated in the plots. Data can be further compensated by increasing
the compensation values.
• When you export FCS 3.0 or FCS 3.1 files, a valid compensation matrix
might not be created if a tube is exported with only a subset of its recorded
parameters (that is, not all parameters selected in the Export Parameters
dialog). In this case, only compensated data is exported.
When you export compensated data with negative values (see Using the
Compensation Tab on page 131) as FCS 2.0, the negative values are set to
zero in the exported file. When the file is imported and analyzed in another
software application or in BD FACSDiva software, statistical results can be
different from the original file.
FCS 2.0 log data is scaled down to four log decades during export, which
can also impact statistical results. After importing an FCS 2.0 file, any
events that were below channel 26 are placed at 26, which can change
statistics.
Exporting Experiments
1 Select one or more experiments in the Browser.
If one of the experiments is open or expanded, use the Ctrl key to select
only experiments.
Make sure you select the Experiments command, not the Experiment
Template command. Data is not included when you export an experiment
as a template.
• Verify that the experiments listed are those you intended to export. If
they are not, click Cancel and repeat steps 1 through 3.
4 Click OK.
The export process begins. If the Delete experiments after export checkbox
was selected, each experiment will be deleted from the Browser
immediately after its successful export.
Importing Experiments
Experiments from the current or previous versions of BD FACSDiva software can
be imported using the import experiments command. When an experiment is
imported, its components are listed in the same order as when the experiment
was originally exported. If an identically named experiment already exists in the
Browser, the imported experiment is appended with _00x, where x is the next
consecutive number for experiments of the same name.
2 Locate the experiment or Zip file to be imported in the dialog that opens
(Figure 5-2).
3 Select the folder containing the required experiment and click Import.
NOTE If you select a folder that contains only data, a warning dialog
opens. Select only folders containing valid BD FACSDiva experiments.
Do not move the Data Manager or run it from a batch file located outside
the BD FACSDiva application directory.
• Restore. Replaces the current database with a backup copy from a specified
drive. See page 268.
Before backing up the database, make sure you have adequate storage space
on the backup medium. Exceeding the capacity of the hard disk can result
in system errors and potential data loss.
NOTE Backing up does not free up space on the hard drive because the original
files are retained. To back up directly to a DVD, use the Data Manager to direct-
format the DVD and then back up to the DVD. Otherwise, back up to the drive
and use DVD Writer to copy the backup onto the DVD.
See Using the Data Manager Utility on page 265. The Data Manager
window appears with the Backup tab displayed.
To change the path, click the Browse button. After mapping a network
drive, files can be backed up directly to the network. See Mapping a
Network Drive on page 268.
3 Click Backup.
4 Use Windows Explorer to verify the presence of the backup files in the
specified location.
Data Manager adds three items to the specified folder during a backup:
4 Enter the path of the network backup folder in the Folder field
(\\servername\foldername).
Alternatively, click the Browse button and navigate to the required folder.
5 Click Finish.
Restoring a Database
Use the Restore tab of Data Manager to replace the existing database with a
backup copy. Note that when you restore data from a backup, Data Manager
automatically stops the Sybase Adaptive Server® Anywhere service. Therefore,
make sure you have privileges to stop and restart system services before you
begin the restore.
See Using the Data Manager Utility on page 265. The Data Manager
window opens with the Backup tab displayed.
To change the path, click the Browse button or enter the path in the
Directory field.
4 Click Restore.
5 Click OK to continue.
NOTE If an error occurs during this phase of the Data Manager Restore
process, Sybase Adaptive Server Anywhere might have to be restarted
manually. See General Software Troubleshooting on page 273 for
instructions.
Troubleshooting
The tips in this section are provided to help you troubleshoot issues that might
arise when using BD FACSDiva software. For cytometer-specific troubleshooting,
see your cytometer manual.
271
Electronics Troubleshooting
Observation Possible Causes Recommended Solutions
“Master DAQ Event rate is too high. Decrease the event rate or verify
Overflow” is in the threshold.
Cytometer window
Too many analysis objects are Delete analysis objects, decrease
on the worksheet or too the Display value, or delete
many events are displayed. parameters from the cytometer
settings Inspector.
Software is not starting FTP service was started by Stop the FTP service for the other
another application. application.
1 Select Start > Settings > Control
Panel.
2 Double-click the Administrative
Tools icon, and then the
Services icon.
3 Select the conflicting FTP
service, then click the Stop
button.
4 Start BD FACSDiva software.
Database is loading. Verify that the Start Services
buttons are available. If the
buttons are disabled, the database
is still loading. A large database
can take 30 minutes or more to
load.
Delete or export experiments to
reduce the database size.
Unable to access the Adaptive Server Anywhere is Verify that the database server has
database not running. been started.
1 Select Start > Settings > Control
Panel and double-click the
Administrative Tools icon.
2 Double-click the Services icon.
3 Select Adaptive Server
Anywhere. If the Start button is
enabled, click the button to
start the database server. If the
buttons are unavailable, the
database could be loading.
Software is not Other applications are Exit all other applications. Do not
responding running in the background. run scheduled tasks such as virus
scans or disk defragmentation in
the background when you are
running BD FACSDiva software.
Error message is in Communication, fluidics, or Shut down the computer and the
Status tab sorting error. cytometer, and then restart them.
If the message reappears, contact
technical support. Make sure you
provide the exact wording of the
status message.
Shortcut keys (Ctrl+X) Keys are not activated. Use the menu selections to activate
or Delete key are not the keys. After the initial
functioning activation, the shortcut keys and
Delete key can be used.
Numeric keypad is Num Lock key was reset. Press the Num Lock key on the
not functioning keyboard and try the keypad
again.
No wireless keyboard or Keyboard or mouse is too far Move the keyboard or mouse
mouse response away from workstation. closer to the workstation.
Plot button is disabled No tube is selected in the Select a tube to enable the button.
Browser (normal worksheets
only).
No cytometer settings Current tube pointer is not Click to set the current tube
are in Cytometer set. pointer.
window
No experiment is open. Open an experiment.
Faulty screen display or Another program is running. Close all other open programs.
slow user interface
response Pointer shadow is enabled. Select Start > Settings > Control
Panel. Double-click the Mouse
icon and click the Pointers tab.
Clear the Enable pointer shadow
checkbox, then click OK.
Error creating Naming conflict with existing 1 Locate the control or worksheet
compensation controls control or worksheet. that is named (ParameterName)
Stained Control, and change the
name.
2 Create the compensation
controls again.
No root gate appears for the Create a P1 gate in the FSC vs SSC
first control. plot for the appropriate control.
BD FACSCanto setup file Setup file is missing or has Exit from BD FACSDiva software,
cannot be imported errors. re-run setup in BD FACSCanto
clinical software, and open
BD FACSDiva software again.
Fewer events than Current tube pointer is set to Set the pointer to the correct tube.
expected are in the gated the wrong tube.
population
On-axis events are left out of Redraw the gate to make sure
the gate. events on the axis are included, or
format the plot with biexponential
display so that all events are
shown.
Laser delay is set incorrectly. Adjust the laser delay settings. See
your cytometer manual for
instructions.
Missing analysis objects Analysis objects are obscured Double-click the tube containing
on worksheet by other objects. the analysis objects of interest.
Select the objects on the worksheet
and move them to another
location.
No events are in plots Current tube pointer is not Set the current tube pointer next
set. to the appropriate tube.
Message during backup: Attempted to back up Do not back up the database into
“Unable to complete database into BD FACSDiva the Program Files\BD FACSDiva
task. Exit value is: x.” directory. Software folder. Back up the
database to a different disk
location.
Software message: “An No valid backup is in the Verify that the directory path is
error occurred while specified directory. entered correctly.
attempting to restore the
database.”
Unable to read or write Incorrect file name or file Verify the source and target file
FCS file when attempting path. names and paths.
import or export
File is in use by another Verify that the file is not in use by
program. another program.
Data limit exceeded (FCS 2.0 FCS 2.0 file format can write up
only). to 99,999,999 bytes of list-mode
data.
Unable to read or write File is read-only or hidden. Verify that the file is not set as a
FCS file when attempting read-only or hidden file.
import or export
(continued) Data type within file is other When creating the FCS file, the
than Integer or Float. data type must be either Integer or
Float.
Unable to append data to Cytometer settings changed When appending data, make sure
an existing FCS file since original data was the cytometer settings match those
collected. of the data already recorded.
One or more tubes were No data in the tubes selected Verify that the tubes selected for
not exported for export. export contain data. Tubes with
no data will be skipped.
Data is truncated in the File is too large to fit in Move the file to a workstation
imported file available memory. with more RAM to maximize
available import space.
Print spooling problems can occur on some Tektronix Phaser printers, causing
excessive amounts of data to be spooled. When this occurs, the print spooler can
corrupt the data. If you experience problems printing through the print spooler,
try one of the following:
• Use a third-party application to print to a PDF file, and then print the PDF
file.
Keyboard Shortcuts
This appendix provides a list of the available keyboard shortcuts.
283
Keyboard Shortcuts
Keyboard shortcuts are provided for the following functions.
Start/stop acquisition Click the To start, the current tube pointer must be
Browser pointer set (green). To stop, acquisition or
recording must be in progress (yellow or
orange pointer).
Start/stop recording Alt+click the To start, the current tube pointer must be
Browser pointer green or yellow. To stop, recording must
be in progress (orange pointer).
The following table has key combinations to show or hide specific windows.
Browser Ctrl+Shift+B
Cytometer Ctrl+Shift+N
Inspector Ctrl+Shift+P
Worksheet Ctrl+Shift+W
Sorting Ctrl+Shift+S
287
contour plot Graphical representation of two-parameter data in which contour
lines show the distribution of events.
Similar to a topographical map, contour lines show event
frequencies as peaks and valleys.
current tube Pointer or plot icon next to tubes in an open experiment in the
pointer Browser. Indicates the tube currently selected for data acquisition,
recording, or data display on a global worksheet.
When the software is connected to the cytometer, the pointer can
also be used to control acquisition.
cytometer settings Collection of values for parameters measured, photomultiplier tube
(PMT) voltages, threshold, compensation, and any ratio
measurements collected.
cytometer setup Setup function in the BD FACSDiva software workspace.
and tracking
Cytometer Setup Beads used to automatically perform basic cytometer setup and
and Tracking beads performance tracking.
data file A collection of measured values from a single tube combined with
text describing the data that has been stored to disk.
density plot Graphical representation of two-parameter data in which colored
dots show density for events with the same signal intensity.
A density plot simulates three-dimensional event display.
derived gate Combination of one or more defined populations using the Boolean
operators AND (intersected gate), OR (joined gate), or NOT
(inverted gate).
dot plot Graphical representation of two-parameter data.
Each axis of the plot displays values of one parameter. A dot
represents an event (particle).
Events to Record The Events to Record list is one method for entering numbers of
list events in the Events to Record fields. This list is in the Experiment
Layout.
Glossary 289
panel template Group of labeled tubes commonly used together in the same
experiment.
Any specimen can be exported as a panel. Along with the specimen
name and collection date, an exported panel contains a group of
tubes and any parameter labels defined for each tube. Exported
specimen panels can also include global worksheets and their
associated analysis objects.
parameter Measurement of a cell property that is ascertained as the cell passes
through the laser beam.
Each parameter is the output of a single photomultiplier tube or
photodiode, measuring fluorescent or scattered light.
population Data subset defined by a gate or interval.
robust co-efficient Robust coefficient of variation is calculated as follows:
of variation (rCV)
%rCV = ((rSD)/median)*100)
robust standard Robust standard deviation is calculated as follows.
deviation (rSD)
The median of the data sample is computed:
median = med i x i
snap-to gate Gate drawn automatically when you select a peak or cluster of
events in a plot.
Unlike static gates, snap-to gates are automatically redrawn when
data in the gate changes.
specimen Browser object representing the type of material to be analyzed, the
tubes used to analyze the material, the collection date, and user-
defined keywords.
n
2
SD = Xi – X n – 1
i=1
Glossary 291
workspace window Component in BD FACSDiva software workspace.
Workspace windows can be hidden or shown, resized, and closed.
The visibility, size, and position are saved when you quit the
software and are restored when you start the software the next
time.
293
applying biexponential display
biexponential display values 204 about 201
gate coordinates 230 disabling 103, 206
setups 151 enabling 103, 184, 201, 206
area parameters 128 exporting/importing values 204
area scaling scaling
about 112 freezing during batch
adjusting 112 analysis 244
viewing settings 76, 115, 148 manual 203
arrows to population 205
adding 160, 169 showing zero point 184
deleting 169 Biexponential Editor 203
formatting 169 blue pointer 124
assistance, technical xiii Boolean
Auto Movement checkbox 213 gates 228
Auto Size checkbox 214 boolean
autointerval gates 159, 211 keywords 86
automatic updates to settings 133 Browser
autopolygon gates 159, 211 about 16, 43
auto-scaling of Time parameter 18, 189 buttons, customizing 100
axis labels elements
changing 184 adding 46
hiding/showing 187 deleting 251
scale 129, 182 renaming 44
reordering experiments 44
B resizing 40
searching 45, 58
backup, database shortcuts 45
about 266 toolbar 46
frequency 249
restoring 268
C
batch analysis 242
BD FACS Workflow Manager 19 calcium flux 188
BD FACSCanto setups See setup calculating
BD FACSDiva software See software compensation using cytometer
BD FACSLink 19 setup 146
BDDatabase files, importance 248 statistics 121, 231, 236, 238
catalog, setup 147
CellQuest Pro, exporting files to 22, 254
Index 295
cytometer D
configuration 109
controls, software 108 dashboard See acquisition dashboard
disconnected 24, 272 data
not responding 272 analysis tools 155
status 110 appending 120, 189, 259, 281
report 115 converting 258
troubleshooting 272 deleting 251
Cytometer menu 108 displaying 121
cytometer settings exporting 252
about 125 FCS 124, 248
adjusting 126 finding 58
applying setups 151 importing 252
automatic updates to 133 linear 129, 254, 258
exporting 137 log 129, 182, 254
global 133, 150 maintaining 248
importing 137 management options 249
Inspector 125 optimizing processing 250
parameters 127 overwriting 120
preferences 91 preserving integrity 248
printing 136 restoring backup 268
tube-specific 78, 132 saving 54, 248
unlinking setups 150 troubleshooting 279
viewing 115, 125 truncated 259, 281
cytometer setup Data Manager
about 139 about 16
calculating compensation 146 backing up data 266
creating relocating 265
compensation controls 138, 139 restoring data 268
label-specific controls 141 starting 265
editing gates 145 troubleshooting 280
global gate changes 145 database
troubleshooting 276 about 248
using labeled controls with 152 backing up 248, 249, 266
viewing setup catalog 147 experiments in 44
cytometer status 108, 110 files, importance 248
report 115, 116 limits 249
maintaining 248, 251
restoring 268
size limits 251
troubleshooting 274
Index 297
E Experiment Layout
about 60
editing creating labels 61
gates 217 editing keywords 63
headers, statistics views 234 experiments
keywords 63 about 49
parameter statistics 236 adding 50
plots 179 deleting 251
population statistics 235 editing keywords 63
Statistics views 233 exporting 58, 261
templates 56 as Zip files 262
text 170 without data 263
worksheets 168 finding 45, 58
Elapsed Time indicator 119 hiding shared 45, 57
electronic importing 51, 58, 263
aborts 122 data into 256
documentation 20 Inspector 53
error messages opening 52
See also troubleshooting renaming 44
An error occurred 280 reordering 44
check cytometer status 110, 275 saving 54, 248
Cytometer Disconnected 272 sharing 57
Cytometer not responding 272 templates 51, 54
Error 12 275 exporting
FTP Service 273 analysis templates 80
Hardware key 275 biexponential scale values 204
Master DAQ overflow 272 cytometer settings 137
No Cytometer 276 data 252
setup errors 276, 278 experiment templates 54
Upgrading firmware 272 experiments 58, 261
events as Zip files 262
changing color 223 without data 263
processed 122 FCS files 22, 97, 253, 259
to display 121 format, XML 102
to record 77, 120 gated events into FCS files 255
to record list 66 image formats 97
to show 190 keywords 83
troubleshooting 279 log data 254
panel templates 70
parameters 253, 256
Index 299
quadrant 159, 210 hiding
rectangle 159, 209 gate borders 219
Rest of 229 page breaks, numbers 166
snap-to 159, 212 Hierarchy Inspector 224
snap-to–interval 159 histograms
stopping 67, 77, 120 about 176
storage 77, 120 creating 158
tethered 215 formatting 195
viewing properties 223 overlay 18
general preferences 90
geometric mean 238, 239 I
global cytometer settings 133, 150
global worksheets image formats, exporting 97
See also worksheets importing
about 156, 163 biexponential scale values 204
assigning 67 cytometer settings 137
creating 163 data 252
customizing 168 experiments 51, 58, 263
default 100 FCS files 22, 258, 259
exporting analysis templates 80 user profiles 34
setting as default 69, 100 Increase Plot Size button 174, 180
using 164 Inspectors
viewing 156, 157 about 42
green pointer 124 Arrow 169
grid cytometer settings 125
display on worksheet 93 Experiment 53
showing 184 Gate 224
GUID, showing 91, 234 Headers and Footers tab 167
Hierarchy 224
Line 169
H
Plot 183
half grid outline 186 Show Worksheet Grid 168
hardware requirements 21 Specimen 69
header, statistics view 234 Statistics 233
headers and footers 93 troubleshooting 276
tab in Inspector 167 Tube 75
worksheet 93, 95 Worksheet 165
height parameters 128 institutions, adding 27
help, online 20 intersected gates 228
interval gates 159, 209
Index 301
moving P
gates 218
plots 173 pages, worksheet 165
snap-to gates 213 panel analysis, applying 73
text 170 panel templates 70, 72
windows 40 parameters
multiple labels, creating 62 about 127
adding 127
calculating statistics 236
N changing on plot 180, 184
naming crossed out 164
keywords 85 deleting 128
populations 225 exporting 253, 256
setups 146 labels 61, 62, 76
specimens 69 measuring 128
tubes 76 ratio 131, 132
worksheets 166 threshold 129
network drives, mapping 268 Time 18, 180, 188, 254
Next Tube button 119 passwords 31
normal worksheets 100, 161 PDF files, saving worksheets as 175
numbering worksheet pages 166 percentage to ignore 195
numeric keywords 85 performance tracking 108
performance, optimizing 250
photomultiplier (PMT) voltages,
O
adjusting 128
offline work 117, 246 plate automation 19
opaque background text box 170 Plot Inspector, Acquisition tab 188
opening experiments 52 plots
Or threshold values 130 about 176
orange aligning 160
gates 208 background color 96, 185
pointer 124 changing parameters 180, 184
organizing worksheets 161 contour 158, 176, 190
outline, plot 185 copying 171, 178
overlay indicator on plots 96 creating 158, 177
overlay plots density 176, 193
creating 197 dot 158, 176, 190
modifying 199 dot size customizing 18
overview 18, 197 duplicating 178
using the legend 200 editing 179
overwriting data 120 exporting 171
Index 303
red Status tab display
renaming freezing during batch analysis 244
browser elements 44 histogram 195
setups 147 log display 129, 182
report manual 203
cytometer status 115, 116 method, plot 190, 193
specimen 245 ratios 131, 132
requirements, system 21 to population 205
resizing searching Browser 45, 58
Browser 40 security key, troubleshooting 275
plots 158, 173, 180 security module, troubleshooting 275
windows 40 selectable keywords 86
worksheets 162, 165 Sentinel System Driver 16
Rest of gates 229 service pack, Microsoft 21
Restart button 120 services, starting/stopping 268, 274
restoring database 268 settings catalogs 108
Robust Coefficient of Variation 240 settings, cytometer See cytometer settings
Robust Standard Deviation 240, 290 setup
rSD 240, 290 See also cytometer setup
Rule Inspector 169 about 147, 150
adding parameters to 144
S applying to settings 151
catalog 147
Save as PDF copying 147
button 157 deleting 148
checkbox 244 naming 146
save settings to profile 18 printing 149
saving renaming 147
analyses 91, 165 troubleshooting 276, 278
data 54, 248 unlinking from settings 150
experiments 54, 248 shared experiments, hiding 45, 57
scale to population 205 sharing experiments 57
scaling shortcuts
area 112 Browser 45
biexponential See biexponential keyboard 46, 126, 284
keys, troubleshooting 275
show or hide worksheet grid 95, 160,
168
Index 305
status threshold
acquisition 122 about 129
clearing 111 count 122
cytometer 108, 110 rate 118
messages 110, 111 throughput 250
report 115, 116 tick labels 185
Stop Acquiring button 119 time
Stop Recording button 119 acquisition 119
stopping stopping 121
acquisition 77, 119, 120 Time parameter
gate 67, 77, 120 auto-scaling 18, 189
events 119 displaying 180
recording 119 exporting 254
services 268, 274 in calcium flux 188
software 36 values 188
time 68, 121 titles, plot 187
storage gate 77, 120 toolbars
assigning 68 Browser 46
string keywords 86 Worksheet 156
subsetting populations 227 Workspace 39
Sybase SQL Anywhere 16 tracking file, user login 31
system requirements 21 transparent background text box 170
troubleshooting
T analysis 279
cytometer 272
technical assistance xiii Data Manager 280
templates database 274
adding with buttons 100 Delete key 275
analysis 79, 80 events 279
editing 56 FCS files 280
experiment 51, 54 FTP Service error 273
preferences 100 function keys 275
specimen panels 70, 72 general software 273
tethered gates 215 Inspector 276
text box, transparent or opaque keyboard 275
background 170 keyboard shortcuts 275
text, adding 160, 170 mouse 275
printing 282
screen display 276
security key 275
Index 307
Inspector 42 Workspace toolbar 39
moving 40 workstation requirements 21
resizing 40
restoring defaults 41 X
showing/hiding 39, 285
Worksheet 156 XML export format 102
working offline 117, 246 XML files, exporting elements 171
worksheet
grid 95 Y
headers and footers 93
menu y-axis scaling 195
Show Grid 168 yellow pointer 124
Snap to Grid 168
preferences 93 Z
Worksheet toolbar 156
Zip files, exporting experiments as 262
worksheets
Zoom buttons 158
about 156
adding pages to 165
aligning objects on 160, 173
annotating 160, 170
creating 162
deleting 162
duplicating objects 171
editing 168
exporting elements
as XML 171
global See global worksheets
Inspector 165
naming 166
organizing 161
preferences 90, 93
printing 174
resizing 162
saving as PDF files 175
tube-specific 90, 119, 161
undo/redo function 156, 168
viewing 156, 157
workspace
components 38
view options 40