RCADE: Recognition Code-Assisted Discovery of regulatory Elements
For motif discovery using RCADE, you will need the sequence of the C2H2-ZF protein that was targeted in the ChIP-seq experiment, as well as the sequences of the peaks identified from ChIP-seq. We suggest that you use the top 500 peaks (based on peak p-values), and center the sequences on peak summits. You can either copy/paste the sequences in FASTA format in the provided text boxes, or upload the FASTA files.
Once the sequences/files are selected, click on the “Submit” button. This will take you to the results page, which provides you with the links for downloading the RCADE output files, and also shows an in-depth log of activities, which is mostly helpful for debugging purposes. In case you encounter an error running RCADE, please include this log text along with your input files in an email to email@example.com.
Here are the output files that you can download on the results page:
- Optimization summary (PS): A postscript file that visualizes a summary of the optimization results. RCADE identifies several motifs from the ChIP-seq data, which are sorted in this file based on their AUROC values for distinguishing ChIP-seq peaks from dinucleotide-shuffled sequences. For each motif, the corresponding zinc fingers are shown on the top (for example, CTCF:3-7 means that zinc fingers 3-7 of the CTCF protein are used for predicting the initial seed motif that is then optimized). The seed motif that is directly predicted from protein sequence is then shown, followed by the motif that is optimized based on ChIP-seq data. The AUROC value for each motif, the associated p-value, as well as the Pearson similarity of the seed and optimized motifs are also shown.
- Optimization summary for the top motif (PS): Same as the above output, except that it only includes the top-scoring optimized motif.
- Top optimized motif (CisBP format): A text file containing the PFM of the top-scoring optimized motif, in a format similar to what is used in the CisBP database (http://cisbp.ccbr.utoronto.ca/).
- Top optimized motif (MEME format): A text file containing the PFM of the top-scoring optimized motif, in a format suitable for the MEME suite (http://meme.nbcr.net/meme/).
- All seeds and optimized motifs (CisBP format): A text file containing all seed motifs and their optimized versions (the optimized motif names end with the phrase “opt”). The motifs are in CisBP format.
- Log: The log file showing all the messages produced by RCADE.
RCADE source code
The source code for RCADE can be downloaded here.
R version 3.0.1 or later (http://www.r-project.org/)
R “randomForest” library (http://cran.r-project.org/web/packages/randomForest/index.html)
GNU-compatible MAKE software (https://gcc.gnu.org/)
MEME Suite (http://meme.nbcr.net/meme/downloads.html)
Step 1. To install the program, extract the package, and run the "make" command.
Step 2. Change the value of line 7 of the “RCOpt.sh” script to where the executable MEME files are located on your computer.
To test the pipeline, execute this command:
bash RCOpt.sh MyTestJob examples/CTCF/CTCF.fasta examples/CTCF/GSM1407629.500bp.fasta
This should create a “./out/MyTestJob” folder, with the RCADE output files described above.
Use the RCOpt.sh script to run RCADE on your dataset:
bash RCOpt.sh <job_name> <C2H2_fasta> <ChIP_fasta>