Efficiency Calculation
Kartorium calculates efficiency at two levels: OEE (Overall Equipment Effectiveness) for machine/station performance, and OPS Efficiency for labor productivity.
OEE (Overall Equipment Effectiveness)
OEE is the standard manufacturing metric that combines three factors:
Each factor is a percentage (0-100%). OEE is calculated per machine, per station, or across a site, over any time range.
Availability
Availability measures what proportion of time the machine was actually running vs. stopped.
Which types of downtime count in the denominator depends on the calculation mode:
| Mode | Denominator | Description |
|---|---|---|
standard | Run Time + Unplanned Downtime | Excludes idle and planned downtime. Only unplanned stops reduce availability. |
strict | Run Time + Unplanned + Planned Downtime | Excludes only idle time. Both planned maintenance and unplanned stops reduce availability. |
teep | Total Calendar Time | Most stringent. All time counts — run time, planned downtime, unplanned downtime, and idle time. |
Downtime type is inherited from the downtime reason’s parent group:
- Unplanned — breakdowns, equipment failures. Always reduces availability.
- Planned — scheduled maintenance, changeovers. Reduces availability in
strictandteepmodes. - Idle — no production scheduled, waiting for work. Reduces availability only in
teepmode.
See Reason Taxonomy for how downtime reasons are organized into typed groups.
Performance
Performance measures how fast the machine produced relative to its target rate.
Target rate is configured per machine via:
ideal_cycle_time_seconds— target time per parttarget_rate/target_rate_unit— target production rateexpected_parts_per_batch— expected output per batch
Performance can exceed 100% if the machine produces faster than target.
Quality
Quality measures the proportion of good parts vs. total parts produced.
Part counts are recorded when batches/jobs are completed. Aborted batches are excluded from quality calculations but included in availability and performance.
Target OEE
Each machine has configurable target percentages:
target_oee_percent(default 85%)target_availability_percent(default 90%)target_performance_percent(default 95%)target_quality_percent(default 99.5%)
Target OEE is also configurable per Product Family per Station via Station Product Standards, enabling different targets for different products at different stations.
OPS Efficiency (Labor Productivity)
OPS Efficiency measures how productively labor time was used compared to the expected time for the work completed:
This is distinct from OEE. OEE tracks machine effectiveness; OPS Efficiency tracks labor productivity.
Standard Hours
Standard hours represent the expected labor time to complete a job. They come from the product hierarchy with fallback:
- Product-level — the product’s
standard_hours(most specific) - Family-level — the product family’s
standard_hours(fallback) - Zero if neither is defined (efficiency returns NULL)
Actual Hours
Actual hours come from labor time entries — time clocked by workers against jobs. Only closed entries (where the worker has clocked out) are counted. See Job Time Tracking for the full time accumulation model.
Efficiency Granularities
Five views are available:
| View | Aggregation |
|---|---|
| Per Job | Efficiency for each completed/scrapped job in a time range |
| Per Station | Total standard hours / total labor hours across all jobs at each Station |
| Per Person | Each worker’s clocked hours vs. earned hours from completed jobs |
| Per Team | Aggregate across all workers at a site |
| Per Product Family | How efficiently each Product Family is produced |
Station View Summary
A single-station summary provides:
- Job counts (queued, in progress, completed, scrapped)
- Part totals and scrap rate
- Efficiency percentage
- Average cycle time in minutes
Key Behaviors
- Efficiency can be NULL when there are no labor hours or no standard hours. The system does not default to 0% or 100%.
- Per-station snapshots are stored in station history for per-station analysis.
- All functions validate site-organization ownership before returning data.
See Also
- Analytics — user-created OEE charts with calculation mode selection
- Machines — how machines provide data for OEE
- Station Dashboard KPIs
- Product
- Product Family
- Station Analytics
- Job Time Tracking