Contents

1 Installation

1.1 Required dependencies

inferCNV uses the R packages ape, BiocGenerics, binhf, caTools, coda, coin, dplyr, doparallel, edgeR, fastcluster, fitdistrplus, foreach, futile.logger, future, gplots, ggplot2, HiddenMarkov, reshape, rjags, RColorBrewer, SingleCellExperiment, SummarizedExperiment and imports functions from the archived GMD.

1.2 Installing

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

1.3 Optional extension

If you want to use the interactive heatmap visualization, please check the add-on packge R inferCNV_NGCHM after installing the packages tibble, tsvio and NGCHMR. To install optional packages, type the following in an R command window:

install.packages("tibble")

install.packages("devtools")
devtools::install_github("bmbroom/tsvio")
devtools::install_github("bmbroom/NGCHMR", ref="stable")
devtools::install_github("broadinstitute/inferCNV_NGCHM")

And download the NGCHM java application by typing the following in a regular shell:

wget http://tcga.ngchm.net/NGCHM/ShaidyMapGen.jar

2 Running InferCNV

2.1 Create the InferCNV Object

Reading in the raw counts matrix and meta data, populating the infercnv object

infercnv_obj = CreateInfercnvObject(
  raw_counts_matrix="../inst/extdata/oligodendroglioma_expression_downsampled.counts.matrix.gz",
  annotations_file="../inst/extdata/oligodendroglioma_annotations_downsampled.txt",
  delim="\t",
  gene_order_file="../inst/extdata/gencode_downsampled.EXAMPLE_ONLY_DONT_REUSE.txt",
  ref_group_names=c("Microglia/Macrophage","Oligodendrocytes (non-malignant)"))
## INFO [2020-10-27 21:02:25] Parsing matrix: ../inst/extdata/oligodendroglioma_expression_downsampled.counts.matrix.gz
## INFO [2020-10-27 21:02:27] Parsing gene order file: ../inst/extdata/gencode_downsampled.EXAMPLE_ONLY_DONT_REUSE.txt
## INFO [2020-10-27 21:02:27] Parsing cell annotations file: ../inst/extdata/oligodendroglioma_annotations_downsampled.txt
## INFO [2020-10-27 21:02:27] ::order_reduce:Start.
## INFO [2020-10-27 21:02:27] .order_reduce(): expr and order match.
## INFO [2020-10-27 21:02:27] ::process_data:order_reduce:Reduction from positional data, new dimensions (r,c) = 10338,184 Total=18322440.6799817 Min=0 Max=34215.
## INFO [2020-10-27 21:02:27] num genes removed taking into account provided gene ordering list: 399 = 3.8595473012188% removed.
## INFO [2020-10-27 21:02:27] -filtering out cells < 100 or > Inf, removing 0 % of cells
## INFO [2020-10-27 21:02:28] validating infercnv_obj

2.2 Running the full default analysis

out_dir = tempfile()
infercnv_obj_default = infercnv::run(
    infercnv_obj,
    cutoff=1, # cutoff=1 works well for Smart-seq2, and cutoff=0.1 works well for 10x Genomics
    out_dir=out_dir,
    cluster_by_groups=TRUE, 
    plot_steps=FALSE,
    denoise=TRUE,
    HMM=FALSE,
    no_prelim_plot=TRUE,
    png_res=60
)

Basic ouput from running inferCNV.

3 Additional Information

3.1 Online Documentation

For additional explanations on files, usage, and a tutorial please visit the wiki.

3.2 TrinityCTAT

This tool is a part of the TrinityCTAT toolkit focused on leveraging the use of RNA-Seq to better understand cancer transcriptomes. To find out more please visit TrinityCTAT

4 Session info

## R version 4.0.3 (2020-10-10)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 18.04.5 LTS
## 
## Matrix products: default
## BLAS:   /home/biocbuild/bbs-3.12-bioc/R/lib/libRblas.so
## LAPACK: /home/biocbuild/bbs-3.12-bioc/R/lib/libRlapack.so
## 
## locale:
##  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
##  [3] LC_TIME=en_US.UTF-8        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] infercnv_1.6.0   BiocStyle_2.18.0
## 
## loaded via a namespace (and not attached):
##  [1] nlme_3.1-150                bitops_1.0-6               
##  [3] matrixStats_0.57.0          doParallel_1.0.16          
##  [5] RColorBrewer_1.1-2          GenomeInfoDb_1.26.0        
##  [7] tools_4.0.3                 R6_2.4.1                   
##  [9] KernSmooth_2.23-17          BiocGenerics_0.36.0        
## [11] colorspace_1.4-1            tidyselect_1.1.0           
## [13] gridExtra_2.3               compiler_4.0.3             
## [15] argparse_2.0.3              Biobase_2.50.0             
## [17] formatR_1.7                 DelayedArray_0.16.0        
## [19] sandwich_3.0-0              bookdown_0.21              
## [21] caTools_1.18.0              scales_1.1.1               
## [23] mvtnorm_1.1-1               stringr_1.4.0              
## [25] digest_0.6.27               rmarkdown_2.5              
## [27] XVector_0.30.0              pkgconfig_2.0.3            
## [29] htmltools_0.5.0             MatrixGenerics_1.2.0       
## [31] limma_3.46.0                rlang_0.4.8                
## [33] generics_0.0.2              zoo_1.8-8                  
## [35] jsonlite_1.7.1              gtools_3.8.2               
## [37] dplyr_1.0.2                 RCurl_1.98-1.2             
## [39] magrittr_1.5                modeltools_0.2-23          
## [41] GenomeInfoDbData_1.2.4      futile.logger_1.4.3        
## [43] Matrix_1.2-18               Rcpp_1.0.5                 
## [45] munsell_0.5.0               S4Vectors_0.28.0           
## [47] ape_5.4-1                   lifecycle_0.2.0            
## [49] stringi_1.5.3               multcomp_1.4-14            
## [51] yaml_2.2.1                  edgeR_3.32.0               
## [53] MASS_7.3-53                 SummarizedExperiment_1.20.0
## [55] zlibbioc_1.36.0             gplots_3.1.0               
## [57] plyr_1.8.6                  grid_4.0.3                 
## [59] parallel_4.0.3              listenv_0.8.0              
## [61] crayon_1.3.4                lattice_0.20-41            
## [63] splines_4.0.3               locfit_1.5-9.4             
## [65] knitr_1.30                  pillar_1.4.6               
## [67] fastcluster_1.1.25          GenomicRanges_1.42.0       
## [69] codetools_0.2-16            stats4_4.0.3               
## [71] futile.options_1.0.1        glue_1.4.2                 
## [73] evaluate_0.14               lambda.r_1.2.4             
## [75] BiocManager_1.30.10         png_0.1-7                  
## [77] vctrs_0.3.4                 foreach_1.5.1              
## [79] tidyr_1.1.2                 gtable_0.3.0               
## [81] purrr_0.3.4                 reshape_0.8.8              
## [83] future_1.19.1               ggplot2_3.3.2              
## [85] xfun_0.18                   coin_1.3-1                 
## [87] libcoin_1.0-6               coda_0.19-4                
## [89] survival_3.2-7              rjags_4-10                 
## [91] SingleCellExperiment_1.12.0 tibble_3.0.4               
## [93] iterators_1.0.13            IRanges_2.24.0             
## [95] globals_0.13.1              fitdistrplus_1.1-1         
## [97] TH.data_1.0-10              ellipsis_0.3.1