omni_container_cbm_utilization
Calculate ocean container CBM volume, metric payload, and utilization for 20ft, 40ft, and 40ft HC shipments from carton count, dimensions, and weight.
Instructions
Ocean Shipping Container CBM Volume & Payload Calculator. Calculate cubic meter (CBM) volume, metric ton payload capacity, and container utilization percentage for 20ft, 40ft, and 40ft High Cube (HC) ocean containers. Discipline: LOGISTICS. Governing mathematical model / formula: Total CBM = Total Cartons × (Length × Width × Height in meters) | 1 CBM = 35.315 cu ft.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_cargo_cbm (Total Cargo Volume (CBM)), best_container_type (Recommended Container), total_cargo_mass_kg (Total Cargo Weight), weight_utilization_pct (Payload Weight Allowance) using carton_count (Total Number of Cartons in cartons), carton_l_cm (Carton Length (cm) in cm), carton_w_cm (Carton Width (cm) in cm), carton_h_cm (Carton Height (cm) in cm), carton_weight_kg (Weight per Carton (kg) in kg). 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 'Ocean Shipping Container CBM Volume & Payload 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): "container-cbm-utilization"
category (string): "logistics"
name (string): "Ocean Shipping Container CBM Volume & Payload Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_cargo_cbm (Total Cargo Volume (CBM)): Formatted display string (e.g. '40.2 CBM')
metrics.best_container_type (Recommended Container): Formatted display string (e.g. '1x 40ft Standard (59% full)')
metrics.total_cargo_mass_kg (Total Cargo Weight): Formatted display string (e.g. '12,325 kg (12.33 MT)')
metrics.weight_utilization_pct (Payload Weight Allowance): Formatted display string (e.g. '46.5% of 26,500 kg limit')
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_container_cbm_utilization"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| carton_h_cm | No | Carton Height (cm) (cm). External case height. Default: 30. Min: 10. Max: 150. | |
| carton_l_cm | No | Carton Length (cm) (cm). External case length. Default: 45. Min: 10. Max: 200. | |
| carton_w_cm | No | Carton Width (cm) (cm). External case width. Default: 35. Min: 10. Max: 150. | |
| carton_count | No | Total Number of Cartons (cartons). Total packaged shipping cartons. Default: 850. Min: 10. Max: 10000. | |
| carton_weight_kg | No | Weight per Carton (kg) (kg). Weight per case in kilograms. Default: 14.5. Min: 0.5. Max: 100. |