Learn R Programming

spartan (version 3.0.2)

oat_csv_result_file_analysis: Performs a robustness analysis for supplied simulation data, comparing simulation behaviour at different parameter values

Description

This method takes either the CSV file created in oat_processParamSubsets or provided by the user and analyses the impact that a change in a single parameter value has had on simulation response. This is performed by comparing the distribution of responses for a perturbed parameter condition with the distribution under baseline/calibrated conditions. This produces a CSV file, in the directory stated in FILEPATH, named as stated by parameter ATESTRESULTSFILENAME, containing the A-Test scores for all parameter conditions under which the simulation was run. This method can be performed for a number of simulation timepoints, producing these statistics for each timepoint taken.

Usage

oat_csv_result_file_analysis(FILEPATH, CSV_FILE_NAME, PARAMETERS, BASELINE,
  MEASURES, ATESTRESULTFILENAME, PMIN = NULL, PMAX = NULL,
  PINC = NULL, PARAMVALS = NULL, TIMEPOINTS = NULL,
  TIMEPOINTSCALE = NULL, check_done = FALSE)

Arguments

FILEPATH

Directory where either the simulation runs or single CSV file result can be found

CSV_FILE_NAME

Name of the CSV file in which the results of all simulations exist (or have been summarised)

PARAMETERS

Array containing the names of the parameters for which local analyses are being conducted

BASELINE

Array containing the values assigned to each of these parameters in the calibrated baseline

MEASURES

Array containing the names of the output measures which are used to analyse the simulation

ATESTRESULTFILENAME

File name of the ATests result summary file that will be created For one timepoint, this could be ATests.csv. For additional timepoints, the time is added to the file name

PMIN

Array containing the minimum value that should be used for each parameter. Sets a lower bound on sampling space

PMAX

Array containing the maximum value that should be used for each parameter. Sets an upper bound on sampling space

PINC

Array containing the minimum value that should be used for each parameter. Sets a lower bound on sampling space

PARAMVALS

Array containing a list of strings for each parameter, each string containing comma separated values that should be assigned to that parameter. Thus sampling can be performed for specific values for each parameter, rather than a uniform incremented value. This replaces the PMIN, PMAX, and PINC where this method is used

TIMEPOINTS

Implemented so this method can be used when analysing multiple simulation timepoints. If only analysing one timepoint, this should be set to NULL. If not, this should be an array of timepoints, e.g. c(12,36,48,60)

TIMEPOINTSCALE

Implemented so this method can be used when analysing multiple simulation timepoints. Sets the scale of the timepoints being analysed, e.g. "Hours"

check_done

Whether the input has been checked (used when doing multiple timepoints)