CAI-PyPI: An updated version of the Codon Adaptation Index (CAI) package
This package is based on the original CAI project by Benjamin Lee (https://github.com/Benjamin-Lee/CodonAdaptationIndex). It has been updated to resolve compatibility issues with PyPI and ensure the latest version is easily accessible via pip. While maintaining the core functionality of the original project, this version aims to provide a smoother installation process and better integration with PyPI.
Original README:
# Python Codon Adaptation Index (CAI-PyPI)
![PyPI](https://img.shields.io/pypi/v/CAI-PyPI.svg)
This is a fork of the original [Codon Adaptation Index](https://github.com/Benjamin-Lee/CodonAdaptationIndex) project by Benjamin Lee. It has been updated to resolve compatibility issues with PyPI and ensure the latest version is easily accessible via pip.
## Original Project Information
![DOI](http://joss.theoj.org/papers/8adf6bd9fd6391d5343d15ea0b6b6525/status.svg)
![Docs](https://readthedocs.org/projects/cai/badge/?version=latest)
![CodeFactor](https://www.codefactor.io/repository/github/benjamin-lee/codonadaptationindex/badge/master)
An implementation of [Sharp and Li's 1987 formulation](https://www.ncbi.nlm.nih.gov/pmc/articles/PMC340524/pdf/nar00247-0410.pdf) of the [codon adaption index](https://en.wikipedia.org/wiki/Codon_Adaptation_Index).
## Why This Fork?
The original CAI package had some issues with PyPI compatibility, making it difficult for users to install via pip. This fork (CAI-PyPI) addresses these issues, providing a smoother installation process and better integration with PyPI. While maintaining the core functionality of the original project, CAI-PyPI ensures that users can easily access and use the latest version of the Codon Adaptation Index implementation.
## Installation
### Installing CAI-PyPI (Recommended)
This forked version is available from PyPI and can be downloaded with the following command:
```
$ pip install CAI-PyPI
```
### Installing the Original CAI (For Reference)
The original module is available from PyPI and can be downloaded with the following command:
```
$ pip install CAI
```
To install the latest development version of the original project:
```
$ pip install git+https://github.com/Benjamin-Lee/CodonAdaptationIndex.git
```
## Quickstart
Finding the CAI of a sequence is easy:
```python
>>> from CAI import CAI
>>> CAI("ATG...", reference=["ATGTTT...", "ATGCGC...",...])
0.24948128951724224
```
Similarly, from the command line:
```
$ CAI -s sequence.fasta -r reference_sequences.fasta
0.24948128951724224
```
Determining which sequences to use as the reference set is left to the user, though the [HEG-DB](http://genomes.urv.cat/HEG-DB/) is a great resource of highly expressed genes.
## Contributing and Getting Support
If you encounter any issues using CAI-PyPI, feel free to [create an issue](https://github.com/Adibvafa/CodonAdaptationIndex/issues).
To contribute to the project, please [create a pull request](https://github.com/Adibvafa/CodonAdaptationIndex/pulls).
## Citation
If you use this software in your work, please cite the original paper:
Lee, B. D. (2018). Python Implementation of Codon Adaptation Index. *Journal of Open Source Software, 3*(30), 905. [https://doi.org/10.21105/joss.00905](https://doi.org/10.21105/joss.00905)
```bibtex
@article{Lee2018,
doi = {10.21105/joss.00905},
url = {https://doi.org/10.21105/joss.00905},
year = {2018},
month = {oct},
publisher = {The Open Journal},
volume = {3},
number = {30},
pages = {905},
author = {Benjamin D. Lee},
title = {Python Implementation of Codon Adaptation Index},
journal = {Journal of Open Source Software}
}
```
## Contact
For issues related to this fork (CAI-PyPI), please contact Adibvafa Fallahpour at [Adibvafafallahpour@gmail.com](mailto:Adibvafafallahpour@gmail.com).
For matters related to the original project, Benjamin Lee is available at [benjamin_lee@college.harvard.edu](mailto:benjamin_lee@college.harvard.edu).
## Reference
```
Sharp, P. M., & Li, W. H. (1987). The codon adaptation index--a measure of directional synonymous codon usage bias, and its potential applications. *Nucleic Acids Research*, 15(3), 1281–1295.
```
Raw data
{
"_id": null,
"home_page": "https://github.com/Adibvafa/CodonAdaptationIndex",
"name": "CAI-PyPI",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "bioinformatics codon adaptation index genetics PyPI",
"author": "Adibvafa Fallahpour",
"author_email": "Adibvafafallahpour@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/f7/8a/8af8e49d0fc57ec662db7d425e3054f77f89faaa97459b68dfd25fdd7090/CAI-PyPI-2.0.1.tar.gz",
"platform": null,
"description": "CAI-PyPI: An updated version of the Codon Adaptation Index (CAI) package\r\n\r\nThis package is based on the original CAI project by Benjamin Lee (https://github.com/Benjamin-Lee/CodonAdaptationIndex). It has been updated to resolve compatibility issues with PyPI and ensure the latest version is easily accessible via pip. While maintaining the core functionality of the original project, this version aims to provide a smoother installation process and better integration with PyPI.\r\n\r\nOriginal README:\r\n\r\n# Python Codon Adaptation Index (CAI-PyPI)\r\n\r\n![PyPI](https://img.shields.io/pypi/v/CAI-PyPI.svg)\r\n\r\nThis is a fork of the original [Codon Adaptation Index](https://github.com/Benjamin-Lee/CodonAdaptationIndex) project by Benjamin Lee. It has been updated to resolve compatibility issues with PyPI and ensure the latest version is easily accessible via pip.\r\n\r\n## Original Project Information\r\n\r\n![DOI](http://joss.theoj.org/papers/8adf6bd9fd6391d5343d15ea0b6b6525/status.svg)\r\n![Docs](https://readthedocs.org/projects/cai/badge/?version=latest)\r\n![CodeFactor](https://www.codefactor.io/repository/github/benjamin-lee/codonadaptationindex/badge/master)\r\n\r\nAn implementation of [Sharp and Li's 1987 formulation](https://www.ncbi.nlm.nih.gov/pmc/articles/PMC340524/pdf/nar00247-0410.pdf) of the [codon adaption index](https://en.wikipedia.org/wiki/Codon_Adaptation_Index).\r\n\r\n## Why This Fork?\r\n\r\nThe original CAI package had some issues with PyPI compatibility, making it difficult for users to install via pip. This fork (CAI-PyPI) addresses these issues, providing a smoother installation process and better integration with PyPI. While maintaining the core functionality of the original project, CAI-PyPI ensures that users can easily access and use the latest version of the Codon Adaptation Index implementation.\r\n\r\n## Installation\r\n\r\n### Installing CAI-PyPI (Recommended)\r\n\r\nThis forked version is available from PyPI and can be downloaded with the following command:\r\n\r\n```\r\n$ pip install CAI-PyPI\r\n```\r\n\r\n### Installing the Original CAI (For Reference)\r\n\r\nThe original module is available from PyPI and can be downloaded with the following command:\r\n\r\n```\r\n$ pip install CAI\r\n```\r\n\r\nTo install the latest development version of the original project:\r\n\r\n```\r\n$ pip install git+https://github.com/Benjamin-Lee/CodonAdaptationIndex.git\r\n```\r\n\r\n## Quickstart\r\n\r\nFinding the CAI of a sequence is easy:\r\n\r\n```python\r\n>>> from CAI import CAI\r\n>>> CAI(\"ATG...\", reference=[\"ATGTTT...\", \"ATGCGC...\",...])\r\n0.24948128951724224\r\n```\r\n\r\nSimilarly, from the command line:\r\n\r\n```\r\n$ CAI -s sequence.fasta -r reference_sequences.fasta\r\n0.24948128951724224\r\n```\r\n\r\nDetermining which sequences to use as the reference set is left to the user, though the [HEG-DB](http://genomes.urv.cat/HEG-DB/) is a great resource of highly expressed genes.\r\n\r\n## Contributing and Getting Support\r\n\r\nIf you encounter any issues using CAI-PyPI, feel free to [create an issue](https://github.com/Adibvafa/CodonAdaptationIndex/issues).\r\n\r\nTo contribute to the project, please [create a pull request](https://github.com/Adibvafa/CodonAdaptationIndex/pulls).\r\n\r\n## Citation\r\n\r\nIf you use this software in your work, please cite the original paper:\r\n\r\nLee, B. D. (2018). Python Implementation of Codon Adaptation Index. *Journal of Open Source Software, 3*(30), 905. [https://doi.org/10.21105/joss.00905](https://doi.org/10.21105/joss.00905)\r\n\r\n```bibtex\r\n@article{Lee2018,\r\n doi = {10.21105/joss.00905},\r\n url = {https://doi.org/10.21105/joss.00905},\r\n year = {2018},\r\n month = {oct},\r\n publisher = {The Open Journal},\r\n volume = {3},\r\n number = {30},\r\n pages = {905},\r\n author = {Benjamin D. Lee},\r\n title = {Python Implementation of Codon Adaptation Index},\r\n journal = {Journal of Open Source Software}\r\n}\r\n```\r\n\r\n## Contact\r\n\r\nFor issues related to this fork (CAI-PyPI), please contact Adibvafa Fallahpour at [Adibvafafallahpour@gmail.com](mailto:Adibvafafallahpour@gmail.com).\r\n\r\nFor matters related to the original project, Benjamin Lee is available at [benjamin_lee@college.harvard.edu](mailto:benjamin_lee@college.harvard.edu).\r\n\r\n## Reference\r\n```\r\nSharp, P. M., & Li, W. H. (1987). The codon adaptation index--a measure of directional synonymous codon usage bias, and its potential applications. *Nucleic Acids Research*, 15(3), 1281\u20131295.\r\n```\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python implementation of codon adaptation index, updated for PyPI compatibility",
"version": "2.0.1",
"project_urls": {
"Bug Reports": "https://github.com/Adibvafa/CodonAdaptationIndex/issues",
"Homepage": "https://github.com/Adibvafa/CodonAdaptationIndex",
"Original Project": "https://github.com/Benjamin-Lee/CodonAdaptationIndex",
"Source": "https://github.com/Adibvafa/CodonAdaptationIndex"
},
"split_keywords": [
"bioinformatics",
"codon",
"adaptation",
"index",
"genetics",
"pypi"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d597ba5ce417199b1457adc092454886cbeef6dd3cf04a58305e378a508ffa08",
"md5": "f0d2161ee14a7dc50802454610610afc",
"sha256": "6d72c1a75973e38b3c3a20b35c5db75c06f97741182fc4fe4fa24b963a5f2668"
},
"downloads": -1,
"filename": "CAI_PyPI-2.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f0d2161ee14a7dc50802454610610afc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 8062,
"upload_time": "2024-07-28T16:09:26",
"upload_time_iso_8601": "2024-07-28T16:09:26.111282Z",
"url": "https://files.pythonhosted.org/packages/d5/97/ba5ce417199b1457adc092454886cbeef6dd3cf04a58305e378a508ffa08/CAI_PyPI-2.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f78a8af8e49d0fc57ec662db7d425e3054f77f89faaa97459b68dfd25fdd7090",
"md5": "cce7432a155359de27021360dd59c605",
"sha256": "88c2340f8a30579fb9c48708c7bda32516abd05d2be71a57e382a4b82c92010a"
},
"downloads": -1,
"filename": "CAI-PyPI-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "cce7432a155359de27021360dd59c605",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 12274,
"upload_time": "2024-07-28T16:09:27",
"upload_time_iso_8601": "2024-07-28T16:09:27.245362Z",
"url": "https://files.pythonhosted.org/packages/f7/8a/8af8e49d0fc57ec662db7d425e3054f77f89faaa97459b68dfd25fdd7090/CAI-PyPI-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-28 16:09:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Adibvafa",
"github_project": "CodonAdaptationIndex",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "scipy",
"specs": [
[
">=",
"1.7.1"
]
]
},
{
"name": "biopython",
"specs": [
[
">=",
"1.79"
]
]
},
{
"name": "click",
"specs": [
[
">=",
"7"
]
]
}
],
"lcname": "cai-pypi"
}