open-variant


Nameopen-variant JSON
Version 1.0.1 PyPI version JSON
download
home_pageNone
SummaryOpenVariant provides different functionalities to read, parse and operate different multiple input file formats, being able to customize the output.
upload_time2024-12-16 13:02:26
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseBSD 3-Clause License Copyright (c) 2021, BBGLab - Barcelona Biomedical Genomics Lab All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
keywords bbglab bioinformatics openvar openvariant
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <div align="center">
    <a href="https://openvariant.readthedocs.io/">
      <img src="https://github.com/bbglab/openvariant/raw/master/logo.png" width="590" height="350">
    </a>
    <br>
    <br>
  	<a href="https://opensource.org/licenses/BSD-3-Clause">
  		<img alt="License" src="https://img.shields.io/github/license/bbglab/openvariant">
  	</a>
  	<a href="https://pypi.org/project/open-variant/">
  		<img alt="PyPi" src="https://img.shields.io/pypi/v/open-variant">
  	</a>
     <a href="https://github.com/bbglab/openvariant/actions/workflows/openvariant_tester.yml">
         <img alt="Test" src="https://github.com/bbglab/openvariant/actions/workflows/openvariant_tester.yml/badge.svg">
     </a>
    <a href="https://codecov.io/gh/bbglab/openvariant" > 
        <img alt="Coverage" src="https://codecov.io/gh/bbglab/openvariant/branch/develop/graph/badge.svg?token=N6HUMWS9U5"/> 
    </a>
  	<a href="https://openvariant.readthedocs.io/en/latest/?badge=latest">
  		<img alt="Documentation Status" src="https://readthedocs.org/projects/openvariant/badge/?version=latest">
  	</a>
    <br>
    <br>
</div>

OpenVariant is a comprehensive Python package that provides different functionalities to read, parse and operate
different multiple input file formats (e. g. ``tsv``, ``csv``, ``vcf``, ``maf``, ``bed``), being able to customize the output.

Its aim is being able to manage a ton of data represented in multiple ways and be able to build an unified output with 
a proper annotation file structure. This package was thought to work with any kind of data that can be represented 
as a table.

_Documentation_: [https://openvariant.readthedocs.io](https://openvariant.readthedocs.io)

## Features

OpenVariant offers a toolkit to transform and operate the parsed input data. We will be able to apply different 
functionalities on our parsed result some of them are the following ones:

- Find files
- Read and save
- Cat
- Group by
- Count
- Command-line interface (CLI)
- Plugins

<div align="center">
  <a href="https://openvariant.readthedocs.io/en/latest/user_guide.html">
    <img src="https://github.com/bbglab/openvariant/raw/master/workflow.gif" width="600" height="352">
  </a>
</div>

Check [User guide](https://openvariant.readthedocs.io/en/latest/user_guide.html) in OpenVariant's documentation to find all the information about how it works 
and how can be applied the different functionalities.  

## Installation

It requires Python 3 or higher and can be installed as [PyPI package](https://pypi.org/project/open-variant/) with:

```bash
pip install open-variant
```

For more details check our [Installation](https://openvariant.readthedocs.io/en/latest/installation.html) section.

## Examples

We provide a variety of [examples](https://github.com/bbglab/openvariant/tree/master/examples) to help to understand how OpenVariant can be applied. Explore the 
[Examples](https://openvariant.readthedocs.io/en/latest/examples.html) section in OpenVariant's documentation for more details.

As well, we present a small dataset for hands-on use with OpenVariant, allowing users to test the tool's functionalities. It may be found at [Zenodo](https://zenodo.org/records/14215914) and it can be downloaded using the following commands:
```bash
pip install zenodo_get                      
zenodo_get 14215914
```

## Contributing

You're welcome to contribute to the code as much as you'd like!

Please review the guidelines outlined in the [Contributing](https://github.com/bbglab/openvariant/blob/master/CONTRIBUTING.md) document and adhere to the standards of conduct detailed in the [Code of Conduct](https://github.com/bbglab/openvariant/blob/master/CODE_OF_CONDUCT.md).

## License

The software is licensed under [BSD-3-Clause](https://github.com/bbglab/openvariant/blob/master/LICENSE).

## Reference

If you use OpenVariant in your research, please cite:

> David Martínez-Millán, Federica Brando, Miguel L. Grau, Mònica Sánchez-Guixé, Carlos López-Elorduy, Iker Reyes-Salazar, Jordi Deu-Pons, Núria López-Bigas, Abel González-Pérez, OpenVariant: a toolkit to parse and operate multiple input file formats, Bioinformatics, Volume 40, Issue 12, December 2024, btae714, [https://doi.org/10.1093/bioinformatics/btae714](https://doi.org/10.1093/bioinformatics/btae714)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "open-variant",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "bbglab, bioinformatics, openvar, openvariant",
    "author": null,
    "author_email": "\"BBGLab (Barcelona Biomedical Genomics Lab)\" <bbglab@irbbarcelona.org>",
    "download_url": "https://files.pythonhosted.org/packages/9c/1b/5478f2b01efffad3e0a9767c7f116c4c41f300539adc2a3c9a8d6c6210ce/open_variant-1.0.1.tar.gz",
    "platform": null,
    "description": "<div align=\"center\">\n    <a href=\"https://openvariant.readthedocs.io/\">\n      <img src=\"https://github.com/bbglab/openvariant/raw/master/logo.png\" width=\"590\" height=\"350\">\n    </a>\n    <br>\n    <br>\n  \t<a href=\"https://opensource.org/licenses/BSD-3-Clause\">\n  \t\t<img alt=\"License\" src=\"https://img.shields.io/github/license/bbglab/openvariant\">\n  \t</a>\n  \t<a href=\"https://pypi.org/project/open-variant/\">\n  \t\t<img alt=\"PyPi\" src=\"https://img.shields.io/pypi/v/open-variant\">\n  \t</a>\n     <a href=\"https://github.com/bbglab/openvariant/actions/workflows/openvariant_tester.yml\">\n         <img alt=\"Test\" src=\"https://github.com/bbglab/openvariant/actions/workflows/openvariant_tester.yml/badge.svg\">\n     </a>\n    <a href=\"https://codecov.io/gh/bbglab/openvariant\" > \n        <img alt=\"Coverage\" src=\"https://codecov.io/gh/bbglab/openvariant/branch/develop/graph/badge.svg?token=N6HUMWS9U5\"/> \n    </a>\n  \t<a href=\"https://openvariant.readthedocs.io/en/latest/?badge=latest\">\n  \t\t<img alt=\"Documentation Status\" src=\"https://readthedocs.org/projects/openvariant/badge/?version=latest\">\n  \t</a>\n    <br>\n    <br>\n</div>\n\nOpenVariant is a comprehensive Python package that provides different functionalities to read, parse and operate\ndifferent multiple input file formats (e. g. ``tsv``, ``csv``, ``vcf``, ``maf``, ``bed``), being able to customize the output.\n\nIts aim is being able to manage a ton of data represented in multiple ways and be able to build an unified output with \na proper annotation file structure. This package was thought to work with any kind of data that can be represented \nas a table.\n\n_Documentation_: [https://openvariant.readthedocs.io](https://openvariant.readthedocs.io)\n\n## Features\n\nOpenVariant offers a toolkit to transform and operate the parsed input data. We will be able to apply different \nfunctionalities on our parsed result some of them are the following ones:\n\n- Find files\n- Read and save\n- Cat\n- Group by\n- Count\n- Command-line interface (CLI)\n- Plugins\n\n<div align=\"center\">\n  <a href=\"https://openvariant.readthedocs.io/en/latest/user_guide.html\">\n    <img src=\"https://github.com/bbglab/openvariant/raw/master/workflow.gif\" width=\"600\" height=\"352\">\n  </a>\n</div>\n\nCheck [User guide](https://openvariant.readthedocs.io/en/latest/user_guide.html) in OpenVariant's documentation to find all the information about how it works \nand how can be applied the different functionalities.  \n\n## Installation\n\nIt requires Python 3 or higher and can be installed as [PyPI package](https://pypi.org/project/open-variant/) with:\n\n```bash\npip install open-variant\n```\n\nFor more details check our [Installation](https://openvariant.readthedocs.io/en/latest/installation.html) section.\n\n## Examples\n\nWe provide a variety of [examples](https://github.com/bbglab/openvariant/tree/master/examples) to help to understand how OpenVariant can be applied. Explore the \n[Examples](https://openvariant.readthedocs.io/en/latest/examples.html) section in OpenVariant's documentation for more details.\n\nAs well, we present a small dataset for hands-on use with OpenVariant, allowing users to test the tool's functionalities. It may be found at [Zenodo](https://zenodo.org/records/14215914) and it can be downloaded using the following commands:\n```bash\npip install zenodo_get                      \nzenodo_get 14215914\n```\n\n## Contributing\n\nYou're welcome to contribute to the code as much as you'd like!\n\nPlease review the guidelines outlined in the [Contributing](https://github.com/bbglab/openvariant/blob/master/CONTRIBUTING.md) document and adhere to the standards of conduct detailed in the [Code of Conduct](https://github.com/bbglab/openvariant/blob/master/CODE_OF_CONDUCT.md).\n\n## License\n\nThe software is licensed under [BSD-3-Clause](https://github.com/bbglab/openvariant/blob/master/LICENSE).\n\n## Reference\n\nIf you use OpenVariant in your research, please cite:\n\n> David Mart\u00ednez-Mill\u00e1n, Federica Brando, Miguel L. Grau, M\u00f2nica S\u00e1nchez-Guix\u00e9, Carlos L\u00f3pez-Elorduy, Iker Reyes-Salazar, Jordi Deu-Pons, N\u00faria L\u00f3pez-Bigas, Abel Gonz\u00e1lez-P\u00e9rez, OpenVariant: a toolkit to parse and operate multiple input file formats, Bioinformatics, Volume 40, Issue 12, December 2024, btae714, [https://doi.org/10.1093/bioinformatics/btae714](https://doi.org/10.1093/bioinformatics/btae714)\n",
    "bugtrack_url": null,
    "license": "BSD 3-Clause License  Copyright (c) 2021, BBGLab - Barcelona Biomedical Genomics Lab All rights reserved.  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.  3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.",
    "summary": "OpenVariant provides different functionalities to read, parse and operate different multiple input file formats, being able to customize the output.",
    "version": "1.0.1",
    "project_urls": {
        "Documentation": "https://openvariant.readthedocs.io/",
        "Homepage": "https://github.com/bbglab/openvariant",
        "Issues": "https://github.com/bbglab/openvariant/issues",
        "Repository": "https://github.com/bbglab/openvariant"
    },
    "split_keywords": [
        "bbglab",
        " bioinformatics",
        " openvar",
        " openvariant"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "acc9267b68430b6594ffa38256c60a5e6bc7f42729b6bb37c6b47587cae6835d",
                "md5": "020179f43c41673dd374029224621dcf",
                "sha256": "b4374c0cfc68550bec603ee01e7525a501fc0310cc084a12716545557c066ced"
            },
            "downloads": -1,
            "filename": "open_variant-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "020179f43c41673dd374029224621dcf",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 33413,
            "upload_time": "2024-12-16T13:02:14",
            "upload_time_iso_8601": "2024-12-16T13:02:14.453389Z",
            "url": "https://files.pythonhosted.org/packages/ac/c9/267b68430b6594ffa38256c60a5e6bc7f42729b6bb37c6b47587cae6835d/open_variant-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "9c1b5478f2b01efffad3e0a9767c7f116c4c41f300539adc2a3c9a8d6c6210ce",
                "md5": "14d1dac5e98a23044bd672a2dfa16250",
                "sha256": "531c14d9f9e9deaeb317b0d5229b6a9598e8d8ce3976252a001ababb5da6f081"
            },
            "downloads": -1,
            "filename": "open_variant-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "14d1dac5e98a23044bd672a2dfa16250",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 64013969,
            "upload_time": "2024-12-16T13:02:26",
            "upload_time_iso_8601": "2024-12-16T13:02:26.837848Z",
            "url": "https://files.pythonhosted.org/packages/9c/1b/5478f2b01efffad3e0a9767c7f116c4c41f300539adc2a3c9a8d6c6210ce/open_variant-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-16 13:02:26",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "bbglab",
    "github_project": "openvariant",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "open-variant"
}
        
Elapsed time: 0.41316s