Skip to contents

CellTFusion integrates immune cell type deconvolution with transcription factor (TF)–gene regulatory networks to characterize immune cell states in the tumor microenvironment (TME) from bulk RNA-seq data.

Starting from a count matrix, CellTFusion builds cell groups — sets of deconvolution features related to the same TF co-activity module to the same degree (a similar correlation with the module activity) — and scores them in each sample. The cell group scores can be tested against clinical variables and used as features for machine learning, and they are summarized into latent factors, a compact representation of the TME described by their cell niches (the cell groups that contribute most to each factor).

Installation

To avoid GitHub API rate limit issues, set up a Personal Access Token (PAT) before installing:

# install.packages(c("usethis", "gitcreds"))
usethis::create_github_token()
gitcreds::gitcreds_set()

Install CellTFusion from GitHub:

# install.packages("pak")
pak::pkg_install("VeraPancaldiLab/CellTFusion")

Quick start

The CellTFusion() wrapper runs the whole pipeline in one call, using the example data shipped with the package. Intermediate results and plots are saved in a Results/ folder in the working directory.

library(CellTFusion)

res <- CellTFusion(
  raw_counts     = CellTFusion::raw.counts.tuto,
  normalized     = TRUE,
  deconv_methods = c("Quantiseq", "Epidish"),
  file_name      = "Tutorial"
)

head(res$Latent_spaces$Z)  # latent factor scores (samples x factors)

Tutorials

Step-by-step tutorials are available in the Articles section of the navigation bar:

Shiny app

CellTFusion includes an interactive app to run the pipeline on the example data or on your own data:

shiny::runApp(system.file("shiny", package = "CellTFusion"))

Citation

If you use CellTFusion in a scientific publication, please cite:

Hurtado, M., & Pancaldi, V. (2026). CellTFusion: A transcriptional regulatory network framework for the identification of functional multicellular states from bulk RNA-seq data. bioRxiv. https://doi.org/10.64898/2026.06.30.735682