omni_lumber_board_feet
Calculate board footage and total lumber cost from thickness, width, length, quantity, and price per board foot, returning FBM, cost, and linear footage to prevent formula errors.
Instructions
Board Feet (FBM) & Lumber Price Calculator. Calculate board footage (FBM) and total pricing for rough-sawn and dimensional hardwood and softwood lumber. Discipline: CONSTRUCTION. Governing mathematical model / formula: Board Feet = [Thickness (in) × Width (in) × Length (in)] / 144.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_bf (Total Board Feet (FBM)), single_bf (Board Feet per Piece), total_cost (Total Lumber Cost), linear_footage (Total Linear Footage) using thickness (Nominal Thickness in in), width (Nominal Width in in), length_ft (Board Length in ft), quantity (Number of Pieces), price_per_bf (Price per Board Foot). 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 'Board Feet (FBM) & Lumber Price 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): "lumber-board-feet"
category (string): "construction"
name (string): "Board Feet (FBM) & Lumber Price Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_bf (Total Board Feet (FBM)): Formatted display string (e.g. '150.0 BF')
metrics.single_bf (Board Feet per Piece): Formatted display string (e.g. '10.0 BF')
metrics.total_cost (Total Lumber Cost): Formatted display string (e.g. '$787.50')
metrics.linear_footage (Total Linear Footage): Formatted display string (e.g. '150.0 linear ft')
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_lumber_board_feet"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| width | No | Nominal Width (in). Width in inches. Default: 6. Min: 1. Max: 24. | |
| quantity | No | Number of Pieces. Count of identical boards. Default: 15. Min: 1. Max: 5000. | |
| length_ft | No | Board Length (ft). Length in feet. Default: 10. Min: 1. Max: 30. | |
| thickness | No | Nominal Thickness (in). Thickness in inches (4/4 = 1", 8/4 = 2"). Default: 2. Min: 0.5. Max: 16. | |
| price_per_bf | No | Price per Board Foot. Lumberyard price per FBM. Default: 5.25. Min: 0.5. Max: 50. |