oee_compute
Read-only
Compute OEE from production inputs, identify Six Big Losses, and assess energy usage vs baseline when energy data is supplied.
Instructions
[READ][risk=low] OEE = Availability × Performance × Quality (+ loss/energy depth).
Args:
planned_time_s: Planned production time (seconds).
run_time_s: Actual running time (seconds) — planned minus downtime.
ideal_cycle_time_s: Ideal/nameplate cycle time per part (seconds).
total_count: Total parts produced.
good_count: Good (non-reject) parts produced.
breakdown_time_s: Optional — unplanned-stop seconds (splits availability loss).
setup_time_s: Optional — changeover/setup seconds (splits availability loss).
minor_stop_time_s: Optional — minor-stop seconds (splits performance loss;
the remainder is speed loss).
startup_reject_count: Optional — startup/warm-up rejects (splits quality
loss; the remainder is production rejects).
actual_kwh: Optional — measured energy for this run; enables the energy block.
baseline_kwh: Optional — expected/baseline energy for the actual-vs-baseline
deviation verdict.
emission_factor_kg_per_kwh: Optional — carbon factor (kg CO2e/kWh). Default is
a flagged placeholder (see the tool's carbon note); pass the grid's value.
energy_tolerance: ± band (fraction) for the over/under/on-target verdict.
Returns dict: OEE factors + oee/oee_pct + inputs + losses, plus
``six_big_losses`` (breakdown/setup/minor-stops/speed/startup/production-reject
time-ladder that sums with OEE to 100%) and, when ``actual_kwh`` is given,
``energy`` (kwh_per_unit, carbon, and baseline deviation).
Example: oee_compute(planned_time_s=28800, run_time_s=25200,
ideal_cycle_time_s=2.0, total_count=12000, good_count=11800,
setup_time_s=1800, actual_kwh=940, baseline_kwh=880).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actual_kwh | No | ||
| good_count | Yes | ||
| run_time_s | Yes | ||
| total_count | Yes | ||
| baseline_kwh | No | ||
| setup_time_s | No | ||
| planned_time_s | Yes | ||
| breakdown_time_s | No | ||
| energy_tolerance | No | ||
| minor_stop_time_s | No | ||
| ideal_cycle_time_s | Yes | ||
| startup_reject_count | No | ||
| emission_factor_kg_per_kwh | No |