# GimmeMotifs
[](http://bioconda.github.io)
[](https://badge.fury.io/py/gimmemotifs)
[](https://travis-ci.org/vanheeringen-lab/gimmemotifs)
[](http://gimmemotifs.readthedocs.io/en/master/?badge=master)
[](https://codeclimate.com/github/vanheeringen-lab/gimmemotifs/maintainability)
[](https://codeclimate.com/github/vanheeringen-lab/gimmemotifs/test_coverage)
[](https://anaconda.org/bioconda/gimmemotifs)
[](https://zenodo.org/badge/latestdoi/676678)
Suite of motif tools, including a motif prediction pipeline for ChIP-seq experiments.
See [full GimmeMotifs documentation](http://gimmemotifs.readthedocs.org/) for detailed installation instructions and usage examples.
For documentation on the development version see [here](http://gimmemotifs.readthedocs.org/en/latest/).
The manuscript describing this latest release is available on [biorRxiv](https://doi.org/10.1101/474403) as a preprint and can be cited as:
> [**GimmeMotifs: an analysis framework for transcription factor motif analysis**](https://doi.org/10.1101/474403) <br>
Niklas Bruse, Simon J. van Heeringen<br>
_bioRxiv_ (2018) DOI: [10.1101/474403](https://doi.org/10.1101/474403)
You can interactively try out the Python API in a Jupyter notebook using binder: [](https://mybinder.org/v2/gh/vanheeringen-lab/gimmemotifs/develop?filepath=docs%2Fapi_examples.ipynb)
## We need your help!
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?
[Let us know!](https://github.com/simonvh/gimmemotifs/issues/)
## Easy installation
The most straightforward way to install GimmeMotifs is via [conda](https://docs.continuum.io/anaconda/) using the [bioconda](https://bioconda.github.io/) 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 defaults
$ 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 python=3 gimmemotifs
# Activate the environment
$ conda activate gimme
```
Python 3 is the required, from version 0.13.0 on GimmeMotifs no longer supports Python 2.
Don't forget to activate the environment with `conda activate gimme` whenever you want to use GimmeMotifs.
## Quick start
### Predict some de novo motifs:
```
$ gimme motifs my_peaks.bed my_motifs -g /data/genomes/hg38/hg38.fa --denovo
```
### Download a genome
The example above assumes that you have the hg38 genome in
`/data/genomes/hg38/hg38.fa`.
GimmeMotifs can also use genomes installed by
[genomepy](http://github.com/simonvh/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 # genomepy >=0.9.0
```
Now you can specify this genome for GimmeMotifs by name.
```
$ gimme motifs my_peaks.bed -g hg38 -n my_motifs
```
## Help
* Full documentation:
[http://gimmemotifs.readthedocs.io/](http://gimmemotifs.readthedocs.io/).
* Check the [FAQ](http://gimmemotifs.readthedocs.io/en/master/faq.html#faq) for
common issues.
* The preferred way to get support is through the Github
[issues](https://github.com/simonvh/gimmemotifs/issues/) page
* Finally, you can reach me by [mail](simon.vanheeringen@gmail.com) or
[Twitter](https://twitter.com/svheeringen).
Raw data
{
"_id": null,
"home_page": "https://github.com/vanheeringen-lab/gimmemotifs/",
"name": "gimmemotifs",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Simon van Heeringen",
"author_email": "simon.vanheeringen@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/23/b1/31f5061ff2749292af7c70ec4f1c81afd1991ea4a2cb62c4e5235d3f1f1c/gimmemotifs-0.18.0.tar.gz",
"platform": null,
"description": "# GimmeMotifs\n\n[](http://bioconda.github.io)\n[](https://badge.fury.io/py/gimmemotifs)\n[](https://travis-ci.org/vanheeringen-lab/gimmemotifs)\n[](http://gimmemotifs.readthedocs.io/en/master/?badge=master)\n[](https://codeclimate.com/github/vanheeringen-lab/gimmemotifs/maintainability)\n[](https://codeclimate.com/github/vanheeringen-lab/gimmemotifs/test_coverage)\n\n[](https://anaconda.org/bioconda/gimmemotifs)\n[](https://zenodo.org/badge/latestdoi/676678)\n\nSuite of motif tools, including a motif prediction pipeline for ChIP-seq experiments.\n\nSee [full GimmeMotifs documentation](http://gimmemotifs.readthedocs.org/) for detailed installation instructions and usage examples.\n\nFor documentation on the development version see [here](http://gimmemotifs.readthedocs.org/en/latest/).\n\nThe manuscript describing this latest release is available on [biorRxiv](https://doi.org/10.1101/474403) as a preprint and can be cited as:\n\n> [**GimmeMotifs: an analysis framework for transcription factor motif analysis**](https://doi.org/10.1101/474403) <br>\nNiklas Bruse, Simon J. van Heeringen<br>\n_bioRxiv_ (2018) DOI: [10.1101/474403](https://doi.org/10.1101/474403)\n\nYou can interactively try out the Python API in a Jupyter notebook using binder: [](https://mybinder.org/v2/gh/vanheeringen-lab/gimmemotifs/develop?filepath=docs%2Fapi_examples.ipynb)\n\n## We need your help!\n\nGimmeMotifs 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?\n\n[Let us know!](https://github.com/simonvh/gimmemotifs/issues/)\n\n\n\n## Easy installation\n\nThe most straightforward way to install GimmeMotifs is via [conda](https://docs.continuum.io/anaconda/) using the [bioconda](https://bioconda.github.io/) channel.\n\nIf you have not used bioconda before, first set up the necessary channels (in this order!). You only have to do this once.\n\n```\n$ conda config --add channels defaults\n$ conda config --add channels bioconda\n$ conda config --add channels conda-forge\n```\n\nYou can now install GimmeMotifs with one command:\n\n```\n# Create an environment called gimme with all dependencies\n$ conda create -n gimme python=3 gimmemotifs\n\n# Activate the environment\n$ conda activate gimme\n```\n\nPython 3 is the required, from version 0.13.0 on GimmeMotifs no longer supports Python 2. \nDon't forget to activate the environment with `conda activate gimme` whenever you want to use GimmeMotifs.\n\n## Quick start\n\n### Predict some de novo motifs:\n\n```\n$ gimme motifs my_peaks.bed my_motifs -g /data/genomes/hg38/hg38.fa --denovo\n```\n\n### Download a genome\n\nThe example above assumes that you have the hg38 genome in\n`/data/genomes/hg38/hg38.fa`. \nGimmeMotifs can also use genomes installed by\n[genomepy](http://github.com/simonvh/genomepy).\n\nYou can configure the directory where genomepy stores genomes by editing\n`~/.config/genomepy/genomepy.yaml`\n\n``` \ngenome_dir: /data/genomes\n``` \n\nTo download a genome from UCSC:\n\n```\n$ genomepy install hg38 --annotation # genomepy >=0.9.0\n```\n\nNow you can specify this genome for GimmeMotifs by name.\n\n```\n$ gimme motifs my_peaks.bed -g hg38 -n my_motifs\n```\n\n## Help \n\n\n* Full documentation:\n [http://gimmemotifs.readthedocs.io/](http://gimmemotifs.readthedocs.io/).\n* Check the [FAQ](http://gimmemotifs.readthedocs.io/en/master/faq.html#faq) for\n common issues.\n* The preferred way to get support is through the Github\n [issues](https://github.com/simonvh/gimmemotifs/issues/) page\n* Finally, you can reach me by [mail](simon.vanheeringen@gmail.com) or\n [Twitter](https://twitter.com/svheeringen).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "GimmeMotifs is a motif prediction pipeline.",
"version": "0.18.0",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "23b131f5061ff2749292af7c70ec4f1c81afd1991ea4a2cb62c4e5235d3f1f1c",
"md5": "63b70ece9f8ecf7e5ca1521c04a4ec48",
"sha256": "94f1f4f642f1a981598003254ed207a9d22716111f556e78bbe1ab709cc4d3a7"
},
"downloads": -1,
"filename": "gimmemotifs-0.18.0.tar.gz",
"has_sig": false,
"md5_digest": "63b70ece9f8ecf7e5ca1521c04a4ec48",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 12164816,
"upload_time": "2023-01-18T10:40:19",
"upload_time_iso_8601": "2023-01-18T10:40:19.599115Z",
"url": "https://files.pythonhosted.org/packages/23/b1/31f5061ff2749292af7c70ec4f1c81afd1991ea4a2cb62c4e5235d3f1f1c/gimmemotifs-0.18.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-18 10:40:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "vanheeringen-lab",
"github_project": "gimmemotifs",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"lcname": "gimmemotifs"
}
JSON
