IQRdosing objects represent dosing schemes that can be passed to simulation functions included in IQRtools. Essentially, they are data frames with a define set of columns and certain requirements.
IQRdosing(TIME, ADM, AMT, TINF = NULL, RATE = NULL, ADDL = NULL, II = NULL)
Scalar or vector with dosing times (numeric)
Scalar or vector with ADM numbers (matching IQRmodel INPUT*) and same length as TIME. (numeric)
Scalar or vector with dose amount (numeric)
Scalar or vector with duration of administration (numeric) This can be 0 in case of a BOLUS and larger if longer duration administrations happen (e.g. infusion time). 0 values will be implemented by a short duration of 1e-4 time units.
Scalar or vector with rate of administration (numeric) To implement a bolus, RATE needs to be set to 0. Definition of both RATE and TINF will lead to an error.
Additional doses to be given. If undefined ADDL=0, coding for only a single dose record. If ADDL is defined then also II argument needs to be defined.
Dosing interval for additional doses, defined by ADDL. If II is defined then also ADDL needs to be defined.
An IQRdosing object.
The function IQRdosing constructs IQRdosing objects. Required input arguments are: TIME, ADM, AMT, which need to be passed as numeric vectors.
Optional input arguments are: RATE or TINF, ADDL and II. RATE and TINF are mutually exclusive and if defined need to be numeric vectors. ADDL and II need to be present in pair and define the additional doses and the dosing interval. During creation of an IQRdosing object the ADDL and II information will be expanded to separate dose records in the IQRdosing object.
The resulting IQRdosing object has the following columns: TIME, ADM, AMT, TINF
x <- IQRdosing(TIME=0,ADM=1,AMT=400)