oee_multidim
Read-only
Aggregate OEE and energy metrics across shifts, machines, or parts. Identify worst performers and flag energy baseline deviations using tolerance and robust outlier rules.
Instructions
[READ][risk=low] Aggregate OEE (+ optional energy) across dimensions.
Args:
records: Labelled records — {<dimension labels>, planned_time_s, run_time_s,
ideal_cycle_time_s, total_count, good_count} plus optional actual_kwh /
baseline_kwh to enable the energy rollup.
dimensions: Dimension keys to group by (default ['machine','part','shift']);
use ['shift'] for the classic by-shift energy comparison.
emission_factor_kg_per_kwh: Optional carbon factor (kg CO2e/kWh); default is a
flagged placeholder — pass the grid's published value.
energy_tolerance: ± band (fraction) for the actual-vs-baseline verdict.
Returns dict: {dimensions, group_count, mean_oee, worst_performers:[...],
matrix:[{dimensions, oee, oee_pct, availability, performance, quality,
energy?}]}. When any record carries energy, adds an ``energy_baseline`` block
that flags cross-group deviation anomalies (tolerance + robust-outlier rules).
Example: oee_multidim(records=[{"shift":"day","planned_time_s":28800,
"run_time_s":25000,"ideal_cycle_time_s":2,"total_count":12000,
"good_count":11800,"actual_kwh":940,"baseline_kwh":880}], dimensions=["shift"]).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| records | Yes | ||
| dimensions | No | ||
| energy_tolerance | No | ||
| emission_factor_kg_per_kwh | No |