WSPBiexTransform Class

class flowkit.transforms.WSPBiexTransform(transform_id, negative=0, width=-10, positive=4.41854, max_value=262144.000029)

Biex transform as implemented in FlowJo 10. This transform is applied exactly as the FlowJo 10 is implemented, using lookup tables with only a limited set of parameter values. See the supported values in the BIEX_NEG_VALUES and BIEX_WIDTH_VALUES arrays within the transforms module.

Information on the input parameters from the FlowJo docs:

Adjusting width: The value for w will determine the amount of channels to be compressed into linear space around zero. The space of linear does not change, but rather the number of channels or bins being compressed into the linear space.

Width should be set high enough that all the data in the histogram is visible on screen, but not so high that extra white space is seen to the left-hand side of your dimmest distribution. For most practical uses, once all events have been shifted off the axis and there is no more axis ‘pile-up’, then the optimal width basis value has been reached.

Negative: Another component in the biexponential transform calculation is the negative decades or negative space. This is the only other value you will probably ever need to adjust. In cases where a high width basis may start compressing dim events into the negative cluster, you may want to lower the width basis (less compression around zero) and instead, increase the negative space by 0.5 – 1.0. Doing this will expand the space around zero so the dim events are still visible, but also expand the negative space to remove the cells from the axis and allow you to see the full distribution.

Positive: The presence of the positive decade adjustment is due to the algorithm used for logicle transformation, but is not useful in 99.9% of the cases that require adjusting the biexponential transform. It may be appropriate to adjust this value only if you use data that displays data with a data range greater than 5 decades.

Parameters:

  • transform_id – A string identifying the transform

  • negative – Value for the FlowJo biex option ‘negative’ (float)

  • width – Value for the FlowJo biex option ‘width’ (float)

  • positive – Value for the FlowJo biex option ‘positive’ (float)

  • max_value – parameter for the top of the linear scale (default=262144.000029)

apply(events)

Apply transform to given events.

Parameters:

events – NumPy array of FCS event data

Returns:

NumPy array of transformed events

inverse(events)

Apply the inverse transform to given events.

Parameters:

events – NumPy array of FCS event data

Returns:

NumPy array of inversely transformed events