Add Default Configuration for Time Profile Plots

This function adds a default configuration sheet for time profile plots to the plot configuration table. It can either create a new sheet or overwrite an existing one based on the specified parameters.

Usage

addDefaultConfigForTimeProfilePlots(
  projectConfiguration,
  dataObserved = NULL,
  sheetName = "TimeProfiles",
  overwrite = FALSE
)

Arguments

projectConfiguration

A `ProjectConfiguration` class object containing configuration details, including: - `plotsFile`: A string representing the file path to the Excel workbook containing the plot configurations.

dataObserved

Optional. A data object containing observed data, if available.

sheetName

A character string specifying the name of the sheet in the plot configuration table. Default is `TimeProfiles`.

overwrite

A boolean indicating whether existing configurations should be overwritten. Default is FALSE.

Value

NULL This function updates the Excel workbook in place and does not return a value. It is called for its side effects.

Details

The function retrieves scenario definitions, output path IDs, and data groups from the project configuration. It checks if the specified sheet already exists and whether to overwrite it. If not, it creates a new header and fills in the default configuration values for the time profile plots.

Additionally, the function performs a validity check to ensure that it is not executed during a context where helper functions are prohibited (`validRun`). If such a context is detected, an error is raised to prevent execution.

See also

Other plot functions: addDefaultConfigForPKForestPlots(), plotDistributionVsDemographics(), plotHistograms(), plotPKBoxwhisker(), plotPKForestAggregatedAbsoluteValues(), plotPKForestAggregatedRatios(), plotPKForestPointEstimateOfAbsoluteValues(), plotPKForestPointEstimateOfRatios(), plotSensitivity(), plotTimeProfiles()

Other plot configuration helper function: addDefaultConfigForDistributionsVsDemographics(), addDefaultConfigForHistograms(), addDefaultConfigForPKBoxwhsikerPlots(), addDefaultConfigForPKForestPlots()