SigRepo: An R package for storing and processing omic signatures

The SigRepo package provides a comprehensive set of functions for easy storage and management of biological signatures and their components. SigRepo (the client) works alongside SigRepo_Server, its server counterpart. While SigRepo enables you to store, search, and retrieve signatures and signature collections, these operations rely on a running SigRepo_Server instance.

Interested in setting up your own SigRepo_Server? Check out the installation instructions here.

To upload and download signatures — and to fully utilize the functionalities offered by the SigRepo package — signatures and signature collections must be represented as specific R6 objects. You can create these objects using our proprietary package, OmicSignature.

Click on each link below for more information:

• Overview of the object structure
• Create an OmicSignature (OmS)
• Create an OmicSignatureCollection (OmSC)

Below, we walk you through few essential steps to install the SigRepo package, and to store, retrieve, and interact with a list of signatures stored in an already deployed SigRepo server.

Installation

• Using devtools package

# Load devtools package
library(devtools)

# Install SigRepo
devtools::install_github(repo = 'montilab/SigRepo')

# Install OmicSignature
devtools::install_github(repo = 'montilab/OmicSignature')

# Load tidyverse package
library(tidyverse)

# Load SigRepo package
library(SigRepo)

# Load OmicSignature package
library(OmicSignature)

Before you begin

Please navigate to our sigrepo.org portal to create your account. On the login page, click "Register here!" and fill out the registration form to create an account. You will receive an email when your account has been activated. Due to SQL constraints, having multiple users on the same testing account, like running the tutorial in the readme, will fail to connect. Each user using their own account is ideal.

Connect to SigRepo Database

We adopt a MySQL database structure for efficiently storing, searching, and retrieving the biological signatures and its constituents. To access the signatures stored in our database, VISIT OUR WEBSITE to create an account or CONTACT US to be added.

There are three types of user accounts:
- admin has READ and WRITE access to all signatures in the database.
- editor has READ and WRITE access to ONLY their own uploaded signatures in the database.
- viewer has ONLY READ access to see a list of signatures that are publicly available in the database but DO NOT HAVE WRITE access to the database.

Once you have a valid account, to connect to our SigRepo database, one can use the SigRepo::newConnHandler() function to create a handler which contains user credentials to establish connection to our database.

# Create a connection handler
conn_handler <- SigRepo::newConnHandler(
  dbname = "sigrepo", 
  host = "sigrepo.org", 
  port = 3306, 
  user = <your_username>, 
  password = <your_password>
)

Guides

• [Uploading Signature Tutorial]
• Uploading Signature Collection Tutorial