# VaxPress
VaxPress is a codon optimizer platform tailored for mRNA vaccine
development. It refines coding sequences starting from protein or
RNA sequences to boost both storage stability and *in vivo* protein
expression. Plus, additional properties can be easily programmed
into the optimization process with just a few lines of code via a
pluggable interface. For the detailed information about VaxPress,
including its options and algorithmic features, please refer to the
[VaxPress documentation page](https://vaxpress.readthedocs.io/).
# Installation
### pip
You can install VaxPress via pip.
#### Installing
```bash
# Create a virtual environment for VaxPress
python -m venv /path/to/vaxpress-env
# Activate the virtual environment
source /path/to/vaxpress-env/bin/activate
# Install VaxPress alone
pip install vaxpress
# Alternatively, install VaxPress with LinearFold (only for non-commercial uses)
pip install 'vaxpress[nonfree]'
```
#### Running
```bash
# Activate the virtual environment
source /path/to/vaxpress-env/bin/activate
# Run VaxPress
vaxpress -h
```
#### iCodon Dependency
If you wish to activate the iCodon predicted stability
(`--iCodon-weight`) in the fitness function, ensure you have
working installations of *R,* *rpy2* (version >= 3.0) and
*iCodon.* For detailed installation instructions, visit
[iCodon's GitHub page](https://github.com/santiago1234/iCodon/).
### Conda
Alternatively, you may also install VaxPress via a conda package:
#### Installation
```bash
conda create -n vaxpress -y -c changlabsnu -c bioconda -c conda-forge vaxpress
```
#### Running
```bash
# Activate the environment
conda activate vaxpress
# Run VaxPress
vaxpress -h
```
### Singularity
To run VaxPress via Singularity, you will need to install the
[Singularity CE](https://sylabs.io/singularity/) first.
Download the container image from
[the GitHub project page](https://github.com/ChangLabSNU/VaxPress/releases)
and place it in a directory of your choice.
```bash
singularity vaxpress.sif -h
```
When using the Singularity image, both the input and output must
be somewhere inside your home directory for VaxPress to run without
complicated directory binding configurations for Singularity.
# Usage
## Quick Start
Here's a basic command-line instruction to start using VaxPress.
Note that `-i` and `-o` options are mandatory:
```bash
vaxpress -i spike.fa -o output --iterations 1000 -p 32
```
### Input
VaxPress requires a FASTA format input file that contains the CDS
(CoDing Sequence) to be optimized. In case the FASTA file holds a
protein sequence, the additional `--protein` switch is required.
### Number of Iterations
The `--iterations` option is set to `10` by default. However,
for thorough optimization, it's recommended to use at least `500`
iterations. The optimal number of iterations may differ depending
on the length, composition of the input, and the selected optimization
settings. It's important to note that the optimization process may
stop before completing all the specified iterations if no progress
is observed over several consecutive cycles. Guidelines for setting
the appropriate number of iterations and other optimization parameters
can be found in the
[Tuning Optimization Parameters](https://vaxpress.readthedocs.io/en/latest/user_guides.html#tuning-parameters)
section.
You can set `--iterations` to `0` to generate VaxPress's sequence
evaluation report without any optimization.
### Multi-Core Support
You can use multiple CPU cores for optimization with the `-p` or
`--processes` option.
### More About Options
VaxPress offers the flexibility to adjust optimization strategies
in detail and integrate with LinearDesign. It also allows several
more convenient functions such as preset parameters, user-defined
custom scoring functions, and etc. For comprehensive explanation,
please refer to [the manual](https://vaxpress.readthedocs.io/en/latest/).
## Output
Once you've run VaxPress, the specified output directory will contain
the following five files:
- ``report.html``: A summary report detailing the result and
optimization process.
- ``best-sequence.fasta``: The refined coding sequence.
- ``checkpoints.tsv``: The best sequences and the evaluation results
at each iteration.
- ``log.txt``: Contains the logs that were displayed in the console.
- ``parameters.json``: Contains the parameters employed for the optimization.
This file can be feeded to VaxPress with the `--preset` option to duplicate
the set-up for other sequence.
# Citing VaxPress
If you employed our software in your research, please
kindly reference our publication:
Ju, Ku, and Chang (2023) Title. Journal. Volume. (in preparation)
# License
VaxPress is distributed under the terms of the [MIT License](LICENSE.txt).
LinearFold and LinearDesign are licensed for non-commercial use
only. If considering commercial use, be cautious about using options
such as `--lineardesign` and `--folding-engine linearfold`.
Raw data
{
"_id": null,
"home_page": "https://github.com/ChangLabSNU/VaxPress",
"name": "vaxpress",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "mRNA vaccine,messenger RNA,codon optimization",
"author": "Hyeshik Chang",
"author_email": "hyeshik@snu.ac.kr",
"download_url": "https://files.pythonhosted.org/packages/43/31/acec3427630c9f0c1d88723b317b7be4a6b5fb26b22aee25f0d519bdfc75/vaxpress-0.9.tar.gz",
"platform": null,
"description": "# VaxPress\n\nVaxPress is a codon optimizer platform tailored for mRNA vaccine\ndevelopment. It refines coding sequences starting from protein or\nRNA sequences to boost both storage stability and *in vivo* protein\nexpression. Plus, additional properties can be easily programmed\ninto the optimization process with just a few lines of code via a\npluggable interface. For the detailed information about VaxPress,\nincluding its options and algorithmic features, please refer to the\n[VaxPress documentation page](https://vaxpress.readthedocs.io/).\n\n# Installation\n\n### pip\n\nYou can install VaxPress via pip.\n\n#### Installing\n\n```bash\n# Create a virtual environment for VaxPress\npython -m venv /path/to/vaxpress-env\n\n# Activate the virtual environment\nsource /path/to/vaxpress-env/bin/activate\n\n# Install VaxPress alone\npip install vaxpress\n\n# Alternatively, install VaxPress with LinearFold (only for non-commercial uses)\npip install 'vaxpress[nonfree]'\n```\n\n#### Running\n\n```bash\n# Activate the virtual environment\nsource /path/to/vaxpress-env/bin/activate\n\n# Run VaxPress\nvaxpress -h\n```\n\n#### iCodon Dependency\n\nIf you wish to activate the iCodon predicted stability\n(`--iCodon-weight`) in the fitness function, ensure you have\nworking installations of *R,* *rpy2* (version >= 3.0) and\n*iCodon.* For detailed installation instructions, visit\n[iCodon's GitHub page](https://github.com/santiago1234/iCodon/).\n\n### Conda\n\nAlternatively, you may also install VaxPress via a conda package:\n\n#### Installation\n\n```bash\nconda create -n vaxpress -y -c changlabsnu -c bioconda -c conda-forge vaxpress\n```\n\n#### Running\n\n```bash\n# Activate the environment\nconda activate vaxpress\n\n# Run VaxPress\nvaxpress -h\n```\n\n### Singularity\n\nTo run VaxPress via Singularity, you will need to install the\n[Singularity CE](https://sylabs.io/singularity/) first.\nDownload the container image from\n[the GitHub project page](https://github.com/ChangLabSNU/VaxPress/releases)\nand place it in a directory of your choice.\n\n```bash\nsingularity vaxpress.sif -h\n```\n\nWhen using the Singularity image, both the input and output must\nbe somewhere inside your home directory for VaxPress to run without\ncomplicated directory binding configurations for Singularity.\n\n# Usage\n\n## Quick Start\n\nHere's a basic command-line instruction to start using VaxPress.\nNote that `-i` and `-o` options are mandatory:\n\n```bash\nvaxpress -i spike.fa -o output --iterations 1000 -p 32\n```\n\n### Input\n\nVaxPress requires a FASTA format input file that contains the CDS\n(CoDing Sequence) to be optimized. In case the FASTA file holds a\nprotein sequence, the additional `--protein` switch is required.\n\n### Number of Iterations\n\nThe `--iterations` option is set to `10` by default. However,\nfor thorough optimization, it's recommended to use at least `500`\niterations. The optimal number of iterations may differ depending\non the length, composition of the input, and the selected optimization\nsettings. It's important to note that the optimization process may\nstop before completing all the specified iterations if no progress\nis observed over several consecutive cycles. Guidelines for setting\nthe appropriate number of iterations and other optimization parameters\ncan be found in the\n[Tuning Optimization Parameters](https://vaxpress.readthedocs.io/en/latest/user_guides.html#tuning-parameters)\nsection.\n\nYou can set `--iterations` to `0` to generate VaxPress's sequence\nevaluation report without any optimization.\n\n### Multi-Core Support\n\nYou can use multiple CPU cores for optimization with the `-p` or\n`--processes` option.\n\n### More About Options\n\nVaxPress offers the flexibility to adjust optimization strategies\nin detail and integrate with LinearDesign. It also allows several\nmore convenient functions such as preset parameters, user-defined\ncustom scoring functions, and etc. For comprehensive explanation,\nplease refer to [the manual](https://vaxpress.readthedocs.io/en/latest/).\n\n## Output\n\nOnce you've run VaxPress, the specified output directory will contain\nthe following five files:\n\n- ``report.html``: A summary report detailing the result and\n optimization process.\n- ``best-sequence.fasta``: The refined coding sequence.\n- ``checkpoints.tsv``: The best sequences and the evaluation results\n at each iteration.\n- ``log.txt``: Contains the logs that were displayed in the console.\n- ``parameters.json``: Contains the parameters employed for the optimization.\n This file can be feeded to VaxPress with the `--preset` option to duplicate\n the set-up for other sequence.\n\n# Citing VaxPress\n\nIf you employed our software in your research, please\nkindly reference our publication:\n\nJu, Ku, and Chang (2023) Title. Journal. Volume. (in preparation)\n\n# License\n\nVaxPress is distributed under the terms of the [MIT License](LICENSE.txt).\n\nLinearFold and LinearDesign are licensed for non-commercial use\nonly. If considering commercial use, be cautious about using options\nsuch as `--lineardesign` and `--folding-engine linearfold`.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Codon Optimizer for mRNA Vaccine Design",
"version": "0.9",
"project_urls": {
"Download": "https://github.com/ChangLabSNU/VaxPress/releases",
"Homepage": "https://github.com/ChangLabSNU/VaxPress"
},
"split_keywords": [
"mrna vaccine",
"messenger rna",
"codon optimization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fdd3ed534ab2ccd71a233162fa65ca996d1e1e6334ca53487b0498c8b41914a8",
"md5": "0fbd8c4c81d54b1838b75d6bc85caa45",
"sha256": "7315310cc91da4c7a4e561215d9070382cab1254d604089f0982a21e274f9f5a"
},
"downloads": -1,
"filename": "vaxpress-0.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0fbd8c4c81d54b1838b75d6bc85caa45",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 99270,
"upload_time": "2023-10-02T18:43:06",
"upload_time_iso_8601": "2023-10-02T18:43:06.903227Z",
"url": "https://files.pythonhosted.org/packages/fd/d3/ed534ab2ccd71a233162fa65ca996d1e1e6334ca53487b0498c8b41914a8/vaxpress-0.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4331acec3427630c9f0c1d88723b317b7be4a6b5fb26b22aee25f0d519bdfc75",
"md5": "822cdf7e2e997d98220afa3a1b3d8359",
"sha256": "5da8311c8681d0ef62fac91a0b56aeb067eda356c0e0f4096e253460aa404094"
},
"downloads": -1,
"filename": "vaxpress-0.9.tar.gz",
"has_sig": false,
"md5_digest": "822cdf7e2e997d98220afa3a1b3d8359",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 80995,
"upload_time": "2023-10-02T18:43:08",
"upload_time_iso_8601": "2023-10-02T18:43:08.567381Z",
"url": "https://files.pythonhosted.org/packages/43/31/acec3427630c9f0c1d88723b317b7be4a6b5fb26b22aee25f0d519bdfc75/vaxpress-0.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-02 18:43:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ChangLabSNU",
"github_project": "VaxPress",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "vaxpress"
}
JSON
