omni_compression_ratio
Calculate engine static compression ratio from cylinder swept volume, chamber, gasket, and piston volumes to get deterministic results and eliminate LLM arithmetic errors.
Instructions
Engine Static Compression Ratio Calculator. Calculate static compression ratio (CR) from cylinder swept volume, combustion chamber cc, head gasket thickness/bore, and piston dome/dish volume. Discipline: PHYSICS. Governing mathematical model / formula: Compression Ratio = (Swept Volume + Clearance Volume) / Clearance Volume.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of static_cr_result (Static Compression Ratio), total_clearance_vol (Total Clearance Volume), octane_guidance (Recommended Fuel Octane), total_cylinder_volume (Total BDC Volume) using cyl_swept_vol_cc (Cylinder Swept Volume (cc) in cc), chamber_cc (Cylinder Head Chamber Volume (cc) in cc), gasket_cc (Compressed Head Gasket Volume (cc) in cc), piston_net_cc (Piston Dome (+) or Dish/Deck (-) Volume (cc) in cc). 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.
SIBLING ROUTING: Use this dedicated specialist tool for 'Engine Static Compression Ratio Calculator' rather than generic dispatchers like omni_universal_query. For cross-discipline dynamic dispatch, see omni_universal_query.
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): "compression-ratio"
category (string): "physics"
name (string): "Engine Static Compression Ratio Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.static_cr_result (Static Compression Ratio): Formatted display string (e.g. '9.27 : 1.0')
metrics.total_clearance_vol (Total Clearance Volume): Formatted display string (e.g. '60.50 cc')
metrics.octane_guidance (Recommended Fuel Octane): Formatted display string (e.g. 'Regular 87 AKI Unleaded')
metrics.total_cylinder_volume (Total BDC Volume): Formatted display string (e.g. '560.50 cc')
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_compression_ratio"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gasket_cc | No | Compressed Head Gasket Volume (cc) (cc). Volume occupied by head gasket bore/thickness. Default: 6.5. Min: 1. Max: 25. | |
| chamber_cc | No | Cylinder Head Chamber Volume (cc) (cc). Measured combustion chamber volume. Default: 58. Min: 20. Max: 150. | |
| piston_net_cc | No | Piston Dome (+) or Dish/Deck (-) Volume (cc) (cc). Dish adds volume (-); dome reduces clearance (+). Default: -4. Min: -50. Max: 50. | |
| cyl_swept_vol_cc | No | Cylinder Swept Volume (cc) (cc). Single cylinder displacement in cc. Default: 500. Min: 50. Max: 2000. |