omni_bac
Calculate blood alcohol concentration and hours until sober from drink count, body weight, drinking duration, and biological sex using the Widmark formula for exact results.
Instructions
Blood Alcohol Concentration (BAC) Calculator. Calculate Blood Alcohol Concentration (BAC) and hours until sober using the clinically validated Widmark chemical distribution formula. Discipline: HEALTH. Governing mathematical model / formula: BAC = [Alcohol Consumed (g) / (Body Weight (g) × r)] × 100 - (β × Hours).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of bac_percentage (Estimated BAC), legal_status (Legal Driving Status (0.08% Limit)), hours_to_sober (Hours Until 0.00% Zero BAC), alcohol_grams (Pure Alcohol Ingested) using drinks_count (Standard Drinks Consumed), body_weight_lbs (Body Weight in lbs), drinking_hours (Hours Since First Drink in hrs), gender_factor (Biological Sex (1 for Male, 0 for Female)). 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 'Blood Alcohol Concentration (BAC) 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): "bac"
category (string): "health"
name (string): "Blood Alcohol Concentration (BAC) Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.bac_percentage (Estimated BAC): Formatted display string (e.g. '0.046%')
metrics.legal_status (Legal Driving Status (0.08% Limit)): Formatted display string (e.g. 'Under Legal Limit')
metrics.hours_to_sober (Hours Until 0.00% Zero BAC): Formatted display string (e.g. '3.1 Hours Remaining')
metrics.alcohol_grams (Pure Alcohol Ingested): Formatted display string (e.g. '42.0 grams')
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_bac"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| drinks_count | No | Standard Drinks Consumed. 1 drink = 12oz beer (5%), 5oz wine (12%), or 1.5oz shot (40%). Default: 3. Min: 1. Max: 20. | |
| gender_factor | No | Biological Sex (1 for Male, 0 for Female). r = 0.68 for males, r = 0.55 for females. Default: 1. Min: 0. Max: 1. | |
| drinking_hours | No | Hours Since First Drink (hrs). Total elapsed drinking duration. Default: 2. Min: 0.5. Max: 12. | |
| body_weight_lbs | No | Body Weight (lbs). Weight in pounds. Default: 175. Min: 80. Max: 400. |