Bioconvert is a collaborative project to facilitate the interconversion of life science data from one format to another.
- contributions
Want to add a convertor ? Please join #1
- How to cite
Caro et al, BioConvert: a comprehensive format converter for life sciences (2023) NAR Genomics and Bioinformatics (5),3. https://doi.org/10.1093/nargab/lqad074
Life science uses many different formats. They may be old, or with complex syntax and converting those formats may be a challenge. Bioconvert aims at providing a common tool / interface to convert life science data formats from one to another.
Many conversion tools already exist but they may be dispersed, focused on few specific formats, difficult to install, or not optimised. With Bioconvert, we plan to cover a wide spectrum of format conversions; we will re-use existing tools when possible and provide facilities to compare different conversion tools or methods via benchmarking. New implementations are provided when considered better than existing ones.
In Jan 2023, we had 50 formats, 100 direct conversions available.
BioConvert is developped in Python. Please use conda or any Python environment manager to install BioConvert using the pip command:
pip install bioconvert50% of the conversions should work out of the box. However, many conversions require external tools. This is why we recommend to use a conda environment. In particular, most external tools are available on the bioconda channel. For instance if you want to convert a SAM file to a BAM file you would need to install samtools as follow:
conda install -c bioconda samtoolsSince bioconvert is available on bioconda on solution that installs BioConvert and all its dependencies is to use conda/mamba:
conda env create --name bioconvert mamba
conda activate bioconvert
mamba install bioconvert
bioconvert --helpSee the Installation section for more details and alternative solutions (docker, singularity).
There are many conversions available. Type:
bioconvert --help to get a list of valid method of conversions. Taking the example of a conversion from a FastQ file into a FastA file, you could do the conversion as follows:
bioconvert fastq2fasta input.fastq output.fasta
bioconvert fastq2fasta input.fq output.fasta
bioconvert fastq2fasta input.fq.gz output.fasta.gz
bioconvert fastq2fasta input.fq.gz output.fasta.bz2When there is no ambiguity, you can be implicit:
bioconvert input.fastq output.fastaThe default method of conversion is used but you may use another one. Checkout the available methods with:
bioconvert fastq2fasta --show-methodsFor more help about a conversion, just type:
bioconvert fastq2fasta --helpand more generally:
bioconvert --helpYou may also call BioConvert from a Python shell:
# import a converter
from bioconvert.fastq2fasta import FASTQ2FASTA
# Instanciate with infile/outfile names
convert = FASTQ2FASTA(infile, outfile)
# the conversion itself:
convert()
Setting up and maintaining Bioconvert has been possible thanks to users and contributors. Thanks to all:
| Version | Description |
|---|---|
1.1.1 |
|
1.1.0 |
|
1.0.0 |
|
0.6.3 |
|
0.6.2 |
|
0.6.1 |
|
0.6.0 |
|
| 0.5.2 | * Update requirements and environment.yml and add a conda spec-file.txt file |
| 0.5.1 | * add genbank2gff3 requirement material in bioconvert.utils.biocode |
0.5.0 |
|
0.4.X |
|
| 0.3.X |
|
| 0.2.X |
|
| 0.1.X |
|