addTBsignature {TBSignatureProfiler} | R Documentation |
Introduce a new signature into the TBSignatureProfiler.
Description
This function allows users to integrate new signatures into the TBSP
with a function that updates the TBsignatures, TBcommon,
sigAnnotData and common_sigAnnotData objects. Users that wish to use this
function should do so with the downloaded package as a working directory,
and not as a casual package function. This function does not complete all
required updates to the package for a signature to be full added; users
should check the vignette "Submitting Signatures to the TBSP Package"
on the
[TBSP website](https://compbiomed.github.io/TBSignatureProfiler-docs/.)
for a walkthrough of this complete process.
Also note that this function only adds one signature at a time,
and must me run multiple times to add subsequent signatures.
Usage
addTBsignature(
sigsymbols,
authname,
signame_common = NULL,
sigtype,
tissuetype,
saveobjs = FALSE,
views = TRUE
)
Arguments
sigsymbols |
a character vector of the gene symbols that compose
the signature to be added. Required.
|
authname |
a character string containing the last name of the primary
author of the publication where the signature was first identified.
If spaces are present, omit them, and use proper capitalization. Required.
|
signame_common |
a character string of the alternate name of the
signature given by the publication, if it exists. If NULL , no
assigned name is assumed to exist. Default is null .
|
sigtype |
a character string that gives the context that the
signature was developed under. Most commonly,
it will distinguish TB from LTBI ("Disease"),
TB from some combination of other diseases and possibly LTBI
("Disease/Other Diseases"), TB from Human Immunodeficiency Virus
("Disease/HIV"), TB from pneumonia ("Disease/Pneumonia"),
or identify risk of progression to TB ("risk"), risk of TB treatment
failure ("failure"), or classify treatment responses
(i.e., failures from cures, "response"). Required.
|
tissuetype |
a character string that denotes whether the
signature was developed using samples of either whole blood/paxgene
("whole blood") or peripheral blood mononuclear cells ("PBMC").
Due to the manipulation of cells inherently required to obtain PBMCs,
many scientists prefer to use only whole blood samples for analysis.
Accepts "whole blood", "PBMC" or "mixed". Required.
|
saveobjs |
logical . If TRUE , the contents of the data
file (TBsignatures , TBcommon , sigAnnotData ,
common_sigAnnotData ) will be overwritten and updated to include
the new signature. If FALSE , no files will be overwritten, but
you can check function output for errors before writing RDS objects
by setting views = TRUE . Default is saveobjs = FALSE .
|
views |
logical. If TRUE , all objects will be sent to a
data view in a new window to check for errors. Default is TRUE .
|
Value
Either data objects TBsignatures
, TBcommon
,
sigAnnotData
, and common_sigAnnotData
will be updated with the
new signature and overwritten if saveobjs = FALSE
, or no output will
be produced except errors and messages for checking that the function
runs correctly given the inputs.
Examples
# Mock example signature
TBSignatureProfiler:::addTBsignature(sigsymbols = c("GBP5", "BATF2", "GZMA"),
authname = "Odom",
signame_common = NULL,
sigtype = "Disease/HIV",
tissuetype = "PBMC",
saveobjs = FALSE,
views = FALSE)
[Package
TBSignatureProfiler version 1.5.14
Index]