<div align="center">
# SCEPTR
[](https://pypi.org/p/sceptr)
[](https://sceptr.readthedocs.io)
[](https://github.com/yutanagano/sceptr?tab=MIT-1-ov-file#readme)
### Check out the [documentation page](https://sceptr.readthedocs.io).
</div>
**SCEPTR** (**S**imple **C**ontrastive **E**mbedding of the **P**rimary sequence of **T** cell **R**eceptors) is a small, fast, and accurate TCR representation model that can be used for alignment-free TCR analysis, including for TCR-pMHC interaction prediction and TCR clustering (metaclonotype discovery).
Our [preprint](https://arxiv.org/abs/2406.06397) demonstrates that SCEPTR can be used for few-shot TCR specificity prediction with improved accuracy over previous methods.
SCEPTR is a BERT-like transformer-based neural network implemented in [Pytorch](https://pytorch.org).
With the default model providing best-in-class performance with only 153,108 parameters (typical protein language models have tens or hundreds of millions), SCEPTR runs fast- even on a CPU!
And if your computer does have a [CUDA-enabled GPU](https://en.wikipedia.org/wiki/CUDA), the sceptr package will automatically detect and use it, giving you blazingly fast performance without the hassle.
sceptr's API exposes three intuitive functions: `calc_vector_representations`, `calc_cdist_matrix`, and `calc_pdist_vector`- and it's all you need to make full use of the SCEPTR models.
What's even better is that they are fully compliant with [pyrepseq](https://pyrepseq.readthedocs.io)'s [tcr_metric](https://pyrepseq.readthedocs.io/en/latest/api.html#pyrepseq.metric.tcr_metric.TcrMetric) API, so sceptr will fit snugly into the rest of your repertoire analysis workflow.
## Installation
```bash
pip install sceptr
```
Raw data
{
"_id": null,
"home_page": null,
"name": "sceptr",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "Yuta Nagano <yutanagano51@proton.me>",
"keywords": "TCR, TR, T cell, transformer, bert, MLM, immunology, bioinformatics",
"author": null,
"author_email": "Yuta Nagano <yutanagano51@proton.me>",
"download_url": "https://files.pythonhosted.org/packages/c1/f8/6f09714de627e97bae45fc30cd5a09a5c8189a63981c081a6a20feb74d13/sceptr-1.0.1.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n# SCEPTR\n\n[](https://pypi.org/p/sceptr)\n\n[](https://sceptr.readthedocs.io)\n[](https://github.com/yutanagano/sceptr?tab=MIT-1-ov-file#readme)\n\n### Check out the [documentation page](https://sceptr.readthedocs.io).\n\n</div>\n\n**SCEPTR** (**S**imple **C**ontrastive **E**mbedding of the **P**rimary sequence of **T** cell **R**eceptors) is a small, fast, and accurate TCR representation model that can be used for alignment-free TCR analysis, including for TCR-pMHC interaction prediction and TCR clustering (metaclonotype discovery).\nOur [preprint](https://arxiv.org/abs/2406.06397) demonstrates that SCEPTR can be used for few-shot TCR specificity prediction with improved accuracy over previous methods.\n\nSCEPTR is a BERT-like transformer-based neural network implemented in [Pytorch](https://pytorch.org).\nWith the default model providing best-in-class performance with only 153,108 parameters (typical protein language models have tens or hundreds of millions), SCEPTR runs fast- even on a CPU!\nAnd if your computer does have a [CUDA-enabled GPU](https://en.wikipedia.org/wiki/CUDA), the sceptr package will automatically detect and use it, giving you blazingly fast performance without the hassle.\n\nsceptr's API exposes three intuitive functions: `calc_vector_representations`, `calc_cdist_matrix`, and `calc_pdist_vector`- and it's all you need to make full use of the SCEPTR models.\nWhat's even better is that they are fully compliant with [pyrepseq](https://pyrepseq.readthedocs.io)'s [tcr_metric](https://pyrepseq.readthedocs.io/en/latest/api.html#pyrepseq.metric.tcr_metric.TcrMetric) API, so sceptr will fit snugly into the rest of your repertoire analysis workflow.\n\n## Installation\n\n```bash\npip install sceptr\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Fast and performant TCR representation model",
"version": "1.0.1",
"project_urls": {
"Documentation": "https://sceptr.readthedocs.io",
"Homepage": "https://sceptr.readthedocs.io",
"Issues": "https://github.com/yutanagano/sceptr/issues",
"Repository": "https://github.com/yutanagano/sceptr"
},
"split_keywords": [
"tcr",
" tr",
" t cell",
" transformer",
" bert",
" mlm",
" immunology",
" bioinformatics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "72a3274571eccb91393a1208f3ec6ba9f1089f4e0609a530e8851d860d4a9beb",
"md5": "49a2a6605175ad3e02c6caf167155223",
"sha256": "c827d462f68734deebe3e7fcc82d3898dce7b91e85ef7e47a6e1be8f2416ff83"
},
"downloads": -1,
"filename": "sceptr-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "49a2a6605175ad3e02c6caf167155223",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 10699782,
"upload_time": "2024-06-11T12:20:19",
"upload_time_iso_8601": "2024-06-11T12:20:19.819463Z",
"url": "https://files.pythonhosted.org/packages/72/a3/274571eccb91393a1208f3ec6ba9f1089f4e0609a530e8851d860d4a9beb/sceptr-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c1f86f09714de627e97bae45fc30cd5a09a5c8189a63981c081a6a20feb74d13",
"md5": "b7720fea9319347ac12baf3ceabd23e1",
"sha256": "ce8f1bb6b510a54f19e363db41a7aac50d864df1dea4bdc43df8df661491192d"
},
"downloads": -1,
"filename": "sceptr-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "b7720fea9319347ac12baf3ceabd23e1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 10701232,
"upload_time": "2024-06-11T12:20:22",
"upload_time_iso_8601": "2024-06-11T12:20:22.874337Z",
"url": "https://files.pythonhosted.org/packages/c1/f8/6f09714de627e97bae45fc30cd5a09a5c8189a63981c081a6a20feb74d13/sceptr-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-11 12:20:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yutanagano",
"github_project": "sceptr",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "sceptr"
}
JSON
