SWIM (version 1.0.0)

stress_mean_sd_w: Stressing Mean and Standard Deviation

Description

Provides weights on simulated scenarios from a baseline stochastic model, such that a stressed model component (random variable) fulfils a constraint on its mean and standard deviation. Scenario weights are selected by constrained minimisation of the Wasserstein distance to the baseline model.

Usage

stress_mean_sd_w(
  x,
  new_means,
  new_sd,
  k = 1,
  h = 1,
  names = NULL,
  log = FALSE,
  method = "Nelder-Mead",
  ...
)

Arguments

x

A vector, matrix or data frame containing realisations of random variables. Columns of x correspond to random variables; OR A SWIMw object, where x corresponds to the underlying data of the SWIMw object. The stressed random component is assumed continuously distributed.

new_means

Numeric, the stressed mean.

new_sd

Numeric, the stressed standard deviation.

k

Numeric, the column of x that is stressed (default = 1).

h

Numeric, a multiplier of the default bandwidth using Silverman<U+2019>s rule (default h = 1).

names

Character vector, the names of stressed models.

log

Boolean, the option to print weights' statistics.

method

The method to be used in [stats::optim()]. (default = Nelder-Mead).

...

Additional arguments to be passed to nleqslv.

Value

A SWIMw object containing:

• x, a data.frame containing the data;

• h, h is a multiple of the Silverman<U+2019>s rule;

• u, vector containing the gridspace on [0, 1];

• lam, vector containing the lambda's of the optimized model;

• str_fY, function defining the densities of the stressed component;

• str_FY, function defining the distribution of the stressed component;

• str_FY_inv, function defining the quantiles of the stressed component;

• gamma, function defining the risk measure;

• new_weights, a list of functions, that applied to the kth column of x, generates the vectors of scenario weights. Each component corresponds to a different stress;

• type = "mean sd";

• specs, a list, each component corresponds to a different stress and contains k, new_means and new_sd.

See SWIM for details.

References

Pesenti2019reverseSWIM

Pesenti2020SSRNSWIM

Pesenti2021SSRNSWIM

See Also

Other stress functions: stress_HARA_RM_w(), stress_RM_mean_sd_w(), stress_RM_w(), stress_VaR_ES(), stress_VaR(), stress_mean_sd(), stress_mean_w(), stress_mean(), stress_moment(), stress_prob(), stress_user(), stress_wass(), stress()

Examples

# NOT RUN {
set.seed(0)
x <- as.data.frame(cbind(
  "normal" = rnorm(1000),
  "gamma" = rgamma(1000, shape = 2)))
res1 <- stress_wass(type = "mean sd", x = x, k = 1,
  new_means=1, new_sd=0.9)
  summary(res1)

## calling stress_RM_w directly
## stressing "gamma"
res2 <- stress_mean_sd_w(x = x, 
  new_means=2.2, new_sd=1.5, k = 2)
summary(res2)
# }
# NOT RUN {
# }