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)

This is a fork of the original Codon Adaptation Index 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

An implementation of Sharp and Li's 1987 formulation of the codon adaption 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:

>>> 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 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.

To contribute to the project, please create a pull request.

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

@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.

For matters related to the original project, Benjamin Lee is available at 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.