Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

summary

Basic expected shortfall (ES) report on failures and severity

Syntax

S = summary(ebt)

Description

example

S = summary(ebt) returns a basic report on the given esbacktest data, including the number of observations, number of failures, observed confidence level, and so on (see S for details).

Examples

collapse all

Create an esbacktest object.

load ESBacktestData
ebt = esbacktest(Returns,VaRModel1,ESModel1,'VaRLevel',VaRLevel)
ebt = 

  esbacktest with properties:

    PortfolioData: [1966×1 double]
          VaRData: [1966×1 double]
           ESData: [1966×1 double]
      PortfolioID: "Portfolio"
            VaRID: "VaR"
         VaRLevel: 0.9750

Generate the ES summary report.

S = summary(ebt)
S =

  1×11 table

    PortfolioID    VaRID    VaRLevel    ObservedLevel    ExpectedSeverity    ObservedSeverity    Observations    Failures    Expected    Ratio     Missing
    ___________    _____    ________    _____________    ________________    ________________    ____________    ________    ________    ______    _______

    "Portfolio"    "VaR"    0.975       0.97101          1.1928              1.4221              1966            57          49.15       1.1597    0      

Input Arguments

collapse all

esbacktest (ebt) object, contains a copy of the given data (the PortfolioData, VarData, and ESData properties) and all combinations of portfolio ID, VaR ID, and VaR levels to be tested. For more information on creating an esbacktest object, see esbacktest.

Output Arguments

collapse all

Summary report, returned as a table. The table rows correspond to all combinations of portfolio ID, VaR ID, and VaR levels to be tested. The columns correspond to the following information:

  • 'PortfolioID' — Portfolio ID for the given data

  • 'VaRID' — VaR ID for each of the VaR data columns provided

  • 'VaRLevel' — VaR level for the corresponding VaR data column

  • 'ObservedLevel' — Observed confidence level, defined as the number of periods without failures divided by number of observations

  • 'ExpectedSeverity' — Expected average severity ratio, that is, the average ratio of ES to VaR over the periods with VaR failures

  • 'ObservedSeverity' — Observed average severity ratio, that is, the average ratio of loss to VaR over the periods with VaR failures

  • 'Observations' — Number of observations, where missing values are removed from the data

  • 'Failures' — Number of failures, where a failure occurs whenever the loss (negative of portfolio data) exceeds the VaR

  • 'Expected' — Expected number of failures, defined as the number of observations multiplied by 1 minus the VaR level

  • 'Ratio' — Ratio of number of failures to expected number of failures

  • 'Missing' — Number of periods with missing values removed from the sample

    Note

    The 'ExpectedSeverity' and 'ObservedSeverity' ratios are undefined (NaN) when there are no VaR failures in the data.

Introduced in R2017b

Was this topic helpful?