omni_dim_weight_calculator
Calculates dimensional and billable parcel weight from box dimensions, actual weight, and DIM divisor to determine carrier charges and volumetric weight penalties.
Instructions
Dimensional Weight (DIM Factor 139 / 166) Calculator. Calculate volumetric dimensional weight, billable weight, and carrier rate adjustments for FedEx, UPS, DHL, and USPS domestic and international parcels. Discipline: LOGISTICS. Governing mathematical model / formula: DIM Weight (lbs) = (Length × Width × Height in inches) / DIM Divisor (139 or 166).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of billable_weight_lbs (Carrier Billable Weight), dimensional_weight_lbs (Calculated DIM Weight), package_volume_cuft (Total Package Volume), dim_premium_pct (Volumetric Weight Penalty) using box_length_in (Box Length (Inches) in in), box_width_in (Box Width (Inches) in in), box_height_in (Box Height (Inches) in in), actual_weight_lbs (Actual Scale Weight (lbs) in lbs), dim_divisor (Carrier DIM Factor (139 = FedEx/UPS Daily, 166 = USPS/Retail)). 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 'Dimensional Weight (DIM Factor 139 / 166) 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): "dim-weight-calculator"
category (string): "logistics"
name (string): "Dimensional Weight (DIM Factor 139 / 166) Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.billable_weight_lbs (Carrier Billable Weight): Formatted display string (e.g. '50.0 lbs')
metrics.dimensional_weight_lbs (Calculated DIM Weight): Formatted display string (e.g. '49.8 lbs (Billed as 50 lbs)')
metrics.package_volume_cuft (Total Package Volume): Formatted display string (e.g. '4.00 cu ft')
metrics.dim_premium_pct (Volumetric Weight Penalty): Formatted display string (e.g. '+127% Above Scale Weight')
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_dim_weight_calculator"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dim_divisor | No | Carrier DIM Factor (139 = FedEx/UPS Daily, 166 = USPS/Retail). Standard commercial divisor is 139, retail is 166. Default: 139. Min: 115. Max: 250. | |
| box_width_in | No | Box Width (Inches) (in). Second package dimension. Default: 18. Min: 1. Max: 72. | |
| box_height_in | No | Box Height (Inches) (in). Third package dimension. Default: 16. Min: 1. Max: 72. | |
| box_length_in | No | Box Length (Inches) (in). Longest package dimension. Default: 24. Min: 1. Max: 108. | |
| actual_weight_lbs | No | Actual Scale Weight (lbs) (lbs). Physical weight measured on postal scale. Default: 22. Min: 0.5. Max: 150. |