eadChart

Generate exposure-at-default (EAD) chart

Since R2024b

Syntax

eadChart(saccrObj)

eadChart(saccrObj,Name=Value)

h = eadChart(saccrObj,___)

h = eadChart(ax,saccrObj,___)

Description

eadChart(saccrObj) creates a chart of portfolio exposure-at-default (EAD) values. Each EAD value can be decomposed into contributions from replacement cost (RC), potential future exposure (PFE) and alpha scaling. The final EAD values are selected between the uncollateralized and collateralized values to minimize EAD.

eadChart(saccrObj,Name=Value) creates a chart of portfolio EAD values using optional name-value arguments.

h = eadChart(saccrObj,___) additionally returns the figure handle h for the EAD chart.

h = eadChart(ax,saccrObj,___) creates the EAD chart on the axes specified by ax and returns the figure handle h for the chart.

Examples

Create SA-CCR Chart for EAD Values

Use eadChart to create a SA-CCR chart for portfolio exposure-at-default (EAD) values. Each EAD value can be decomposed into contributions from replacement cost (RC), potential future exposure (PFE), and alpha scaling. The final EAD values are selected between the uncollateralized and collateralized values to minimize EAD.

Create saccr Object

Define the FX spot currency exchange rate table.

Base = ["EUR";"GBP";"GBP"];
Quote = ["USD";"USD";"EUR"];
SpotRate = [1.0543;1.2195;1.1567];
FXSpotTable = table(Base,Quote,SpotRate);

Define the ISDA® SA-CCR CRIF filename.

SACCRCRIF = "SACCR_CRIF_Ports_1_to_9.csv";

Use saccr to create a saccr object using the SA-CCR CRIF file.

mySACCR = saccr(SACCRCRIF,DomesticCurrency="USD",FXSpot=FXSpotTable)

mySACCR = 
  saccr with properties:

                         CRIF: [100×19 table]
                NumPortfolios: 9
                 PortfolioIDs: [9×1 string]
              CounterpartyIDs: [9×1 string]
                   Portfolios: [9×1 saccr.Portfolio]
                   Regulation: "Basel_CRE52"
             DomesticCurrency: "USD"
                        Alpha: [9×1 double]
                  FXSpotRates: [3×3 table]
          TradeDecompositions: [5×2 table]
           CollateralHaircuts: [200×6 table]
        SupervisoryParameters: [19×7 table]
    MaturityBusinessDaysFloor: 10
          NumBusinessDaysYear: 250

Generate EAD Charts

Use eadChart to generate the charts. Specify "final" for Style to plot the bar chart for the final EAD values.

eadChart(mySACCR,Style="final");
ax = gca;
ax.YAxis.Exponent = 0;
ytickformat('%.0f')

Specify "breakdown" for Style to stack the bar graphs for the EAD contributions from alpha scaling, PFE, and RC.

eadChart(mySACCR,Style="breakdown");
ax = gca;
ax.YAxis.Exponent = 0;
ytickformat('%.0f')

Specify "comparison" for Style to overlay the uncollateralized and collateralized aggregate EAD bar graphs on top of the final EAD bar graphs. If there is no collateralization, collateralized values are the same as uncollateralized values.

eadChart(mySACCR,Style="comparison");
ax = gca;
ax.YAxis.Exponent = 0;
ytickformat('%.0f')

Plot a subset of portfolios using the IDs name-value argument.

figure
eadChart(mySACCR, Style="breakdown", ...
    IDs=["Port_002","Port_004","Port_006","Port_008"])
ax = gca;
ax.YAxis.Exponent = 0;
ytickformat('%.0f')

Specify Parent to create an EAD chart on the axes specified by the optional ax argument.

f = figure;
ax = newplot(f);
eadChart(mySACCR, Parent=ax)
ax = gca;
ax.YAxis.Exponent = 0;
ytickformat('%.0f')

Input Arguments

saccrObj — SA-CCR object

object

SA-CCR object, specified as a saccr object. You create a saccr object using saccr.

Data Types: object

ax — Valid axes object in which to display EAD chart

ax object

(Optional) Valid axes object in which to display the EAD chart, specified as an ax object that you create using axes. The EAD chart is created on the axes specified by the optional ax argument instead of on the current axes (gca). The optional argument ax can precede any of the input argument combinations.

Data Types: object

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: eadChart(mySACCR,Style="breakdown")

Style — Style of EAD bar chart

"final" (default) | string

Style of EAD bar chart, specified as a scalar string with one of the following values:

• "final" — Plot the bar chart for the final EAD values.

• "comparison" — Overlay the uncollateralized and collateralized aggregate EAD bar graphs on top of the final EAD bar graphs. If there is no collateralization, collateralized values are the same as uncollateralized values.

• "breakdown" — Stack the bar graphs for the EAD contributions from alpha scaling, PFE, and RC.

Data Types: string

IDs — List of portfolio IDs to plot

Plot all portfolios (default) | string vector

List of portfolio IDs to plot, specified as a scalar string or string vector.

Data Types: string

Parent — Scalar parent in which to plot

[] (default) | Axes object

Scalar parent in which to plot, specified as an Axes object using ax.

Data Types: object

Output Arguments

h — Figure handle for the EAD chart

handle object

Figure handle for the EAD chart, returned as a handle object. You can use h to access and change the properties of the chart.

References

[1] Bank for International Settlements. "CRE52 - Standardised Approach to Counterparty Credit Risk." June 2020. Available at https://www.bis.org/basel_framework/chapter/CRE/52.htm.

[2] Bank for International Settlements. "CRE22- Standardised Approach: Credit Risk Migration." November 2020. Available at https://www.bis.org/basel_framework/chapter/CRE/22.htm.

[3] Bank for International Settlements. "Basel Committee on Banking Supervision: The Standardised Approach for Measuring Counterparty Credit Risk Exposures." April 2014. Available at https://www.bis.org/publ/bcbs279.pdf.

Version History

Introduced in R2024b