Skip to content

Chemotherapy

compute_cell_death_rate_for_chemo(t, chemo_spec)

Compute the rate of cell death induced by chemotherapy at a given time.

Parameters:

Name Type Description Default
t datetime

The current time for the calculation.

required
chemo_spec ChemotherapySpecification

Specifications for chemotherapy, including sensitivity and protocol.

required

Returns:

Name Type Description
float Tensor

The rate of cell death induced by the drug.

compute_chemo_concentration_for_dose(t, decay_rate, treatment_day, dose)

Compute the drug concentration for a single chemotherapy dose.

This uses an exponential decay model to calculate the concentration of the drug at a specific time after its administration.

Parameters:

Name Type Description Default
t datetime

The current time for concentration calculation.

required
decay_rate float

The drug decay rate (1/day).

required
treatment_day TreatmentTime

The time the dose was administered.

required
dose float

The administered dose.

required

Returns:

Name Type Description
float float

The drug concentration at time t.

compute_chemo_concentrations(t, chemotherapy_specification)

Compute the concentrations of chemotherapy drugs for all doses in a protocol.

Parameters:

Name Type Description Default
t datetime

The current time for concentration calculation.

required
chemotherapy_specification ChemotherapySpecification

Specifications for chemotherapy, including protocol and decay rate.

required

Returns:

Type Description
List[float]

List[float]: A list of drug concentrations, one for each dose in the protocol.

compute_total_cell_death_chemo(t, chemo_specs)

Compute the total rate of cell death induced by multiple chemotherapy drugs.

Parameters:

Name Type Description Default
t datetime

The current time for the calculation.

required
chemo_specs List[ChemotherapySpecification]

A list of chemotherapy specifications for different drugs.

required

Returns:

Name Type Description
float Tensor

The total rate of cell death induced by all drugs.

plot_chemotherapy(timesteps, chemotherapy_specifications)

Plot chemotherapy drug concentrations and their effects over time.

This function visualizes the time-dependent concentrations of chemotherapy drugs and their sensitivity-scaled effects, as well as the total cell death rate.

Parameters:

Name Type Description Default
timesteps List[datetime]

The times at which to compute the concentrations and effects.

required
chemotherapy_specifications List[ChemotherapySpecification]

Specifications for the chemotherapy drugs to be plotted.

required