## Model[IRS]

"Model[IRS]" is a special type of Model

aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa aaaaaaaa

#### TYPE INCLUSION RELATIONSHIPS

#### AVAILABLE FUNCTIONS

#### AVAILABLE CREATE FUNCTION KEYS

#### TYPICAL OBJECTS OF TYPE Model[IRS]

This type represents that represents all modelling assumptions needed in valuation algorithms concerning objects of type IRS.

In general, the riskless Yield Curve found in the supplied market data is used for both calculating the required forward rates and discounting the resulting cash flows.

It is possible to choose any specific yield curve for calculating the forward rates associated with a designated rate type by specifying an optional Issuer that matches the issuer of that specific curve.

It is also possible to choose a specific yield curve for discounting purposes by specifying an optional

**that matches the issuer of that specific curve.**

*Issuer*If an IRS happens to involve an upfront payment, the Price function exceptionally will take into account that payment even if it occurs at trade date and Trade Date CFs =

*FALSE*The following labels may be assigned to the key Output of the Price function in order for the latter to return the respective quantities.

List of valid values:

**CashFlows**

All cash flows displayed in chronological order as a table with a maximum of 26 columns.

Only those columns appear that are relevant in a given context.

The column titles indicate the meaning of the respective data.

The following preliminaries need to be known.

Most of the columns pertain to cash flows resulting from the observed (i.e. realized) value

**of an index.**

*I*Exceptions are bullet amounts - such as principal repayments - that are paid at some time

**, but are not linked to any index.**

*T*The index value

**may lead to a rate**

*I***that is assumed to accrue over a time interval**

*R***and produces an amount of**

*[T₁,T₂]***being paid at time**

*NRΔ₁₂***, where:**

*T***is the applicable notional and**

*N***is the year fraction of the interval**

*Δ₁₂***according to some daycount convention.**

*[T₁,T₂]*A typical construction of the rate

**out of the index**

*R***is throught the formula:**

*I*

*R = g(I + c) + s*where

**is a number known as gearing or multiplier**

*g***is a number known as convexity adjustment and**

*c***is a number known as spread**

*s*Note, a rate

**may not result from any index**

*R***, such as the case is for fixed rate payments where the fixed rate**

*I***is contractually specified.**

*R*Below is an alphabetical list of all possible column titles with their descriptions:

*#AccrDays*The number of calendar days in the accrual interval

*[T₁,T₂]*

*#AccrDC*The daycount convention associated with the accrual interval

**and used in the calculation of the year fraction**

*[T₁,T₂]*

*Δ₁₂*

*#AccrEnd*The date

**of the accrual interval**

*T₂*

*[T₁,T₂]*

*#AccrStart*The date

**of the accrual interval**

*T₂*

*[T₁,T₂]*

*#AccrTime*The year fraction

**of the accrual interval**

*Δ₁₂*

*[T₁,T₂]*

*#AdjIndex*The adjusted index

**resulting from the observed index**

*I + c***after a likely convexity adjustment has been added to it.**

*I*

*#Amount*The amount paid at time

**. This will be only shown in a context where the prerequisite index - if applicable -**

*T***can be calculated. If negative, the absolute value is regarded as being paid out.**

*I*

*#Ccy*The denomination currency of the amount paid at time

*T*

*#Details*An object containing details about the related index

*I*

*#Dir*This is the contractual direction of the cash flow and can be either

**or**

*PAY***. Whether the cash flow represents a positive amount being received or paid is determined by other factors as well and is unequivocally determined by the sign of the amount in the column titled**

*REC*

*#Amount*

*#Fixing*The date when the index

**is fixed (i.e. set or observed). For example,**

*I***may represent a 6-month Libor rate that is set at**

*I***and spans the 6-month period**

*T'₀ = T'₁ - 2B***. Then the date**

*[T'₁,T'₂]***is shown here.**

*T'₀*

*#FixingEnd*The index

**may be defined as some rate that references a certain time interval**

*I***. Here is shown the date**

*[T'₁,T'₂]***. For example,**

*T'₂***may represent a 6-month Libor rate that is set at**

*I***and spans the 6-month period**

*T'₀ = T'₁ - 2B*

*[T'₁,T'₂]*

*#FixingStart*The index

**may be defined as some rate that references a certain time interval**

*I***. Here is shown the date**

*[T'₁,T'₂]***. For example,**

*T'₁***may represent a 6-month Libor rate that is set at**

*I***and spans the 6-month period**

*T'₀ = T'₁ - 2B*

*[T'₁,T'₂]*

*#FxFixing*Applies only when the index

**represents an fx rate. Then it shows the date when the fx rate is fixed (i.e. set or observed). For example,**

*I***may represent the fx rate EUR/USD that is set at some time**

*I***. Then the date**

*T'₀***is shown here.**

*T'₀*

*#FxIndex*Applies only when the index

**represents an fx rate. Then it shows the value of the fx rate that is fixed (i.e. set or observed) at the date shown in the column titled**

*I*

*#FxFixing*

*#Gearing*The gearing

**in the formula**

*g***that is used to calculate the rate**

*R = g(I + c) + s***shown in the column titled**

*R*

*#Rate*

*#Index*The applicable index

**, if one applies.**

*I*

*#InLegCF*The counter - starting with 1 - of the referenced cash flow when counting only the cash flows of the containing leg in chronological order (according to the payment date).

*#Leg*The leg where the cash flow belongs. 1 <-> first leg. 2 <-> second leg.

*#Notional*The notional

**that is relevant for determining the respective cash flow, which is the notional at the beginning of the accrual period. In the special case of fx reset, this will be the converted domestic notional that arises after the fixed foreign notional is multiplied with the spot fx rate observed at the beginning of the accrual period.**

*N*

*#PmtDate*The payment date

**of the cash flow.**

*T*

*#Rate*The rate

**that is used to determine the paid out amount according to the formula**

*R*

*NRΔ₁₂*

*#Spread*The spread

**in the formula**

*s***that is used to calculate the rate**

*R = g(I + c) + s***shown in the column titled**

*R*

*#Rate*

*#Type*The type of the cash flow.

*#ValueEnd*Applies only when the index

**represents an overnight index term rate. In that case the index**

*I***is defined as a certain weighted average of the daily overnight index observed in the time interval**

*I***, where**

*[T'₁,T'₂]***and**

*T'₁***are shown in the columns titled**

*T'₂***and**

*#FixingStart***. But the weight that applies on each daily overnight index is not necessarily linked to the number of calendar days spanned by the respective index. When there is a lookback involved (as described at Lookback), the weight is read off a shifted date (referred as Value Date) and might thus be different. For example, if the overnight rate is set on a Friday and the lookback is 1, the corresponding Value Date will be the next Monday and the applicable weight will not be linked to the 3 days over the weekend but rather to the one day corresponding to the Value Date of Monday. Here is shown the end date of the time interval containing all the Value Dates.**

*#FixingEnd*

*#ValueStart*Same as above, with the distinction that the date shown here pertains to the start date of the time interval containing all the Value Dates.

**Leg 1 BPS**

Refers to the output of QuantLib's

**function.**

*legBPS*Applied on the first leg.

**Leg 1 NPV**

Refers to the output of QuantLib's

**function.**

*legNPV*Returns the Net Present Value of the first leg.

**Leg 2 BPS**

Refers to the output of QuantLib's

**function.**

*legBPS*Applied on the second leg.

**Leg 2 NPV**

Refers to the output of QuantLib's

**function.**

*legNPV*Returns the Net Present Value of the second leg.

**Price**

The output is a number that represents the price - also known as NPV (Net Present Value) - of the referenced tradable as of the trade date

Note the applicable

**equals the global trade date, except if overwriten by the optional entry As Of**

*trade date*The cash flows occurring on the trade date are included only if Trade Date CFs is set to

*TRUE*