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()