omni_drug_volume_of_distribution
Calculate apparent volume of distribution and required loading dose from IV dose, extrapolated peak concentration, patient weight, and target plasma concentration.
Instructions
Apparent Volume of Distribution (Vd) & Loading Dose Calculator. Calculate apparent Volume of Distribution (Vd in L and L/kg) and determine exact intravenous or oral loading doses required to reach target plasma concentrations immediately. Discipline: BIOTECH. Governing mathematical model / formula: Vd = Dose_IV / C₀ | Loading Dose = (Target Plasma Conc · Vd) / Bioavailability (F).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of apparent_volume_of_distribution_vd (Apparent Volume of Distribution (Vd)), normalized_vd_liters_per_kg (Normalized Vd (L/kg)), calculated_target_loading_dose (Required Loading Dose (IV)), tissue_binding_classification (Physiological Distribution Pattern) using administered_iv_dose_mg (Administered IV Bolus Dose (mg) in mg), extrapolated_peak_c0_mg_l (Extrapolated Peak Plasma Conc C₀ (mg/L) in mg/L), patient_body_weight_kg (Patient Weight (kg) in kg), desired_target_plasma_conc (Desired Target Plasma Level (mg/L) in mg/L). 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 'Apparent Volume of Distribution (Vd) & Loading Dose 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): "drug-volume-of-distribution"
category (string): "biotech"
name (string): "Apparent Volume of Distribution (Vd) & Loading Dose Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.apparent_volume_of_distribution_vd (Apparent Volume of Distribution (Vd)): Formatted display string (e.g. '40.0 Liters')
metrics.normalized_vd_liters_per_kg (Normalized Vd (L/kg)): Formatted display string (e.g. '0.57 L/kg')
metrics.calculated_target_loading_dose (Required Loading Dose (IV)): Formatted display string (e.g. '600.0 mg Loading Dose')
metrics.tissue_binding_classification (Physiological Distribution Pattern): Formatted display string (e.g. 'Total Body Water Distribution (~0.6 L/kg)')
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_drug_volume_of_distribution"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| patient_body_weight_kg | No | Patient Weight (kg) (kg). Patient weight to calculate normalized Vd (L/kg). Default: 70. Min: 10. Max: 250. | |
| administered_iv_dose_mg | No | Administered IV Bolus Dose (mg) (mg). Intravenous dose administered at start of trial. Default: 500. Min: 1. Max: 10000. | |
| extrapolated_peak_c0_mg_l | No | Extrapolated Peak Plasma Conc C₀ (mg/L) (mg/L). Plasma level extrapolated back to time t=0. Default: 12.5. Min: 0.01. Max: 500. | |
| desired_target_plasma_conc | No | Desired Target Plasma Level (mg/L) (mg/L). Therapeutic trough or peak target. Default: 15. Min: 0.1. Max: 500. |