Create a PKNCAconc object
PKNCAconc(data, ...)# S3 method for default
PKNCAconc(data, ...)
# S3 method for tbl_df
PKNCAconc(data, ...)
# S3 method for data.frame
PKNCAconc(
data,
formula,
subject,
time.nominal,
exclude,
duration,
volume,
exclude_half.life,
include_half.life,
sparse = FALSE,
...
)
A PKNCAconc object that can be used for automated NCA.
A data frame with concentration (or amount for urine/feces),
time, and the groups defined in formula
.
Ignored.
The formula defining the concentration~time|groups
or
amount~time|groups
for urine/feces (In the remainder of the
documentation, "concentration" will be used to describe concentration or
amount.) One special aspect of the groups
part of the formula is that
the last group is typically assumed to be the subject
; see the
documentation for the subject
argument for exceptions to this assumption.
The column indicating the subject number. If not provided,
this defaults to the beginning of the inner groups: For example with
concentration~time|Study+Subject/Analyte
, the inner groups start with the
first grouping variable before a /
, Subject
. If there is only one
grouping variable, it is assumed to be the subject (e.g.
concentration~time|Subject
), and if there are multiple grouping variables
without a /
, subject is assumed to be the last one. For single-subject
data, it is assigned as NULL
.
(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.
(optional) The duration of collection as is typically used for concentration measurements in urine or feces.
(optional) The volume (or mass) of collection as is typically used for urine or feces measurements.
A character scalar for the column name in the dataset of the points to exclude from the half-life calculation (still using normal curve-stripping selection rules for the other points) or to include for the half-life (using specifically those points and bypassing automatic curve-stripping point selection). See the "Half-Life Calculation" vignette for more details on the use of these arguments.
Are the concentration-time data sparse PK (commonly used in small nonclinical species or with terminal or difficult sampling) or dense PK (commonly used in clinical studies or larger nonclinical species)?
Other PKNCA objects:
PKNCAdata()
,
PKNCAdose()
,
PKNCAresults()