`PsiBVaR (cell,percentile,simulation)`

PsiBVaR returns the Value at Risk for the specified uncertain function cell at the specified ‘confidence level,’ which is better described as a percentile – for example, 0.95 or 0.99.  (The “B” stands for “Basel” or “building block,” and is used to distinguish this function name from a function named PsiVar() in the Premium Solver Platform.)

In finance applications, the Value at Risk is the maximum loss that can occur at a given confidence level.  In a distribution of returns or profits, losses would lie at the “left end” of the distribution and would be represented by negative numbers and smaller percentiles (say 0.01 or 0.05).  But it is customary in Value at Risk analysis to treat losses as positive numbers at the “right end” of the distribution.  So we compute PsiBVaR (cell, percentile) as –PsiPercentile(cell, 1- percentile).

For example, PsiBVaR (A1, 0.95) = –PsiPercentile (A1, 0.05).

Two additional arguments are utilized when a Psi Statistic function is used with Dimensional Modeling: Struc_format and Param_slice.

`PsiBVar (cell,percentile,simulation,struc_format,param_slice)`

Struc_format: This argument is an optional argument entered as a string. If omitted, all cube values will be printed in a single column. If “dims” is passed for this argument, the Psi Statistic function will print all dimensions in the cube with their lengths so the user can be advised of the size of the cubes and will be able to estimate the range needed when entering the Psi Statistic function as an array formula. If “vals” is passed for this argument, the result values will be displayed along with the dimension elements in the form of a relational or pivot table. Please see the Simulation example in the Dimensional Modeling chapter in Frontline Solvers User Guide for more information on this function. It’s also possible to use this argument to return the name of a specific element in a cube containing one or more structural dimensions.

To use this argument to return the value of a specific element in a 1-dimensional cube (containing a structural dimension), use the form: “ [StructuralDimisension1].[Element1]”. To use this argument to return the value of a 2-dimensional cube (containing structural dimensions), use the form: “[StructuralDimension1].[Element],[StructuralDimension2].[Element]”.

To use this argument to return the value of a N-dimensional cube (containing structural dimensions), use the form: “[StructuralDimension1].[Element],[StructuralDimension2].[Element],…,[StructuralDimensionN].[Element]”.

Param_slice: The param_slice argument is an optional string argument specifying the desired element “slice” for the parametric dimensions. If omitted the elements selected in the pane will be used. It’s also possible to use this argument to return the value of a specific element in a cube containing one or more parametric dimensions.

To use this argument to return the value of a specific element in a 1-dimensional cube (containing a parametric dimension), use the form: “[ParametricDimisension1].[Element1]”.

To use this argument to return the value of a 2-dimensional cube (containing parametric dimensions), use the form: “[ParametricDimension1].[Element],[ParametricDimension2].[Element]”.