omni_combine_harvester_grain_loss
Calculate combine harvester field grain loss in bushels per acre and lost dollar revenue from kernel counts, crop type, harvested acres, and grain price.
Instructions
Combine Harvester Field Grain Loss & Bushel Dockage Rate Calculator. Calculate field harvesting grain loss in bushels per acre and lost dollar revenue from kernel counts behind combine header and rotor/shoe separator. Discipline: AGRICULTURE. Governing mathematical model / formula: Loss (Bu/Acre) = Counted Kernels Per Square Foot / Kernels per Square Foot per Bushel (Corn = 2, Soybeans = 4, Wheat = 20).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of bushels_lost_per_acre (Harvest Loss Rate), total_dollar_harvest_loss (Total Dollar Revenue Left in Field), acceptable_loss_status (Combustion Loss Performance), dollar_loss_per_acre (Loss Per Harvested Acre) using kernels_counted_per_sqft (Kernels Counted in 1 Sq Ft Behind Combine in kernels/sq ft), crop_type (Crop Type (1 = Corn, 2 = Soybeans, 3 = Wheat)), harvest_acres_total (Total Harvest Field Acres in acres), commodity_market_price (Grain Cash Price ($/Bushel)). 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 'Combine Harvester Field Grain Loss & Bushel Dockage Rate 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): "combine-harvester-grain-loss"
category (string): "agriculture"
name (string): "Combine Harvester Field Grain Loss & Bushel Dockage Rate Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.bushels_lost_per_acre (Harvest Loss Rate): Formatted display string (e.g. '3.0 Bu / Acre')
metrics.total_dollar_harvest_loss (Total Dollar Revenue Left in Field): Formatted display string (e.g. '$7,125.00 Lost')
metrics.acceptable_loss_status (Combustion Loss Performance): Formatted display string (e.g. 'Unacceptable Loss (> 1.5 Bu/ac)')
metrics.dollar_loss_per_acre (Loss Per Harvested Acre): Formatted display string (e.g. '$14.25 / Acre')
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_combine_harvester_grain_loss"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| crop_type | No | Crop Type (1 = Corn, 2 = Soybeans, 3 = Wheat). 1: Corn (2 kernels/sq ft = 1 bu/ac), 2: Soybeans (4 kernels), 3: Wheat (20 kernels). Default: 1. Min: 1. Max: 3. | |
| harvest_acres_total | No | Total Harvest Field Acres (acres). Total acres harvested. Default: 500. Min: 10. Max: 10000. | |
| commodity_market_price | No | Grain Cash Price ($/Bushel). Local elevator cash grain price. Default: 4.75. Min: 2. Max: 20. | |
| kernels_counted_per_sqft | No | Kernels Counted in 1 Sq Ft Behind Combine (kernels/sq ft). Count grains on ground inside a 12x12 inch square frame. Default: 6. Min: 0.5. Max: 50. |