SONIA
This Package is not actively mantained, please refer to the most updated SoNNia package which includes sonia models as well: https://github.com/statbiophys/soNNia
SONIA is a python 3.6/2.7 software developed to infer selection pressures on features of amino acid CDR3 sequences. The inference is based on maximizing the likelihood of observing a selected data sample given a representative pre-selected sample. This method was first used in Elhanati et al (2014) to study thymic selection. For this purpose, the pre-selected sample can be generated internally using the OLGA software package, but SONIA allows it also to be supplied externally, in the same way the data sample is provided.
SONIA takes as input TCR CDR3 amino acid sequences, with or without per sequence lists of possible V and J genes suspected to be used in the recombination process for this sequence. Its output is selection factors for each amino acid ,(relative) position , CDR3 length combinations, and also for each V and J gene choice. These selection factors can be used to calculate sequence level selection factors which indicate how more or less represented this sequence would be in the selected pool as compared to the the pre-selected pool. These in turn could be used to calculate the probability to observe any sequence after selection and sample from the selected repertoire.
Version
Latest released version: 0.2.2
Installation
SONIA is a python 2.7/3.6 software. It is available on PyPI and can be downloaded and installed through pip:
pip install sonia.
SONIA is also available on GitHub.
Sometimes pip fails to install the dependencies correctly. Thus, if you get any error try first to install the dependencies separately:
pip install tensorflow
pip install matplotlib
pip install olga
pip install sonia
For mac user on new metal devices, make sure to install additional dependencies. Currently, the configuration tensorflow-macos==2.9 and tensorflow-metal==0.5.0 should work.
References
- Sethna Z, Isacchini G, Dupic T, Mora T, Walczak AM, Elhanati Y, Population variability in the generation and thymic selection of T-cell repertoires, (2020) bioRxiv, https://doi.org/10.1101/2020.01.08.899682
- Isacchini G, Sethna Z, Elhanati Y ,Nourmohammad A, Mora T, Walczak AM, Generative models of T-cell receptor sequences, (2020) Phys. Rev. E 101, 062414, https://journals.aps.org/pre/abstract/10.1103/PhysRevE.101.062414
- Elhanati Y, Murugan A , Callan CGJ , Mora T , Walczak AM, Quantifying selection in immune receptor repertoires, PNAS July 8, 2014 111 (27) 9875-9880, https://doi.org/10.1073/pnas.1409572111
Documentation
Extensive documentation can be found here
Contact
Any issues or questions should be addressed to us.
License
Free use of SONIA is granted under the terms of the GNU General Public License version 3 (GPLv3).
1 maintainer
Release files for sonia 0.2.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sonia-0.2.2.tar.gz | 851.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sonia-0.2.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.7 MB
Release files / sonia-0.2.2.tar.gz
| Download URL | sonia-0.2.2.tar.gz |
|---|---|
| Size | 851.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
07134f662a5b0efacb75e6b1f94a7b43b75217d3fda077ef784a3d0cb4ab5201
|
|
BLAKE2b-256 checksum How to use checksums |
87b46b4001e7059e45a69369ea792bd21f398315ba77965f3b1c323cce15572e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.10.6
|
Release files / sonia-0.2.2-py3-none-any.whl
| Download URL | sonia-0.2.2-py3-none-any.whl |
|---|---|
| Size | 854.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6fa6b354c377659b0f342ee8c37343dc531135a6b552385564ca45f3fb47858d
|
|
BLAKE2b-256 checksum How to use checksums |
f4be305132bc4674c181e06cce5ab3b681b05e6c927e2b221045e4728ae587ff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.10.6
|
