Create a PKNCAdose object
PKNCAdose(data, ...)# S3 method for default
PKNCAdose(data, ...)
# S3 method for tbl_df
PKNCAdose(data, ...)
# S3 method for data.frame
PKNCAdose(data, formula, route, rate, duration, time.nominal, exclude, ...)
A PKNCAconc object that can be used for automated NCA.
A data frame with time and the groups defined in
formula
.
Ignored.
The formula defining the
dose.amount~time|groups
where time
is the time of the
dosing and dose.amount
is the amount administered at that
time (see Details).
Define the route of administration. The value may be
either a column name from the data
(checked first) or a
character string of either "extravascular"
or
"intravascular"
(checked second). If given as a column
name, then every value of the column must be either
"extravascular"
or "intravascular"
.
(optional) for "intravascular"
dosing,
the rate or duration of dosing. If given as a character string, it
is the name of a column from the data
, and if given as a
number, it is the value for all doses. Only one may be given, and
if neither is given, then the dose is assumed to be a bolus
(duration=0
). If rate
is given, then the dose amount
must be given (the left hand side of the formula
).
(optional) The name of the nominal time column
(if the main time variable is actual time. The time.nominal
is not used during calculations; it is available to assist with
data summary and checking.
(optional) The name of a column with concentrations to
exclude from calculations and summarization. If given, the column
should have values of NA
or ""
for concentrations to
include and non-empty text for concentrations to exclude.
The formula
for a PKNCAdose
object can be
given three ways: one-sided (missing left side), one-sided (missing
right side), or two-sided. Each of the three ways can be given
with or without groups. When given one-sided missing the left
side, the left side can either be omitted or can be given as a
period (.
): ~time|treatment+subject
and
.~time|treatment+subject
are identical, and dose-related NCA
parameters will all be reported as not calculable (for example,
clearance). When given one-sided missing the right side, the right
side must be specified as a period (.
):
dose~.|treatment+subject
, and only a single row may be given
per group. When the right side is missing, PKNCA assumes that the
same dose is given in every interval. When given as a two-sided
formula
Other PKNCA objects:
PKNCAconc()
,
PKNCAdata()
,
PKNCAresults()