Executive Briefing
Executive Summary
If this KPI trends up: Usually signals better operating performance, assuming the denominator and period filters are unchanged. If it trends down: Usually signals weaker performance or a possible data-quality issue that should be investigated. Owner check: What changed in source data, business process, or KPI logic that explains movement in Ethylene Production Yield?
Business Meaning
Percentage of feedstock mass successfully converted to ethylene product.
Decision
Maximize conversion efficiency in the steam cracking unit within safe operating limits.
Trust
Governed metric ready for operational decision support.
Risk
Incorrect interpretation may affect Operations planning, accountability, or exception response.
Mathematical Formulation
Formal Formula
\[ \mathrm{Ethylene_Production_Yield} = \left(\frac{\mathrm{Ethylene\,Produced}}{\mathrm{Feedstock\,Input}}\right) \times 100 \]
Where:
- Numerator: Ethylene Produced (Tons)
- Denominator: Feedstock Input (Tons)
- Scale: ×100
Annotated Formula
Ethylene Produced
Ethylene Produced
Divided By
÷
Feedstock Input
Feedstock Input
Scaled by 100
× 100
Developer Lineage Breakdown
1 | def calculate_ethylene_yield_pct(ethylene_produced_tons: float, feedstock_input_tons: float) -> float:
Calculation expression: combines source variables used by the formal formula.
2 | """Calculates ethylene production yield as a percentage of feedstock input."""
Output alias: maps this expression to a in the result set.
3 | if feedstock_input_tons <= 0:
Source context: supports the KPI definition or execution boundary.
4 | return 0.0
Source context: supports the KPI definition or execution boundary.
5 | return (ethylene_produced_tons / feedstock_input_tons) * 100.0
Calculation expression: combines source variables used by the formal formula.
Evidence & Lineage
def calculate_ethylene_yield_pct(ethylene_produced_tons: float, feedstock_input_tons: float) -> float:
"""Calculates ethylene production yield as a percentage of feedstock input."""
if feedstock_input_tons <= 0:
return 0.0
return (ethylene_produced_tons / feedstock_input_tons) * 100.0
Inline evidence snippet
1 | def calculate_ethylene_yield_pct(ethylene_produced_tons: float, feedstock_input_tons: float) -> float: 2 | """Calculates ethylene production yield as a percentage of feedstock input.""" 3 | if feedstock_input_tons <= 0: 4 | return 0.0 5 | return (ethylene_produced_tons / feedstock_input_tons) * 100.0
Developer Lineage Breakdown
1 | def calculate_ethylene_yield_pct(ethylene_produced_tons: float, feedstock_input_tons: float) -> float:
Calculation expression: combines source variables used by the formal formula.
2 | """Calculates ethylene production yield as a percentage of feedstock input."""
Output alias: maps this expression to a in the result set.
3 | if feedstock_input_tons <= 0:
Source context: supports the KPI definition or execution boundary.
4 | return 0.0
Source context: supports the KPI definition or execution boundary.
5 | return (ethylene_produced_tons / feedstock_input_tons) * 100.0
Calculation expression: combines source variables used by the formal formula.
Operational Intent
Percentage of feedstock mass successfully converted to ethylene product. LEAP frames this as an operational evidence signal for operations decision-making.
Verified Logic Mapping
- First, LEAP certifies the KPI definition against control_no_conflict_yield.py and classifies the implementation as PYTHON evidence.
- Second, it presents the certified calculation expression (Ethylene Yield % = (Ethylene Produced (tons) / Feedstock Input (tons)) * 100) in the formal MathJax formula shown above.
- Finally, it preserves the executable context and code fingerprint so future changes to the KPI logic can be identified.
Logic Safeguards
OK
Implementation Traceability: Executable evidence is locked to control_no_conflict_yield.py at line 1.
OK
Formula Consistency Check: The business formula and implementation evidence share compatible calculation structure based on LEAP's structured comparison.
OK
Change Detection: Code Fingerprint 48f65d9980 records the current implementation so drift can be identified after the next workspace refresh.
OK
RACI Accountability: Operations Data Owner is assigned as accountable owner for rule confirmation and escalation.
Executive Alignment
Business rules are aligned to inferred from source path: Production, refinery, and process operations. RACI Owner: Operations Data Owner. Consulted reviewer: Process Engineering Team. Current status: Validated.
Business Data SystemEXPLICIT SOURCE: DCS Historian (OSIsoft PI) and shift production logs
Source Filecontrol_no_conflict_yield.py
Source Line1
Definition PatternComment
Governance DomainOperations
KPI IDKPI-48F65D9980
Business Usage
Operations Performance Dashboard, Cracker Unit KPI Review
Input Evidence
Ethylene produced (tons), Feedstock input (tons)
Definition
Percentage of feedstock mass successfully converted to ethylene product.
Business Context
Maximize conversion efficiency in the steam cracking unit within safe operating limits.
Edge Cases / Comments
Compliance mode preserved only implementation-grounded evidence; unresolved business context is routed to owner confirmation.