Exports virtual subjects obtained through individual parameter estimation or sampling from population distribution

The export consists of a folder in which the underlying structural model is stored in the form of a text based IQRmodel. Parameters for all virtual subjects are stored as a CSV file of the following format: Column names: NAME, TYPE, INFO, VS1, VS2, ... VSN. Exported parameter values are either the individual parameter estimates of a model fit or can be sampled from the estimated population distribution (with or without uncertainty). The columns in the exported CSV Virtual Subjects file have the following meaning and content:

  • NAME: Name of the parameter or state in the model. Parameters that are assigned by initial assignments are not exported.

  • TYPE: "State" or "Parameter" or "Parameter (individual)".

  • INFO: The comment in the IQRmodel for the respective element. "NA" if not present

  • VS1...N: The value of the respective element for virtual subject 1...N

exportVirtualSubjects_IQRnlmeProject(
  projectPath,
  pathname,
  FLAGoverwrite = FALSE,
  Nsamples = NULL,
  covariates = NULL,
  FLAGuncertainty = FALSE,
  FLAGss = TRUE,
  comment = NULL,
  timeSS = 10000,
  opt_abstol = 1e-06,
  opt_reltol = 1e-06
)

Arguments

projectPath

Pato to an IQRsysProject or IQRnlmeProject to obtain the individual parameters from - or to sample from the population distribution.

pathname

The pathname to which to export structural model and virtual subject parameters.

FLAGoverwrite

Logical. If TRUE then an existing pathname will be removed and newly created.

Nsamples

If set to a value >=1 then instead of storing the individual parameter estimates, Nsamples individual parameterizations will be drawn from the population distribution. By default this is set to NULL, which results in storage of the individual parameter estimates.

covariates

A data.frame that can be passed to the sampling function (Nsamples >= 1). Each column in this data.frame can have the name of a covariate in the project and will be used to determine new samples of individual parameters. If row number less than Nsamples, sampling is done with replacement. If row number is larger then no replacement will be done and if row number is identical to Nsamples the exact values will be used in the order of obtained individual parameters.

FLAGuncertainty

Logical. If TRUE then new population mean parameters will be drawn from the uncertainty distribution and then new individual parameters are sampled from these. If FALSE, then point estimates of population mean parameters are used.

FLAGss

Logical. If TRUE then each individual parameterization will be simulated until steady-state to allow storage of parameters and associated steady-state state variables as initial conditions for subsequent simulations. If FALSE then state variables and parameter will be stored as is. Only non-numerical ICs will be calculated based on parameterization in the latter case. Normally a user would want to always set this to TRUE.

comment

A comment about the virtual subject population can be provided and will be stored in a separate file - using the same name but with .info attached. File will be only written if a comment is provided.

timeSS

The time to be used to simulate to steady-state (if desired by setting FLAGss to TRUE)

opt_abstol

The absolute integrator tolerance for steady-state simulation

opt_reltol

The relative integrator tolerance for steady-state simulation

Details

Note that in the case of an IQRsysProject the random effects are not sampled from the population distribution (as this is not estimated in sysfit) but from the empirical post-hoc eta distribution. If an IQRnlmeProject is used as a basis (estimated in NONMEM, MONOLIX, or NLMIXR) then the estimated random effects will be used.

Virtual subjects are 1-N parameterizations of a model that are either obtained from individual fits or from sampling from the population parameters. These individual parameterizations can be stored along with the structural model in a folder of the users choice. Functionality is available to allow loading this information again and simulate these individual virtual subjects. Virtual cohorts are formed by a number of subjects (N>1), Virtual populations are formed by a larger number of virtual subjects (N>>1). It is assumed that statistical properties on the population level are matched by the virtual population if the estimation of the parameters led to an adequate description of the underlying population.

See also

Other IQRnlmeProject: IQRnlmeEst(), IQRnlmeProject(), addCovariateToModelSpec_IQRest(), addPar_modelSpec(), as_IQRnlmeProject(), as_IQRnlmeProjectMulti(), bootstrap_IQRnlmeProject(), compareModels_IQRnlmeProjectMulti(), convertETAINDIVPRED_IQRnlmeProject(), covariateEffect_IQRnlmeProject(), data_IQRest(), dosing_IQRest(), duplicate_IQRnlmeProject(), eigenvalues_IQRnlmeProject(), getData_IQRnlmeProject(), getETAs_IQRnlmeProject(), getEst_IQRnlmeProject(), getHeader_IQRnlmeProject(), getIndivParameters_IQRnlmeProject(), getIndivPredictions_IQRnlmeProject(), getModel_IQRnlmeProject(), getObsPred_IQRnlmeProject(), getPopParameters_IQRnlmeProject(), getResults_IQRnlmeProject(), getResults_IQRnlmeProjectMulti(), hasrun_IQRnlmeProject(), hasrun_IQRnlmeProjectMulti(), informationContent_IQRnlmeProject(), is_IQRnlmeEst(), is_IQRnlmeProject(), is_IQRnlmeProjectMulti(), is_MONOLIX_IQRnlmeProject(), is_NLMIXR_IQRnlmeProject(), is_NONMEM_IQRnlmeProject(), modelSpec_IQRest(), outlier_IQRnlmeProject(), plot.IQRnlmeProject(), plot.IQRnlmeProjectMulti(), plotBLQVPC_IQRdataVPC(), plotConvergence_IQRnlmeProject(), plotETACOV_IQRnlmeProject(), plotETA_IQRnlmeProject(), plotGOF_IQRnlmeProject(), plotINDIVSIM_IQRnlmeProject(), plotINDIV_IQRnlmeProject(), plotMEANSIM_IQRnlmeProject(), plotVPC_IQRdataVPC(), pred_IQRnlmeProject(), print.IQRnlmeEst(), print.IQRnlmeProject(), print.IQRnlmeProjectMulti(), print_modelSpec(), run_IQRnlmeProject(), run_IQRnlmeProjectMulti(), sample_IQRnlmeProject(), scm_IQRnlmeProject(), summary.IQRnlmeProject(), summary.IQRnlmeProjectMulti(), summaryComments_IQRnlmeProjectMulti(), summaryCorrelations_IQRnlmeProjectMulti(), summaryCovariates_IQRnlmeProjectMulti(), summaryParameters_IQRnlmeProjectMulti(), vpc_IQRnlmeProject()

Other QSP: IQRsysEst(), IQRsysModel(), IQRsysProject(), addOutputs_IQRmodel(), addRelations_IQRmodel(), as_IQRsysEst(), as_IQRsysProject(), as_IQRsysProjectMulti(), comparePars_IQRsysModel(), duplicate_IQRsysProject(), exportVariant_IQRmodel(), export_IQRsysData(), getDosing_IQRsysModel(), getEmpiricalETACovarianceMatrix_IQRsysProject(), getOptTrace_IQRsysProject(), getPars_IQRoptTrace(), getPars_IQRsysModel(), getPrediction_IQRsysModel(), hasrun_IQRsysProject(), importVariant_IQRmodel(), import_IQRsysData(), is_IQRsysEst(), is_IQRsysModel(), is_IQRsysProject(), is_IQRsysProjectMulti(), load_IQRsysProject(), modelSpec_IQRsysEst(), model_IQRsysModel(), offsetTIME_IQRsysData(), plotDVPRED_IQRsysModel(), plotFit_IQRsysModel(), plotPars_IQRsysModel(), plotPred_IQRsysModel(), plotProfile_IQRsysModel(), plotWRES_IQRsysModel(), plotWaterfall_IQRsysModel(), plot_IQRoptTrace(), plot_IQRsysModel(), print.IQRsensitivity(), print.IQRsysProject(), profile_IQRsysModel(), replaceTerms_IQRmodel(), run_IQRsysProject(), run_IQRsysProjectMulti(), sample_IQRsysModel(), sensitivity_IQRmodel(), setPars_IQRsysModel(), sim_IQRsysModel(), sim_IQRvirtualSubjects(), simbio_CSV2namedVector(), simbio_updateParamIC_IQRmodel(), spmIIV_IQRsysProject(), spm_IQRsysProject(), switchOpt_IQRsysModel(), tablePars_IQRsysModel()