Load Pmetrics NPAG or IT2B output

Loads all the data from an NPAG or IT2B run. This function has been superseded by PM_load, which returns objects. In contrast, PMload loads them directly into the Global environment, which is not best-practice programming.

Usage

PMload(run = 1, ..., remote = F, server_address)

Arguments

run

The numerical value of the folder number containing the run results. This number will also be used to name objects uniquely by appending “.run”, e.g. NPdata.1 or ITdata.1 if run=1. This parameter is 1 by default.

...

Additional runs to load if desired.

remote

Default is FALSE. Set to TRUE if loading results of an NPAG run on remote server. See NPrun. Currently remote runs are not configured for IT2B or the Simulator.

server_address

If missing, will use the default server address returned by getPMoptions(). Pmetrics will prompt the user to set this address the first time the remote argument is set to TRUE in NPrun.

Value

The following objects are loaded into R.

NPdata/ITdata

List with all output from NPAG/IT2B

pop

NPAG only: Population predictions for each output equation

post

NPAG only: Individual posterior predictions for each output equation

final

Final cycle population support points and parameter summary statistics

cycle

Cycle log-likelihood, AIC, BIC, Gamma/lambda, and normalized parameter means, medians and SDs

op

List of observed vs. population and posterior predicted plots for each output equation

cov

Data frame of subject ID, covariate values, and Bayesian posterior parameter estimates

mdata

The original .csv data file used in the run

valid

If makeValid has been executed after a run, this object will be added to the save data. It contains the information required to plot visual predictive checks and normalized prediction error discrepancies via the npde code developed by Comets et al

See also

NPparse, ITparse, makeFinal, makeCycle, makeOP, makeCov, makePop, makePost

Author

Michael Neely