Computational phenotyping is the science of inferring clinically meaningful patient states from routinely collected data. Instead of relying on billing codes that record a diagnosis only after the fact, phenotyping algorithms attempt to detect conditions such as sepsis, kidney injury, or respiratory failure as they unfold. In critical care this problem is unusually hard. Patient physiology is non-stationary, meaning the underlying state changes rapidly. Observations arrive at irregular intervals, many measurements are missing for reasons related to the illness itself, and diagnostic codes carry no timestamp indicating when a disease process actually began. Standard retrospective benchmarks, which evaluate a model once at the end of a hospital stay, therefore fail to capture what clinicians actually need: estimates that update whenever a new observation becomes available.

RealPhe formalizes this challenge as causal phenotype estimation. Each prediction uses only information available at that moment, so a model estimating a patient’s conditions at hour twelve of an ICU stay cannot peek at data from hour thirteen. For development and evaluation, the framework aggregates irregular clinical events into two-hour intervals, a discretization that defines the training representation rather than the intended frequency of inference updates. Static cohort covariates are available from the start of the stay, while time-varying inputs contain only observations up to the prediction time. The current release evaluates this setting offline on retrospectively constructed trajectories; the authors are explicit that the software does not implement a live streaming or bedside deployment interface, and that it is not a certified medical device.

Architecturally, RealPhe is organized as a modular Python package wrapped in a reproducible workflow layer. Version 1.0.1, released under the GNU General Public License, replaced the original TensorFlow and Keras stack with PyTorch and introduced a reusable training engine. The codebase is divided into functional layers covering MIMIC-IV data access, preprocessing and task construction, model training, analytic tasks, and workflow provenance. Separate packages handle database querying, metrics and monitoring, the training loop with callbacks and custom losses, and executable tasks for cohort setup, evaluation, confidence intervals, feature importance, and mortality prediction. The scientific workflow itself is specified in a DVC pipeline whose stages run from cohort construction and signal extraction through adversarial validation, model training, and four phenotype-to-outcome mortality tasks.

The reproducibility machinery is where RealPhe departs from most research code. Parameters live in a configuration file, dependencies are pinned in pyproject.toml and uv.lock, and DVC records which artifacts depend on which stages. When a researcher changes, say, the temporal aggregation interval or a diagnosis-frequency threshold, the system recomputes only the affected preprocessing stages and their downstream model outputs, leaving unrelated cached results untouched. This makes methodological experimentation auditable: a scientist can swap an LSTM for a transformer, rerun a single command, and compare tracked metrics, plots, and aggregated predictions against every previous run. The design follows the reproducibility principles long championed by the MIMIC Code Repository community.

On the modeling side, the framework trains a single-layer Long Short-Term Memory network with dropout and a sigmoid output layer spanning 561 phenotypes simultaneously. Irregular clinical events are vectorized into two-hour time steps, with event-count features preserving information about missingness and measurement frequency. Preprocessing is strictly leakage-safe, with fold-specific imputation, scaling, and encoding, and a signal imputer that combines sample-and-hold imputation with training-set means. Variable-length patient sequences are collated as packed PyTorch batches that avoid wasting computation on padding, and the data pipeline uses multiprocessing, prefetching, and asynchronous transfers to keep the GPU fed. A weighted binary cross-entropy loss with a linear temporal ramp and label smoothing shapes training toward both early and late prediction quality.

Evaluation is deliberately multi-contextual. The framework reports first-step metrics that quantify phenotyping from the earliest measurements, time-distributed metrics that score causal predictions at successive two-hour points, and last-step metrics that allow comparison with retrospective benchmarks. Reliability is addressed through repeated ten-fold multi-label stratified cross-validation across seven random seeds, with predictions averaged across fold-specific models and seeds. Bootstrap confidence intervals, adversarial validation, and permutation feature importance round out the toolkit. The feature-importance procedure shuffles each input column once across all valid rows and time steps, measuring sensitivity to breaking the association between a feature and the rest of the input, though the authors caution it provides no causal estimate and does not preserve within-patient temporal alignment.

Software validation is unusually thorough for a research codebase. The repository includes 64 automated pytest cases built on small synthetic datasets that require no access to protected clinical data, covering the weighted temporal loss, ranking metrics, early stopping, preprocessing, packed sequences, and model serialization; all passed in the locked Python 3.12.13 environment. More striking is the end-to-end reproduction: the complete workflow was rerun with the same MIMIC-IV 2.0 data and configuration on a second computational system, moving from a TensorFlow-based v0.1.0 implementation to the PyTorch-based v1.0.1. All nine principal phenotyping metrics differed from the published values by at most 0.008, comfortably below a practical reproduction criterion of 0.01. Repeated complete runs in the same locked environment reproduced identical numerical results, confirming same-version repeatability.

The computational economics are also notable. A representative fold-specific training run covering 46,264 ICU stays and 561 phenotypes completed in 74.2 seconds on an NVIDIA GeForce RTX 5060 Ti, with peak host memory of 16.3 GiB and peak GPU memory of just 1.84 GiB. Offline inference over 13,045 test stays and 436,706 valid time steps ran at a median of 1.20 seconds per batch, a throughput of roughly 364,000 time steps per second. Because the LSTM is unidirectional and each input contains only past information, a single forward pass emits causal predictions at all valid time steps without recomputing retrospective prefixes. This efficiency makes repeated cross-validation feasible on hardware accessible to ordinary academic laboratories, lowering the barrier to rigorous benchmarking.

The implications extend beyond the ICU. Downstream multilayer perceptron models consume phenotype probabilities to predict 24-hour, ICU, in-hospital, and 30-day mortality, and the associated methodological study reported competitive performance, including an in-hospital mortality AUC-ROC of 0.913 after 24 hours that outperformed several traditional severity scores at the same time point. Attributing risk to clinically meaningful disease-state probabilities rather than raw vital signs opens a path toward more interpretable prediction. The authors point to several research directions the platform enables: controlled comparisons of temporal backbones from GRU-D to transformers and state-space models, systematic study of how missingness assumptions and cohort exclusions affect early versus retrospective performance, and auditing of healthcare-process biases. They are equally clear about limits: external multicenter validation, prospective evaluation, privacy-preserving federated approaches, and governance review all remain prerequisites before any clinical use, leaving RealPhe for now as a rigorous research foundation rather than a bedside tool.

Subject of Research: Reproducible real-time computational phenotyping of critical care patients from electronic health records using machine learning

Article Title: RealPhe: A reproducible framework for real-time phenotyping in critical care from electronic health records

Article References: Picheta, P., & Deniziak, S. (2026). RealPhe: A reproducible framework for real-time phenotyping in critical care from electronic health records. SoftwareX, 36, Article 103083. https://doi.org/10.1016/j.softx.2026.103083

Image Credits: AI Generated

DOI: 10.1016/j.softx.2026.103083

Keywords: RealPhe, computational phenotyping, electronic health records, critical care, MIMIC-IV, machine learning, LSTM, reproducibility, PyTorch, DVC, mortality prediction, intensive care

The research team, led by Abin Abraham of Children’s Hospital of Philadelphia together with collaborators at the University of California, San Francisco, Vanderbilt University Medical Center, and Vanderbilt University, took an unconventional approach to the problem. Instead of treating preterm birth as a yes-or-no label, they mined longitudinal electronic health records from nearly sixty thousand individuals across two separate clinical sites. Their goal was to let the data reveal natural groupings of conditions that tend to co-occur in the weeks and months surrounding delivery, and to test whether those groupings, once uncovered, could connect the clinical presentation of preterm birth to its inherited risk. The work was supported in part by the March of Dimes and the National Institutes of Health, reflecting a growing recognition that solving preterm birth requires both computational scale and genetic depth.

The mathematical engine behind the study is called tensor decomposition, a technique that will be familiar to physicists and data scientists but has only recently found traction in medicine. A tensor is simply a multi-dimensional array, and in this case the array captured three dimensions at once: patients, comorbid diagnoses, and the timing of those diagnoses relative to delivery. The researchers applied a classical decomposition method known as CANDECOMP/PARAFAC, which breaks a large, unwieldy tensor into a small set of latent factors. Each latent factor is essentially a pattern, a coherent combination of conditions and a temporal trajectory that recurs across many patients. Where a human clinician might see a chaotic list of diagnoses, the algorithm sees recurring themes, such as a cluster of metabolic conditions that spike at a particular window before birth.

What emerged from the decomposition was striking. The analysis uncovered latent factors corresponding to recognizable clinical territories, including metabolic disease, inflammatory conditions, and mental health disorders, each with its own characteristic timing relative to delivery. Some factors were enriched in preterm births while others tracked with term deliveries, suggesting that the patterns are not generic artifacts of pregnancy but genuinely differentiating signatures. Crucially, the team ran the same analysis independently at both clinical sites and found that similar factors surfaced at each one. This replication across institutions is a critical sanity check in computational phenotyping, because it demonstrates that the discovered patterns reflect real biology and shared clinical structure rather than the idiosyncrasies of a single hospital’s coding practices or patient population.

The latent factors were not merely descriptive curiosities. When the researchers trained machine learning models to predict preterm birth, models built on the compressed latent factor representation performed comparably to models trained on the full, high-dimensional electronic health record data. That result carries practical weight: a handful of interpretable factors can substitute for thousands of raw diagnostic codes without sacrificing predictive accuracy. In other words, the decomposition achieved a rare double win in medical machine learning, compressing the data while making it more transparent. Clinicians and regulators are often wary of black-box models, and a predictor built from factors with clear clinical meanings, such as a hypertensive disorder trajectory, is far easier to scrutinize, validate, and ultimately deploy at the bedside than an opaque ensemble of raw codes.

The study’s most ambitious move was to connect these clinical patterns to genetics. Twin studies have long indicated that preterm birth has a substantial heritable component, but genome-wide association studies have struggled to pin down specific mechanisms, partly because the phenotype itself is so heterogeneous. The team integrated genome-wide genotyping data for more than 2,200 individuals in the cohort and calculated polygenic risk scores, which aggregate the small effects of thousands of genetic variants across the genome into a single number for each trait. When they tested whether genetic predisposition to other conditions influenced preterm birth risk, a clear signal appeared: women carrying a high polygenic burden for cardiometabolic traits, including cardiovascular disease, type 2 diabetes, and elevated body mass index, faced robustly elevated odds of delivering preterm.

That association raised an obvious question: how does genetic risk for heart disease and diabetes translate into an early delivery? To answer it, the researchers turned to mediation analysis, a statistical framework for testing whether an observed relationship between two variables travels through an intermediate one. Here the intermediates were the latent factors themselves. The results were compelling. A latent factor capturing hypertensive disorders of pregnancy, such as preeclampsia, transmitted part of the cardiometabolic polygenic risk to preterm birth. In plain terms, inherited susceptibility to metabolic and cardiovascular disease appears to raise preterm birth risk partly by manifesting as hypertension during pregnancy, which in turn drives early delivery. This provides a mechanistic bridge linking a woman’s genome, her pregnancy complications, and her delivery outcome, and it reframes preterm birth as one downstream consequence of a broader cardiometabolic diathesis.

The implications of this framing extend beyond academic taxonomy. If preterm birth is not one disease but several, then prevention strategies may need to be tailored to sub-phenotype. A pregnancy marked by a metabolic-inflammatory trajectory might warrant intensified glucose monitoring and early blood pressure management, while a trajectory dominated by mental health conditions could call for entirely different surveillance and support. The latent factor framework also offers a principled way to stratify patients in future genetic studies, potentially boosting statistical power by analyzing genetically coherent subgroups rather than a blended population. And because the factors are computable from data that hospitals already collect, the approach could in principle be retrofitted onto existing records systems without new tests or expensive instrumentation, lowering the barrier to clinical translation.

There are, of course, important caveats. Electronic health records are notoriously noisy, shaped by inconsistent diagnostic coding, variable access to care, and the biases of who gets recorded and why. The genetic subsample of the cohort, at just over 2,200 individuals with genotyping, is modest by the standards of modern genomics, and the mediation findings, while robust within this dataset, will need replication in larger and more ancestrally diverse cohorts before they can guide practice. The authors themselves note that the study is a step toward refining the preterm birth phenotype, not a finished clinical tool. Still, the convergence of evidence, from replicated latent factors across two sites to predictive parity with full-record models to genetically mediated risk pathways, makes a persuasive case that the approach captures something real.

The broader lesson may resonate far beyond obstetrics. Preterm birth is hardly the only complex condition whose definition lumps together biologically distinct entities; depression, chronic kidney disease, and many autoimmune disorders suffer from the same problem, and the same genetic heterogeneity that has stalled their own genome-wide studies. This study offers a template: use tensor decomposition on longitudinal records to discover latent phenotypes, verify them across institutions, and then interrogate them with polygenic risk scores and mediation analysis to expose the pathways connecting genes to outcomes. If that pipeline generalizes, the humble medical record, long viewed as a billing byproduct, may become one of the most powerful instruments in precision medicine. For the roughly one in ten infants born preterm each year, and for the mothers whose pregnancies follow hidden trajectories that medicine is only now learning to read, that possibility is more than an abstraction. It is a roadmap toward prediction, prevention, and, ultimately, longer and healthier lives that begin at term.

Subject of Research: Latent phenotyping of preterm birth using tensor decomposition of electronic health records and its links to polygenic genetic risk

Article Title: Discovering latent phenotypic signatures of preterm birth and genetic risk using tensor decomposition on electronic health records

Article References: Abraham, A., Takasuka, H., Bejan, C., Rinker, D., Rokas, A., Sirota, M., & Capra, J. A. (2026). Discovering latent phenotypic signatures of preterm birth and genetic risk using tensor decomposition on electronic health records. BMC Medicine. https://doi.org/10.1186/s12916-026-05203-1

Image Credits: AI Generated

DOI: 10.1186/s12916-026-05203-1

Keywords: preterm birth, electronic health records, tensor decomposition, latent factors, polygenic risk score, computational phenotyping, machine learning, hypertensive disorders of pregnancy, cardiometabolic traits, genetic association study, comorbidity trajectories, BMC Medicine