dli_volume_calculator: Donor Lymphocyte Infusion (DLI) Volume Calculator

In cliot: Clinical Indices and Outcomes Tools

Donor Lymphocyte Infusion (DLI) Volume Calculator

Description

Estimates the volume of whole blood to process via apheresis to collect the required number of CD3+ cells for Donor Lymphocyte Infusion (DLI). The calculation accounts for recipient weight, target dose per infusion, number of infusions, donor blood parameters, and machine collection efficiency.

Usage

dli_volume_calculator(recipient_weight_kg, target_cd3_dose_per_kg,
                      donor_wbc_count_cells_ul, donor_lymphocyte_percent,
                      donor_cd3_percent, collection_efficiency_percent,
                      num_infusions)

Arguments

recipient_weight_kg	Numeric. Recipient's weight in kilograms.
target_cd3_dose_per_kg	Numeric. The target dose of CD3+ cells per kg (e.g., 1e7).
donor_wbc_count_cells_ul	Numeric. Donor's White Blood Cell count in cells/uL (e.g., 6000).
donor_lymphocyte_percent	Numeric. Percentage of lymphocytes in the donor's WBC differential (0-100).
donor_cd3_percent	Numeric. Percentage of CD3+ cells within the lymphocyte population (0-100).
collection_efficiency_percent	Numeric. The efficiency of the apheresis machine in collecting lymphocytes (typically 40-60%).
num_infusions	Numeric. The total number of DLI doses planned for the recipient.

Value

A list containing:

Volume_to_Process_L	The estimated volume of donor blood to process in Liters.
Total_CD3_Cells_Required	The total absolute count of CD3+ cells needed.
Donor_CD3_Concentration_cells_mL	The calculated concentration of CD3+ cells in the donor's blood.

References

Guidelines on the Use of Therapeutic Apheresis in Clinical Practice. J Clin Apher. 2019.

Examples

# Example 1: Standard Collection
# 70kg Recipient, Target 1x10^7 cells/kg, 1 Dose
# Donor: WBC 6000/uL, Lymphs 30%, CD3 70%, Efficiency 50%
dli_volume_calculator(70, 1e7, 6000, 30, 70, 50, 1)

# Example 2: Multiple Doses
# Same patient, but 3 doses planned
dli_volume_calculator(70, 1e7, 6000, 30, 70, 50, 3)

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