Convert-Pheno Convert-Pheno

A software toolkit for the interconversion of standard data models for phenotypic data

Build and Test Coverage Status CPAN Publish version Docker Build Docker Pulls Documentation Status License

📘 Documentation · 💻 Installation · 📓 Google Colab · 📦 CPAN · 🐳 Docker

Convert-Pheno

Convert-Pheno converts clinical and phenotypic records between BFF, Phenopackets (PXF), OMOP-CDM, REDCap, CSV, CDISC formats, FHIR R4, openEHR, cBioPortal, i2b2, PCORnet CDM, and Sentinel CDM.

The command-line interface is the primary interface. The same conversion engine is also available through a Perl module, Python binding, HTTP(s) API, and native desktop application.

Quick Start

convert-pheno -ipxf phenopacket.json -obff individuals.json
convert-pheno -ibff individuals.json -opxf phenopackets.json
convert-pheno -iomop omop-export/ -obff individuals.json --ohdsi-db

Entity-aware BFF output can write individuals, biosamples, datasets, and cohorts when the selected source route supports them:

convert-pheno -ipxf phenopacket.json \
  -obff --entities individuals biosamples datasets cohorts \
  --out-dir bff_out/

See the command-line interface guide for commands by source and target, or run convert-pheno --help for the full CLI option list.

Installation

Desktop Application

From Convert-Pheno 0.35, a native desktop application provides route selection, local file handling, conversion runs, output previews, and terminology review. See the desktop application guide.

Tested Examples

Synthetic fixtures under t/ provide tested inputs and reference outputs for the supported conversion routes.

Citation

Rueda, M et al. (2024). Convert-Pheno: A software toolkit for the interconversion of standard data models for phenotypic data. Journal of Biomedical Informatics. https://doi.org/10.1016/j.jbi.2023.104558

Author

Manuel Rueda, PhD. CNAG: https://www.cnag.eu