If my data does not have a Time parameter, can I create one?

There are flow cytometry platforms that do not export Time as a parameter for their data.

In FCS Express, you can create a Time parameter for data files that do not have a Time parameter that was exported with the file.

To do this, we will use 3 features:

To summarize, Parameter Math will allow us to create new parameters for our data by using existing features of the data.  In this example, we will:

  • use a keyword token to extract the total number of events within the file,
  • create a custom token to help us determine the amount of time it took to acquire the data, by using the keywords $BTIM and $ETIM in a function, MinutesBetween, that extracts the amount of minutes between each time point.

Please note that if your data lacks a Time parameter, the data file will lack the information to provide FCS Express with the arrival times for each event.  As a result, FCS Express will equally space each event between the begin time and the end time information stored within the data file.

1. To get started, open a new blank layout by going to File > New > New.
2. Insert a plot that contains your Time-less data file.
3. From the View tab, open the Custom Tokens window.
4. Add a new Custom Token by clicking on the + sign in the Custom Tokens toolbar.
5. Rename the custom token Minutes Between.
6. For the custom token formula, add an = sign, then right click to select the Insert Function menu.
7. From the Date-Time category, select the function MinutesBetween(start time, end time).

 

*If you would like to view Time in a unit other than Minutes, you can use other Date-Time Functions, such as HoursBetween, SecondsBetween or MillisecondsBetween.

8. Within the function, we will need to replace start time and end time with the actual time points coming from our data.  We can use the keywords $BTIM and $ETIM for this.
9. Clear out the information between the parenthesis and then right click within the parenthesis to select Insert Token.
10. Select Keyword from the Insert a Token window and then click Insert.
11. In the Create Keyword window, select the Keyword category and then either type the keyword $BTIM in the field or click on the ellipsis to browse for the keyword within the data file., then click OK.
12. Add a comma after the keyword that we just added and insert another keyword token, this time for the keyword $ETIM.  Close the parenthesis at the end of the function.
13. At this point, your function should now look like this.
14. Close the Custom Tokens window.
15. From the Tools tab, open the Transformations window.
16. Within the Transformations window toolbar, click on the triangle next to the + sign.
17. Select Parameter Math and rename the transformation Calculated Time.
18. Under the Transformation Options section, click New.
19. Within the Create New Sequence Item window, enter Calculated Time for the Output Parameter Name.
20. Select the Formula option.
21. Within the Formula field, enter (row-1)*(.
22. After the open parenthesis, right click and select Insert Token.
23. From Custom, select the Minutes Between custom token that we created in Step 5.
24. After the token, add a /, then right click and select Insert Token.
25. Select Keyword, then in the Keyword category, type in $TOT for the keyword to use, then click OK.  This is the keyword for the total number of events within the data file.
26. After the $TOT keyword, add a ) to close the formula and then click OK.
27. At this point, you should see something similar to this:
28. To apply the Parameter Math to your data, drag the transformation onto a plot.
29. The title of your plot should now reflect that Parameter Math has been applied.  The new parameter can now be selected from the X or Y axis.

 

Previous How does FCS Express implement software compensation?
Next What is compensation?