Improve doc

PresentValueSeries/PresentValue - Episode 2.ipynb

@@ -46,7 +46,7 @@
                 "\n",
                 "\nThe aim of this notebook is to illustrate the IFRS 17 *Present Value* calculation using Systemorph Cloud Technology. Present Values are the amount of money that someone would pay in the present day for the contracts of the group up to their run off. The starting point are the so called *Nominal Cash flows*, which express the amounts of cash and cash equivalents being transferred into and out of a business. Cash flow values are **discounted** according to the *Yield Curve* provided as economic input in order to take into account the corresponding Interest Accretion, and the discounted figures are **cumulated** to find the **Present Values**. ",
                 "\n",
-                "\nThe IFRS 17 standard prescribes that the accounting statements are based on the value of a group of insurance contracts at the beginning of the period (BoP), their development throughout the period, and the value at the end of the period (EoP). While the period is typically a quarter, the **Analysis of Change** (AoC) from BoP to EoP per group of contract is made considering for each step the variation of the cashflow so as to enhance the readability of the value changes. To this aim it is necessary to **evaluate the Present Value difference** (or delta) between each step, yielding the figures shown in the resulting report.",
+                "\nThe IFRS 17 standard prescribes that the accounting statements are based on the value of a group of insurance contracts at the beginning of the period (BoP), their development throughout the period, and the value at the end of the period (EoP). While the period is typically a quarter, the **Analysis of Change** (AoC) from BoP to EoP per group of contract is made considering for each step the variation of the cash flow so as to enhance the readability of the value changes. To this aim it is necessary to **evaluate the Present Value difference** (or delta) between each step, yielding the figures shown in the resulting report.",
                 "\n",
                 "\nThis process is pictorially represented in the flowchart below"
             ],
@@ -57,7 +57,7 @@
         {
             "cell_type": "markdown",
             "source": [
-                "<center><img src=\"./Images/PvFlowchart.png\" width=\"30%\" style=\"float:center;\">"
+                "<center><img src=\"https://stacdnsmcwe.blob.core.windows.net/content/IFRS17CalculationEngine/Images/PresentValueOfCashFlow/Flowchart.png\" width=\"30%\" style=\"float:center;\">"
             ],
             "metadata": {},
             "execution_count": 0,
@@ -68,7 +68,7 @@
             "source": [
                 "---",
                 "\n",
-                "\nImport the IFRS17 calculation engine:"
+                "\nImport the IFRS 17 calculation engine:"
             ],
             "metadata": {},
             "execution_count": 0,
@@ -92,7 +92,7 @@
                 "\n",
                 "\n**Data Nodes**: Grouping of (Re-)Insurance Contracts belonging to the same Portfolio, and defined by their Reporting Node, Scenario, Contractual Currency, FunctionalCurrency, LineOfBusiness, ValuationApproach, and OCI Type. ",
                 "\n",
-                "\n**Aoc Type**: the Analysis of Change steps used for accounting statements."
+                "\n**AoC Type**: the Analysis of Change steps used for accounting statements."
             ],
             "metadata": {},
             "execution_count": 0,
@@ -131,11 +131,11 @@
                 "In the following code cells, the necessary data to start the IFRS calculator are being imported.",
                 "\nAfter the standard dimensions and parameters are loaded, for the calculation of the Present Value ",
                 "\none needs the economic input yield curves for the target period",
-                "\nand the nominal cashflows for the desired group of contracts:",
+                "\nand the nominal cash flows for the desired group of contracts:",
                 "\n",
                 "\n**Yield Curve**: line that plots yields, i.e. interest rates. It depends on the given currency related to the target *Reporting Node*, and is imported on a yierly basis. The slope of the yield curve gives an idea of future interest rate changes and economic activity.",
                 "\n",
-                "\n**Nominal Cashflows**: they are the amounts of cash and cash equivalents that a company expects to transfer into and out of a business, without any adjustment. This is useful for anticipating future revenue and expenses.",
+                "\n**Nominal Cash flows**: they are the amounts of cash and cash equivalents that a company expects to transfer into and out of a business, without any adjustment. This is useful for anticipating future revenue and expenses.",
                 "\n",
                 "\nThe import process of these example spreadsheets can be completed by running the two cells below"
             ],
@@ -228,7 +228,7 @@
         {
             "cell_type": "markdown",
             "source": [
-                "Systemorph notebook technology excels in analyse on the fly the imported data. In this section the newly imported Yield Curves and nominal cashflows can be analysed."
+                "Systemorph notebook technology excels in analyse on the fly the imported data. In this section the newly imported Yield Curves and nominal cash flows can be analysed."
             ],
             "metadata": {},
             "execution_count": 0,
@@ -264,7 +264,7 @@
         {
             "cell_type": "markdown",
             "source": [
-                "**Imported Nominal Cashflows**"
+                "**Imported Nominal Cash flows**"
             ],
             "metadata": {},
             "execution_count": 0,
@@ -340,7 +340,7 @@
         {
             "cell_type": "markdown",
             "source": [
-                "The Cumulated Discounted Cashflow ($\\text{CDC}$) is defined by the following recursive formulas",
+                "The Cumulated Discounted Cash flow ($\\text{CDC}$) is defined by the following recursive formulas",
                 "\n",
                 "\n$$",
                 "\n\\text{CDC}_t = \\left\\{",
@@ -351,7 +351,7 @@
                 "\n\\right.",
                 "\n$$",
                 "\n",
-                "\nwhere the Period Type depends on the given cashflow Amount Type. "
+                "\nwhere the Period Type depends on the given cash flow Amount Type. "
             ],
             "metadata": {},
             "execution_count": 0,
@@ -361,7 +361,7 @@
             "cell_type": "markdown",
             "source": [
                 "In the following, the premiums are retrieved from the nominals **Data Cube** through a simple Filter. ",
-                "\nAdditionally, among the list of premiums provided, we select only the cashflows for the Assumption Update (AU) and Experience Variance (EV) steps."
+                "\nAdditionally, among the list of premiums provided, we select only the cash flows for the Assumption Update (AU) and Experience Variance (EV) steps."
             ],
             "metadata": {},
             "execution_count": 0,
@@ -442,7 +442,7 @@
         {
             "cell_type": "markdown",
             "source": [
-                "The contribution to the Present Value related to the Experience Variance AoC step, is given by the third element of the Values array, ",
+                "The contribution to the Present Value related to the Experience Variance AoC Step, is given by the third element of the Values array, ",
                 "\nwhich corresponds to the value at the EOP of the current quarter, that is, the BOP of the next one"
             ],
             "metadata": {},

PresentValueSeries/PresentValue - Episode 3.ipynb

@@ -46,7 +46,7 @@
                 "\n",
                 "\nThe aim of this notebook is to illustrate the IFRS 17 *Present Value* calculation using Systemorph Cloud Technology. Present Values are the amount of money that someone would pay in the present day for the contracts of the group up to their run off. The starting point are the so called *Nominal Cash flows*, which express the amounts of cash and cash equivalents being transferred into and out of a business. Cash flow values are **discounted** according to the *Yield Curve* provided as economic input in order to take into account the corresponding Interest Accretion, and the discounted figures are **cumulated** to find the **Present Values**. ",
                 "\n",
-                "\nThe IFRS 17 standard prescribes that the accounting statements are based on the value of a group of insurance contracts at the beginning of the period (BoP), their development throughout the period, and the value at the end of the period (EoP). While the period is typically a quarter, the **Analysis of Change** (AoC) from BoP to EoP per group of contract is made considering for each step the variation of the cashflow so as to enhance the readability of the value changes. To this aim it is necessary to **evaluate the Present Value difference** (or delta) between each step, yielding the figures shown in the resulting report.",
+                "\nThe IFRS 17 standard prescribes that the accounting statements are based on the value of a group of insurance contracts at the beginning of the period (BoP), their development throughout the period, and the value at the end of the period (EoP). While the period is typically a quarter, the **Analysis of Change** (AoC) from BoP to EoP per group of contract is made considering for each step the variation of the cash flow so as to enhance the readability of the value changes. To this aim it is necessary to **evaluate the Present Value difference** (or delta) between each step, yielding the figures shown in the resulting report.",
                 "\n",
                 "\nThis process is pictorially represented in the flowchart below"
             ],
@@ -57,7 +57,7 @@
         {
             "cell_type": "markdown",
             "source": [
-                "<center><img src=\"./Images/PvFlowchart.png\" width=\"40%\" style=\"float:center;\">"
+                "<center><img src=\"https://stacdnsmcwe.blob.core.windows.net/content/IFRS17CalculationEngine/Images/PresentValueOfCashFlow/Flowchart.png\" width=\"40%\" style=\"float:center;\">"
             ],
             "metadata": {},
             "execution_count": 0,
@@ -68,7 +68,7 @@
             "source": [
                 "---",
                 "\n",
-                "\nImport the IFRS17 calculation engine:"
+                "\nImport the IFRS 17 calculation engine:"
             ],
             "metadata": {},
             "execution_count": 0,
@@ -92,7 +92,7 @@
                 "\n",
                 "\n**Data Nodes**: Grouping of (Re-)Insurance Contracts belonging to the same Portfolio, and defined by their Reporting Node, Scenario, Contractual Currency, FunctionalCurrency, LineOfBusiness, ValuationApproach, and OCI Type. ",
                 "\n",
-                "\n**Aoc Type**: the Analysis of Change steps used for accounting statements."
+                "\n**AoC Type**: the Analysis of Change steps used for accounting statements."
             ],
             "metadata": {},
             "execution_count": 0,
@@ -131,11 +131,11 @@
                 "In the following code cells, the necessary data to start the IFRS calculator are being imported.",
                 "\nAfter the standard dimensions and parameters are loaded, for the calculation of the Present Value ",
                 "\none needs the economic input yield curves for the target period",
-                "\nand the nominal cashflows for the desired group of contracts:",
+                "\nand the nominal cash flows for the desired group of contracts:",
                 "\n",
                 "\n**Yield Curve**: line that plots yields, i.e. interest rates. It depends on the given currency related to the target *Reporting Node*, and is imported on a yierly basis. The slope of the yield curve gives an idea of future interest rate changes and economic activity.",
                 "\n",
-                "\n**Nominal Cashflows**: they are the amounts of cash and cash equivalents that a company expects to transfer into and out of a business, without any adjustment. This is useful for anticipating future revenue and expenses.",
+                "\n**Nominal Cash flows**: they are the amounts of cash and cash equivalents that a company expects to transfer into and out of a business, without any adjustment. This is useful for anticipating future revenue and expenses.",
                 "\n",
                 "\nThe import process of these example spreadsheets can be completed by running the two cells below"
             ],
@@ -282,7 +282,7 @@
         {
             "cell_type": "markdown",
             "source": [
-                "Systemorph notebook technology excels in analyse on the fly the imported data. In this section the newly imported Yield Curves and nominal cashflows can be analysed."
+                "Systemorph notebook technology excels in analyse on the fly the imported data. In this section the newly imported Yield Curves and nominal cash flows can be analysed."
             ],
             "metadata": {},
             "execution_count": 0,
@@ -318,7 +318,7 @@
         {
             "cell_type": "markdown",
             "source": [
-                "**Imported Nominal Cashflows**"
+                "**Imported Nominal Cash flows**"
             ],
             "metadata": {},
             "execution_count": 0,
@@ -422,7 +422,7 @@
         {
             "cell_type": "markdown",
             "source": [
-                "The Cumulated Discounted Cashflow ($\\text{CDC}$) is defined by the following recursive formulas",
+                "The Cumulated Discounted Cash flow ($\\text{CDC}$) is defined by the following recursive formulas",
                 "\n",
                 "\n$$",
                 "\n\\text{CDC}_t = \\left\\{",
@@ -433,7 +433,7 @@
                 "\n\\right.",
                 "\n$$",
                 "\n",
-                "\nwhere the Period Type depends on the given cashflow Amount Type. "
+                "\nwhere the Period Type depends on the given cash flow Amount Type. "
             ],
             "metadata": {},
             "execution_count": 0,
@@ -443,7 +443,7 @@
             "cell_type": "markdown",
             "source": [
                 "In the following, the premiums are retrieved from the nominals **Data Cube** through a simple Filter. ",
-                "\nAdditionally, among the list of premiums provided, we select only the cashflows for the Assumption Update (AU) and Experience Variance (EV) steps."
+                "\nAdditionally, among the list of premiums provided, we select only the cash flows for the Assumption Update (AU) and Experience Variance (EV) steps."
             ],
             "metadata": {},
             "execution_count": 0,
@@ -524,7 +524,7 @@
         {
             "cell_type": "markdown",
             "source": [
-                "The contribution to the Present Value related to the Experience Variance AoC step, is given by the n-th element of the Values array, ",
+                "The contribution to the Present Value related to the Experience Variance AoC Step, is given by the n-th element of the Values array, ",
                 "\nwith $n$ equal to the target Month. This element corresponds to the value at the EOP of the current quarter, that is, the BOP of the next one"
             ],
             "metadata": {},