OPEN builds a shared vocabulary for computable phenotypes

A new preprint introduces OPEN, a community-informed metadata framework designed to make computable phenotypes easier to exchange across research libraries and health data networks. The work tackles a problem that has slowed reuse for years: phenotype definitions are often highly useful inside one institution or platform, then become hard to interpret, compare, or port elsewhere because the surrounding metadata are inconsistent or incomplete.

Computable phenotypes sit at the center of modern clinical informatics. They define patient cohorts using code, logic, data sources, and validation rules, then power observational studies, quality measurement, and translational research. When those definitions are opaque, even a well-constructed phenotype can lose value outside the original environment. OPEN attempts to lower that barrier by identifying the metadata fields that matter most for discovery, interpretation, and reuse.

The project combined two efforts. One was a library-led initiative from the Open PhEnomics Network consortium that compared fields across phenotype libraries and reviewed the literature to draft candidate metadata elements. The other was a community consensus process in the United Kingdom built from stakeholder interviews, a survey, and a workshop. Rather than relying on a single group’s assumptions about what should be recorded, the framework was shaped by both library stewardship and user requirements.

Cross-library comparison produced 23 candidate fields

The consortium’s cross-library process yielded 23 candidate fields spanning three broad areas: phenotype description, data and technical details, and performance domains. Thirteen of those fields aligned across all five libraries examined, which suggests a core shared structure already exists even if it has not been formalized into one standard. Twenty-two fields matched published desiderata for phenotype libraries, reinforcing the idea that the same metadata needs recur across multiple curation environments.

The framework is important because metadata are not a cosmetic layer. They determine whether a phenotype can be searched, understood, versioned, and reproduced in a different data environment. In practice, a coding terminology without a clear description, a unique identifier without version history, or a validation report without context can leave a secondary user uncertain about whether the definition applies to a new cohort, a new database, or a new research question.

Interoperability testing used diabetes-related phenotypes as a practical use case. Manual mapping successfully catalogued phenotypes across libraries, while API-mediated mapping achieved 63% to 76% metadata field completeness across libraries. Even without a claim of perfect transferability, that range shows that machine-mediated exchange is feasible when the underlying fields are structured carefully. In this setting, completeness is not a trivial bookkeeping statistic; incomplete metadata can interrupt cohort discovery and force users back to manual review.

The performance domains matter because phenotype libraries are not only repositories of definitions. They also carry signals about how a phenotype was built, where it came from, and how reliably it performs in a given setting. A framework that preserves those details can help downstream investigators judge portability before they invest time in adaptation or revalidation.

Community users wanted six fields to be mandatory

The community survey included 124 respondents and identified six metadata elements with majority support as mandatory: description, coding terminology, phenotype type, version history, unique identifier, and data source. These selections reveal a practical user priority. Researchers want enough information to identify what the phenotype is, trace where it came from, and determine whether it has changed over time.

The results also show restraint around over-prescription. Logic representation and validation requirements were rated as mostly context-dependent rather than universally mandatory. In real-world informatics, that distinction matters because different use cases need different levels of formalism. A rapid exploratory cohort query may not require the same degree of executable logic documentation as a regulatory-grade or multi-site implementation. Forcing every use case into one rigid mold could make the framework less usable, not more.

Community priorities aligned strongly with the OPEN framework, although some requirements were only partially represented. The overlap suggests the two processes were pointing in the same direction even though they were built from different starting points. One came from library infrastructure and literature synthesis; the other came from the expectations of users who need phenotypes to work across local and distributed settings.

A metadata standard lives or dies by adoption, not elegance.

That is where the framework’s emphasis on interoperability becomes clinically relevant. In health data science, reusable phenotypes support phenome-wide studies, trial emulation, signal detection, and comparative effectiveness research. Each of those applications depends on knowing not just the phenotype name, but the exact operational definition, the data source, and the history of revisions. Without those anchors, cross-site synthesis becomes brittle.

Why the framework matters for reproducible health data science

OPEN is less about a single disease area than about the machinery that underpins large-scale clinical research. The framework speaks directly to the FAIR principles — findable, accessible, interoperable, and reusable — by turning phenotype metadata into something more structured and shareable. In a world where health systems store data differently and researchers frequently move between institutions, that kind of standardization can reduce friction before analysis even begins.

The biological and clinical logic behind the effort is straightforward even if the subject is technical rather than therapeutic. Patient-level inference depends on accurate cohort definition, and cohort definition depends on metadata that explain how a phenotype was assembled from coded data. If the phenotype is meant to identify diabetes, heart failure, or another condition, the stakes are not abstract: misclassification can distort prevalence estimates, bias associations, and weaken reproducibility.

By explicitly distinguishing between mandatory and context-dependent elements, OPEN also avoids forcing every library into identical workflows. That may be one of its strongest features. A standard that can be adopted across institutions, while still accommodating local operational differences, has a better chance of surviving contact with real data systems.

Feasibility is encouraging, but standardization is still unfinished

The preprint argues that OPEN provides a credible foundation for a FAIR computable phenotype metadata standard. The evidence supports that claim at a framework level: the field comparison identified a core structure, the community process surfaced user priorities, and the mapping exercise showed that exchange across libraries is technically possible. Still, the work remains a preprint and has not undergone peer review.

Several questions remain open. The framework needs broader validation across additional libraries, more disease areas, and more heterogeneous data environments before it can function as a durable standard. The completeness range from API-mediated mapping also leaves room for improvement, especially if the goal is seamless exchange rather than partial portability. Adoption will depend on whether libraries can implement the framework without excessive burden and whether investigators see immediate value in recording richer metadata.

For now, OPEN offers a concrete answer to a persistent informatics problem: computable phenotypes become more useful when their metadata are designed for human interpretation and machine exchange at the same time. The next test is whether the framework can move beyond consensus and into routine library practice without losing the flexibility that made it workable in the first place.


Reporting by Dr. A. Nikhil Krishnan, MBBS for Medicine World Foundation, with additional data provided by medRxiv (Clinical Preprints).