TFBSTools (version 1.10.3)

getMatrixByID: Basic JASPAR database search functionis getMatrixByID, getMatrixByName

Description

This method fetches matrix data under the given ID or name from the database and returns a XMatrix object.

Usage

"getMatrixByID"(x, ID) "getMatrixByID"(x, ID) "getMatrixByID"(x, ID) "getMatrixByName"(x, name) "getMatrixByName"(x, name) "getMatrixByName"(x, name)

Arguments

x

character(1) for the path of JASPAR SQLite file, a SQLiteConnection object, a JASPAR2014, or a JASPAR2016object.

ID

character() of JASPAR stable ID(s). See more details below.

name

character() of JASPAR stable name(s).

Value

A PFMMatrix object is returned when input ID or name is length 1. Otherwise, PFMMatrixList is returned.

Details

For getMatrixByID, ID is a string which refers to the stable JASPAR ID (usually something like "MA0001") with or without version numbers. "MA0001" will give the latest version on MA0001, while "MA0001.2" will give the second version, if existing.

For getMatrixByName, according to the current JASPAR data model, name is not necessarily a unique identifier. Also, names change over time. In the case where there are several matrices with the same name in the database, the function fetches the first one and prints a warning. You've been warned. Some matrices have multiple versions. The function will return the latest version. For specific versions, use getMatrixByID(ID.version)

See Also

getMatrixSet

Examples

    library(JASPAR2014)
    db <- file.path(system.file("extdata", package="JASPAR2014"), 
                    "JASPAR2014.sqlite")
                    
    ## character and ID
    pfm <- getMatrixByID(db, ID="MA0003")
    
    ## character and IDs
    pfmList <- getMatrixByID(db, ID=c("MA0003", "MA0004"))
    
    ## character and name
    pfm <- getMatrixByName(db, name="TFAP2A")
    
    ##
    ## character and name
    pfmList <- getMatrixByName(db, name=c("TFAP2A", "Arnt"))
    
    ## JASPAR2014 and ID
    pfm <- getMatrixByID(JASPAR2014, ID="MA0003")