body_fluid_balance: Body Fluid Balance Calculator

In cliot: Clinical Indices and Outcomes Tools

Body Fluid Balance Calculator

Description

Calculates the net fluid balance over a specified period (typically 24 hours) by summing all sources of fluid intake (Input) and subtracting all sources of fluid loss (Output). This calculation is critical for monitoring hydration status in hospitalized patients, particularly those with heart failure, kidney disease, or shock.

Usage

body_fluid_balance(oral_input_ml = 0, iv_input_ml = 0, enteral_input_ml = 0,
                   other_input_ml = 0, urine_output_ml = 0, stool_output_ml = 0,
                   emesis_ng_output_ml = 0, drain_output_ml = 0,
                   insensible_loss_ml = 0)

Arguments

oral_input_ml	Numeric. Total volume of fluid consumed orally (PO) in milliliters.
iv_input_ml	Numeric. Total volume of intravenous (IV) fluids administered in milliliters (including continuous infusions, boluses, and medication volumes).
enteral_input_ml	Numeric. Total volume of enteral nutrition (tube feeds) and water flushes in milliliters.
other_input_ml	Numeric. Any other fluid intake (e.g., blood products) in milliliters.
urine_output_ml	Numeric. Total volume of urine produced in milliliters.
stool_output_ml	Numeric. Estimated volume of liquid stool or ostomy output in milliliters.
emesis_ng_output_ml	Numeric. Volume of vomit or nasogastric (NG) tube output in milliliters.
drain_output_ml	Numeric. Volume from surgical drains, chest tubes, etc., in milliliters.
insensible_loss_ml	Numeric. Estimated insensible losses (skin, respiration) in milliliters. Often estimated as 500-800 mL/day or 10 mL/kg/day in adults, though highly variable with fever or ventilation.

Value

A list containing:

Net_Fluid_Balance_mL	The calculated balance (Input - Output).
Status	Description of the balance (Positive, Negative, or Neutral).
Summary	Total summed Input and Output values.
Detailed_Inputs	Breakdown of input sources.
Detailed_Outputs	Breakdown of output sources.

References

Mazzoni D, et al. Fluid Balance. In: StatPearls. Treasure Island (FL): StatPearls Publishing. 2023.

Examples

# Example 1: Positive Balance (Fluid Overload concern)
# 2L IV, 500mL Oral, 1L Urine, no other losses
body_fluid_balance(oral_input_ml = 500, iv_input_ml = 2000, urine_output_ml = 1000)

# Example 2: Negative Balance (Dehydration/Diuresis)
# 1L Oral, 2L Urine, 500mL Insensible
body_fluid_balance(oral_input_ml = 1000, urine_output_ml = 2000, insensible_loss_ml = 500)

cliot documentation built on Dec. 1, 2025, 1:06 a.m.