# Cutevariant
**A standalone and free application to explore genetics variations from VCF file**
Published in [Bioinformatics Advanced](https://academic.oup.com/bioinformaticsadvances/article/2/1/vbab028/6440032?login=true)
Documentation available on [cutevariant.labsquare.org](https://cutevariant.labsquare.org/)
[](https://github.com/labsquare/cutevariant/actions/workflows/test.workflows.yml) [](https://codecov.io/gh/labsquare/cutevariant)
Cutevariant is a cross-plateform application dedicated to maniupulate and filter variation from annotated VCF file.
When you create a project, data are imported into an sqlite database that cutevariant queries according your needs.
Presently, SnpEff and VEP annotations are supported.
Once your project is created, you can query variant using different gui controller or directly using the VQL language. This Domain Specific Language is specially designed for cutevariant and try to keep the same syntax than SQL for an easy use.
| | | |
|:-------------------------:|:-------------------------:|:-------------------------:|
|<img width="1604" alt="screen shot 2017-08-07 at 12 18 15 pm" src="https://raw.githubusercontent.com/labsquare/cutevariant/master/screenshot1.png"> |<img width="1604" alt="screen shot 2017-08-07 at 12 18 15 pm" src="https://raw.githubusercontent.com/labsquare/cutevariant/master/screenshot2.png">|<img width="1604" alt="screen shot 2017-08-07 at 12 18 15 pm" src="https://raw.githubusercontent.com/labsquare/cutevariant/master/screenshot4.png">|
# Installation
## Windows
Standalone binary are available for windows:
- [Download cutevariant 32 bit](https://github.com/labsquare/cutevariant/releases/latest/download/cutevariant-standalone-x86.zip)
- [Download cutevariant 64 bit](https://github.com/labsquare/cutevariant/releases/latest/download/cutevariant-standalone-x64.zip)
## Linux
If you run Linux, then you can either use PyPI or install from source.
But before you proceed to installation, make sure that running this command:
```bash
sqlite3 --version
```
returns at least `3.32`.
If not, run:
```bash
# Uninstall previous versions of sqlite3 (to avoid conflicts)
sudo apt remove sqlite3
# Download latest sqlite version
wget https://www.sqlite.org/2022/sqlite-autoconf-3380500.tar.gz
# Extract it
tar -xvf sqlite-autoconf-3380500.tar.gz
cd sqlite-autoconf-3380500
./configure
# Run make to build
make
# Run make install, this will put the shared object in /usr/local/lib
sudo make install
# Then add LD_LIBRARY_PATH to your bash profile (either ~/.zshrc, ~/.bashrc, or whatever is your favorite)
echo "export LD_LIBRARY_PATH=/usr/local/lib" >> ~/.zshrc
# Source your shell profile so you don't have to restart it
source ~/.zshrc
#Now just to be sure:
sqlite3 --version
# You should see 3.38 now. If not, this means that the installation went wrong.
# That's it! Now you can install cutevariant, either from PyPI or directly from source
```
## PyPi
Cutevariant is avaible from [Pypi](https://pypi.org/project/cutevariant/) :
pip install cutevariant # install
python -m cutevariant # run
## From source
- Python 3.7 or newer is required
```bash
# Clone repository
git clone https://github.com/labsquare/cutevariant.git
cd cutevariant
# Create a virtual environement
python3 -m virtualenv venv
source venv/bin/activate
# Install cutevariant in local mode
python -m pip install -e
# Run cutevariant as module
python -m cutevariant # or `make run`
# Run test
python -m pytest tests
```
## Usages
You can follow this tutorial to familiarize yourself with cutevarant.
https://github.com/labsquare/cutevariant/wiki/Usage-examples
The VQL langage specification is available here :
https://github.com/labsquare/cutevariant/wiki/VQL-language
## Contributions / Bugs
Cutevariant is a new project and all contributors are welcome
### Issues
If you found a bug or have a feature request, you can report it from the [Github isse trackers](https://github.com/labsquare/cutevariant/issues).
### Create a plugin
Documentation to create a plugin is [available here](https://github.com/labsquare/cutevariant/wiki/Plugins)
### Chat
You can join us [on discord](https://discord.gg/7sSH4VSPKK). We are speaking french right now, but we can switch to english.
## Licenses
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/gpl-3.0.txt.
Raw data
{
"_id": null,
"home_page": "https://github.com/labsquare/cutevariant",
"name": "cutevariant",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "GUI,health",
"author": "Sacha Schutz, Pierre Vignet",
"author_email": "sacha@labsquare.org",
"download_url": "https://files.pythonhosted.org/packages/50/39/1f65cec1cd3cd638f739d0630d5043bbd88d0fdd452912c097f029b53cb9/cutevariant-0.4.5.tar.gz",
"platform": null,
"description": "# Cutevariant\n\n**A standalone and free application to explore genetics variations from VCF file**\n\nPublished in [Bioinformatics Advanced](https://academic.oup.com/bioinformaticsadvances/article/2/1/vbab028/6440032?login=true) \nDocumentation available on [cutevariant.labsquare.org](https://cutevariant.labsquare.org/)\n\n[](https://github.com/labsquare/cutevariant/actions/workflows/test.workflows.yml) [](https://codecov.io/gh/labsquare/cutevariant)\n\nCutevariant is a cross-plateform application dedicated to maniupulate and filter variation from annotated VCF file. \nWhen you create a project, data are imported into an sqlite database that cutevariant queries according your needs. \nPresently, SnpEff and VEP annotations are supported. \nOnce your project is created, you can query variant using different gui controller or directly using the VQL language. This Domain Specific Language is specially designed for cutevariant and try to keep the same syntax than SQL for an easy use.\n\n\n\n\n\n| | | |\n|:-------------------------:|:-------------------------:|:-------------------------:|\n|<img width=\"1604\" alt=\"screen shot 2017-08-07 at 12 18 15 pm\" src=\"https://raw.githubusercontent.com/labsquare/cutevariant/master/screenshot1.png\"> |<img width=\"1604\" alt=\"screen shot 2017-08-07 at 12 18 15 pm\" src=\"https://raw.githubusercontent.com/labsquare/cutevariant/master/screenshot2.png\">|<img width=\"1604\" alt=\"screen shot 2017-08-07 at 12 18 15 pm\" src=\"https://raw.githubusercontent.com/labsquare/cutevariant/master/screenshot4.png\">|\n\n\n# Installation\n\n## Windows \nStandalone binary are available for windows: \n- [Download cutevariant 32 bit](https://github.com/labsquare/cutevariant/releases/latest/download/cutevariant-standalone-x86.zip)\n- [Download cutevariant 64 bit](https://github.com/labsquare/cutevariant/releases/latest/download/cutevariant-standalone-x64.zip)\n\n## Linux\n\nIf you run Linux, then you can either use PyPI or install from source.\nBut before you proceed to installation, make sure that running this command:\n```bash\nsqlite3 --version\n```\nreturns at least `3.32`.\nIf not, run:\n\n```bash\n# Uninstall previous versions of sqlite3 (to avoid conflicts)\nsudo apt remove sqlite3\n# Download latest sqlite version\nwget https://www.sqlite.org/2022/sqlite-autoconf-3380500.tar.gz\n# Extract it\ntar -xvf sqlite-autoconf-3380500.tar.gz\ncd sqlite-autoconf-3380500\n./configure\n# Run make to build\nmake\n# Run make install, this will put the shared object in /usr/local/lib\nsudo make install\n# Then add LD_LIBRARY_PATH to your bash profile (either ~/.zshrc, ~/.bashrc, or whatever is your favorite)\necho \"export LD_LIBRARY_PATH=/usr/local/lib\" >> ~/.zshrc\n# Source your shell profile so you don't have to restart it\nsource ~/.zshrc\n#Now just to be sure:\nsqlite3 --version\n# You should see 3.38 now. If not, this means that the installation went wrong.\n# That's it! Now you can install cutevariant, either from PyPI or directly from source\n```\n\n## PyPi\nCutevariant is avaible from [Pypi](https://pypi.org/project/cutevariant/) : \n\n pip install cutevariant # install\n python -m cutevariant # run\n\n## From source \n- Python 3.7 or newer is required \n\n```bash\n# Clone repository\ngit clone https://github.com/labsquare/cutevariant.git\ncd cutevariant\n# Create a virtual environement\npython3 -m virtualenv venv \nsource venv/bin/activate\n# Install cutevariant in local mode\npython -m pip install -e \n# Run cutevariant as module \npython -m cutevariant # or `make run`\n# Run test \npython -m pytest tests\n```\n\n## Usages \nYou can follow this tutorial to familiarize yourself with cutevarant. \nhttps://github.com/labsquare/cutevariant/wiki/Usage-examples\n\nThe VQL langage specification is available here : \nhttps://github.com/labsquare/cutevariant/wiki/VQL-language\n\n## Contributions / Bugs\nCutevariant is a new project and all contributors are welcome\n### Issues\nIf you found a bug or have a feature request, you can report it from the [Github isse trackers](https://github.com/labsquare/cutevariant/issues).\n\n### Create a plugin\nDocumentation to create a plugin is [available here](https://github.com/labsquare/cutevariant/wiki/Plugins)\n\n### Chat \nYou can join us [on discord](https://discord.gg/7sSH4VSPKK). We are speaking french right now, but we can switch to english. \n\n## Licenses\nThis program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/gpl-3.0.txt.\n",
"bugtrack_url": null,
"license": "",
"summary": "GUI to visualize and process variant data",
"version": "0.4.5",
"split_keywords": [
"gui",
"health"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "eda169058aeca5bb5c4d4898a860785e6100b0a971e5403f3148207893840bff",
"md5": "7135c8f4fa8421e1e5a6292e84fb79c8",
"sha256": "e7de29076ff686ecdec8d967e51022c3b25b3042bfa38faadf73db44854cb91d"
},
"downloads": -1,
"filename": "cutevariant-0.4.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7135c8f4fa8421e1e5a6292e84fb79c8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 1178032,
"upload_time": "2023-03-21T17:54:33",
"upload_time_iso_8601": "2023-03-21T17:54:33.215808Z",
"url": "https://files.pythonhosted.org/packages/ed/a1/69058aeca5bb5c4d4898a860785e6100b0a971e5403f3148207893840bff/cutevariant-0.4.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "50391f65cec1cd3cd638f739d0630d5043bbd88d0fdd452912c097f029b53cb9",
"md5": "27e6e7a38956261620089d4d3139b1e8",
"sha256": "8ab4912f74e926c2c84e6e33c0204ae2466500102aacf7252714826cd3699440"
},
"downloads": -1,
"filename": "cutevariant-0.4.5.tar.gz",
"has_sig": false,
"md5_digest": "27e6e7a38956261620089d4d3139b1e8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1117963,
"upload_time": "2023-03-21T17:54:36",
"upload_time_iso_8601": "2023-03-21T17:54:36.924324Z",
"url": "https://files.pythonhosted.org/packages/50/39/1f65cec1cd3cd638f739d0630d5043bbd88d0fdd452912c097f029b53cb9/cutevariant-0.4.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-21 17:54:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "labsquare",
"github_project": "cutevariant",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"appveyor": true,
"lcname": "cutevariant"
}
JSON
