pytometry.tools.normalize_logicle#
- pytometry.tools.normalize_logicle(adata, t=262144, m=4.5, w=0.5, a=0, copy=False)#
Logicle transformation.
- Parameters
adata (AnnData) – AnnData object
t (float, optional) – parameter for the top of the linear scale. Defaults to 262144.
m (float, optional) – parameter for the number of decades the true logarithmic scale approaches at the high end of the scale. Defaults to 4.5.
w (float, optional) – parameter for the approximate number of decades in the linear region. Defaults to 0.5.
a (float, optional) – parameter for the additional number of negative decades. Defaults to 0.
copy (bool, optional) – Return a copy instead of writing to adata. Defaults to False.
- Returns
Depending on
copy
, returns or updatesadata
in the following fieldadata.X
is then a normalised adata object
- Details:
Logicle transformation, implemented as defined in the GatingML 2.0 specification, adapted from FlowKit and Flowutils Python packages.
logicle(x, T, W, M, A) = root(B(y, T, W, M, A) - x)
where B is a modified bi-exponential function defined as
B(y, T, W, M, A) = ae^(by) - ce^(-dy) - f
The Logicle transformation was originally defined in the publication of
Moore WA and Parks DR. Update for the logicle data scale including operational code implementations. Cytometry A., 2012:81A(4):273-277.