omni_inventory_bullwhip_effect
Calculate supply chain bullwhip effect by comparing order and demand variance across echelons, returning amplification ratio, upstream order variance, excess inventory cost, and instability severity.
Instructions
Supply Chain Bullwhip Effect Variance Amplification Calculator. Calculate order variance amplification ratio across supply chain echelons (retailer, distributor, manufacturer) to measure the Bullwhip Effect. Discipline: LOGISTICS. Governing mathematical model / formula: Bullwhip Measure = (Variance of Orders / Mean of Orders) / (Variance of Demand / Mean of Demand).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of bullwhip_amplification_ratio (Bullwhip Amplification Multiplier), upstream_order_variance (Upstream Factory Order Variance), excess_inventory_cost_pct (Estimated Excess Safety Stock Penalty), distortion_severity (Supply Chain Instability Tier) using retail_demand_variance (Consumer Demand Variance (σ²_demand)), lead_time_echelons (Cumulative Supply Chain Lead Time (Days) in days), forecasting_factor (Demand Forecasting Smoothing (p)). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Supply Chain Bullwhip Effect Variance Amplification Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "inventory-bullwhip-effect"
category (string): "logistics"
name (string): "Supply Chain Bullwhip Effect Variance Amplification Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.bullwhip_amplification_ratio (Bullwhip Amplification Multiplier): Formatted display string (e.g. '3.85x')
metrics.upstream_order_variance (Upstream Factory Order Variance): Formatted display string (e.g. '173.2 (vs 45.0 Retail)')
metrics.excess_inventory_cost_pct (Estimated Excess Safety Stock Penalty): Formatted display string (e.g. '+48.0% Working Capital Waste')
metrics.distortion_severity (Supply Chain Instability Tier): Formatted display string (e.g. 'High Distortion (VMI Recommended)')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_inventory_bullwhip_effect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| forecasting_factor | No | Demand Forecasting Smoothing (p). Order update smoothing factor (Chen et al. model). Default: 0.25. Min: 0.05. Max: 0.95. | |
| lead_time_echelons | No | Cumulative Supply Chain Lead Time (Days) (days). Total lead time across ordering tiers. Default: 28. Min: 2. Max: 180. | |
| retail_demand_variance | No | Consumer Demand Variance (σ²_demand). Variance of point-of-sale customer purchases. Default: 45. Min: 5. Max: 1000. |