Gimmemotifs is a suite of motif tools, including a motif prediction pipeline for ChIP-seq experiments. See the documentation for detailed installation instructions and usage examples.
The most straightforward way to install GimmeMotifs is via conda using the bioconda channel.
If you have not used bioconda before, first set up the necessary channels (in this order!). You only have to do this once.
$ conda config --add channels bioconda
$ conda config --add channels conda-forge
You can now install GimmeMotifs with one command:
# Create an environment called gimme with all dependencies
$ conda create -n gimme gimmemotifs-minimal
# or
$ conda create -n gimme gimmemotifs
# Activate the environment
$ conda activate gimme
Don't forget to activate the environment with conda activate gimme whenever you want to use GimmeMotifs.
$ gimme motifs my_peaks.bed my_motifs -g /data/genomes/hg38/hg38.fa --denovo
The example above assumes that you have the hg38 genome in /data/genomes/hg38/hg38.fa.
GimmeMotifs can also use genomes installed by genomepy.
You can configure the directory where genomepy stores genomes by editing
~/.config/genomepy/genomepy.yaml
genome_dir: /data/genomes
To download a genome from UCSC:
$ genomepy install hg38 --annotation
Now you can specify this genome for GimmeMotifs by name.
$ gimme motifs my_peaks.bed -g hg38 -n my_motifs
The manuscript describing this latest release is available on biorRxiv as a preprint and can be cited as:
GimmeMotifs: an analysis framework for transcription factor motif analysis
Niklas Bruse, Simon J. van Heeringen
bioRxiv (2018) DOI: 10.1101/474403
GimmeMotifs was originally developed for our own needs but we would really like it to be useful to the wider community. However, this also depends on your input. Let us know what you think! What features are missing? Which tutorial would you like to see? What part of the documentation is unclear? Have great ideas for future developments? Maybe you even want to join in developing this software?
- Full documentation: http://gimmemotifs.readthedocs.io/
- Check the FAQ for common issues
- The preferred way to get support is through the GitHub issues page
- Finally, you can reach me by mail
