Adds individual parameter estimates from a IQRnlmeProject to a dataset. Existing regression parameters are kept. Existing columns with same names as regression parameters are substituted.

In the case that individual parameter information is not available in the model fit, then the regression parameters will be set to population mean parameters. By default, if covariates have been used in the model, the mean parameters will by adjusted by covariates. Using FLAGnoCovSample=TRUE this can be disabled and only mean point estimates will be imputed.

addIndivRegressors_IQRdataGENERAL(
  projectPath,
  dataPath = NULL,
  data = NULL,
  filename = NULL,
  model = NULL,
  regressorNames = NULL,
  doseNAMES = NULL,
  obsNAMES = NULL,
  FLAGrmNoInd = FALSE,
  FLAGnoCovSample = FALSE,
  FLAGxpt = FALSE,
  FLAGdefine = TRUE,
  FLAGzip = FALSE,
  addColLabels = NULL
)

Arguments

projectPath

IQRnlmeProject folder from which the estimates are added as regression parameters.

dataPath

path to dataset (IQRdataGENERAL) to which regression parameters will be added

data

Instead of the path in dataPath also an IQRdataGENERAL object can be provided.

filename

Filename of the NLME CSV file to create (not more than 8 characters without extension - if FLAGxpt=TRUE). If filename not provided the dataset is returned by the function.

model

If given (IQR model or path to IQR model file), set of added regression parameters is reduced to parameters that exist in the model

regressorNames

If given (character vector), set of added regression parameters is reduced to given set.

doseNAMES

Vector with dose record names to use during NLME data export. ADM values will be set according to the order of NAMEs in the doseNAMES argument

obsNAMES

Vector with observation names to use during NLME data export. YTYPE values will be set according to the order of NAMEs in the obsNAMES argument

FLAGrmNoInd

If TRUE then subjects for which no individual regression parameters are available will be removed. If FALSE, population mean parameters will be used instead.

FLAGnoCovSample

If TRUE then if individual parameters are missing they will be set to point mean estimates without consideration of covariates. If FALSE then covariates will be considered.

FLAGxpt

If TRUE then a SAS XPT file will be generated additionally

FLAGdefine

If TRUE then a define.rmd file will be generated additionally. The syntax of this file is in the IQReport markdown syntax and allows human readbility. The IQReport software can subsequently be used to convert this file to Microsoft WORD, allowing further editing and saving as a PDF file. Please read the documentation for the exportDEFINE_IQRdataGENERAL function to learn more about IQReport.

FLAGzip

If TRUE then the exported data files (.csv, .atr, .xpt, .docx, .rmd, etc.) will be zipped and placed in the potential path in the "filename" as the filename.dat.zip. Other files will be removed.

addColLabels

List with named elements. Names are column names and the value of an element is the label. If defining addColLabels for columns that are already handled automatically, the provided labels will overwrite the automatic ones. Example: addColLabels <- list(IXGDF="Other label",NEWCCOL="Label for NEWCOL"). This information is needed only for XPT and define file generation

Value

If a filename is provided, NULL is returned. Otherwise a list is returned with a vector of the added regression parameter names and the updated dataset.

See also

Other IQRdataGeneral: +.IQRdataGENERAL(), IQRcalcTAD(), IQRdataGENERAL(), IQRexpandADDLII(), IQRloadCSVdata(), IQRsaveCSVdata(), addLabel_IQRdataGENERAL(), attributes0(), blloqInfo_IQRdataGENERAL(), blloq_IQRdataGENERAL(), check_IQRdataGENERAL(), clean_IQRdataGENERAL(), combine_IQRdataGENERAL(), convertCat2Text(), covImpute_IQRdataGENERAL(), date2dateday_IQRdataProgramming(), date2datetime_IQRdataProgramming(), date2time_IQRdataProgramming(), exportDEFINE_IQRaedataER(), exportDEFINE_IQRdataGENERAL(), exportDEFINEpdf_IQRdataGENERAL(), exportSYS_IQRdataGENERAL(), export_IQRdataGENERAL(), getLabels_dataframe(), getNAcolNLME_IQRdataGENERAL(), handleSameTimeObs_IQRdataGENERAL(), is_IQRdataGENERAL(), loadATRinfo_csvData(), loadAttributeFile(), load_IQRdataGENERAL(), mapCategoricalCovariate_IQRnlmeProject(), mapCategoricalCovariate_csvData(), mapContinuousCovariate_IQRnlmeProject(), mapContinuousCovariate_csvData(), mutateCov_IQRdataGENERAL(), obfuscate_IQRdataGENERAL(), plot.IQRdataGENERAL(), plotCorCat_IQRdataGENERAL(), plotCorCovCat_IQRdataGENERAL(), plotCorCov_IQRdataGENERAL(), plotCovDistribution_IQRdataGENERAL(), plotDoseSchedule_IQRdataGENERAL(), plotIndiv_IQRdataGENERAL(), plotRange_IQRdataGENERAL(), plotSampleSchedule_IQRdataGENERAL(), plotSpaghetti_IQRdataGENERAL(), print.IQRdataGENERAL(), removeCommata_dataframe(), rmAMT0_IQRdataGENERAL(), rmDosePostLastObs_IQRdataGENERAL(), rmIGNOREd_IQRdataGENERAL(), rmMissingTIMEobsRecords_IQRdataGENERAL(), rmNOobsSUB_IQRdataGENERAL(), rmNonTask_IQRdataGENERAL(), rmPLACEBO_IQRdataGENERAL(), rmSubjects_IQRdataGENERAL(), setIGNORErecords_IQRdataGENERAL(), setMissingDVobsRecordsIGNORE_IQRdataGENERAL(), subset.IQRdataGENERAL(), summary.IQRdataGENERAL(), summaryCat_IQRdataGENERAL(), summaryCov_IQRdataGENERAL(), summaryObservations_IQRdataGENERAL(), transformObs_IQRdataGENERAL(), unlabel_dataframe()