Quickstart guide

Tan Yong kee

2022-11-01

Installing and Loading the Package


To install oneSENSE package, start R and run the following code:

if (!requireNamespace("BiocManager", quietly=TRUE))
    install.packages("BiocManager")
BiocManager::install("oneSENSE")

Load the package with the following code

library(oneSENSE)

Read the package description to find out more about oneSENSE GUI

? "onesense_GUI()"
## No documentation for 'onesense_GUI()' in specified packages and libraries:
## you could try '??onesense_GUI()'

Using the oneSENSE package


Rational of One-SENSE

One-SENSE measures cellular parameters assinged to manually predefined
catergories, and a one-dimensional map is constructed for each catergory
using t-SNE. Each dimension is informative and can be annotated through
the use of heatplots aligned in parallel to each axis, allowing for
simultaneous visualization of two catergories across a two-dimensional plot.
The cellular occupancy of the resulting plots alllows for direct assessment
of the relationships between the categories.

Read more about One-SENSE: here

Run oneSENSE using the GUI

The easiest way to access oneSENSE is via the Graphics User Interface(GUI)
provided in the package. After loading the package, simply set the directory
as instructed in the note above and run the following code:

The interface will appear like below, you can click the information button
! to check the explanation for each entry and customize your own analysis.

1. Choose the directory where the FCS files are located.

Selecting FCS directory

Selecting FCS directory

2. Display the markers you want to select

Display Markers

Display Markers

3. Select the first, second and/or third(optional) category of markers
you want to group together
Select Markers by Catergory

4. Input the number you want to subsample from each FCS file under ceil.

Ceiling and Bins

Ceiling and Bins

5. Input the number of bins you want for the cells to be sorted into

6. Press submit and it will run to produce median heatplots

7. If you wish to do a frequency heatmap, press select coordinates,
and after selecting coordinates, press generate CSV.

Coordinate Selection

Coordinate Selection

8. Press submit frequency heatplot to generate a different set of heatplot Frequency Heatplot Submission

Depending on the size of your data, it will take some time to run
the analysis. Once done, the oneSENSE visualisations will be displayed.

Median Heatplot example

Median Heatplot

Median Heatplot

Frequency Heatplot example

Frequency Heatplot

Frequency Heatplot

Session Information

sessionInfo()
## R version 4.2.1 (2022-06-23)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 20.04.5 LTS
## 
## Matrix products: default
## BLAS:   /home/biocbuild/bbs-3.16-bioc/R/lib/libRblas.so
## LAPACK: /home/biocbuild/bbs-3.16-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] oneSENSE_1.20.0      scatterplot3d_0.3-42 shinyFiles_0.9.3    
## [4] shiny_1.7.3          webshot_0.5.4       
## 
## loaded via a namespace (and not attached):
##  [1] Biobase_2.58.0      httr_1.4.4          sass_0.4.2         
##  [4] tidyr_1.2.1         jsonlite_1.8.3      viridisLite_0.4.1  
##  [7] gtools_3.9.3        bslib_0.4.0         assertthat_0.2.1   
## [10] stats4_4.2.1        yaml_2.3.6          pillar_1.8.1       
## [13] glue_1.6.2          digest_0.6.30       promises_1.2.0.1   
## [16] colorspace_2.0-3    htmltools_0.5.3     httpuv_1.6.6       
## [19] pkgconfig_2.0.3     purrr_0.3.5         flowCore_2.10.0    
## [22] xtable_1.8-4        scales_1.2.1        later_1.3.0        
## [25] Rtsne_0.16          tibble_3.1.8        generics_0.1.3     
## [28] ggplot2_3.3.6       ellipsis_0.3.2      cachem_1.0.6       
## [31] BiocGenerics_0.44.0 lazyeval_0.2.2      cli_3.4.1          
## [34] magrittr_2.0.3      mime_0.12           evaluate_0.17      
## [37] fs_1.5.2            fansi_1.0.3         gplots_3.1.3       
## [40] tools_4.2.1         data.table_1.14.4   lifecycle_1.0.3    
## [43] matrixStats_0.62.0  stringr_1.4.1       plotly_4.10.0      
## [46] S4Vectors_0.36.0    munsell_0.5.0       compiler_4.2.1     
## [49] jquerylib_0.1.4     caTools_1.18.2      rlang_1.0.6        
## [52] grid_4.2.1          htmlwidgets_1.5.4   bitops_1.0-7       
## [55] rmarkdown_2.17      cytolib_2.10.0      gtable_0.3.1       
## [58] DBI_1.1.3           R6_2.5.1            RProtoBufLib_2.10.0
## [61] knitr_1.40          dplyr_1.0.10        fastmap_1.1.0      
## [64] utf8_1.2.2          KernSmooth_2.23-20  stringi_1.7.8      
## [67] Rcpp_1.0.9          vctrs_0.5.0         tidyselect_1.2.0   
## [70] xfun_0.34