omni_offgrid_generator_fuel
Calculate hourly fuel consumption, tank runtime, and cost per kWh for off-grid diesel, propane, or natural gas generators using rated kW, load percentage, tank capacity, and fuel price.
Instructions
Off-Grid Diesel & Propane Generator Fuel Consumption Calculator. Calculate hourly fuel consumption in gallons, run-time on tank, and cost per kilowatt-hour for diesel, propane, and natural gas standby generators. Discipline: ENERGY. Governing mathematical model / formula: Diesel Fuel Burn ≈ 0.07 × Rated kW (at 50% load) to 0.08 × Rated kW (at 100% load) gal/hr.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of hourly_burn_rate (Hourly Fuel Consumption Rate), tank_runtime_hours (Continuous Runtime on Tank), hourly_fuel_cost (Operating Cost per Hour), cost_per_kwh_gen (Cost per Generated kWh) using generator_rated_kw (Generator Rated Output (kW) in kW), electrical_load_pct (Average Operating Load (%) in %), fuel_type (Fuel Type (1 = Diesel, 2 = Propane LPG, 3 = Natural Gas)), fuel_tank_capacity (Fuel Tank Capacity (Gallons) in gal), fuel_cost_per_unit (Fuel Price ($/Gallon or $/Therm)). 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 'Off-Grid Diesel & Propane Generator Fuel Consumption 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): "offgrid-generator-fuel"
category (string): "energy"
name (string): "Off-Grid Diesel & Propane Generator Fuel Consumption Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.hourly_burn_rate (Hourly Fuel Consumption Rate): Formatted display string (e.g. '1.40 gal/hr')
metrics.tank_runtime_hours (Continuous Runtime on Tank): Formatted display string (e.g. '35.7 hours')
metrics.hourly_fuel_cost (Operating Cost per Hour): Formatted display string (e.g. '$5.39 / hr')
metrics.cost_per_kwh_gen (Cost per Generated kWh): Formatted display string (e.g. '$0.54 / kWh')
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_offgrid_generator_fuel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fuel_type | No | Fuel Type (1 = Diesel, 2 = Propane LPG, 3 = Natural Gas). 1: Diesel, 2: Propane (gal/hr), 3: Natural Gas (therms/hr). Default: 1. Min: 1. Max: 3. | |
| fuel_cost_per_unit | No | Fuel Price ($/Gallon or $/Therm). Current local price per gallon. Default: 3.85. Min: 1. Max: 10. | |
| fuel_tank_capacity | No | Fuel Tank Capacity (Gallons) (gal). Volume of base tank or auxiliary fuel storage. Default: 50. Min: 5. Max: 1000. | |
| generator_rated_kw | No | Generator Rated Output (kW) (kW). Continuous prime or standby power rating. Default: 20. Min: 3. Max: 250. | |
| electrical_load_pct | No | Average Operating Load (%) (%). 50% is standard nominal operating load. Default: 50. Min: 25. Max: 100. |