Portal Flow UI Overview
  • 03 Sep 2024
  • PDF

Portal Flow UI Overview

  • PDF

Article summary

Image: alert icon.
When using the Portal website to interact with the Flow2 or DevKit headset, it is strongly recommended that you use a Chrome internet browser. Other browsers are not guaranteed to work.

Once you have properly started up the Flow2 or DevKit system from the Flow tab on Portal, you have access to Portal's Flow UI. 

The window has three sections:



Laser Control buttons

At the top of the window, there are a set of buttons:

  • Turn Lasers ON/OFF: Manually turns on (enable) or turns off (disable) all lasers. 
    • There is no indication on the headset itself whether the lasers are on or off.
    • The color and text at the top of the Laser Control buttons bar indicates whether the lasers are OFF (green) or ON (yellow). 
  • Continue: Performs laser power adjustments (also known as "tuning lasers"). Lasers remain on after the Tune Lasers operation is complete. Tune Lasers must be performed each time the headset is placed on a participant's head. See Tuning the lasers for either Flow2 or DevKit.

Image: Alert IconDo not enable the lasers (or perform the Initialize or Continue commands, which both turn on the lasers) when the headset is not secured on a participant’s head or on the provided Headset Stand.

Kernel Flow2 and DevKit utilize class 1 lasers. Please review the  Laser Safety Warnings.


Module Status View

NOTE:
If you have assembled a DevKit cap that differs from the reference cap design, the provided layout may not reflect your module configuration. In this case, you may measure and submit your own module location information. We can then update the Flow UI on the backend accordingly. Please contact Kernel support if this applies to you.



The main area of the window shows an outline representing a human head with each of the fNIRS modules (circles with numbers), and each of the EEG electrodes (squares) in the headset. 

This view shows a map of the attached Kernel headset. When lasers are ON, the quality of signal received by each detector (and in aggregate by each module) is represented by the color as defined by the legend on the right. Darker blue indicates a better signal, while lighter blue/white indicates a worse signal. The aggregate quality of signal from groups of modules is displayed with numbers on the right. See Getting the Best Signal under the Flow2 or DevKit pages for more information.

NOTE:
When the lasers are OFF, the module map contains green modules only. When the lasers are ON, the map has modules in shades of white to dark blue. If lasers are ON while the headset is on the Headset Stand, expect all modules to be dark blue.

Placement Guide

On the left side of the window, a placement guide is displayed. Kernel recommends positioning the bottom rim of the frontal plate to rest level on the eyebrows. The white placement arrow should align precisely with the center point between the eyebrows. Adhering to these guidelines is crucial when using Kernel-developed Unity tasks with default analyses in Portal, as the expected neural activations correspond to specific locations of the headset.


Data Acquisition controls

After you press Continue to tune the lasers, a new screen is presented with a series of buttons and fields used when recording a session.

 

  • Participant ID:  Click this drop-down to select a Participant ID from the ones available in the Study in which you are recording. This field must be filled in to record. 
  • Task: Optionally click this pop-up to select a Task name from the ones available in the Study in which you are recording. 
  • Number: Optionally enter a number for the dataset. 
  • Name: Optionally enter a name for the dataset. 
  • Description: Optionally enter a description or notes about the dataset. 
  • Duration: Optionally enter a value in this field to limit the duration of the recording. Enter a number in seconds (eg: 600 = 10 min). You can still end a recording by clicking the Stop Recording button. 
  • Start Recording/Stop Recording: Clicking this button begins or ends the recording of a session. This button is only active if a Participant ID is filled out. While recording is ongoing, the button changes to Stop Recording.
  • Launch Tasks: Use this button to launch Kernel's pre-built menu of Unity Tasks.
  • Warnings: Warnings alert the operator of issues that may affect data quality, such as failing to tune lasers, module failures, etc.