R version: R version 4.1.1 (2021-08-10)
Bioconductor version: 3.14
Package version: 1.18.0
The following psuedo-code illustrates a typical R / Bioconductor session. It makes use of the flow cytometry packages to load, transform and visualize the flow data and gate certain populations in the dataset.
The workflow loads the flowCore
, flowStats
and flowWorkspace
packages and its
dependencies. It loads the ITN data with 15 samples, each of which includes,
in addition to FSC and SSC, 5 fluorescence channels: CD3, CD4, CD8, CD69 and
HLADR.
## Load packages
library(flowCore)
library(flowStats)
library(flowWorkspace)
library(ggcyto)
library(scales)
## Load data
data(ITN)
ITN
## A flowSet with 15 experiments.
##
## An object of class 'AnnotatedDataFrame'
## rowNames: sample01 sample02 ... sample15 (15 total)
## varLabels: GroupID SiteCode ... name (7 total)
## varMetadata: labelDescription
##
## column names(8): FSC SSC ... HLADr Time
First, we need to transform all the fluorescence channels. Using a GatingSet
object can help to keep track of our progress.
## Create a workflow instance and transform data using asinh
gs <- GatingSet(ITN)
trans.obj <- trans_new("myAsinh", transform=asinh, inverse=sinh)
tl <- transformerList(colnames(ITN)[3:7], trans.obj)
gs <- transform(gs, tl)
Next we use the lymphGate
function to find the T-cells in the CD3/SSC
projection.
## Identify T-cells population
lg <- lymphGate(gs_cyto_data(gs), channels=c("CD3", "SSC"),
preselection="CD4", filterId="TCells",
scale=2.5)
gs_pop_add(gs, lg)
## [1] 2
recompute(gs)
## done!
ggcyto(gs, aes(x = CD3, y = SSC)) + geom_hex(bins = 32) + geom_gate("TCells")
A typical workflow for flow cytometry data analysis in Bioconductor flow packages include data transformation, normalization, filtering, manual gating, semi-automatic gating and automatic clustering if desired. Details can be found in flowWorkFlow.pdf or the vignettes of the flow cytometry packages.
[ Back to top ]
Follow installation instructions to start using these
packages. To install the flowCore
package and all of its
dependencies, evaluate the commands
if (!"BiocManager" %in% rownames(installed.packages()))
install.packages("BiocManager")
BiocManager::install("flowCore")
Package installation is required only once per R installation. View a full list of available packages.
To use the flowCore
package, evaluate the command
library("flowCore")
This instruction is required once in each R session.
[ Back to top ]
Packages have extensive help pages, and include vignettes highlighting common use cases. The help pages and vignettes are available from within R. After loading a package, use syntax like
help(package="flowCore")
?read.FCS
to obtain an overview of help on the flowCore
package, and the
read.FCS
function, and
browseVignettes(package="flowCore")
to view vignettes (providing a more comprehensive introduction to
package functionality) in the flowCore
package. Use
help.start()
to open a web page containing comprehensive help resources.
[ Back to top ]
The following provide a brief overview of packages useful for analysis of high-throughput assays. More comprehensive workflows can be found in documentation (available from package descriptions) and in Bioconductor publications.
These packages use standard FCS files, including infrastructure, utilities, visualization and semi-autogating methods for the analysis of flow cytometry data.
flowCore, flowViz, flowQ, flowStats, flowUtils, flowFP, flowTrans,
Algorithms for clustering flow cytometry data are found in these packages:
flowClust, flowMeans, flowMerge, SamSPECTRAL
A typical workflow using the packages flowCore
, flowViz
, flowQ
and
flowStats
is described in detail in flowWorkFlow.pdf.
The data files used in the workflow can be downloaded from
here.
These packages provide data structures and algorithms for cell-based high-throughput screens (HTS).
This package supports the xCELLigence system which contains a series of real-time cell analyzer (RTCA).
These package provide algorithm for the analysis of cycle threshold (Ct) from quantitative real-time PCR data.
These packages provide framework for processing, visualization, and statistical analysis of mass spectral and proteomics data.
These packages provide infrastructure for image-based phenotyping and automation of other image-related tasks:
[ Back to top ]
sessionInfo()
## R version 4.1.1 (2021-08-10)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 20.04.3 LTS
##
## Matrix products: default
## BLAS: /home/biocbuild/bbs-3.14-bioc/R/lib/libRblas.so
## LAPACK: /home/biocbuild/bbs-3.14-bioc/R/lib/libRlapack.so
##
## locale:
## [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
## [3] LC_TIME=en_GB LC_COLLATE=C
## [5] LC_MONETARY=en_US.UTF-8 LC_MESSAGES=en_US.UTF-8
## [7] LC_PAPER=en_US.UTF-8 LC_NAME=C
## [9] LC_ADDRESS=C LC_TELEPHONE=C
## [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
##
## attached base packages:
## [1] stats graphics grDevices utils datasets methods base
##
## other attached packages:
## [1] scales_1.1.1 ggcyto_1.22.0
## [3] ncdfFlow_2.40.0 BH_1.75.0-0
## [5] RcppArmadillo_0.10.7.0.0 ggplot2_3.3.5
## [7] highthroughputassays_1.18.0 flowWorkspace_4.6.0
## [9] flowStats_4.6.0 flowCore_2.6.0
## [11] BiocStyle_2.22.0
##
## loaded via a namespace (and not attached):
## [1] bitops_1.0-7 matrixStats_0.61.0 RColorBrewer_1.1-2
## [4] httr_1.4.2 Rgraphviz_2.38.0 tools_4.1.1
## [7] bslib_0.3.1 utf8_1.2.2 R6_2.5.1
## [10] KernSmooth_2.23-20 DBI_1.1.1 BiocGenerics_0.40.0
## [13] colorspace_2.0-2 withr_2.4.2 gridExtra_2.3
## [16] tidyselect_1.1.1 curl_4.3.2 compiler_4.1.1
## [19] graph_1.72.0 Biobase_2.54.0 xml2_1.3.2
## [22] labeling_0.4.2 bookdown_0.24 sass_0.4.0
## [25] DEoptimR_1.0-9 hexbin_1.28.2 mvtnorm_1.1-3
## [28] robustbase_0.93-9 stringr_1.4.0 digest_0.6.28
## [31] rainbow_3.6 rmarkdown_2.11 rrcov_1.6-0
## [34] base64enc_0.1-3 jpeg_0.1-9 pkgconfig_2.0.3
## [37] htmltools_0.5.2 highr_0.9 fastmap_1.1.0
## [40] rlang_0.4.12 farver_2.1.0 jquerylib_0.1.4
## [43] generics_0.1.1 jsonlite_1.7.2 mclust_5.4.7
## [46] dplyr_1.0.7 RCurl_1.98-1.5 magrittr_2.0.1
## [49] RProtoBufLib_2.6.0 Matrix_1.3-4 Rcpp_1.0.7
## [52] munsell_0.5.0 S4Vectors_0.32.0 fansi_0.5.0
## [55] lifecycle_1.0.1 stringi_1.7.5 yaml_2.2.1
## [58] MASS_7.3-54 zlibbioc_1.40.0 plyr_1.8.6
## [61] grid_4.1.1 crayon_1.4.1 lattice_0.20-45
## [64] splines_4.1.1 magick_2.7.3 knitr_1.36
## [67] pillar_1.6.4 fda_5.4.0 stats4_4.1.1
## [70] XML_3.99-0.8 glue_1.4.2 evaluate_0.14
## [73] latticeExtra_0.6-29 data.table_1.14.2 BiocManager_1.30.16
## [76] RcppParallel_5.1.4 deSolve_1.30 png_0.1-7
## [79] vctrs_0.3.8 gtable_0.3.0 aws.s3_0.3.21
## [82] purrr_0.3.4 assertthat_0.2.1 ks_1.13.2
## [85] xfun_0.27 fds_1.8 pracma_2.3.3
## [88] IDPmisc_1.1.20 pcaPP_1.9-74 tibble_3.1.5
## [91] cytolib_2.6.0 aws.signature_0.6.0 flowViz_1.58.0
## [94] cluster_2.1.2 ellipsis_0.3.2 hdrcde_3.4
[ Back to top ]