xpose4 (version 4.5.3)

Data: Extract data from an xpose.data object.

Description

Extracts the data from the Data or SData slots in an "xpose.data" object.

Usage

Data(object,
     inclZeroWRES = FALSE,
     onlyfirst = FALSE,
     subset = NULL)
SData(object,
      inclZeroWRES = FALSE,
      onlyfirst = FALSE,
      subset = NULL,
      samp = NULL)
Data(object,quiet=TRUE,keep.structure=F)  <- value
SData(object) <- value

Arguments

object

An "xpose.data" object

inclZeroWRES

Logical value indicating whether rows with WRES==0 should be included in the extracted data.

onlyfirst

Logical value indicating whether only the first line per individual should be included in the extracted data.

subset

Expression with which the extracted data should be subset (see xsubset)

samp

An integer between 1 and object@Nsim (seexpose.data-class) specifying which of the simulated data sets to extract from SData.

quiet

TRUE or FALSE ifFALSE then some more information is printed out when adding data to an Xpose object.

keep.structure

TRUE or FALSE ifFALSE then values are converted to continuous or categorical according to the rules set up by xpose using object@[e-mail], object@[e-mail] and the values in the "catab" file.

value

An R data.frame.

Value

Returns a data.frame from the Data or SData slots, excluding rows as indicated by the arguments.

Details

When using Data to assign a data.frame to the Data slot in the "xpose.data" object a number of things happen:

Each column in the data.frame is checked and set to factor if the number of unique values are less than the value of Cat.levels (see xpose.prefs-class).

It is checked which of the predefined xpose data variables that exists in the data.frame. The variable defintions that does not exist are set to NULL.

The column identified by the dv xpose variable definition, is checked and set to factor if the number of unique values are less than or equal to the DV.Cat.levels (see xpose.prefs-class).

Finally, each column name in the data.frame is checked for a label (see xpose.prefs-class). If it is non-existent, the label is set to the column name.

When SData is used to assign a data.frame to the SData slot it is first checked that the number of rows in the SData data.frame is an even multiple of the number of rown in Data. Next, each column in the SData data.frame is assigned the same class as the corresponding column in the Data data.frame (it is required that the columns are the same in Data and SData). Finally, an extra column, "iter", is added to SData, which indicates the iteration number that each row belongs to. At the same time, the Nsim slot of the "xpose.data" object is set to the number of iterations (see nsim).

See Also

xpose.data-class,xpose.prefs-class

Examples

## xpdb5 is an Xpose data object
## We expect to find the required NONMEM run and table files for run
## 5 in the current working directory
xpdb5 <- xpose.data(5)

## Extract data
my.dataframe <- Data(xpdb5, subset="TIME < 24")

## Assign data
Data(xpdb5) <- my.dataframe

## Extract simulated data
my.simulated.dataframe <- SData(xpdb5)

## Assign simulated data
SData(xpdb5) <- my.simulated.dataframe