Quick Guide
NeoFlow Quick Guide
A concise guide to the everyday workflow: importing FCS files, gating, fluorescence compensation, creating publication-ready layouts, and exporting the finished figure.
1. Quick start
- Import FCS filesClick “📥 Import FCS,” or drop FCS files onto the window.
- Open a graphDouble-click a sample row in the left panel.
- Set up the viewChoose the graph type, X axis, Y axis, and scales.
- Create a gateSelect a rectangle, polygon, ellipse, or another gate tool and draw on the plot.
- Send it to LayoutClick the “⤴” button in the Graph window.
- Save and exportPress ⌘S, then use “Export” to create a PDF or another output.
Keyboard labels and most screenshots in this quick guide follow the macOS version. Some controls and wording differ in the Windows version.
2. FCS files and workspaces
Import FCS files
- Click “📥 Import FCS” or press ⇧⌘I. You can select multiple FCS files.
- You can also drag FCS files directly onto the Workspace window.
- If you drop a folder containing FCS files, NeoFlow searches its subfolders and imports the files into a group named after the folder.
- Open FlowJo
.wsp/.jofiles with “📂 Open.” NeoFlow converts groups, gates, compensation matrices, display scales, and layouts where available.
Use groups
- All Samples always contains every imported sample.
- Click “+” to create a group. Drag a sample row onto a group tab to add it.
- “Remove from Group” removes samples only from the active regular group.
- “Delete Selected” in All Samples removes the samples and their gates from the workspace.
Save the workspace
Press ⌘S or click “💾 Save” to save a .neo workspace. The file stores gates, groups, compensation matrices, axis settings, and all layouts.
3. Graphs and gates
Open a graph and change its display
- Double-click a sample row to open a graph for the ungated population (all events).
- Choose a graph type in the upper toolbar: Pseudocolor, Dot plot, Contour, Density, or Histogram.
- Choose the X- and Y-axis channels, then adjust Linear, Log, or Biex scales if needed.
- Double-click an existing gate to drill down into that population.
Create a gate
| Graph | Main gate tools |
|---|---|
| 2D plot | Rectangle, Polygon, Ellipse, Quadrant, Freehand |
| Histogram | Range, Bisector |
- Select a gate tool in the lower row of the Graph window toolbar.
- Drag or click on the plot to draw the gate.
- For Rectangle, Polygon, Ellipse, Freehand, and Range gates, enter a name and confirm.
- Return to the Select tool (↖) to move or reshape the gate using its body or handles.
Rename, recolor, or delete a gate
- Right-click a gate row and choose “Rename” or “Change Color.”
- Select a gate and press Delete to remove it. After confirmation, its child gates are removed as well.
- Use ⌘Z to undo and ⇧⌘Z to redo.
Apply gates to other samples
- Drag a gate row onto a row under another sample to copy the gate and its descendants.
- Drag a gate row onto a regular group tab to apply it to every sample in that group.
- Shared gates stay linked, so edits to shape, name, or color propagate to their linked copies.
4. Compensation
- Click “🎛️ Compensation” in the Workspace toolbar.
- Choose the target “File” and the “Population” used for inspection. The default is ungated (all events).
- Click the off-diagonal cell you want to adjust.
- Adjust its H or V coefficient in one of three ways:
- Drag horizontally or vertically inside the scatter plot.
- Move the H or V slider in the footer.
- Enter a percentage directly in the numeric field.
- Review the result, then save it as a preset or export it as JSON if needed.
| Action | What it does |
|---|---|
| ↑ / ↓ | Adjust the active numeric field by 1.00% |
| ⇧↑ / ⇧↓ | Adjust it by 0.10% |
| Restore FCS Defaults | Restore the matrix recorded in the current FCS file |
| Reset All to 0 | Reset every file to 100% on the diagonal and 0% elsewhere |
| 💾 Save | Export JSON and also save the matrix as an instrument preset |
| 📌 Save Preset | Save a preset for automatic use with future FCS files from the same instrument |
“Auto Compensation” is on when NeoFlow starts. A saved preset is applied automatically only when the instrument information and the number and order of channels match.
5. Creating a layout
Place plots
- Click the “⤴” button in a Graph window to add the plot automatically to the current layout.
- Drag the “⤴” button onto the page to place the plot at a specific position.
- You can also drag sample or gate rows from the Workspace directly onto the Layout page.
Select, move, and resize
| Action | Result |
|---|---|
| Click | Select one item |
| Shift + click | Add to the selection |
| ⌘ + click | Toggle the clicked item in the selection |
| Drag over empty space | Select everything inside the marquee |
| Drag an item | Move the entire selection; hold Shift to constrain movement horizontally or vertically |
| Drag a corner handle | Resize while preserving the aspect ratio |
| Drag an edge handle | Change width or height freely |
| Shift + drag a handle | Adjust frame padding instead of the plot itself |
Refine the appearance
- Double-click a plot, or right-click it and choose “Plot Settings,” to change its population, axes, graph type, statistics, and other options.
- If multiple plots are selected, opening Plot Settings applies changes to all selected plots.
- Use “Copy Formatting” and “Paste Formatting” in the context menu to transfer display styles without changing the data source.
- Drop one Histogram onto another, or combine Pseudocolor / Dot plot tiles, to create an overlay.
- Double-click empty page space to add text. Double-click existing text or an axis title to edit it.
Create a batch report
Choose a target group, arrangement direction, and the number of columns or rows, then click “Batch.” The selected plots become templates, and NeoFlow creates a new layout for every sample in the group.
Place images, PDF, PPTX, and other files
Drop files onto the page or choose File → “Place Files in Layout...” (⇧⌘O). NeoFlow supports PDF, PDF-compatible Illustrator files, SVG, PPTX, and common raster-image formats. Copy and paste from other applications is also supported.
6. Saving, exporting, and printing
Save your editable work
Press ⌘S to save the workspace. ⇧⌘S opens “Save As.” Save the editable .neo workspace before exporting the final figure.
Export the finished output
- Click “Export” in the first row of the Layout toolbar.
- Select the layouts to export.
- Choose a format: PDF, PPTX, PNG, or Illustrator (.ai).
- Set the resolution or PPTX options if needed, then choose the destination.
| Format | Best for | Default |
|---|---|---|
| Publication and sharing; text, frames, ticks, and gates remain vector | 300 dpi for plot images | |
| PPTX | Further editing in PowerPoint and presentations | Tick and gate conversion enabled |
| PNG | Image sharing and placement in slides | 144 dpi |
| Illustrator | Editing in Illustrator; the .ai file is PDF-compatible | 300 dpi for plot images |
Press ⌘P or click “🖨 Print” to print all layouts. Use “🖨 Print Layout” to print only the active layout.
7. Common keyboard shortcuts
| Keys | Action |
|---|---|
| ⌘S / ⇧⌘S | Save / Save As |
| ⇧⌘I | Import FCS files |
| ⇧⌘O | Place external files in a layout |
| ⌘Z / ⇧⌘Z | Undo / Redo |
| ⌘C / ⌘X / ⌘V | Copy / Cut / Paste |
| ⌘D | Duplicate selected layout items |
| ⌘G / ⌘U | Group / Ungroup |
| ← ↑ ↓ → | Move selected items by 1 px; add Shift for 10 px |
| Delete | Delete the selected gate or layout items |
| Space + drag | Pan the Layout view |
| ⌘P | Print all layouts |
8. Troubleshooting
NeoFlow cannot find the FCS files when opening a workspace
An FCS file cannot be imported
.fcs extension. NeoFlow displays an alert for a file it cannot parse, then continues importing the remaining files in a multi-file operation.