Example Cases

Module Introduction

This module provides pre-configured marking scenarios (workspaces) representing eight distinct constraint combinations. These scenarios are derived from two sets of KM images (comprising a total of four individual KM curves). For each dataset, the ground-truth metrics—including Hazard Ratios (HR), median survival times, and 1- to 5-year survival rates—are provided. These details allow users to quantitatively assess the fidelity of the IPD reconstructed by KM-PoPiGo by comparing the calculated results against the actual reported survival statistics.

The reconstruction process relies on various Constraints, denoted as combinations of Sample Size (N), Number of Events (E), At-risk Table (R), and Censoring Times (C). This module allows users to load and inspect the specific marking status for the eight combinations: NERC, NER, NEC, NRC, NE, NR, NC, and N. By examining these pre-configured workspaces, users can intuitively learn the expected marking patterns and the corresponding input values required in the "Set Study Parameters" module for various constraint combinations. Furthermore, users can interactively modify these pre-loaded workspaces to validate reconstruction results, serving as an effective training ground to quickly master the KM-PoPiGo workflow.

Module Usage

  1. Access Interface: Click the "Example Cases" button to open the case selection panel.
  2. Load Scenario: Locate the desired constraint combination (e.g., NERC, NER) and click the corresponding "Load" button. The KM-PoPiGo tool will automatically populate the workspace with the pre-set data.

Visual & Parameter Feedback: The displayed markings and parameter inputs will vary dynamically based on the selected constraint combination:

  • Full Constraint (e.g., NERC): The workspace will display both Key Points and Censoring Times on the graph. Simultaneously, the "Set Study Parameters" module will be filled with the complete dataset (Sample Size, Number of Events, At-risk Table, and Censoring Times).
  • Partial Constraint (e.g., NER): The Censoring Times will be absent from the graph (as Censoring data is not included).
  • Minimal Constraint (e.g., N): The tool will only load the Key Points and the Sample Size, leaving other parameter fields blank.

Important Notes

  • Educational Value: In the "Example Cases" module, each KM curve is presented with multiple constraint combinations (e.g., NERC vs. N). This design helps users understand how the marking patterns and the input requirements in "Set Study Parameters" evolve under different scenarios.
  • Best Practice for Reconstruction: For real-world tasks, users are strongly advised to input as many Constraints as available. Providing a comprehensive set of constraints (e.g., including At-risk tables and Censoring times) significantly maximizes the accuracy and reliability of the final IPD reconstruction.