DSAIRM (version 0.5.0)

simulate_modelexploration: Simulation to illustrate parameter scan of the basic bacteria model #'

Description

This function simulates the simple bacteria model ODE for a range of parameters. The function returns a data frame containing the parameter that has been varied and the outcomes (see details).

Usage

simulate_modelexploration(B = 10, I = 1, g = 1, Bmax = 1e+06,
  dB = 0.1, k = 1e-07, r = 0.001, dI = 1, tstart = 0,
  tfinal = 200, dt = 0.1, samples = 10, parmin = 1e-08,
  parmax = 1e-05, samplepar = "k", pardist = "lin")

Arguments

B

: Starting value for bacteria : numeric

I

: Starting value for immune response : numeric

g

: Maximum rate of bacteria growth : numeric

Bmax

: Bacteria carrying capacity : numeric

dB

: Bacteria death rate : numeric

k

: Bacteria kill rate : numeric

r

: Immune response growth rate : numeric

dI

: Immune response decay rate : numeric

tstart

: Start time of simulation : numeric

tfinal

: Final time of simulation : numeric

dt

: Times for which result is returned : numeric

samples

: Number of values to run between pmin and pmax : numeric

parmin

: Lower value for varied parameter : numeric

parmax

: Upper value for varied parameter : numeric

samplepar

: Name of parameter to be varied : character

pardist

: spacing of parameter values, can be either 'lin' or 'log' : character

Value

The function returns the output as a list, list element 'dat' contains the data frame with results of interest. The first column is called xvals and contains the values of the parameter that has been varied as specified by 'samplepar'. The remaining columns contain peak and steady state values of bacteria and immune response, Bpeak, Ipeak, Bsteady and Isteady. A final boolean variable 'steady' is returned for each simulation. It is TRUE if the simulation reached steady state, otherwise FALSE.

Notes

The parameter dt only determines for which times the solution is returned, it is not the internal time step. The latter is set automatically by the ODE solver.

Warning

This function does not perform any error checking. So if you try to do something nonsensical (e.g. specify negative parameter values or fractions > 1), the code will likely abort with an error message.

Details

##this code illustrates how to do analyze a simple model. A simple 2 compartment ODE model (the simple bacteria model introduced in the app of that name) is simulated for different parameter values. This function runs the simple bacterial infection model for a range of parameters. The user can specify which parameter is sampled, and the simulation returns for each parameter sample the peak and final value for B and I. Also returned is the varied parameter and an indicator if steady state was reached.

See Also

See the shiny app documentation corresponding to this simulator function for more details on this model.

Examples

# NOT RUN {
# To run the simulation with default parameters just call the function:
# }
# NOT RUN {
res <- simulate_modelexploration()
# }
# NOT RUN {
# To choose parameter values other than the standard one, specify them, like such:
res <- simulate_modelexploration(tfinal=100, samples=5, samplepar='Bmax', parmin=1e1, parmax=1e5)
# You should then use the simulation result returned from the function, like this:
plot(res$dat[,"xvals"],res$data[,"Bpeak"],xlab='Parameter values',ylab='Peak Bacteria',type='l')
# }