Pheno-Ranker: a toolkit for comparison of phenotypic data stored in GA4GH standards and beyond
Authors:
Open Access
- 4 December 2024
- journal article
- research article
- Published by Springer Nature in BMC Bioinformatics
- Vol. 25 (1) , 1-20
Abstract
Background: Phenotypic data comparison is essential for disease association studies, patient stratification, and genotype–phenotype correlation analysis. To support these efforts, the Global Alliance for Genomics and Health (GA4GH) established Phenopackets v2 and Beacon v2 standards for storing, sharing, and discovering genomic and phenotypic data. These standards provide a consistent framework for organizing biological data, simplifying their transformation into computer-friendly formats. However, matching participants using GA4GH-based formats remains challenging, as current methods are not fully compatible, limiting their effectiveness. Results: Here, we introduce Pheno-Ranker, an open-source software toolkit for individual-level comparison of phenotypic data. As input, it accepts JSON/YAML data exchange formats from Beacon v2 and Phenopackets v2 data models, as well as any data structure encoded in JSON, YAML, or CSV formats. Internally, the hierarchical data structure is flattened to one dimension and then transformed through one-hot encoding. This allows for efficient pairwise (all-to-all) comparisons within cohorts or for matching of a patient’s profile in cohorts. Users have the flexibility to refine their comparisons by including or excluding terms, applying weights to variables, and obtaining statistical significance through Z-scores and p-values. The output consists of text files, which can be further analyzed using unsupervised learning techniques, such as clustering or multidimensional scaling (MDS), and with graph analytics. Pheno-Ranker’s performance has been validated with simulated and synthetic data, showing its accuracy, robustness, and efficiency across various health data scenarios. A real data use case from the PRECISESADS study highlights its practical utility in clinical research. Conclusions: Pheno-Ranker is a user-friendly, lightweight software for semantic similarity analysis of phenotypic data in Beacon v2 and Phenopackets v2 formats, extendable to other data types. It enables the comparison of a wide range of variables beyond HPO or OMIM terms while preserving full context. The software is designed as a command-line tool with additional utilities for CSV import, data simulation, summary statistics plotting, and QR code generation. For interactive analysis, it also includes a web-based user interface built with R Shiny. Links to the online documentation, including a Google Colab tutorial, and the tool’s source code are available on the project home page: https://github.com/CNAG-Biomedical-Informatics/pheno-ranker.Keywords
This publication has 78 references indexed in Scilit:
- Phenotype‐driven approaches to enhance variant prioritization and diagnosis of rare diseaseHuman Mutation, 2022
- Encoding Clinical Data with the Human Phenotype Ontology for Computational Differential DiagnosticsCurrent Protocols in Human Genetics, 2019
- Efficient In-Database Patient Similarity Analysis for Personalized Medical Decision Support SystemsBig Data Research, 2018
- Phenotype Similarity Regression for Identifying the Genetic Determinants of Rare DiseasesThe American Journal of Human Genetics, 2016
- ggplot22016
- PhenomeCentral: A Portal for Phenotypic and Genotypic Matchmaking of Patients with Rare Genetic DiseasesHuman Mutation, 2015
- Cafe Variome: General-Purpose Software for Making Genotype-Phenotype Data Discoverable in Restricted or Open Access ContextsHuman Mutation, 2015
- PhenoTips: Patient Phenotyping Software for Clinical and Research UseHuman Mutation, 2013
- Clinical Diagnostics in Human Genetics with Semantic Similarity Searches in OntologiesThe American Journal of Human Genetics, 2009
- Error Detecting and Error Correcting CodesBell System Technical Journal, 1950