CoChat

Update for the logicle data scale including operational code implementations

Open access
Moore, Wayne A., Parks, David R. · 2012 · Cytometry Part A
Cited by 36

The DOI matches its Crossref record; 1 of the 1 references it cites were found in a registry or an index.

Abstract

Since its introduction in the early 2000s, the logicle data scale (1, 2) has been widely adopted by the cytometry community. The characteristics of logicle displays and their use to facilitate interpretation of flow cytometry data have been discussed in several papers (3, 4). FlowJo software (Tree Star, Ashland, OR) offers the option of setting logicle transformation as the default for some data types. Diva software (BD Biosciences, San Jose, CA) offers logicle displays with scaling customized to the distribution of the data in each plot (called "Biexponential" but using the logicle constraints on the biexponential and logicle methods for selecting display parameters). In our experience with data from many different biological applications and a variety of instruments, logicle transformation provides good representation of all cytometry data for which direct linear presentation is not the most appropriate choice and has shown no tendency to generate artifactual features in displays. On this basis, we now recommend logicle as the appropriate default method for nonlinear transformation of cytometric data. In support of this recommendation, this communication provides (1) minor updates to the logicle specification, (2) a rigorously defined parameterization that should clarify questions that have come from people who were implementing logicle transformations in software, (3) technical details that were not considered suitable for the original publication but have become important for the standardization and consistent application of the method, (4) reference implementation code for both high-precision and routine calculations, and (5) a more detailed mathematical exposition on Biexponential Functions (Supporting Information). We expect that the formulas presented here will be the normative definition for the logicle transformation included in the ISAC Standards Committee's recommendation in Gating-ML (Analytical Cytometry Standard (ACS)—Gating-ML Component, http://flowcyt.sourceforge.net/gating/). Implementations of the logicle scale in the Java, C++, and C programming languages are provided in the Supporting Information and are released under the Revised Berkeley Software Distribution open source license for free use in cytometry software. A module for integrating the logicle scale into the R statistical programming environment is available in the Bioconductor repository (http://www.bioconductor.org/). Several algorithms and computational methods used in this work were adopted or modified from Ref.5 (NR3, www.cambridge.org/numericalrecipes and www.nr.com). The objective in developing the logicle transform was to avoid the problems encountered with logarithmic scaling of cytometric data, when primary measurements and/or compensated data includes very low and negative values (illustrated in Fig. 1B). The inverse hyperbolic sine function (sinh−1) offers attractive features as a scaling function in that it gives a near-linear region above and below data zero, near-logarithmic behavior at high data values and a narrow but very smooth transition from one to the other. Transformations of this sort have been used for various kinds of data (6, 7). However, we found that sinh−1 and similar formulations do not provide enough flexibility to maintain consistent near-log behavior for high data values while adjusting the width and slope of the near-linear region to optimally display different data sets. Therefore, we adopted a more generalized biexponential form and constrained that so that a single width parameter (W in the mathematical expression below) sets the negative end of the scale and the width and slope of the near-linear region. This single parameter is used to tune the display for a particular data set. The only really comparable transform we are aware of is the HyperLog (8). Truncating a power series expansion of the negative exponential in a logicle formula to just the first-order term generates a HyperLog function. The full exponential function in the logicle version makes the near-linear region closer to linear and the near-log region closer to logarithmic compared to a corresponding HyperLog. Also, at least as originally formulated, HyperLog does not provide a single adjustable parameter comparable to the logicle width for matching to specific data sets. Appropriate and inappropriate selection of display types and display parameters. The lower histograms show events in the boxed region of the corresponding upper bivariate plots. In each of the logicle histograms, the left end of the integration bar approximates the median of the distribution. (A) Uncompensated logicle display of mouse spleen cells stained for only CD19 using a PE-Cy5.5 conjugated reagent and showing spectral overlap onto the PE-Cy7 channel. (B) A 4.5-decade logarithmic display of the same data compensated. The medians of both the CD19+ and the CD19− populations are near zero and below the minimum of the logarithmic scale. The apparent peak i

Overview

The claims and statistics of this paper haven’t been checked yet.

Free: it reads the open-access text and checks the first 5 claims that cite a source we can check. Create a free account to check every claim.

A few free checks a day · papers already verified open instantly · results are public

Integrity signals

Registry

Crossref · 10.1002/cyto.a.22030

Cites

1 of 1 references verified0 citation errors · 0 not checkable

Statistics

Verification

Claims the paper makes

The claims and statistics of this paper haven’t been checked yet.

Free: it reads the open-access text and checks the first 5 claims that cite a source we can check. Create a free account to check every claim.

A few free checks a day · papers already verified open instantly · results are public

Self-check

Percentages, sums and reported differences re-computed from the paper’s own numbers.

The self-check needs the paper’s full text.

Citations

Cites

Cited by

See all 36

Metadata

Authors
Moore, W. A., & Parks, D. R.
Venue
Cytometry Part A
Publisher
Wiley
Published
2012-03-12
Volume
81A
Issue
4
Pages
273-277
ISSN
  • 1552-4922 (ISSN-L)
  • 1552-4930
OpenAlex
W2018119832
Cited by
36
References
1
FWCI
2.29
Type
journal article
Language
en
Open access
green

About these checks

Registry, retraction, Cites and statistics results are computed, not judged, with one exception: a printed reference that no index lists is read once by a model before it counts as a citation error. Claims are extracted by a model and kept only when their quote appears verbatim in the text; each cited source is then checked, with a model’s help, for whether it says what the claim relies on. Those verdicts can be wrong — read the claim’s quote and the cited source before relying on one.

Statistics and arithmetic are recomputed, not judged.

Confidence bands are shown only for fields calibrated on our annotated test set. None is calibrated yet, so no band is shown.

What counts as a claim ›How we measure confidence ›How we check this ›

Are you an author, or do you see a problem with this page? Request a review

Data sources

Bibliographic data: Semantic Scholar, OpenAlex, Crossref.

Contains information from the Semantic Scholar Academic Graph Datasets, made available under the ODC Attribution License (ODC-BY 1.0).

Semantic Scholar’s data is described in: Kinney, R., et al. (2023). The Semantic Scholar Open Data Platform. arXiv:2301.10140.