Skip to Content
This documentation is provided with the HEAT environment and is relevant for this HEAT instance only.
RunnersReact UtilsReact Utils Runner

React Utils Runner

The React Utils runner (react-utils) provides the ReACT dashboard tooling pipeline: it preprocesses raw hydrated capture data into per-role dataframes, computes role-specific metrics (gunner, driver, commander, crew/unit, and AFV Recognition), and transforms those metrics into the legacy v1 dashboard JSON widgets consumed by ui/legacy. Use it in ReACT-based session templates when tasks are routed to the react-utils deployment.

Node template selection

TemplatePurposeLimitationsDetails
react-data-preprocessMerge raw hydrated CSV/JSON parents into one preprocessed bundle of role dataframes, resolve the scenario (title, type, and AFV Recognition level when applicable) via the scenario lookup table, and set session identity metadata.Single canonical entry point for every downstream react-* metrics node; capture-mode registration gates (requireInstructorRegistration, requireCrewRegistration) can stall the node if expected registration events are missing.Index
react-dashboard-transformBuild the legacy v1 dashboard JSON (scoring, results, cognitive load, timeline widgets) from a react-*-metrics node’s output.Produces legacy v1 widget shapes only, not $heat-dataservice; enable update_scenario_instance_times on one transform node per session.Index
react-afv-metricsCompute AFV Recognition scoring, per-group breakdowns, and cognitive load for each gunner in an AFV Recognition scenario.Requires react-data-preprocess output; scoring denominator is a fixed lookup for one training programme’s curriculum, not a general or configurable mechanism.react-afv-metrics
react-crew-unit-metricsAggregate crew and unit-level metrics from preprocessed react data.Requires react-data-preprocess output; no declared configuration.Index
react-driver-metricsCompute driver-role metrics (vehicle, bio, interaction) from preprocessed react data.Requires react-data-preprocess output; no declared configuration.Index
react-gunner-metricsCompute gunner-role metrics for non-AFV-Recognition scenarios from preprocessed react data.Requires react-data-preprocess output; no declared configuration.Index
react-commander-metricsCompute commander-role metrics from preprocessed react data.Requires react-data-preprocess output; no declared configuration.Index

Example workflow