# LanceOTron CLI
[](https://badge.fury.io/py/lanceotron) [](https://pepy.tech/project/lanceotron) [](https://circleci.com/gh/Chris1221/lanceotron/tree/main) [](https://codecov.io/gh/Chris1221/lanceotron)
A bare-bones interface to the trained LanceOTron (LoT) model from the command line.
## Installation
```{sh}
pip install lanceotron
```
### Local installation
1. Clone the repository.
2. Install dependencies with pip.
3. Install the package.
4. Run tests to ensure that everything is working.
```{sh}
git clone git@github.com:Chris1221/lanceotron.git; cd lanceotron # Step 1
pip install -r requirements.txt # Step 2
pip install -e . # Step 3
python -m unittest
```
## Usage
To see available commands, use the `--help` flag.
```
lanceotron --help
```
## Call Peaks
To call peaks from a bigWig track, use the `callPeaks` command.
| Option | Description | Default |
|-----------------|--------------------------------------------------------|---------|
| file | BigWig Track to analyse | |
| -t, --threshold | Threshold for selecting candidate peaks | 4 |
| -w, --window | Window size for rolling mean to select candidate peaks | 400 |
| -f, --folder | Output folder | "./" |
| --skipheader | Skip writing the header | False |
## Call Peaks with Input
To call peaks from a bigWig track with an input file, use the `callPeaks_Input` command.
| Option | Description | Default |
|-----------------|--------------------------------------------------------|---------|
| file | BigWig track to analyse | |
| -i, --input | Control input track to calculate significance of peaks | |
| -t, --threshold | Threshold for selecting candidate peaks | 4 |
| -w, --window | Window size for rolling mean to select candidate peaks | 400 |
| -f, --folder | Output folder | "./" |
| --skipheader | Skip writing the header | False |
## Score a Bed file
To score the peaks in an existing Bed file, use the `scoreBed` command.
| Option | Description | Default |
|-----------------|--------------------------------------------------------|---------|
| file | BigWig Track to analyse | |
| -b, --bed | Bed file of regions to be scored | |
| -f, --folder | Output folder | "./" |
| --skipheader | Skip writing the header | False |
## Examples
There is a basic bigWig file included in the `test` subdirectory. To try out the caller, execute it on this file.
```sh
lanceotron callPeaks test/chr22.bw -f output_folder
```
## Citation
```{bibtex}
@article {Hentges2021.01.25.428108,
author = {Hentges, Lance D. and Sergeant, Martin J. and Downes, Damien J. and Hughes, Jim R. and Taylor, Stephen},
title = {LanceOtron: a deep learning peak caller for ATAC-seq, ChIP-seq, and DNase-seq},
year = {2021},
doi = {10.1101/2021.01.25.428108},
publisher = {Cold Spring Harbor Laboratory},
URL = {https://www.biorxiv.org/content/early/2021/01/27/2021.01.25.428108},
journal = {bioRxiv}
}
```
## Building the documentation
To serve the documentation locally, use
```
python -m mkdocs serve
```
## Bug Reports and Improvement Suggestions
Please [raise an issue](https://github.com/Chris1221/lanceotron/issues/new/choose) if there is anything you wish to ask or contribute.
Raw data
{
"_id": null,
"home_page": "",
"name": "lanceotron",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "deep learning,peak calling,keras",
"author": "Chris Cole, Lance Hentges, Simone G. Riva",
"author_email": "simo.riva15@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/0c/82/48776f35fc6ff5c4d4e7d65d33b993784f4d904fb56085d48228ae7c603b/lanceotron-1.2.6.tar.gz",
"platform": null,
"description": "# LanceOTron CLI\n\n[](https://badge.fury.io/py/lanceotron) [](https://pepy.tech/project/lanceotron) [](https://circleci.com/gh/Chris1221/lanceotron/tree/main) [](https://codecov.io/gh/Chris1221/lanceotron)\n\nA bare-bones interface to the trained LanceOTron (LoT) model from the command line.\n\n## Installation\n\n```{sh}\npip install lanceotron\n```\n\n### Local installation \n\n1. Clone the repository.\n2. Install dependencies with pip.\n3. Install the package.\n4. Run tests to ensure that everything is working.\n\n```{sh}\ngit clone git@github.com:Chris1221/lanceotron.git; cd lanceotron # Step 1\npip install -r requirements.txt # Step 2\npip install -e . # Step 3\npython -m unittest\n```\n\n## Usage\n\nTo see available commands, use the `--help` flag.\n\n```\nlanceotron --help\n```\n\n## Call Peaks\n\nTo call peaks from a bigWig track, use the `callPeaks` command.\n\n| Option | Description | Default |\n|-----------------|--------------------------------------------------------|---------|\n| file | BigWig Track to analyse | |\n| -t, --threshold | Threshold for selecting candidate peaks | 4 |\n| -w, --window | Window size for rolling mean to select candidate peaks | 400 |\n| -f, --folder | Output folder | \"./\" |\n| --skipheader | Skip writing the header | False |\n\n\n## Call Peaks with Input\n\nTo call peaks from a bigWig track with an input file, use the `callPeaks_Input` command.\n\n| Option | Description | Default |\n|-----------------|--------------------------------------------------------|---------|\n| file | BigWig track to analyse | |\n| -i, --input | Control input track to calculate significance of peaks | |\n| -t, --threshold | Threshold for selecting candidate peaks | 4 |\n| -w, --window | Window size for rolling mean to select candidate peaks | 400 |\n| -f, --folder | Output folder | \"./\" |\n| --skipheader | Skip writing the header | False |\n\n## Score a Bed file\n\nTo score the peaks in an existing Bed file, use the `scoreBed` command.\n\n| Option | Description | Default |\n|-----------------|--------------------------------------------------------|---------|\n| file | BigWig Track to analyse | |\n| -b, --bed | Bed file of regions to be scored | |\n| -f, --folder | Output folder | \"./\" |\n| --skipheader | Skip writing the header | False |\n\n\n## Examples\n\nThere is a basic bigWig file included in the `test` subdirectory. To try out the caller, execute it on this file. \n\n```sh\nlanceotron callPeaks test/chr22.bw -f output_folder\n```\n\n## Citation\n\n```{bibtex}\n@article {Hentges2021.01.25.428108,\n\tauthor = {Hentges, Lance D. and Sergeant, Martin J. and Downes, Damien J. and Hughes, Jim R. and Taylor, Stephen},\n\ttitle = {LanceOtron: a deep learning peak caller for ATAC-seq, ChIP-seq, and DNase-seq},\n\tyear = {2021},\n\tdoi = {10.1101/2021.01.25.428108},\n\tpublisher = {Cold Spring Harbor Laboratory},\n\tURL = {https://www.biorxiv.org/content/early/2021/01/27/2021.01.25.428108},\n\tjournal = {bioRxiv}\n}\n```\n\n## Building the documentation\n\nTo serve the documentation locally, use\n\n```\npython -m mkdocs serve\n```\n\n## Bug Reports and Improvement Suggestions\n\nPlease [raise an issue](https://github.com/Chris1221/lanceotron/issues/new/choose) if there is anything you wish to ask or contribute. \n",
"bugtrack_url": null,
"license": "",
"summary": "Command-line interface to the lanceotron deep learning peak caller",
"version": "1.2.6",
"project_urls": {
"Bug Tracker": "https://github.com/LHentges/lanceotron/issues",
"Source": "https://github.com/LHentges/lanceotron"
},
"split_keywords": [
"deep learning",
"peak calling",
"keras"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "da5c41d6e906015106797f35dfbc54a994f86ad630b2f623b968674e90e04e1a",
"md5": "fc936253460baef975674bdb1e205069",
"sha256": "5b1f79a0ca4e893d3510937fa319eb48e80099b9622898469fb1d77a69651f56"
},
"downloads": -1,
"filename": "lanceotron-1.2.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fc936253460baef975674bdb1e205069",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 1600992,
"upload_time": "2023-05-19T08:14:02",
"upload_time_iso_8601": "2023-05-19T08:14:02.683449Z",
"url": "https://files.pythonhosted.org/packages/da/5c/41d6e906015106797f35dfbc54a994f86ad630b2f623b968674e90e04e1a/lanceotron-1.2.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0c8248776f35fc6ff5c4d4e7d65d33b993784f4d904fb56085d48228ae7c603b",
"md5": "045b6e13da072228155b34ff3387b3d4",
"sha256": "e1e0be325c88b4bf44564a3720d24ecac6c32a406ba9a47ef640c51f1f638087"
},
"downloads": -1,
"filename": "lanceotron-1.2.6.tar.gz",
"has_sig": false,
"md5_digest": "045b6e13da072228155b34ff3387b3d4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 1603877,
"upload_time": "2023-05-19T08:14:24",
"upload_time_iso_8601": "2023-05-19T08:14:24.683225Z",
"url": "https://files.pythonhosted.org/packages/0c/82/48776f35fc6ff5c4d4e7d65d33b993784f4d904fb56085d48228ae7c603b/lanceotron-1.2.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-19 08:14:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "LHentges",
"github_project": "lanceotron",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"circle": true,
"lcname": "lanceotron"
}
JSON
