omni_insulation_r_value
Calculate insulation R-value, batt/roll package counts, blow-in bag quantities, required thickness, and heat-loss savings from area, target R-value, and roll coverage.
Instructions
Insulation R-Value & Batt Roll Calculator. Calculate thermal resistance R-value, fiberglass batt and roll quantities, and blow-in bag counts for attics and exterior walls. Discipline: CONSTRUCTION. Governing mathematical model / formula: Total Batts = Total Cavity Area / Area per Batt.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of packages_needed (Batt / Roll Packages Needed), required_thickness (Required Fiberglass Thickness), blow_in_bags (Alternative Loose-Fill Bags), energy_savings (Estimated Heat Loss Reduction) using surface_area (Insulation Area in sq ft), target_r_value (Target R-Value), roll_coverage (Coverage per Roll / Package in sq ft). 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 'Insulation R-Value & Batt Roll 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): "insulation-r-value"
category (string): "construction"
name (string): "Insulation R-Value & Batt Roll Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.packages_needed (Batt / Roll Packages Needed): Formatted display string (e.g. '25 rolls')
metrics.required_thickness (Required Fiberglass Thickness): Formatted display string (e.g. '12.0 inches (R-38)')
metrics.blow_in_bags (Alternative Loose-Fill Bags): Formatted display string (e.g. '31 bags (Attic)')
metrics.energy_savings (Estimated Heat Loss Reduction): Formatted display string (e.g. 'Up to 35% heating savings')
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_insulation_r_value"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| surface_area | No | Insulation Area (sq ft). Attic floor or wall frame area. Default: 1200. Min: 50. Max: 10000. | |
| roll_coverage | No | Coverage per Roll / Package (sq ft). Manufacturer roll square footage. Default: 48.9. Min: 20. Max: 150. | |
| target_r_value | No | Target R-Value. R-13/R-15 for 2×4 walls; R-38 to R-60 for attics. Default: 38. Min: 13. Max: 60. |