Package 'curatedTBData'

Title: Curation of existing tuberculosis transcriptomic studies
Description: The curatedTBData is an R package that provides standardized, curated tuberculosis(TB) transcriptomic studies. The initial release of the package contains 49 studies. The curatedTBData package allows users to access tuberculosis trancriptomic efficiently and to make efficient comparison for different TB gene signatures across multiple datasets.
Authors: Xutao Wang [aut, cre], W. Evan Johnson [aut], Prasad Patil [aut]
Maintainer: Xutao Wang <[email protected]>
License: MIT + file LICENSE
Version: 2.8.0
Built: 2026-10-10 11:16:41 UTC
Source: https://github.com/bioc/curatedTBData

Help Index

Select assay based on input list type

Description

Select assay based on input list type

Usage

.select_assay(object_list, experiment_name, Sobject)

Arguments

object_list

A list of MultiAssayExperiment or SummarizedExperiment objects. The object's assay contain expression data with probes mapped to gene symbol. names(object_list) should not be NULL.
experiment_name

A character/vector of character to choose the name of the assay from the input list of object.
Sobject

Boolean. Indicate whether the input is a list of SummarizedExperiment objects.

Value

A list of selected assays.

Subset curatedTBData based on single/multiple conditions

Description

Subset curatedTBData based on single/multiple conditions

Usage

.subset_curatedTBData(
  theObject,
  annotationColName,
  annotationCondition,
  assayName
)

Arguments

theObject

A SummarizedExperiment or MultiAssayExperiment object.
annotationColName

A character indicates feature of interest in the object's annotation data.
annotationCondition

A vector of character indicates conditions want to be selected.
assayName

A character indicates the name of the assay from the input object. The default is NULL. When assayName is NULL, the function selects the first assay along assay list.

Value

A SummarizedExperiment object containing subjects with desired annotation conditions.

Merge samples with common gene names from selected studies

Description

Merge samples with common gene names from selected studies

Usage

combine_objects(object_list, experiment_name, update_genes = TRUE)

Arguments

object_list

A list of MultiAssayExperiment or SummarizedExperiment objects. The object's assay contain expression data with probes mapped to gene symbol. names(object_list) should not be NULL.
experiment_name

A character/vector of character to choose the name of the assay from the input list of object.
update_genes

Boolean. Indicate whether update the gene symbols using checkGeneSymbols. Default is TRUE.

Value

A SummarizedExperiment object that contains combined data from the input.

Examples

geo <-  c("GSE19435", "GSE19439")
data_list <-  curatedTBData(c("GSE19435", "GSE19439"),
                            dry.run = FALSE, curated.only = TRUE)
combine_objects(data_list, experiment_name = "assay_curated")

Import curated Tuberculosis Data

Description

A function to access available curated tuberculosis transcriptomic data from the Bioconductor's ExperimentHub services

Usage

curatedTBData(study_name, dry.run = TRUE, curated.only = TRUE)

Arguments

study_name

A character or vector of characters that contain name of the studies. When any(study_name == "") == TRUE, the function will return all available studies.
dry.run

Boolean. Indicate the whether downloading resources from the ExperimentHub services. If TRUE (Default), return the names of the available resources to be downloaded. If FALSE, start downloading data.
curated.only

Boolean. Indicate whether downloading resources for the curated version. If TRUE (Default), only download the curated gene expression profile and the clinical annotation information If FALSE, download both raw and curated resources.

Value

A list of MultiAssayExperiment objects.

Examples

curatedTBData("GSE39939", dry.run = TRUE)
curatedTBData(c("GSE39939", "GSE39940"), dry.run = FALSE, curated.only = TRUE)

Summarized tuberculosis studies included in the curatedTBData

Description

A dataset containing metadata information of 49 tuberculosis studies. The variables are as follows:

Usage

data(DataSummary)

Format

A data frame with 49 rows and 14 variables

Study

Name of the dataset included in the curatedTBData

Platform

Sequencing platform information

GeographicalRegion

Geographical region to which study was conducted

Tissue

Tissue type of which samples were collected

Age

Age range of the study

HIVStatus

Whether dataset contains HIV-infected subjects

DiagnosisMethod

The diagnostic methods used in the stusy to identify tuberculosis subtypes

Control

The number of subjects who were identified as healthy control in the study

LTBI

The number of subjects with latent tuberculosis infection in the study

PTB

The number of subjects with active tuberculosis in the study

OD

The number of subjects with other disease(s) in the study

Total

Total number of subjects included in the study

Notes

Additional notes about the study

GeneralType

Sequencing type of the study (Affymertirx Microarray, Agilent Microarray, Agilent Microarray - Two Color, Illumina Microarray, Illumina RNA-seq, MPIIB Microarray - Two Color, Phalanx Microarray, Phalanx RT-PCR)

Source

Summarized results for tuberculosis gene signatures and their corresponding discovery/training studies

Description

A table containing tuberculosis gene signatures with dataset(s) from which they were derived. The variables are as follows:

Usage

data(SignatureInfoTraining)

Format

A data frame with 25 rows and 2 variables:

TBSignature

Name of the tuberculosis gene signatures

Study

Name of the dataset

Source

  • Anderson_42: Anderson, Suzanne T., Myrsini Kaforou, Andrew J. Brent, Victoria J. Wright, Claire M. Banwell, George Chagaluka, Amelia C. Crampin, et al. 2014. "Diagnosis of Childhood Tuberculosis and Host RNA Expression in Africa." The New England Journal of Medicine 370 (18): 1712-23. 10.1056/NEJMoa1303657

  • Anderson_OD_51: Anderson, Suzanne T., Myrsini Kaforou, Andrew J. Brent, Victoria J. Wright, Claire M. Banwell, George Chagaluka, Amelia C. Crampin, et al. 2014. "Diagnosis of Childhood Tuberculosis and Host RNA Expression in Africa." The New England Journal of Medicine 370 (18): 1712-23. 10.1056/NEJMoa1303657

  • Berry_393: Berry, Matthew P. R., Christine M. Graham, Finlay W. McNab, Zhaohui Xu, Susannah A. A. Bloch, Tolu Oni, Katalin A. Wilkinson, et al. 2010. "An Interferon-Inducible Neutrophil-Driven Blood Transcriptional Signature in Human Tuberculosis." Nature 466 (7309): 973-77. 10.1038/nature09247

  • Berry_OD_86: Berry, Matthew P. R., Christine M. Graham, Finlay W. McNab, Zhaohui Xu, Susannah A. A. Bloch, Tolu Oni, Katalin A. Wilkinson, et al. 2010. "An Interferon-Inducible Neutrophil-Driven Blood Transcriptional Signature in Human Tuberculosis." Nature 466 (7309): 973-77. 10.1038/nature09247

  • Blankley_5: Blankley, Simon, Christine M. Graham, Joe Levin, Jacob Turner, Matthew P. R. Berry, Chloe I. Bloom, Zhaohui Xu, et al. 2016. "A 380-Gene Meta-Signature of Active Tuberculosis Compared with Healthy Controls." The European Respiratory Journal: Official Journal of the European Society for Clinical Respiratory Physiology 47 (6): 1873-76. 10.1183/13993003.02121-2015

  • Blankley_380: Blankley, Simon, Christine M. Graham, Joe Levin, Jacob Turner, Matthew P. R. Berry, Chloe I. Bloom, Zhaohui Xu, et al. 2016. "A 380-Gene Meta-Signature of Active Tuberculosis Compared with Healthy Controls." The European Respiratory Journal: Official Journal of the European Society for Clinical Respiratory Physiology 47 (6): 1873-76. 10.1183/13993003.02121-2015

  • Bloom_OD_144: Bloom, Chloe I., Christine M. Graham, Matthew P. R. Berry, Fotini Rozakeas, Paul S. Redford, Yuanyuan Wang, Zhaohui Xu, et al. 2013. "Transcriptional Blood Signatures Distinguish Pulmonary Tuberculosis, Pulmonary Sarcoidosis, Pneumonias and Lung Cancers." PloS One 8 (8): e70630. 10.1371/journal.pone.0070630

  • Esmail_82: Esmail, Hanif, Rachel P. Lai, Maia Lesosky, Katalin A. Wilkinson, Christine M. Graham, Stuart Horswell, Anna K. Coussens, Clifton E. Barry 3rd, Anne O'Garra, and Robert J. Wilkinson. 2018. "Complement Pathway Gene Activation and Rising Circulating Immune Complexes Characterize Early Disease in HIV-Associated Tuberculosis." Proceedings of the National Academy of Sciences of the United States of America 115 (5): E964-73. 10.1073/pnas.1711853115

  • Esmail_203: Esmail, Hanif, Rachel P. Lai, Maia Lesosky, Katalin A. Wilkinson, Christine M. Graham, Stuart Horswell, Anna K. Coussens, Clifton E. Barry 3rd, Anne O'Garra, and Robert J. Wilkinson. 2018. "Complement Pathway Gene Activation and Rising Circulating Immune Complexes Characterize Early Disease in HIV-Associated Tuberculosis." Proceedings of the National Academy of Sciences of the United States of America 115 (5): E964-73. 10.1073/pnas.1711853115

  • Esmail_OD_893: Esmail, Hanif, Rachel P. Lai, Maia Lesosky, Katalin A. Wilkinson, Christine M. Graham, Stuart Horswell, Anna K. Coussens, Clifton E. Barry 3rd, Anne O'Garra, and Robert J. Wilkinson. 2018. "Complement Pathway Gene Activation and Rising Circulating Immune Complexes Characterize Early Disease in HIV-Associated Tuberculosis." Proceedings of the National Academy of Sciences of the United States of America 115 (5): E964-73. 10.1073/pnas.1711853115

  • Kaforou_27: Kaforou, Myrsini, Victoria J. Wright, Tolu Oni, Neil French, Suzanne T. Anderson, Nonzwakazi Bangani, Claire M. Banwell, et al. 2013. "Detection of Tuberculosis in HIV-Infected and -Uninfected African Adults Using Whole Blood RNA Expression Signatures: A Case-Control Study." PLoS Medicine 10 (10): e1001538. 10.1371/journal.pmed.1001538

  • Kaforou_OD_44: Kaforou, Myrsini, Victoria J. Wright, Tolu Oni, Neil French, Suzanne T. Anderson, Nonzwakazi Bangani, Claire M. Banwell, et al. 2013. "Detection of Tuberculosis in HIV-Infected and -Uninfected African Adults Using Whole Blood RNA Expression Signatures: A Case-Control Study." PLoS Medicine 10 (10): e1001538. 10.1371/journal.pmed.1001538

  • Kaforou_OD_53: Kaforou, Myrsini, Victoria J. Wright, Tolu Oni, Neil French, Suzanne T. Anderson, Nonzwakazi Bangani, Claire M. Banwell, et al. 2013. "Detection of Tuberculosis in HIV-Infected and -Uninfected African Adults Using Whole Blood RNA Expression Signatures: A Case-Control Study." PLoS Medicine 10 (10): e1001538. 10.1371/journal.pmed.1001538

  • Lee_4: Lee, Shih-Wei, Lawrence Shih-Hsin Wu, Guan-Mau Huang, Kai-Yao Huang, Tzong-Yi Lee, and Julia Tzu-Ya Weng. 2016. "Gene Expression Profiling Identifies Candidate Biomarkers for Active and Latent Tuberculosis." BMC Bioinformatics 17 Suppl 1 (January): 3. 10.1186/s12859-015-0848-x

  • Leong_RISK_29: Leong, S., Zhao, Y., Ribeiro-Rodrigues, R., Jones-López, E. C., Acuña-Villaorduña, C., Rodrigues, P. M., Palaci, M., Alland, D., Dietze, R., Ellner, J. J., Johnson, W. E., Salgame, P., Cross-validation of existing signatures and derivation of a novel 29-gene transcriptomic signature predictive of progression to TB in a Brazilian cohort of household contacts of pulmonary TB. Tuberculosis (Edinb). 2020 Jan;120:101898. 10.1016/j.tube.2020.101898

  • Maertzdorf_4: Maertzdorf, Jeroen, Gayle McEwen, January Weiner 3rd, Song Tian, Eric Lader, Ulrich Schriek, Harriet Mayanja-Kizza, Martin Ota, John Kenneth, and Stefan He Kaufmann. 2016. "Concise Gene Signature for Point-of-Care Classification of Tuberculosis." EMBO Molecular Medicine 8 (2): 86-95. 10.15252/emmm.201505790

  • Maertzdorf_OD_100: Maertzdorf, Jeroen, January Weiner 3rd, Hans-Joachim Mollenkopf, TBornot TB Network, Torsten Bauer, Antje Prasse, Joachim Müller-Quernheim, and Stefan H. E. Kaufmann. 2012. "Common Patterns and Disease-Related Signatures in Tuberculosis and Sarcoidosis." Proceedings of the National Academy of Sciences of the United States of America 109 (20): 7853-58. 10.1073/pnas.1121072109

  • Rajan_HIV_5: Rajan, Jayant V., Semitala, Fred C., Kamya, Moses R., Yoon, Christina., Mehta, Tejas., Cattamanchi, Adithya., Seielstad, Mark., Montalvo, Lani., Andama, Alfred., Katende, Jane., Asege, Lucy., Nakaye, Martha., Mwebe, Sandra. 2018 "A Novel, 5-Transcript, Whole-blood Gene-expression Signature for Tuberculosis Screening Among People Living With Human Immunodeficiency Virus" Clinical Infectious Diseases: 1-7. 10.1093/cid/ciy835

  • Roe_3: Roe, Jennifer, Venturini, Cristina, Gupta, Rishi K., Gurry, Celine, Chain, Benjamin M., Sun, Yuxin, Southern, Jo, Jackson, Charlotte, Lipman, Marc, C., Miller, Robert F., Martineau, Adrian R., Abubakar, Ibrahim, Noursadeghi, Mahdad. 2019 "T1 Blood transcriptomic stratification of short-term risk in contacts of tuberculosis": . 10.1093/cid/ciz252

  • Roe_OD_4: Roe, Jennifer K., Niclas Thomas, Eliza Gil, Katharine Best, Evdokia Tsaliki, Stephen Morris-Jones, Sian Stafford, et al. 2016. "Blood Transcriptomic Diagnosis of Pulmonary and Extrapulmonary Tuberculosis." JCI Insight 1 (16): e87238. 10.1172/jci.insight.87238

  • Sambarey_HIV_10: Sambarey, Awanti, Abhinandan Devaprasad, Abhilash Mohan, Asma Ahmed, Soumya Nayak, Soumya Swaminathan, George D'Souza, et al. 2017. "Unbiased Identification of Blood-Based Biomarkers for Pulmonary Tuberculosis by Modeling and Mining Molecular Interaction Networks." EBioMedicine 15 (February): 112-26. 10.1016/j.ebiom.2016.12.009

  • Singhania_OD_20: Singhania, Akul, Raman Verma, Christine M. Graham, Jo Lee, Trang Tran, Matthew Richardson, Patrick Lecine, et al. 2018. "A Modular Transcriptional Signature Identifies Phenotypic Heterogeneity of Human Tuberculosis Infection." Nature Communications 9 (1): 2308. 10.1038/s41467-018-04579-w

  • Suliman_4: Suliman, Sara, Ethan Thompson, Jayne Sutherland, January Weiner Rd, Martin O. C. Ota, Smitha Shankar, Adam Penn-Nicholson, et al. 2018. "Four-Gene Pan-African Blood Signature Predicts Progression to Tuberculosis." American Journal of Respiratory and Critical Care Medicine, April. https://doi.org/10.1164/rccm.201711-2340OC. 10.1164/rccm.201711-2340OC

  • Suliman_RISK_4: Suliman, Sara, Ethan Thompson, Jayne Sutherland, January Weiner Rd, Martin O. C. Ota, Smitha Shankar, Adam Penn-Nicholson, et al. 2018. "Four-Gene Pan-African Blood Signature Predicts Progression to Tuberculosis." American Journal of Respiratory and Critical Care Medicine, April. https://doi.org/10.1164/rccm.201711-2340OC. 10.1164/rccm.201711-2340OC

  • Sweeney_OD_3: Sweeney, Timothy E., Lindsay Braviak, Cristina M. Tato, and Purvesh Khatri. 2016. "Genome-Wide Expression for Diagnosis of Pulmonary Tuberculosis: A Multicohort Analysis." The Lancet. Respiratory Medicine 4 (3): 213-24. 10.1016/S2213-2600(16)00048-5

  • Thompson_9: Thompson, Ethan G., Ying Du, Stephanus T. Malherbe, Smitha Shankar, Jackie Braun, Joe Valvo, Katharina Ronacher, et al. 2017. "Host Blood RNA Signatures Predict the Outcome of Tuberculosis Treatment." Tuberculosis 107 (December): 48-58. 10.1016/j.tube.2017.08.004

  • Thompson_FAIL_13: Thompson, Ethan G., Ying Du, Stephanus T. Malherbe, Smitha Shankar, Jackie Braun, Joe Valvo, Katharina Ronacher, et al. 2017. "Host Blood RNA Signatures Predict the Outcome of Tuberculosis Treatment." Tuberculosis 107 (December): 48-58. 10.1016/j.tube.2017.08.004

  • Thompson_RES_5: Thompson, Ethan G., Ying Du, Stephanus T. Malherbe, Smitha Shankar, Jackie Braun, Joe Valvo, Katharina Ronacher, et al. 2017. "Host Blood RNA Signatures Predict the Outcome of Tuberculosis Treatment." Tuberculosis 107 (December): 48-58. 10.1016/j.tube.2017.08.004

  • Walter_51: Walter, Nicholas D., Mikaela A. Miller, Joshua Vasquez, Marc Weiner, Adam Chapman, Melissa Engle, Michael Higgins, et al. 2016. "Blood Transcriptional Biomarkers for Active Tuberculosis among Patients in the United States: A Case-Control Study with Systematic Cross-Classifier Evaluation." Journal of Clinical Microbiology 54 (2): 274-82. 10.1128/JCM.01990-15

  • Walter_PNA_47: Walter, Nicholas D., Mikaela A. Miller, Joshua Vasquez, Marc Weiner, Adam Chapman, Melissa Engle, Michael Higgins, et al. 2016. "Blood Transcriptional Biomarkers for Active Tuberculosis among Patients in the United States: A Case-Control Study with Systematic Cross-Classifier Evaluation." Journal of Clinical Microbiology 54 (2): 274-82. 10.1128/JCM.01990-15

  • Walter_PNA_119: Walter, Nicholas D., Mikaela A. Miller, Joshua Vasquez, Marc Weiner, Adam Chapman, Melissa Engle, Michael Higgins, et al. 2016. "Blood Transcriptional Biomarkers for Active Tuberculosis among Patients in the United States: A Case-Control Study with Systematic Cross-Classifier Evaluation." Journal of Clinical Microbiology 54 (2): 274-82. 10.1128/JCM.01990-15

  • Zak_RISK_16: Zak, Daniel E., Adam Penn-Nicholson, Thomas J. Scriba, Ethan Thompson, Sara Suliman, Lynn M. Amon, Hassan Mahomed, et al. 2016. "A Blood RNA Signature for Tuberculosis Disease Risk: A Prospective Cohort Study." The Lancet 387 (10035): 231222. 10.1016/S0140-6736(15)01316-1

Subset curatedTBData based on single/multiple conditions

Description

The function selects desired samples from curatedTBData database based pre-specified conditions

Usage

subset_curatedTBData(
  theObject,
  annotationColName,
  annotationCondition,
  assayName = NULL
)

Arguments

theObject

A SummarizedExperiment or MultiAssayExperiment object.
annotationColName

A character indicates feature of interest in the object's annotation data.
annotationCondition

A vector of character indicates conditions want to be selected.
assayName

A character indicates the name of the assay from the input object. The default is NULL. When assayName is NULL, the function selects the first assay along assay list.

Value

A SummarizedExperiment object containing subjects with desired annotation conditions.

Examples

obj <-  curatedTBData("GSE74092", dry.run = FALSE, curated.only = TRUE)
subset_curatedTBData(obj[[1]], annotationColName = "TBStatus",
                     annotationCondition = c("Control","PTB"))

Update gene names from input data

Description

Update gene names from input data

Usage

update_gene_symbol(dat_exprs)

Arguments

dat_exprs

A data.frame with row names as gene symbols to be updated.

Value

A data.frame with updated gene symbol as row names.