Learn R Programming
PKNCA (version 0.9.4)

PKNCAconc: Create a PKNCAconc object

Description

Create a PKNCAconc object

Usage

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,
  ...
)

Arguments

data

A data frame with concentration (or amount for urine/feces), time, and the groups defined in formula.

...

Ignored.

formula

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.

subject

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.

time.nominal

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

exclude

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

duration

(optional) The duration of collection as is typically used for concentration measurements in urine or feces.

volume

(optional) The volume (or mass) of collection as is typically used for urine or feces measurements.

exclude_half.life, include_half.life

Points to exclude from the half-life calculation (still using normal selection rules for the other points) or to include for the half-life (using specifically those points and bypassing automatic point selection).

Value

A PKNCAconc object that can be used for automated NCA.

See Also

Other PKNCA objects: PKNCAdata(), PKNCAdose(), PKNCAresults()