{ "info": { "author": "Jens Preussner", "author_email": "jens.preussner@mpi-bn.mpg.de", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Programming Language :: Python", "Topic :: Scientific/Engineering :: Bio-Informatics" ], "description": "Universal RObust Peak Annotator\n=======================================\n\n[![Anaconda-Server Badge](https://img.shields.io/badge/Install%20with-conda-green.svg?style=plastic&logoWidth=40)](https://conda.anaconda.org/bioconda) [![Docker Badge](https://img.shields.io/badge/Container-ready-green.svg?style=plastic&logoWidth=40)](http://biocontainers.pro/registry/#/) [![PyPI Version](https://img.shields.io/pypi/v/uropa.svg?style=plastic)](https://pypi.org/project/uropa/)\n\nThe **Universal RObust Peak Annotator** (UROPA) is a command line based tool, intended for genomic region\nannotation. Based on a configuration file, different target features can be prioritized with multiple integrated queries.\nThese can be sensitive for feature type, distance, strand specificity, feature attributes (eg. protein_coding) or the anchor position relative to the feature.\nUROPA can incorporate reference annotation files (GTF) from different sources, like Gencode, Ensembl, or RefSeq,\nas well as custom reference files produced by the user.\n\nFeatures\n--------\n\n- Detect the most appropriate annotation with flexible parameter keys that allow\n robustness and simple customization, such as\n\n - feature type\n - feature anchor\n - feature direction relative to peak location\n - filter for attribute values, e.g. \u201cprotein\\_coding\u201d\n - strand specificity\n\n- Utilization of all available GTF files as annotation database\n- One run with variable sets of parameters by multiple queries\n- Graduated annotation due to priorization\n- Different easily-readable output tables (allhits, finalfits, besthits).\n- Visual summary for annotation evaluation\n- Preparation of custom annotation files\n\nDocumentation\n--------------\nA detailed description of how to apply UROPA to your data can be found [here](http://uropa-manual.readthedocs.io/).\n\nInstallation and Command-line usage\n------------------------------------\n\n### Conda package manager\n\nWe recommend to install UROPA using the conda package manager. Make sure to have `conda` installed, e.g. via\n\n- [Miniconda](https://conda.io/miniconda.html)\n\t- download the Miniconda installer for **Python 3**\n\t- run ```bash Miniconda3-latest-Linux-x86_64.sh``` to install Miniconda\n\t- Answer the question \"Do you wish the installer to prepend the Miniconda install location to PATH in your /home/.../.bashrc ?\" with yes\n\t\tOR do ```PATH=dir/to/miniconda3:$PATH``` after installation process\n\nThe UROPA installation is now as easy as \n```conda create --name uropa``` \n```conda activate uropa``` \n```conda install python uropa -c bioconda``` \n\n### Biocontainers / Docker\n\nIf you have a running [Docker](docker.com) environment, you can pull a biocontainer with UROPA and all dependencies via\n\n-\t`docker pull quay.io/biocontainers/uropa:latest_tag` using the latest tag from the [taglist](https://quay.io/repository/biocontainers/uropa?tab=tags), e.g. `1.2.1--py27r3.3.2_0`\n-\t`docker pull loosolab/uropa`\n\n### Installation from source\n\nYou can also install UROPA from the source PyPI package. Note that this comes without the R dependencies for auxillary scripts:\n\n`pip install uropa`\n\nTo fulfill all other dependencies, follow the instructions below:\n\n- [R/Rscript](http://www.r-project.org/) (v3.3.0 or higher; follow instructions on url)\n\t- install required packages step by step:\n\t```bash\n\tinstall.packages(c(\"ggplot2\", \"devtools\", \"gplots\", \"gridExtra\", \"jsonlite\", \"VennDiagram\", \"getopt\", \"tidyr\", \"UpSetR\"))\n\tsource(\"https://bioconductor.org/biocLite.R\")\n\tbiocLite(c(\"RBGL\", \"graph\"))\n ```\n\nIn order to plot the Chow-Ruskey plot with uropa_summary.R, install the modified Vennerable package from our fork:\n\n```\nlibrary(devtools)\ninstall_github(\"jenzopr/Vennerable\")\n```\n\n### Usage\n\nTo effectively use UROPA, make yourself familiar with the command-line options:\n\n## Command-line usage\n\n```bash\n$ uropa \nUsage: uropa [options] \n\noptional arguments:\n -h, --help show this help message and exit\n\nArguments for one query:\n -b , --bed Filename of .bed-file to annotate\n -g , --gtf Filename of .gtf-file with features\n --feature [ [ ...]] Feature for annotation\n --feature_anchor [ [ ...]] Feature anchor to annotate to\n --distance [ [ ...]] Maximum permitted distance from feature (1 or 2\n arguments)\n --strand [ [ ...]] Desired strand of annotated feature relative to peak\n --relative_location [ [ ...]] Peak locaion relative to feature location\n --internals Set minimum overlap fraction for internal feature\n annotations. 0 equates to internals=False and 1 equates\n to internals=True. Default is False.\n --filter_attribute Filter on 9th column of GTF\n --attribute_values [ [ ...]] Value(s) of attribute corresponding to\n --filter_attribute\n --show_attributes [ [ ...]] A list of attributes to show in output\n\nMulti-query configuration file:\n -i config.json, --input config.json\n Filename of configuration file (keys in this file\n overwrite command-line arguments about query)\n\nAdditional arguments:\n -p , --prefix Prefix for result file names (defaults to basename of\n .bed-file)\n -o , --outdir Output directory for output files (default: current\n dir)\n -s, --summary Filename of additional visualisation of results in\n graphical format\n -t n, --threads n Multiprocessed run: n = number of threads to run\n annotation process\n -l uropa.log, --log uropa.log Log file name for messages and warnings (default: log\n is written to stdout)\n -d, --debug Print verbose messages (for debugging)\n -v, --version Prints the version and exits\n\n```\n\n## Biocontainer usage\n\nRunning UROPA from a docker container can be done using the following command:\n\n```bash\nsudo docker run --rm -v : UROPA:LATEST uropa -p /'your-file-prefix'\n```\n\n*-v parameter mounts a HOST folder into your docker CONTAINER. This folder should contain the input files for UROPA and also the result files will be stored here. No files will be stored in the container!*\n\n*--rm removes/closes the container after the run*\n\nMake sure to use the uropa -p option specifying the output directory and prefix, otherwise results are lost in the container environment.\n\nHow to cite\n-----------\n\nKondili M, Fust A, Preussner J, Kuenne C, Braun T, and Looso M. UROPA: a tool for Universal RObust Peak Annotation. *Scientific Reports* **7** (2017), doi: [10.1038/s41598-017-02464-y](https://www.nature.com/articles/s41598-017-02464-y)\n\nContribute\n----------\n\n* Source Code [here](https://github.molgen.mpg.de/loosolab/UROPA)\n* Issue Tracker [here](https://github.molgen.mpg.de/loosolab/UROPA/issues)\n\nSupport\n-------\n\nIf you have any questions please feel free to contact Mario Looso (mario.looso@mpi-bn.mpg.de).\n\nLicense\n-------\n\nThe project is licensed under the MIT License.", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.molgen.mpg.de/loosolab/UROPA", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "uropa", "package_url": "https://pypi.org/project/uropa/", "platform": "", "project_url": "https://pypi.org/project/uropa/", "project_urls": { "Homepage": "https://github.molgen.mpg.de/loosolab/UROPA" }, "release_url": "https://pypi.org/project/uropa/3.4.0/", "requires_dist": null, "requires_python": "", "summary": "UROPA is a command line based tool, intended for genomic region annotation", "version": "3.4.0" }, "last_serial": 5786012, "releases": { "1.2.1": [ { "comment_text": "", "digests": { "md5": "10e53bad46946c6c5f29a577de1220a7", "sha256": "6d0cf06ae4507e34cd25b913840be4317d37a7af0e4ee53429b54aca29aab525" }, "downloads": -1, "filename": "uropa-1.2.1.tar.gz", "has_sig": false, "md5_digest": "10e53bad46946c6c5f29a577de1220a7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 35415, "upload_time": "2017-09-07T13:36:52", "url": "https://files.pythonhosted.org/packages/27/6b/018dad28f70de32b799f091aef2159b33eeba7451aa83fcbe40cf4735630/uropa-1.2.1.tar.gz" } ], "2.0.0a0": [ { "comment_text": "", "digests": { "md5": "b211485b634763affdc7a51c1035426c", "sha256": "1ad1b98d222c0c38d0244f6e466ec27f572788220aa31a3674d8e3c98496974f" }, "downloads": -1, "filename": "uropa-2.0.0a0.tar.gz", "has_sig": false, "md5_digest": "b211485b634763affdc7a51c1035426c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 32823, "upload_time": "2017-11-08T10:00:41", "url": "https://files.pythonhosted.org/packages/41/b5/5f6d32992be3f2dd03be43a831a5d6cf77996c9ac1c5b200173fe2e87e7a/uropa-2.0.0a0.tar.gz" } ], "2.0.2a0": [ { "comment_text": "", "digests": { "md5": "a308c3a746cedf7a634b50537f4cacce", "sha256": "210ab49463c237c6899e4382e1b426d6d17f6fd44b5705ce6041ff62aa80d11e" }, "downloads": -1, "filename": "uropa-2.0.2a0.tar.gz", "has_sig": false, "md5_digest": "a308c3a746cedf7a634b50537f4cacce", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 32850, "upload_time": "2018-01-16T14:52:11", "url": "https://files.pythonhosted.org/packages/ac/b5/d762700501e695e6ba0b1d79b389520b899c09e145f14ba695f15f2a7aa1/uropa-2.0.2a0.tar.gz" } ], "2.0.3": [ { "comment_text": "", "digests": { "md5": "920db222a9bb00673b81f76ca33ce3f7", "sha256": "4e2ed21ed655bf1ddb1dc9f135594bc30628616406ac736b5d3f75c5f25ed954" }, "downloads": -1, "filename": "uropa-2.0.3.tar.gz", "has_sig": false, "md5_digest": "920db222a9bb00673b81f76ca33ce3f7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 35879, "upload_time": "2019-01-10T14:34:00", "url": "https://files.pythonhosted.org/packages/9c/66/54bd541ba7c4e2640cb6f88f23ebdf59d79906a6703a17d646b816aa975c/uropa-2.0.3.tar.gz" } ], "2.0.4": [ { "comment_text": "", "digests": { "md5": "6f4420230eea7b1e4bf511eec45eaec9", "sha256": "45060b04a2fee7fbc4bfe7af6c82dd954f6e841c88482b3e4f1ca0710bd06b43" }, "downloads": -1, "filename": "uropa-2.0.4.tar.gz", "has_sig": false, "md5_digest": "6f4420230eea7b1e4bf511eec45eaec9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 36119, "upload_time": "2019-01-31T07:52:46", "url": "https://files.pythonhosted.org/packages/02/97/dbae5f7680e6244ed1059413c1d66fe7bcea60be0ddb0229d756f219da26/uropa-2.0.4.tar.gz" } ], "3.0.0": [ { "comment_text": "", "digests": { "md5": "361e82bba0a1f4b569a221e3827ea48f", "sha256": "a01faf576355699c5958d8cd0e74eec7ac4b02b0816b8c5bf868042ee94862dd" }, "downloads": -1, "filename": "uropa-3.0.0.tar.gz", "has_sig": false, "md5_digest": "361e82bba0a1f4b569a221e3827ea48f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 27229, "upload_time": "2019-03-18T08:07:33", "url": "https://files.pythonhosted.org/packages/51/b5/87a848f9dce9b42053a5a5710ca1b8d6b08dee0f408cf9622f852b5cad4a/uropa-3.0.0.tar.gz" } ], "3.1.0": [ { "comment_text": "", "digests": { "md5": "6b2101ac6d22e4a51aaea43996550851", "sha256": "1312eb7367c79bd6bd2977505dc4728430056e62520efccdbf88a45f745a6bfd" }, "downloads": -1, "filename": "uropa-3.1.0.tar.gz", "has_sig": false, "md5_digest": "6b2101ac6d22e4a51aaea43996550851", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30457, "upload_time": "2019-04-01T07:57:52", "url": "https://files.pythonhosted.org/packages/50/af/df286ef1ddc447003694d43111c0740e327a4583e531c28bce0ef01d2a8b/uropa-3.1.0.tar.gz" } ], "3.1.1": [ { "comment_text": "", "digests": { "md5": "3a8181ce6d6db458f66205c68e716d3b", "sha256": "19f68f46354ac6b0a4243fa12cde5967e351c358fc0144689bde62943831be45" }, "downloads": -1, "filename": "uropa-3.1.1.tar.gz", "has_sig": false, "md5_digest": "3a8181ce6d6db458f66205c68e716d3b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30686, "upload_time": "2019-04-08T13:43:12", "url": "https://files.pythonhosted.org/packages/25/94/af48b56a0b049cc381b101d6cef5da037862e7f0527738ea938cc7fd1b82/uropa-3.1.1.tar.gz" } ], "3.1.2": [ { "comment_text": "", "digests": { "md5": "07886912fba2d51799a4ee34aa9e3b81", "sha256": "672f145aa0d79ba4d8a32c7ba013810c3f6a463654b4cfffe1f4808868164a4e" }, "downloads": -1, "filename": "uropa-3.1.2.tar.gz", "has_sig": false, "md5_digest": "07886912fba2d51799a4ee34aa9e3b81", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30682, "upload_time": "2019-04-08T15:49:01", "url": "https://files.pythonhosted.org/packages/bb/12/d4a846adf04d0841cc87f04e05ff2212edd712dcdfec5164fbcef33a9195/uropa-3.1.2.tar.gz" } ], "3.1.3": [ { "comment_text": "", "digests": { "md5": "52924326ea6a6793221634db3b1281b7", "sha256": "303232fb0ceef6f4cf5ce66b7cc158757832bdd1ce8afe25f52753e20ddfefea" }, "downloads": -1, "filename": "uropa-3.1.3.tar.gz", "has_sig": false, "md5_digest": "52924326ea6a6793221634db3b1281b7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30655, "upload_time": "2019-04-09T08:10:15", "url": "https://files.pythonhosted.org/packages/5f/41/6bbaf93154ee3b5ea832fd5464826567d6039f1380cb3974b573deaf68e6/uropa-3.1.3.tar.gz" } ], "3.1.4": [ { "comment_text": "", "digests": { "md5": "4e88eb56597d4f5aca9194c051a36cb8", "sha256": "7beb0c49ca1d6b1294f0cf575bc3bcfa4ff6f6aec005b593e6746835320bafa8" }, "downloads": -1, "filename": "uropa-3.1.4.tar.gz", "has_sig": false, "md5_digest": "4e88eb56597d4f5aca9194c051a36cb8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30747, "upload_time": "2019-04-13T12:56:14", "url": "https://files.pythonhosted.org/packages/eb/47/8c8a2a745ecd60b97c7320b2be151e026f4a87274cfef6c3568068b2f6da/uropa-3.1.4.tar.gz" } ], "3.2.0": [ { "comment_text": "", "digests": { "md5": "db99aedb5d7abfe894f2484e3aba5c60", "sha256": "d85b38412bf0cc982e4b3c69ab274c65402c3a0b6949101503e8af33c1c8c4ae" }, "downloads": -1, "filename": "uropa-3.2.0.tar.gz", "has_sig": false, "md5_digest": "db99aedb5d7abfe894f2484e3aba5c60", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30870, "upload_time": "2019-04-17T15:48:02", "url": "https://files.pythonhosted.org/packages/0c/4e/636124c25097ec52579c4cbe15ec27849d2b4cfd6f52b3b7f0c965baa4c6/uropa-3.2.0.tar.gz" } ], "3.3.0": [ { "comment_text": "", "digests": { "md5": "f87c57d7a97ed5d7425ea87a918194e1", "sha256": "903619fb5c4415edb488e7cd29adcffc9f75a1dafc69c30ef86c65f6a062855a" }, "downloads": -1, "filename": "uropa-3.3.0.tar.gz", "has_sig": false, "md5_digest": "f87c57d7a97ed5d7425ea87a918194e1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31378, "upload_time": "2019-04-28T13:35:00", "url": "https://files.pythonhosted.org/packages/82/92/dfd28feaff8403621de3c9bb0d70b6942511b8b6dcbc69ce348ba8bd70ca/uropa-3.3.0.tar.gz" } ], "3.3.1": [ { "comment_text": "", "digests": { "md5": "d77c483975bc33a98d3b7a77a16ce589", "sha256": "26f28f04edc9042bdff479a0d30a4ee3673ef2a99a08cc72fb9881f2fece433b" }, "downloads": -1, "filename": "uropa-3.3.1.tar.gz", "has_sig": false, "md5_digest": "d77c483975bc33a98d3b7a77a16ce589", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31446, "upload_time": "2019-05-21T07:25:42", "url": "https://files.pythonhosted.org/packages/a9/46/3a3ec057ab9b6e3acb50df91d608d03dd31246bce2174e942fd3d0899af0/uropa-3.3.1.tar.gz" } ], "3.3.2": [ { "comment_text": "", "digests": { "md5": "afbd587600d7e90aa05a2aa3d96bad56", "sha256": "0fd56569b24ffeb3974a20ef6576dc5e1baa0803c60bbbbabcc529cab45eeab6" }, "downloads": -1, "filename": "uropa-3.3.2.tar.gz", "has_sig": false, "md5_digest": "afbd587600d7e90aa05a2aa3d96bad56", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31652, "upload_time": "2019-05-22T11:49:38", "url": "https://files.pythonhosted.org/packages/a6/82/64f97f7f8a1c57ac1ad77c179cedf0035ecb4db18b2637afb1df2a8554c5/uropa-3.3.2.tar.gz" } ], "3.3.3": [ { "comment_text": "", "digests": { "md5": "eae0490a15e2316e467493bd38f166c3", "sha256": "b05e2e9bf7d2cf7773b7a361220503fa5644c647cac516cab64936917e1cf6f3" }, "downloads": -1, "filename": "uropa-3.3.3.tar.gz", "has_sig": false, "md5_digest": "eae0490a15e2316e467493bd38f166c3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31569, "upload_time": "2019-06-06T11:28:36", "url": "https://files.pythonhosted.org/packages/3d/19/fa561ed7bec1d50ff8d5a208f6e2e8d5287d537d1be275111b7e4ae4685d/uropa-3.3.3.tar.gz" } ], "3.3.4": [ { "comment_text": "", "digests": { "md5": "f8909ba3cc9a697eaaabcf0d03fda2fa", "sha256": "939fb9a7d631f8391c00c1c85dd36bffea168d61ec1d678809ca22379f172238" }, "downloads": -1, "filename": "uropa-3.3.4.tar.gz", "has_sig": false, "md5_digest": "f8909ba3cc9a697eaaabcf0d03fda2fa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31755, "upload_time": "2019-07-01T12:53:07", "url": "https://files.pythonhosted.org/packages/79/ad/f4f7f81febe3e83b3604f3da321047fc30c45247dd4393dd19267a9657b3/uropa-3.3.4.tar.gz" } ], "3.4.0": [ { "comment_text": "", "digests": { "md5": "43f12758cdaabbd5dcd23d7caa5905a5", "sha256": "137b1bd450bbddb3230ffb11f0fe32d0c01cef0b539434ad3cb0784c59be4f8b" }, "downloads": -1, "filename": "uropa-3.4.0.tar.gz", "has_sig": false, "md5_digest": "43f12758cdaabbd5dcd23d7caa5905a5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 32003, "upload_time": "2019-09-05T11:23:04", "url": "https://files.pythonhosted.org/packages/a7/a6/05b61971381e3931c411d047e6caf3ebe118f55d7e3c6f44302c1d451306/uropa-3.4.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "43f12758cdaabbd5dcd23d7caa5905a5", "sha256": "137b1bd450bbddb3230ffb11f0fe32d0c01cef0b539434ad3cb0784c59be4f8b" }, "downloads": -1, "filename": "uropa-3.4.0.tar.gz", "has_sig": false, "md5_digest": "43f12758cdaabbd5dcd23d7caa5905a5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 32003, "upload_time": "2019-09-05T11:23:04", "url": "https://files.pythonhosted.org/packages/a7/a6/05b61971381e3931c411d047e6caf3ebe118f55d7e3c6f44302c1d451306/uropa-3.4.0.tar.gz" } ] }