x.sight software manual · windows 7 (x64) windows 10 (x64) automation interface api and dll...
Post on 05-Dec-2020
27 Views
Preview:
TRANSCRIPT
x.sight
software manual
cytena GmbH
Supporting
software versions
1.0.7 or higher
x.sight - software manual
2 | P a g e
8th edition English 08/2019 Documentation © 2018-2019 cytena GmbH, Freiburg, Germany All rights reserved. Without the written consent of the publisher this manual or any part of it may not be in any form reproduced or distributed using electronic, mechanical or chemical processes. It is possible that the present manual still contains typographical or printing errors. The information in this manual however, is regularly reviewed and corrections are made in the next output version. For technical or typographical errors, we provide no liability for the nature and consequences thereof. All trademarks and copyrights are acknowledged. Printed in Germany. Changes in terms of technical progress are subject to change without notice.
x.sight - software manual
3 | P a g e
Content
1 About this manual .......................................................................................................... 5
2 Technical information ..................................................................................................... 6
2.1 General information: ........................................................................................................ 6
2.2 Embedded PC information: .............................................................................................. 6
2.3 Data properties:................................................................................................................ 6
2.4 Third party hardware ........................................................................................................ 7
2.5 Drivers and additional software ....................................................................................... 7
3 Software overview ......................................................................................................... 8
3.1 General handling .............................................................................................................. 8
3.2 Start screen (LOAD) .......................................................................................................... 8
3.3 Settings (SETTINGS) .......................................................................................................... 9
3.4 Droplet quality control (DROPLET-QC) ........................................................................... 13
3.5 Main screen (DISPENSE) ................................................................................................. 15
3.6 Cell Camera & Region of Interest (ROI) .......................................................................... 18
3.7 Results ............................................................................................................................ 21
3.8 Live log window .............................................................................................................. 22
4 f.sight special ............................................................................................................... 24
4.1 Cell camera modes ......................................................................................................... 24
4.2 Camera alignment mode ................................................................................................ 25
4.3 Collect sample modes..................................................................................................... 27
5 Software use ................................................................................................................ 28
5.1 Starting sequence ........................................................................................................... 28
5.2 Chose a well plate or load a program ............................................................................. 28
5.3 Set up your experiment .................................................................................................. 28
5.4 Configuring your well plate ............................................................................................ 28
5.5 Loading cartridge and well plate .................................................................................... 31
5.6 Set Region of Interest (ROI) ............................................................................................ 32
5.7 Performing Droplet-QC ................................................................................................... 32
5.8 Performing the experiment ............................................................................................ 34
5.9 Data ................................................................................................................................ 34
6 Configuration & OS ....................................................................................................... 35
6.1 Use of antivirus and security software ........................................................................... 35
x.sight - software manual
4 | P a g e
6.2 Domain & domain users................................................................................................. 35
6.3 Connection to local network .......................................................................................... 35
6.4 Connection of additional drives ..................................................................................... 35
x.sight - software manual
5 | P a g e
1 About this manual
Before putting the x.sight device into operation, please read the instructions given within
this manual carefully and keep this document safe.
This manual contains information about the software and its usability. The manual is
containing hints and examples helping to guide the user and show him/her where to pay
special attention. These are color coded like shown below:
Example: this is an example text.
Hint: this is a note text.
Disclaimer of warranty
The x.sight device is designed for research and may not be used for diagnostic
applications.
This is the software manual of the x.sight. Please note that no warranty of any kind will be
given. The cytena GmbH assumes no liability for improper handling.
The x.sight device must only be operated by trained personnel. The cytena GmbH
assumes no liability for damages incurred due to improper handling of the device and the
device components (cartridge, etc.).
x.sight - software manual
6 | P a g e
2 Technical information
2.1 General information:
Platform Microsoft Windows
Framework .NET 4.6.x or higher
DLLs 64-bit
Supported OS Windows 7 (x64)
Windows 10 (x64)
Automation interface API and DLL available
Installation msi self-installer
Space requirements for installation 400 MB hard drive capacity on C:\
Updates Download (as installer)
Internet connection Not required
2.2 Embedded PC information:
OS Win7 (x64) Professional (until 2019)
Win10 (x64) Professional (from 2020)
CPU Intel Core i7 6700 @ 3.4 GHz
RAM 8 GB DDR-4
Hard drive 240 GB SSD, SATA M2
Partition C:\ (OS) 100 GB
Partition D:\ (data) 130 GB
External interfaces
1x DVI
1x Displayport (DP++)
2x GigE LAN
4x USB-3.0
2.3 Data properties:
Program log data format XML
Image data format JPEG
Image resolution 1.3 Mpixels (1280x1024)
Image color format 8-bit greyscale
32-bit RGB (f.sight)
Images per single-cell 5
15 (f.sight)
Data volume per single-cell 1.2 MB
5.0 MB (f.sight)
Data volume per 96-well plate 115 MB
480 MB (f.sight)
x.sight - software manual
7 | P a g e
Data volume per 384-well plate 460 MB
1.9 GB (f.sight)
2.4 Third party hardware
The x.sight will be delivered including keyboard, computer mouse and monitor. Customers
may exchange this hardware by internal peripheral standards. The following conditions
shall be met:
Min. monitor resolution 1920x1080 (HD)
Compatible monitor interfaces
DVI
HDMI
Displayport (DP++)
Compatible keyboard interface USB-2
Compatible mouse interface USB-2
2.5 Drivers and additional software
MS .NET framework 4.6 or higher
IDS USB driver 4.90 or higher
TMCL motor driver 1.1 or higher
WHQL MSP32 driver 2.24 or higher
AIMB Chipset driver
USB Chipset driver
BIOS version
x.sight - software manual
8 | P a g e
3 Software overview
The x.sight will come up with a single application desktop software preinstalled and ready
to be used on the embedded PC. This chapter will introduce the User Interface (UI) and
the handling of software together with hardware required user actions as well as explain
the full software functionality in detail.
Hint: Some of the software functions and buttons described in this manual may
not be available on your device. This depends on the configuration and device
type you have. For any question, please contact technical support.
3.1 General handling
The software contains four main tabs: LOAD, SETTINGS, DROPLET-QC and DISPENSE.
In order to complete the setup process and print a plate, you have to work through these
four tabs from left to right.
The active tab is highlighted in blue, like in the above example the LOAD tab. The non-
active tabs are grey. The following sections explain the single tabs and the options and
buttons on their respective UI pages.
3.2 Start screen (LOAD)
Start the software by using the link on the desktop. After the boot sequence is completed,
the LOAD / start screen appears.
x.sight - software manual
9 | P a g e
The start screen shows (by default) two large tiles, one for 96-well plates and one for 384-
well plates. A click on these tiles opens the main screen with an empty plate in the
respective format.
The small [+] tiles next to the large tiles allows for adding existing preconfigured programs
as tiles to the start screen. A click on [+] opens a dialog. Chose an existing program and
add it as tile to the start screen. Once added, it will appear permanently on the start screen
when the software is loaded. An existing tile can be deleted using the [x] button inside it.
Once deleted it is permanently deleted and has to be re-added if required.
The [Load Program] button in the top right corner can be used to directly load an existing
program. This will not add a tile to the start screen but load the program directly into the
main window.
3.3 Settings (SETTINGS)
Enter the [SETTINGS] tab of the software to get access to the main options and
parameters. You can set default parameters as well as activate or deactivate functions.
The first section called [Agitation] deals with the settings for the automatic mixing unit
(called agitation) that ensures homogeneous distribution of cells throughout time in the
cartridge reservoir.
The toggle switch [Status] enables and disables the agitation. A white switch represents
“off” and a colored switch represents “on” state. The field [Repetitions per Minute] defines
x.sight - software manual
10 | P a g e
the number of mixing cycles per minute performed by the system. The field [Volume]
defines the aspirated and dispensed volume per cycle in microliters.
Example: Typical values would be Repetitions = 15, Volume = 10 µl
Hint: Make sure you have set reasonable settings, so that the agitation is truly
mixing the cells inside the reservoir. Too low parameters
The section [Data Output] defines the output directory for the experiment data being creating in every experiment run. Click on the [Select] button to open the dialog. Select any path and folder from your system or network.
The selected path is then shown below. It is set permanently until being changed, also
when software is restarted. In this selected folder, each experiment is separately saved in
its own subfolder.
Hint: Chose a reasonable storage path. Drive D:\ is recommended. Make sure
that the location has sufficient free space for saving data.
The section [Dispensing] represents the possibility to enable an automatic idle dispensing
mode (called idle shooting). To enable it, turn on the [Idle Shooting] switch. A white switch
represents “off” and a colored switch represents “on” state. The [Idle Shots per Minute]
function let you control how fast the idle dispensing is performed.
When activated, [Idle Shooting] mode generates the set number of droplets per minute.
All droplets are being sucked away by the vacuum shutter system. This ensures that no
target is contaminated, but the cartridge is kept usable as long as no experiment is
performed. The mode will be deactivated automatically when DQC is performed or a
printing experiment is started. It will automatically reactivate after DQC or the experiment
has been completed.
Hint: Idle Shooting is recommended to use when there are longer (> 5 min)
holding times between experiments and you want to continue using the cartridge.
x.sight - software manual
11 | P a g e
Some cell media tend to evaporate quickly on the open nozzle. This leads to
crystallization of the nozzle. The nozzle then is clogged after some minutes. The
continuous, slow generation of droplets prevents this.
The section [Tracking Algorithm] contains the two main properties for the cell detection
algorithm.
The [Detection Radius] defines the ROI radius in micrometers. Default value is 125. It can
be adapted for specific needs (e.g. very low or high viscous media).
The [Detection Threshold] defines the threshold between foreground (= cells or particles)
and background (= chip) of the image. The threshold required to distinguish foreground
objects from the background in image processing. The lower the contrast of objects
against the background, the lower the threshold has to be set. Default value is 25. The
value is automatically taken over and is set permanently until changed, even when
software is restarted.
Hint: The cell detection is sensitive against this value. Too low values will
generate noise and ghost objects that disturb detection. Too high values will
prevent detection of any object, even those with high contrast. Find a suitable
value for your application. A good range is 20 - 40.
The section [Deionisator] allows you to enable automatic plate deionization prior to
printing. To enable it, turn on the [Perform Deionisation] switch. A white switch represents
“off” and a colored switch represents “on” state.
When being activated, each plate is deionized before the actual printing experiment is
performed. The deionization process takes only seconds.
Hint: When using foil based plates (e.g. PCR plates) deionization is
recommended to activate. Droplets may carry electric charge. When the plate is
ionized as well, droplets may not land in the wells precisely.
When using “Offset Compensation” mode, deionization must be activated to
ensure straight droplet flight into the plate.
x.sight - software manual
12 | P a g e
The section [Offset Compensation] offers a high precision printing mode. To enable this
mode, turn on the [Use Offset Correction] switch. A white switch represents “off” and a
colored switch represents “on” state.
The [Offset Compensation] measures the droplets flight trajectory in space and corrects
the axis system with an offset to ensure that the droplet is landing centered in the well.
The automatic correction requires the distance the droplets travels until reaching the
bottom of the well. The input field [MTP Well Depth] let you enter this distance in
millimeters.
When being activated, this mode performs the compensation prior to each experiment run.
Compensation can take up to 3 minutes. It is fully automatic.
Hint: The [Offset Compensation] mode is recommended when using targets
that require a high precision in droplet positioning. For example 384-well plates
with conical wells for PCR or sequencing applications.
It can also be useful when targeting special plates or special applications where
the position of the single-cell on the target is crucial.
Using this mode may significantly increase the total process time per plate.
The section [Automation Settings] contains the relevant settings for running the x.sight in
an automation environment using the cytena API.
To connect the software with the client, the opposite server has to be started as well. Next
to [Automation Server] use the [Start] button to connect server and client. [Server Port
Number] refers to the TPC/IP Port used for connection. [Dispensing Event Warning
Threshold] and [Dispensing Event Error Threshold] refer to the warning and error events
being sent to the automation controller. A counter detects the number of dispenses without
a single-cell event. If the respective thresholds are exceeded, the warning or error is
transmitted.
Hint: For further information please refer to the API handbook.
x.sight - software manual
13 | P a g e
3.4 Droplet quality control (DROPLET-QC)
First step in experimental setup is verification of dispensing performance. Meaning each
new cartridge needs to be calibrated to its loaded sample with regard to droplet generation.
A reproducible and robust droplet generation is required prior to experiment. Therefore the
droplet quality control (DQC) is built in.
The respective window in the software is called [DROPLET-QC] and can be opened from
the main menu.
DQC working principle is stroboscopic droplet imaging. Stroboscopic imaging allows for
observing the generated droplets live and in flight. The window shows a separate camera
view.
Under [Droplet Position] you find three sliders that help to center the droplet in the cameras
field of view and bring it in focus.
• [Vertical/Delay] time delay between drop generation and photo acquisition
• [Horizontal] horizontal position of the droplet, controlled by X-axis
• [Focus] focal position of the droplet, controlled by Y-axis
The sliders under [Stroke Settings] define the actuation of the piezo. Here, stroke means
the swing of the piezo that performs the mechanical deformation of the chip membrane.
Physically the piezo extents, driven a plunger that deflects the membrane. The piezo
extension is defined by two parameters:
• [Length] the geometric length the piezo is extended
• [Speed] the velocity with which the extension is taking place
Both [Length] and [Speed] define the properties of the generated droplet. Length is mainly
influencing droplet volume. Speed is mainly influencing the droplet velocity.
x.sight - software manual
14 | P a g e
The check box under [Vacuum Settings] allows for switching on and off the vacuum shutter
that takes off unwanted droplets. To see a droplet in the DQC camera window, the vacuum
has to off, meaning the box has to be unchecked. The vacuum system is equipped with a
pressure sensor. The actual pressure can be seen (as digital value) next to the checkbox.
Hint: The vacuum checkbox allows for checking, if the vacuum shutter system
works reliable. It is switched off by default when entering the DQC mode. This is
mandatory to see the droplet in the camera window.
When checking the vacuum checkbox, the shutter will be switched on and the
droplet should disappear in the camera window. This is the proof, that the shutter
system is working for the given piezo parameters and the used cartridge and
sample.
Show the droplet not disappear, the system is not working. You should not
continue printing in this case!
You can start and stop the DQC any time using the [Start] / [Stop] button. When entering
the DQC mode the system is switched on automatically. When leaving the DQC mode it
is stopped automatically.
Hint: When entering DQC mode, the axis system is centering the cartridge in
front of the DQC camera at a default position with a default photo delay. Ideally
this position enables you to directly see the droplet in the camera window.
In case you don’t see a droplet, use the sliders under [Droplet Position] to search
for the droplet manually.
The button [Capture DQC Images] allows for saving a sequence of images from the DQC
camera.
x.sight - software manual
15 | P a g e
3.5 Main screen (DISPENSE)
The main (or print) screen is the central part of the UI. It contains an interactive, digital well
plate that can be freely configured. On the right side, you can find the cell camera live
window and the parameter plot.
In the [Name] field you can insert any name for your experiment.
In the [Description] field you can enter a full text description as well as any additional
information about your sample, plate type, etc.
In the [Plate ID] field you can enter your plate barcode or plate name. Here you can use
the included barcode scanner to read the barcode from your plate into the field.
The [SAVE AS] button let you save the current configuration at any time. A previously
saved configuration can be reloaded from the start screen. Click on the [LOAD] menu
button to return to the start screen.
Hint: If you want to save your experiment, you need to set a name at least.
Description and plate ID can be left void. Use the [SAVE AS] button to save the
experiment.
Please note that only the actual experiment configuration is saved. When you
perform changes on the configuration, you have to save again to take over the
changes.
x.sight - software manual
16 | P a g e
The interactive well plate [MTP Configuration] allows for
• selection of single wells by left mouse click
• selection of multiple wells by CTRL + left mouse click
• selection of multiple wells by a rubberband (drag, hold, release left mouse)
• selection of all wells by left mouse click into the grey top left corner of the plate
When at least one well is selected, below the plate the configuration for the selected well(s)
appears. This includes:
• [Action] defines the action to be performed in the well(s)
• [No. of …] defines the number of events to be performed
• [Size] defines the range of cell diameter for cells to be sorted
• [Roundness] defines the range of cell roundness for cells to be sorted
• [FL intensity] defines the range of fluorescence intensity
As [Action] you can choose from
• [Print cell] prints a single droplet that contains one cell
• [Print FL cell] prints a single droplet that contains one fluorescent cell1
• [Print NTC] prints a void single droplet (no cell inside)
• [Print every droplet] prints a single droplet independent from its content
Hint: Besides printing single-cells, the software is also capable of delivering
empty droplets as a negative template control (NTC) for applications that use
assays after cell sorting.
Also the software can print droplets independent from their content (void, single-
cell or multiple cells). This function enables quick delivery of a certain sample
volume into specific wells.
The [No. of …] input field allows for defining the repetitions of the chosen [Action] to be
performed in the specific well(s). It changes depending on the action.
Example: the following example illustrate how Action and No. of are related to
each other and how you can generate different configurations.
[Action] = [Print cell] and [No. of cells] = 10
→ prints 10 cells into the well
[Action] = [Print every droplet] and [No. of droplets] = 100
→ prints 100 droplets into the well, no matter what they contain
[Action] = [Print NTC] and [No. of NTC] = 1
→ prints 1 void droplet into the well
1 Available for f.sight only.
x.sight - software manual
17 | P a g e
The fields for [Size] and [Roundness] are only available when [Print Cell] as [Action] is
chosen. The following screens show the different appearance and color coding of actions.
[Dispense cell]
Color code: red
Sliders for size and roundness
visible below plate
Different configurations on
different wells appear as different
shades of color code
[Dispense NTC]
Color code: grey
Sliders invisible
Different configurations on
different wells appear as different
shades of color code
[Dispense every droplet]
Color code: blue
Sliders invisible
Different configurations on
different wells appear as different
shades of color code
x.sight - software manual
18 | P a g e
[Dispense fluorescent cell] *
Color code: green
Sliders: size and roundness plus
FL intensity [a.u.]
Different configurations on
different wells appear as different
shades of color code
* Available in f.sight only!
The [PLAY] button let you start the actual printing process. As soon as this is started, the
button turns into a [STOP] button. The process can be aborted any time by clicking this
button. Once aborted, it cannot be continued. You have to restart the experiment.
During operation, the well will change its appearance according to its state. There are
basically three different states:
not processed The well is colored with respect to the chosen Action
(e.g. green for Print fluorescent cell)
in process When the system operates over a well, this is indicated
by circulating dots (standard waiting pictogram)
completed Once the action in this well is successfully completed,
a tick mark is shown
3.6 Cell Camera & Region of Interest (ROI)
The cell detection camera (Cell Camera) shows the live stream of the dispenser cartridge,
respectively the nozzle area. The camera is located in the top right corner of the software
main window. The c.sight and b.sight camera is standard bright field (left image) while the
f.sight features an additional fluorescence camera (right image).
x.sight - software manual
19 | P a g e
The live video stream displays the ROI (so called “region of interest”) as three circles
around the nozzle. The green circle of the ROI defines the fluid volume that is expelled
from the chip nozzle when a droplet is generated. The two blue circles define three areas
(A-C) like shown the schematic below:
Only when a single-cell is detected inside region A (inner blue circle) and no other object
is inside region B (between the two blue circles), the single-cell is printed to the substrate.
The correct position of the ROI is crucial to achieve good printing results. The following
reference shows you how to set the ROI. The ROI is vertically centered in the nozzle
(vertical yellow dashed line, left figure). Horizontally, the inner blue circle should touch the
nozzle orifice (red arrows + red dashed line, right figure).
x.sight - software manual
20 | P a g e
To perform an automatic detection of the ROI, press the [Autodetect ROI] button below
the video window. Visually confirm the correct detection according to the reference above.
In case the ROI is not centered over the nozzle as shown below, simply click into the video
field to set the ROI manually. Left click into the video window. Your mouse pointer defines
the center of the circles. Aim as follows:
You can also use the zoom function to enlarge the view. To do so, press the [Roi view]
button below the Cell Camera window. The camera will now show the area around the
ROI in higher magnification. Click in the window to do corrections if required. To close
the enlarged view, press [Roi view] again.
Hint: Whenever you mount a new cartridge to the x.sight, you have to reset the
ROI either automatically or manually. The system does not recognize when a
cartridge is changed.
When pressing the [PLAY] button without having set a ROI initially, the system
will show a respective message and perform the [Autodetect ROI] function
automatically before starting the printing process.
x.sight - software manual
21 | P a g e
3.7 Results
The Results field displays measured parameters from objects being detected in the cell
camera. Main parameters are size and roundness of the objects. These are plotted in a
2D graph.
Before starting an experiment, you can start a sample run to characterize your sample.
Press the [Collect Samples] button to start the sample measurement. The system will
generate droplets, measure all objects passing the nozzle and plot the results into the
graph. Press the button again to stop the sample collection. Press [Clear Results] to clear
the data points from the graph. A counter Data Points (right) indicates the number of
collected data points.
Example: Typically, cells (e.g. CHO, HEK, etc.) range from 10 to 25 µm in size
and 0.5 to 0.9 in roundness.
Double cells (= two cells attached to each other) show a larger size and lower
roundness. For example: size = 30 and roundness = 0.3
Debris typically shows lower size and a large range of roundness. For example:
size = 5, roundness = 0.8 or size = 7, roundness = 0.2
Hint: Collecting too many sample points, the graph will become crowded and
confusing. Use the [Clear Results] button to clear the graph before collecting
new sample points.
Use the mouse pointer to select any of the data points. When clicking on a data point, the
software will open a small pop-up window displaying a photo of the respective object.
x.sight - software manual
22 | P a g e
This allows you to learn, which types of object results in which parameter range. In the
example figure, cells (dense point cloud top right corner) can be distinguished from debris
(single isolated points).
3.8 Live log window
Click the [Log] button to open the live log window. It allows you to monitor the measured
properties of all objects passing the nozzle. When printing is started, the log data is plotted
live in this window.
The following parameters are measured for each object:
- Is printed shows if an object was printed into the substrate - Diameter [µm] shows the average diameter of the object - Area [µm²] shows the area of the object - Perimeter [µm] shows the perimeter of the object - Circularity shows roughness / noise of the contour of the object - Aspect ratio shows the aspect ratio (fitting ellipse) - Roundness shows the ratio of circularity and aspect ratio - FL intensity shows the fluorescence intensity (in a.u.)
For better visibility you can color the objects that have been printed into the substrate
(typically single cells) using the [Coloring] drop-down menu in the left bottom corner.
x.sight - software manual
23 | P a g e
Chose No Color to display all log data in standard black color.
Chose Valid for printing to color those events where the object was not accepted by the
algorithm. Non-acceptance is typically caused when the object does not fulfill all detection
criteria (size, roundness, etc.) set by the operator. This option will color the parameter(s)
which did not match to the detection criteria in red.
Chose Current settings to define yourself, which parameters should be colored under
which boundary conditions. You can select certain lines and even specific parameters in
the live log window.
Use the [Clear] button to delete the displayed parameters form the log window.
In the [Maximum number of samples] field you can set how many lines of logged data are
displayed in the window. As soon as this number is exceeded the “oldest” entry is deleted
and replaced by the latest.
The bottom line gives you more information about the current log buffer and the ratio of
printed cells.
The Samples value displays how many samples are actually stored in the buffer and how
much buffer size is in use (…%).
The Samples printed value shows the ratio of printed samples (= single-cells to substrate)
to total number of samples. The larger this ratio, the more objects (cells) are selected for
printing and the faster the printing process is. However, this does not tell anything about
the quality of the selection.
The value from the Samples would print field can be used in sample collection mode. Open
the live log and press the [Collect Sample] button in the main UI window. Although in collect
sample mode no object is printed, this value shows you how many would have been
printed according to your set detection criteria.
x.sight - software manual
24 | P a g e
4 f.sight special
The following section covers functions and features that are only available in f.sight
models.
4.1 Cell camera modes
f.sight models carry two independent cameras, one for bright field and one for fluorescence
detection. Below the Cell Camera section there are several f.sight specific functions to
control the different cameras.
The [Overlay] button allows for displaying the detected cell contours as an overlay on top
of the camera window. All detected objects will then be surrounded by the respectively
detected contour. The following image shows the difference when Overlay is off (left
picture) and on (right picture). The blue circles represent the ROI, the green contour
represents the cell.
Hint: Using the overlay function will increase the required computing time and
thus slow down the process. Especially, when a sample with higher
concentration is loaded. The overlay may be helpful during setup to verify if your
settings are correct. It is recommended to switch off the function during standard
printing runs to speed up the process.
An additional drop-down menu is displayed below the cell camera window. It allows for
switching between the bright field and fluorescence camera channels and it provides the
possibility to show a combined two channel image. Options here are:
x.sight - software manual
25 | P a g e
• Bright field: shows the bright field channel only (like in c.sight)
• Fluorescence: shows the fluorescence channel only
• BF + FL: shows a combined image of both channels
4.2 Camera alignment mode
The two independent cameras have to be aligned by software before the system is used
to sort cells. This ensures that both channels (bright field and fluorescence) match with
each other. The alignment mode is automatically started with a dialog when either [Collect
Sample] or [PLAY] buttons are pressed.
It is recommended to run this alignment once for each new cartridge. Although the dialog
is always displayed, you can skip this step by pressing [No] every time. The algorithm will
then use the settings from the run before. Chose [Yes] to start the alignment process.
The algorithm will run collect samples in the background and perform the matching on the
acquired cell images from both channels. You will get the results displayed in the dialog:
x.sight - software manual
26 | P a g e
On the left side, the result image of the cell cam is shown (bright field and fluorescence
channel combined). On the right side the matching result will be displayed (background
isolated fluorescence signal plus contour of the cell from the bright field channel).
First, check the black picture with blue contour and the white object. Make sure that
contour and object superpose each other like shown in (A) below. Cases where both do
not superpose (B+C), where only the blue contour is present but no object (D) or where it
is unclear if the blue contour belongs to a specific object (E+F) should be discarded.
Second, check the left bright field + fluorescence picture. Make sure that object (cell) in
bright field is superposing the fluorescence signal (A). Discard cases where object and
fluorescence signal only partly overlap (B) or do not overlap all at (C).
x.sight - software manual
27 | P a g e
A real mismatch case (example B from above) would look like:
Confirm whether the algorithm has performed the matching correctly or not. In case of a
correct matching, confirm by clicking [Ok] in the dialog. If you are not sure about the result
and/or want to perform the matching again, press [Retry]. You can also exit the dialog and
return to the main window by pressing [Cancel].
4.3 Collect sample modes
The sample mode is extended to display two types of data dot plots. One is the standard
display with size versus roundness. The f.sight specific one displays size versus
fluorescent intensity. Use the buttons [Size/Roundness] and [Size/FL intensity] to switch
between the two plots.
You can use them to determine the optimal detection criteria (size, roundness, FL
intensity) for the actual print case.
x.sight - software manual
28 | P a g e
5 Software use
5.1 Starting sequence
To start your x.sight device, press the main power switch on the front side of the unit.
Once the embedded PC has booted, login to Windows and start the software using the
desktop link. Wait until it is started and the start screen appears.
5.2 Chose a well plate or load a program
From the [LOAD] screen, chose your well plate you like to use and click on the respective
tile (e.g. on 96-WELL PROGRAMS). When choosing a favorite, use the small tiles.
5.3 Set up your experiment
In the [SETTINGS] tab, set the boundary conditions for your experiment. For example,
enable deionization of your plate prior to printing. Adjust the agitation speed and volume,
in f.sight models, set up laser and camera exposures. When done, continue to the next
tab.
5.4 Configuring your well plate
The main screen will appear, showing the chosen format. Enter an experiment name in
the [Name] field and (if required) a description in the [Description] field. Type in or scan
x.sight - software manual
29 | P a g e
the plate ID / barcode into the [Plate ID] field. Use the included handheld barcode scanner
for barcode labeled plates.
To configure (program) the well plate according to your needs, use the mouse to select
wells from the interactive well plate. You can either
… select individual wells by left click and combine multiple wells by holding CTRL and left
click:
… select all wells by clicking in the top left corner of the interactive plate:
… select compartments of the plate by dragging frames over the respective well. To do so
click and hold left mouse button and drag until all wanted wells are covered. Release left
mouse button to select:
… select columns or rows by left click on the number or letter on the side:
x.sight - software manual
30 | P a g e
Depending on your experiment, select and configure your plate individually. Once at least
one well is selected, below the plate the configuration controls appear:
Depending on which [Action] is chosen, the controls adapt automatically, displaying only
the specific options being available for this action. The following example show how
individual wells can be independently configured. The displayed color code refers to the
[Action] defined for this well. For two identical actions with different configurations the color
with have a different shade (see example 1).
Example 1: imager optimized. Single cells + multiple cells in A1 for focus finding.
Example 2: evaporation optimized. Single cells in center wells + outer wells empty
x.sight - software manual
31 | P a g e
Example 3: single-cell sequencing incl. separated positive and negative controls
Example 4: limiting dilution approach for rare samples. Every droplet is delivered.
5.5 Loading cartridge and well plate
Before you can actually start your experiment, you have to load a cartridge with your
sample and a well plate on the x.sight device. For detailed instructions please refer to the
x.sight user manual.
x.sight - software manual
32 | P a g e
5.6 Set Region of Interest (ROI)
Once the cartridge is loaded into the x.sight device and the device lid is closed, you have
to set the ROI. You can either click on the [Autodetect ROI] button or click directly into the
[Cell Camera] window. Refer to chapter 3.6 for more details.
Make sure that the ROI is centered over the nozzle. The result is displayed in the [Cell
Camera] window as three circles (blue-green-blue).
5.7 Performing Droplet-QC
Before starting an experiment with a new loaded cartridge, you must perform droplet
quality control (DQC). To enter DQC mode press the [DROPLET-QC] button on the main
menu:
The system will move the dispenser to the QC position and the DQC screen appears.
Use the [Droplet Position] sliders to navigate the droplet into the center of the live image
window. The droplet should appear at a range of 2-5 ms in the [Vertical/Delay] slider which
you should run first. Then tune the [Horizontal] and finally the [Focus] slider until the droplet
appears like shown:
x.sight - software manual
33 | P a g e
Use the [Stroke Settings] sliders to adjust the droplet such that it is stable and single. Make
sure you only see one single droplet and not multiple. Reduce [Speed] in case you see
multiple droplets. When tuning [Speed] the droplet will change its velocity. Adapt
[Vertical/Delay] to make sure the droplet stays centered in the image window.
Once you have a single, stable droplet in the image window, check the vacuum shutter.
To do so, activate the [Turn on] check box under [Vacuum Settings].
When being turned on, the droplet should disappear in the image window. If so, the
vacuum shutter works correctly. If not, please refer to the troubleshoot section or contact
the technical support.
Hint: If you do not perform the DQC prior to starting the printing experiment,
you will get a notification from the software after pressing the [PLAY] button.
Here you can select, if you want to abort and perform the DQC first or if you want
to continue without the DQC.
x.sight - software manual
34 | P a g e
5.8 Performing the experiment
Make sure you have completed all steps required prior to start your experiment. Press the
[PLAY] button to start printing.
Once your experiment is completed, you will receive a message.
5.9 Data
The data generated throughout the experiment runtime will be stored on your hard drive,
flash drive or network drive depending on your selected storage location. Refer to the
[OPTIONS] menu to see where this is.
Every experiment is stored in a separate folder which is named with date and time. All
specific information from you such as [Name], [Description], etc. is stored in an XML file.
Hint: After the experiment is completed, you can:
- rename the experiment folder - move the data including the folder to any other location - copy the data including the folder to any other location - delete the data including the folder to any other location
If it is required to protect your data, please make sure that the experiment data
is generated on a save (backup secured) location or talk to your IT.
x.sight - software manual
35 | P a g e
6 Configuration & OS
6.1 Use of antivirus and security software
Antivirus must be configured such that the cytena software can access the USB
connections and COM ports to which the hardware components are connected. If those
ports are blocked or influenced by any third-party antivirus or firewall application, cytena
cannot guarantee that the cytena application is running correctly.
Further, any modifications and limitation to file and folder access within the cytena software
install folder (incl. subfolders) may lead to problems with the cytena application. The
cytena application uses config files (*.ini ; *.xml) that are modified by the software during
execution (e.g. when the operator changes camera exposure time).
6.2 Domain & domain users
Typically, the following actions can be taken without interfering with the cytena application:
- Change of PC name - Integration into a domain - Setup of domain users - Deleting or disabling local users - Applying GPOs
Important note: GPOs and access rights for domain users have to be set such that the
cytena application can be executed by the logged in user and it can save data (images +
log files) at the specified hard drive paths. Data path can be chosen by the operator / user
freely in the cytena application.
6.3 Connection to local network
The PC can be connected to any local network and/or the internet. There are two GigE
LAN Ports available on the backside of the x.sight device. They can be configured as
required.
6.4 Connection of additional drives
There is only a single SSD embedded into the device. For data redundancy, please use
network or external hard drives. Additional external hard drives can be connected to any
free USB or GigE LAN port on the backside of the x.sight device.
Important note: Do not use external hard drives that are powered over USB! x.sight
cameras are power supplied via USB and require sufficient current to be available to run
at their specified speed and configuration. Max. current available current is limited via
USB. An external hard drive may require more current, than is available. As a result,
cameras may drop frames or even freeze.
Important note: the x.sight does not have internal 12 Vdc support. Connecting additional
internal hard drives is not possible.
x.sight - software manual
36 | P a g e
Disclaimer OpenCV
This software uses OpenCV. By downloading, copying, installing or using the software you agree
to this license. If you do not agree to this license, do not download, install, copy or use the software.
License Agreement
For Open Source Computer Vision Library
(3-clause BSD License)
Brands and Trademarks
The cytena logo, the name “cytena”, the product series name x.sight™ and the product names
c.sight™, f.sight™ and b.sight™ are registered trademarks of cytena GmbH in Europe and/or
other regions. Without written permission from cytena GmbH it is not allowed to use our
registered trademarks and/or logos.
cytena GmbH
Neuer Messplatz 3
D-79108 Freiburg
Germany
Email: info@cytena.com
Website: www.cytena.com
Tel: +49 (0) 761 70 88 900
Amtsgericht Freiburg
HRB 711600
VAT: DE295807841
Managing Director / CEO:
Dr. Jonas Schoendube
top related