viramp-hub


Nameviramp-hub JSON
Version 0.1.0 PyPI version JSON
download
home_page
SummaryVirAmp-Hub lets you manipulate/convert viral amplicon/primer scheme information.
upload_time2023-07-10 10:34:45
maintainer
docs_urlNone
author
requires_python>=3.6
licenseMIT License Copyright (c) 2023 Wolfgang Maier Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords virology tiled-amplicon primer schemes
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # VirAmp-Hub

A tool that lets you manipulate/convert viral amplicon/primer scheme information.

## What is it for?

The layout of (tiled-) amplicon schemes for amplifying and sequencing viral
genomes is typically specified through one of a number of non-standardized
scheme files. These can, generally, not be used interchangeably with downstream
analysis tools.

VirAmp-Hub can convert between commonly used scheme file formats, such as used,
e.g., by the [ARTIC network](https://github.com/artic-network/primer-schemes),
the [ivar](https://github.com/andersen-lab/ivar) and
[cojac](https://github.com/cbg-ethz/cojac) suites of tools, and
[Galaxy](https://galaxyproject.org/) tools and workflows for viral sequencing
data analysis.

## Usage

After installation (`pip install viramp-hub`), use the package via the
`scheme-convert` command.

For help run:

    scheme-convert --help

Prepare an existing primer scheme file for use with ivar:

    scheme-convert primer_scheme.bed --to bed --bed-type ivar -o ivar.bed

Generate an amplicon insert scheme file for cojac:

    scheme-convert primer_scheme.bed --to bed --bed-type cojac -o cojac_insert.bed

Generate an amplicon info file for use with ivar inside Galaxy:

    scheme-convert primer_scheme.bed --to amplicon-info -o info.tsv

Amplicon info files are simple tab-separated files listing primers contributing
to the same amplicon on a single line. For nested primer schemes, you can
control, which primers to report in the info file.

List only the inner primers:

    scheme-convert primer_scheme.bed --to amplicon-info -r inner -o info.tsv

List only the outer primers:

    scheme-convert primer_scheme.bed --to amplicon-info -r outer -o info.tsv

VirAmp-Hub tries to autodetect primer to amplicon assignments using the Python
re pattern: `r'(?P<prefix>(.*_)*)(?P<num>\d+).*_(?P<name>L(?:EFT)?|R(?:IGHT)?)'`.
If this fails for any given primer scheme, it is possible to override
autodetection by providing an amplicon info file directly, e.g.:

    scheme-convert primer_scheme.bed -a amplicon_info.tsv --to bed --bed-type cojac -o cojac_insert.bed

or:

    scheme-convert primer_scheme.bed -a amplicon_info.tsv --to amplicon-info -r inner -o info.tsv


            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "viramp-hub",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6",
    "maintainer_email": "",
    "keywords": "virology,tiled-amplicon,primer schemes",
    "author": "",
    "author_email": "Wolfgang Maier <maierw@informatik.uni-freiburg.de>",
    "download_url": "https://files.pythonhosted.org/packages/72/93/5651ce08708d678a9efba40b619f76cbc82d2178382899e9398243603180/viramp_hub-0.1.0.tar.gz",
    "platform": null,
    "description": "# VirAmp-Hub\n\nA tool that lets you manipulate/convert viral amplicon/primer scheme information.\n\n## What is it for?\n\nThe layout of (tiled-) amplicon schemes for amplifying and sequencing viral\ngenomes is typically specified through one of a number of non-standardized\nscheme files. These can, generally, not be used interchangeably with downstream\nanalysis tools.\n\nVirAmp-Hub can convert between commonly used scheme file formats, such as used,\ne.g., by the [ARTIC network](https://github.com/artic-network/primer-schemes),\nthe [ivar](https://github.com/andersen-lab/ivar) and\n[cojac](https://github.com/cbg-ethz/cojac) suites of tools, and\n[Galaxy](https://galaxyproject.org/) tools and workflows for viral sequencing\ndata analysis.\n\n## Usage\n\nAfter installation (`pip install viramp-hub`), use the package via the\n`scheme-convert` command.\n\nFor help run:\n\n    scheme-convert --help\n\nPrepare an existing primer scheme file for use with ivar:\n\n    scheme-convert primer_scheme.bed --to bed --bed-type ivar -o ivar.bed\n\nGenerate an amplicon insert scheme file for cojac:\n\n    scheme-convert primer_scheme.bed --to bed --bed-type cojac -o cojac_insert.bed\n\nGenerate an amplicon info file for use with ivar inside Galaxy:\n\n    scheme-convert primer_scheme.bed --to amplicon-info -o info.tsv\n\nAmplicon info files are simple tab-separated files listing primers contributing\nto the same amplicon on a single line. For nested primer schemes, you can\ncontrol, which primers to report in the info file.\n\nList only the inner primers:\n\n    scheme-convert primer_scheme.bed --to amplicon-info -r inner -o info.tsv\n\nList only the outer primers:\n\n    scheme-convert primer_scheme.bed --to amplicon-info -r outer -o info.tsv\n\nVirAmp-Hub tries to autodetect primer to amplicon assignments using the Python\nre pattern: `r'(?P<prefix>(.*_)*)(?P<num>\\d+).*_(?P<name>L(?:EFT)?|R(?:IGHT)?)'`.\nIf this fails for any given primer scheme, it is possible to override\nautodetection by providing an amplicon info file directly, e.g.:\n\n    scheme-convert primer_scheme.bed -a amplicon_info.tsv --to bed --bed-type cojac -o cojac_insert.bed\n\nor:\n\n    scheme-convert primer_scheme.bed -a amplicon_info.tsv --to amplicon-info -r inner -o info.tsv\n\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) 2023 Wolfgang Maier  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
    "summary": "VirAmp-Hub lets you manipulate/convert viral amplicon/primer scheme information.",
    "version": "0.1.0",
    "project_urls": {
        "Homepage": "https://github.com/wm75/viramp-hub"
    },
    "split_keywords": [
        "virology",
        "tiled-amplicon",
        "primer schemes"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6d41fa069d517a960741a9780705abc90aab5942a862b7328fd9661a9fc529a2",
                "md5": "55efde276f3ee311cae67def6edec871",
                "sha256": "18b4f668974850d54502ca486cc9aad9caef2803dc03bdac15acfcf355931e52"
            },
            "downloads": -1,
            "filename": "viramp_hub-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "55efde276f3ee311cae67def6edec871",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6",
            "size": 6771,
            "upload_time": "2023-07-10T10:34:43",
            "upload_time_iso_8601": "2023-07-10T10:34:43.776795Z",
            "url": "https://files.pythonhosted.org/packages/6d/41/fa069d517a960741a9780705abc90aab5942a862b7328fd9661a9fc529a2/viramp_hub-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "72935651ce08708d678a9efba40b619f76cbc82d2178382899e9398243603180",
                "md5": "f725ded3d2f4feb0c4267642d942d9fc",
                "sha256": "a930e2caed01d94a96decae239e6dcc0f8c83cc9eaef393c53641a3d61269ffc"
            },
            "downloads": -1,
            "filename": "viramp_hub-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "f725ded3d2f4feb0c4267642d942d9fc",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6",
            "size": 6266,
            "upload_time": "2023-07-10T10:34:45",
            "upload_time_iso_8601": "2023-07-10T10:34:45.512165Z",
            "url": "https://files.pythonhosted.org/packages/72/93/5651ce08708d678a9efba40b619f76cbc82d2178382899e9398243603180/viramp_hub-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-07-10 10:34:45",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "wm75",
    "github_project": "viramp-hub",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "viramp-hub"
}
        
Elapsed time: 0.57868s