{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Abstraction Mapping\n", "\n", "In this notebook we take a closer look to the definition of abstraction between causal models presented in [Rischel2020] and reviewed in the previous notebook *Categorical Abstraction.ipynb*. Along with the theoretical discussion we also define classes to encode SCMs and abstractions.\n", "\n", "This notebook was developed in order to get a deeper insight into the framework introduced in [Rischel2020], and it may hopefully be of help to develop a better understanding of such a framework. The notebook is structured as follows: \n", "- Review of the definition of abstraction (Section 2)\n", "- Analysis of the properties of abstractions at the level of mapping between variables (Section 3)\n", "- Analysis of the properties of abstractions at the level of mapping between domains (Section 4)\n", "- Summary of the properties of an abstraction (Section 5)\n", "- Discussion of some limitations in the definition of abstraction (Section 6)\n", "- Implementation of classes for SCMs and abstraction, and review of previous examples (Section 7)\n", "\n", "DISCLAIMER 1: the notebook refers to ideas from *causality* and *category theory* for which only a quick definition is offered. Useful references for causality are [Pearl2009,Peters2017], while for category theory are [Spivak2014,Fong2018].\n", "\n", "DISCLAIMER 2: mistakes are in all likelihood due to misunderstandings by the notebook author in reading [Rischel2020]. Feedback very welcome! :)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Definition of Abstraction\n", "\n", "Let us first recall the definition of abstraction from [Rischel2020].\n", "\n", "\n", "## Original definition\n", "Let $\\mathcal{M}$ and $\\mathcal{M'}$ be two **structural causal models (SCM)** defined on a finite number of (random) variables, each one with a finite domain of outcomes. (For a more precise definition of SCMs, see the previous notebook *Categorical Abstraction.ipynb*).\n", "\n", "Following [Rischel2020], an **abstraction** from a **low-level base model** $\\mathcal{M}$ to a **high-level abstracted model** $\\mathcal{M}'$ is defined as follows:\n", "\n", "1. A subset $R \\subseteq \\mathcal{X}_\\mathcal{M}$ of relevant (endogenous) variables of $\\mathcal{M}$;\n", "2. A surjective map $a: R \\rightarrow \\mathcal{X}_{\\mathcal{M}'}$ mapping the relevant (endogenous) variables of $\\mathcal{M}$ to the (endogenous) variables of $\\mathcal{M}'$ surjectively, so that all the (endogenous) variables in $\\mathcal{M}'$ have a pre-image in $\\mathcal{M}$;\n", "3. $\\forall X' \\in \\mathcal{X}_{\\mathcal{M}'}$, a surjective function $\\alpha_{X'}: \\mathcal{M}[a^{-1}(X')] \\rightarrow \\mathcal{M}'[X']$; that is, for every variable $X'$ in $\\mathcal{M}'$ with associated set $\\mathcal{M}'[X']$, there is a surjective mapping from the set $\\mathcal{M}[a^{-1}(X')]$ associated with the pre-image of $X'$ in $\\mathcal{M}$ along $a$. In other words, any outcome of the variable $X'$ in $\\mathcal{M}'$ is reachable from the pre-image of the outcomes of variables picked in $\\mathcal{M}$ by $a$.\n", "\n", "## Rephrasing\n", "\n", "For clarity, we rephrase this definition in two parts. An **abstraction** from a **low-level base model** $\\mathcal{M}$ to a **high-level abstracted model** $\\mathcal{M}'$ is defined by two parts:\n", "\n", "1. A **variable-level mapping $a$**: a surjective map $a: R \\rightarrow \\mathcal{X}_{\\mathcal{M}'}$, where $R \\subseteq \\mathcal{X}_\\mathcal{M}$, mapping the set $R$ of relevant (endogenous) variables of $\\mathcal{M}$ to the (endogenous) variables of $\\mathcal{M}'$ surjectively, so that all the (endogenous) variables in $\\mathcal{M}'$ have a pre-image in $\\mathcal{M}$;\n", "\n", "2. A **collection of domain-level mappings $\\alpha_{X'}$**: $\\forall X' \\in \\mathcal{X}_{\\mathcal{M}'}$, a surjective function $\\alpha_{X'}: \\mathcal{M}[a^{-1}(X')] \\rightarrow \\mathcal{M}'[X']$; that is, for every variable $X'$ in $\\mathcal{M}'$ with associated set $\\mathcal{M}'[X']$, there is a surjective mapping from the set $\\mathcal{M}[a^{-1}(X')]$ associated with the pre-image of $X'$ in $\\mathcal{M}$ along $a$. In other words, any outcome of the variable $X'$ in $\\mathcal{M}'$ is reachable from the pre-image of the outcomes of variables picked in $\\mathcal{M}$ by $a$.\n", "\n", "We now analyze the mappings on these two levels." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Variable-level Mapping $a$\n", "\n", "Let us investigate the meaning and the implications of the definition of the mapping $a: R \\rightarrow \\mathcal{X}_{\\mathcal{M}'}$, especially in relation to its domain $R$ and codomain $\\mathcal{X}_{\\mathcal{M}'}$.\n", "\n", "Here, we have a single mapping that connects two sets: a set of relevant variables in the base model, and a set of endogenous variables in the abstracted model." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Properties of $a$\n", "\n", "The mapping $a$ has three main properties: (i) it is applied *after a restriction*, (ii) it is a *function*, (iii) and it is *surjective*. This has the following consequences:\n", "\n", "1. Through restriction, we select only a subset of relevant variables $R \\subseteq \\mathcal{X}_{\\mathcal{M}}$ that we care about. This allows us to **ignore variables** when defining our variable-level mapping.\n", "2. By functionality, a variable in $\\mathcal{M}$ is mapped at most to a variable in $\\mathcal{M}'$, and, specifically **a variable in $R$ is mapped to a single variable in $\\mathcal{M}'$**. Ergo, variables in $\\mathcal{M}$ can not be *'split'* across variables in $\\mathcal{M'}$. This makes sense as abstraction implies simplification, and 'splitting' seems contrary to this notion.\n", "3. By surjectivity, $|R| \\geq |\\mathcal{X}_{\\mathcal{M}'}|$. We must select at least as many relevant variables as the endogenous variables in $\\mathcal{M}'$; or, equivalently, **the abstracted model $\\mathcal{M'}$ must have at most as many variables as the restriction $R$** (and the base model $\\mathcal{M}$). This also makes sense as abstraction implies simplification which, in this case, is interpreted as a reduction of the number of variables." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Role of the restriction $R$\n", "\n", "The selection of relevant variables through a restriction allows to define the actual domain of the variable-level mapping (and, implicitly, what variables from the base model we discard).\n", "\n", "Intuitively, we can picture this process as such:\n", "- The set of endogenous variables $\\mathcal{X}_{\\mathcal{M}}$ in the original model defines the *origin* of the abstraction, the set of variables *from which* we abstract (but not, mathematically, the domain of the mapping $a$!)\n", "- The set of relevant variables $R$ in the original model defines the *object* of the abstraction, the set of variables *which* we abstract (mathematically this is a restriction that defines the domain of the mapping $a$)\n", "- The set of endogenous variables $\\mathcal{X}_{\\mathcal{M'}}$ in the abstracted model defines the *target* of the abstraction, the set of variables *to which* we abstract (mathematically this is the codomain, and by surjectivity, the range of the mapping $a$)\n", "\n", "The set $ \\mathcal{X}_{\\mathcal{M}} \\setminus R $ contains the variables that will be simply ignored by the variable-level mapping $a$." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Choices for the domain $R$\n", "\n", "Let us consider limit cases for the choice of $R$.\n", "\n", "- If $R = \\emptyset$, we claim that there are no relevant variables in $\\mathcal{M}$. There is only the trivial absurd mapping $!: \\emptyset \\rightarrow \\mathcal{X}_{\\mathcal{M}'}$ which does not provide us with a surjective map $a$. Abstracting nothingness thus does not make sense.\n", "- If $R = \\{*\\}$, we claim that only one variable or quantity in $\\mathcal{M}$ is really important to us. The set of endogenous variables $\\mathcal{X}_{\\mathcal{M}'}$ is bound to have dimensionality $0$ or $1$. If the dimensionality is $0$ then there is no function $a$. Therefore the actual dimensionality of $\\mathcal{X}_{\\mathcal{M}'}$ must be $1$.\n", "- If $R \\subset \\mathcal{X}_{\\mathcal{M}}$, we claim that only a limited set of variables in the original model ${\\mathcal{M}}$ are of interest, while others may be discarded. In a proper abstraction process, we would probably expect that discarding means abstracting away (e.g., averaging out) more than simply throwing away. The dimensionality of $\\mathcal{X}_{\\mathcal{M}'}$ may range from $1$ to $|R|$.\n", "- If $R = \\mathcal{X}_{\\mathcal{M}}$, we claim that all variables in the original model are relevant. The dimensionality of $\\mathcal{X}_{\\mathcal{M}'}$ may range from $1$ to $|\\mathcal{X}_{\\mathcal{M}}|$." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Choices for the codomain $\\mathcal{X}_{\\mathcal{M}'}$\n", "\n", "Let us consider limit cases for the choice of $\\mathcal{X}_{\\mathcal{M}'}$.\n", "\n", "- If $\\mathcal{X}_{\\mathcal{M}'} = \\emptyset$, we claim that the abstracted model $\\mathcal{M'}$ is null. No function $a$ can then be found (except for $R = \\emptyset$, which we have already discussed as not meaningful). Abstracting to nothingness thus does not make sense.\n", "- If $\\mathcal{X}_{\\mathcal{M}'} = \\{*\\}$, we claim that everything we care about may be modelled by a single variable. This amounts to forgetting any sort of explicit causal structure, and preserving only statistical behaviour.\n", "- If $|\\mathcal{X}_{\\mathcal{M}'}| < |R|$, we claim that less variables are required in the abstracted model $\\mathcal{M}'$ than the number of relevant variables $R$. This means that the contribution of certain variables will be merged (and, consequently, local causal structure forgotten).\n", "- If $|\\mathcal{X}_{\\mathcal{M}'}| = |R|$, we claim the each relevant variable will be mapped to a corresponding variable in the abstracted model $\\mathcal{M}'$. This makes the mapping $a$ both surjective (by definition) and injective. We then have an isomorphism between $\\mathcal{X}_{\\mathcal{M}'}$ and $R$ (but not necessarily between $\\mathcal{X}_{\\mathcal{M}'}$ and $\\mathcal{X}_{\\mathcal{M}}$).\n", "- If $|\\mathcal{X}_{\\mathcal{M}'}| > |R|$, we can not have a surjective mapping $a$." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Pre-images under $a$\n", "\n", "Let us consider a variable in the set of endogenous variables of the abstracted model, $X' \\in \\mathcal{X}_\\mathcal{M'}$. By surjectivity, it must have a pre-image $a^{-1}(X')$. Let us analyze this pre-image.\n", "\n", "- $a^{-1}(X') = \\emptyset$; by surjectivity, this is not possible; each abstracted variable must have a pre-image. This again corresponds to saying that we can not abstract *from nothingness*, or that new variables in the abstracted model can not be created from thin air.\n", "\n", "- $a^{-1}(X') = X$; in the simplest case an abstracted variable has a single variable as a pre-image. This suggests that a specific low-level variable $X$ is deemed important enough to be preserved individually (although its mechanism/dynamics might be modified).\n", "\n", "- $a^{-1}(X') = \\{X_1, X_2,..., X_i\\}$; in this case an abstracted variables has a set of variables as a pre-image. This means that multiple low-level variables $X_1, X_2,..., X_i$ are somehow collapsed in a single high-level variable." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Recap\n", "\n", "We can summarize the possible settings of the mapping $a$ in the following table, with the domain m=$|R|$ and the codomain n=$|\\mathcal{X}_{\\mathcal{M}'}|$:\n", "\n", "Domain m | Codomain n | Notes\n", ":---:|:---:|:---\n", "m=0 | n=0 | Abstracting no variable to no variable (not meaningful)\n", "m=0 | n>0 | Abstracting nothingness (no surjectivity)\n", "m>0 | n=0 | Abstracting to nothingness (no $a$ function)\n", "m=1 | n=1 | Abstracting a single variable\n", "m=1 | n>1 | Not an abstraction (no surjectivity)\n", "0m | Not an abstraction (no surjectivity)\n", "m=$\\vert\\mathcal{X}_{\\mathcal{M}}\\vert$ | nm | Not an abstraction (no surjectivity)\n", "m>$\\vert\\mathcal{X}_{\\mathcal{M}}\\vert$ | n>0 | Impossible (no subset)\n", "\n", "There are in total four legal settings of interest, which may be summarized in the following four cases:\n", "- *Partial non-isomorphic* ($|\\mathcal{X}_{\\mathcal{M}}|$>m>n): when the relevant variables *m* are less than the original variables, and the abstracted variables *n* are less than the relevant variables; \n", "- *Partial isomorphic* ($|\\mathcal{X}_{\\mathcal{M}}|$>m=n): when the relevant variables *m* are less than the original variables, and the abstracted variables *n* are as many as the relevant variables (m=n=1 is a specific sub-case);\n", "- *Complete non-isomorphic* ($|\\mathcal{X}_{\\mathcal{M}}|$=m>n): when the relevant variables *m* are as many as the original variables, and the abstracted variables *n* are less than the relevant variables; \n", "- *Complete isomorphic* ($|\\mathcal{X}_{\\mathcal{M}}|$=m=n): when the relevant variables *m* are as many as the original variables, and the abstracted variables *n* are as many as the relevant variables.\n", "\n", "Moreover, for each high-level variable $X'$ we have two legal settings:\n", "- *One-to-one mapping*: when the pre-image of $X'$ is a single variable in the low-level model;\n", "- *Many-to-one mapping*: when the pre-image of $X'$ is a set of variables in the low-level model." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Domain-level Mapping $\\alpha$\n", "\n", "Let us now consider meaning and implications of the definition of the mapping $\\alpha_{X'}: \\mathcal{M}[a^{-1}(X')] \\rightarrow \\mathcal{M}'[X']$, once again in relation to its domain $\\mathcal{M}[a^{-1}(X')]$ and codomain $\\mathcal{M}'[X']$.\n", "\n", "Here, we have a collection of mappings (one for each endogenous variable in the abstracted model), each one connecting two sets: the set of outcomes for variable(s) in the base model, and the set of outcomes for a variable in the abstracted model." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Properties of $\\alpha$\n", "\n", "The mapping $\\alpha$ has three main properties: (i) there is *no restriction*, (ii) it is a *function*, (iii) and it is *surjective*. This has the following consequences:\n", "\n", "1. Without restriction, each and every element in the domain $\\mathcal{M}[a^{-1}(X')]$ must be mapped to the codomain $\\mathcal{M'}[X']$, that is, every outcome at low-level must have a representation at high-level. Differently from the variable-level abstraction, **we can not ignore elements (outcomes)**.\n", "2. By functionality, an element in $\\mathcal{M}[a^{-1}(X')]$ is mapped at most to an element in $\\mathcal{M'}[X']$. **A single outcome at low-level deterministically correspond to a single outcome at high-level**.\n", "3. By surjectivity, $|\\mathcal{M}[a^{-1}(X')]| \\geq |\\mathcal{M'}[X']|$. **The number of outcomes of an abstracted variable must be equal or lower than the number of outcomes of the corresponding variable(s) at low-level**. This also makes sense as abstraction implies simplification which, in this case, is interpreted as a reduction in the granularity of variable outcomes." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Role of the absence of restriction\n", "\n", "Differently from the variable-level mapping $a$, domain-level mappings $\\alpha_{X'}$ are not preceded by a restriction subselecting *relevant* outcomes. This means that *all* possible outcomes at low-level must be mapped to outcomes at high-level, and none can be ignored. " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Choices for the domain $\\mathcal{M}[a^{-1}(X')]$\n", "\n", "Let us consider limit cases for the choice of $\\mathcal{M}[a^{-1}(X')]$.\n", "\n", "Let us first suppose that the pre-image $a^{-1}(X')$ is a single variable $X \\in R$. Then the mapping can be simplified as $\\alpha_{X'}: \\mathcal{M}[X] \\rightarrow \\mathcal{M'}[X']$, that is a mapping from the set of outcomes of $X$ to the set of outcomes of $X'$. \n", "\n", "- If $\\mathcal{M}[X] = \\emptyset$, we claim that the low-level variable has no outcome. There is only the trivial absurd mapping $!: \\emptyset \\rightarrow \\mathcal{M'}[X']$ which does not provide us with a surjective map $\\alpha_{X'}$. Abstracting nothingness thus does not make sense.\n", "\n", "- If $\\mathcal{M}[X] = \\{*\\}$, we claim that the low-level variable has a single outcome. The set of high-level outcomes $\\mathcal{M'}[X']$ is bound to have dimensionality $0$ or $1$. If the dimensionality is $0$ then there is no function $\\alpha_{X'}$. Therefore the actual dimensionality of $\\mathcal{M'}[X']$ must be $1$. This corresponds to a low-level deterministic (or intervened?) variable that must be mapped to a similarly-deterministic high-level variable.\n", "\n", "- If $\\mathcal{M}[X] = \\{x_1, x_2, ..., x_n\\}$, we claim that the low-level variable has a finite (by assumption we consider only SCM with variables defined on finite domains) number of outcomes, and each one must be mapped to an outcome of the high-level variable. The dimensionality of $\\mathcal{M'}[X']$ can then range from $1$ to $n$.\n", "\n", "Let us now consider the case that the pre-image $a^{-1}(X')$ is a set of variable $\\{X_1,X_2,...X_i\\} \\subseteq R$. Then, by definition [Rischel2020], the mapping can be simplified as $\\alpha_{X'}: \\mathcal{M}[X_1 \\times X_2 \\times ... \\times X_i] \\rightarrow \\mathcal{M'}[X']$, that is a mapping from the Cartesian product of the outcomes of the variables $X_1,X_2,...X_i$ to the set of outcomes of $X'$.\n", "\n", "- If $\\mathcal{M}[X_1 \\times X_2 \\times ... \\times X_i] = \\emptyset$, we claim that all the low-level variables have no outcome. As already discussed, abstracting nothingness thus does not make sense.\n", "\n", "- If $\\mathcal{M}[X_1 \\times X_2 \\times ... \\times X_i] = \\{*\\}$, we claim that all the low-level variables have a single joint outcome. This corresponds to having a subpart of the low-level model that is deterministic (or intervened?) and that will be mapped to a similarly-deterministic high-level variable.\n", "\n", "- If $\\mathcal{M}[X_1 \\times X_2 \\times ... \\times X_i] = \\{(x_1, x_2, ..., x_i)_1, (x_1, x_2, ..., x_i)_2, ..., (x_1, x_2, ..., x_i)_n\\}$, we claim that the low-level variables have a finite (by assumption we consider only SCM with variables defined on finite domains) number of joint outcomes, and each tuple of joint outcomes must be mapped to an outcome of the high-level variable. The dimensionality of $\\mathcal{M'}[X']$ can then range from $1$ to the cardinality of the Cartesian product set $|X_1 \\times X_2 \\times ... \\times X_i|$.\n", "\n", "(**TODO**: how can we formally discuss of deterministic/intervened variables?)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Choices for the codomain $\\mathcal{M'}[X']$\n", "\n", "Let us consider limit cases for the choice of the codomain $\\mathcal{M'}[(X')]$.\n", "\n", "- If $\\mathcal{M'}[(X')] = \\emptyset$, we claim that the outcomes of the abstracted variables $X'$ are none. This would intuitively correspond to discarding information, but no function $\\alpha_{X'}$ can then be found. Abstracting to nothingness thus does not make sense.\n", "\n", "- If $\\mathcal{M'}[(X')] = \\{*\\}$, we claim that all the outcomes from the low-level variable(s) can be mapped to a single outcome in the high-level variable. This amounts to forgetting any sort of stochasticity (intervention?) in the low-level variable(s) and map it/them to a constant.\n", "\n", "- If $\\mathcal{M'}[X'] = \\{x'_1, x'_2, ..., x'_n\\}$, we claim that outcomes from the low-level variables are mapped to outcomes in the high-level variables. The dimensionality of the pre-image set of outcomes must be at least $n$." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Pre-images under $\\alpha$\n", "\n", "Analogously to what we have done before, let us also take a look at pre-images under a domain-level mapping $\\alpha_{X'}$. Let $x' \\in \\mathcal{M'}[X']$ be an outcome for the variable $X'$ in the abstracted model. By surjectivity, it must have a pre-image $\\alpha_{X'}^{-1}(x')$. Let us analyze this pre-image.\n", "\n", "- $\\alpha_{X'}^{-1}(x') = \\emptyset$; by surjectivity, this is not possible; each abstracted outcome must have a pre-image. This corresponds to saying that we can not abstract *from nothingness*, or that new outcomes in the abstracted model can not be created from thin air.\n", "\n", "- $\\alpha_{X'}^{-1}(x') = x$; in the simplest case an abstracted outcome has a single outcome as a pre-image. This means a 1:1 mapping which suggests that a specific low-level outcome $X$ is deemed important enough to be preserved individually (although multiple outcomes of $X$ may be mapped to $x'$).\n", "\n", "- $\\alpha_{X'}^{-1}(x') = \\{x_1, x_2,..., x_i\\}$; in this case an abstracted outcome has a set of outcomes as a pre-image. This means that the abstracted outcome summarizes or collapse multiple outcome at low-level, making them undifferentiated." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Recap\n", "\n", "We can summarize the possible settings of the mapping $\\alpha_{X'}$ in the following table, with the domain m = $|\\mathcal{M}[a^{-1}(X')]|$ and the codomain n=$|\\mathcal{M'}[X']|$:\n", "\n", "Domain m | Codomain n | Notes\n", ":---:|:---:|:---\n", "m=0 | n=0 | Abstracting no outcome to no outcome (not meaningful)\n", "m=0 | n>0 | Abstracting nothingness (no surjectivity)\n", "m>0 | n=0 | Abstracting to nothingness (no $a$ function)\n", "m=1 | n=1 | Abstracting a deterministic outcome\n", "m=1 | n>1 | Not an abstraction (no surjectivity)\n", "m>1 | n=1 | Abstracting a set of outcomes to a deterministic (intervened?) outcome\n", "m>1 | 11 | n=m | Isomorphic abstracting ($\\alpha_{X'}$ is surjective and injective)\n", "m>1 | n>m | Not an abstraction (no surjectivity)\n", "\n", "There are in total 3 legal settings, which may be summarized in the following cases:\n", "- *Non-isomorphic* (m>n): when the original outcomes *m* are more than the abstracted outcomes *n*, meaning that some base outcomes are collapsed;\n", "- *Isomorphic* (m=n): when the original outcomes *m* are as many as the abstracted outcomes *n*, meaning that we have a 1:1 correspondance between outcomes;\n", "- *Interventional(?)* (n=1): when all the original outcomes *m* are mapped to a single abstracted outcome *n*." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Summary of properties\n", "\n", "We now summarize the properties we have highlighted so far.\n", "\n", "- The **variable-level mapping** $a$ allows us to control abstraction interpreted as the number of variables of interest. The definition of map $a$ implies:\n", " 1. the abstracted model has as many or fewer endogenous variables than the base model (by surjectivity); abstraction simplifies in the sense that it does not increase the number of variables.\n", " 2. every high-level variable has a pre-image (by surjectivity); abstraction simplifies in the sense that new variables can not be created out of thin air without grounding in the base model.\n", " 3. low-level variables can be ignored (by restriction); abstraction simplifies in the sense that we can forget some variables.\n", " 4. relevant low-level variables are deterministically mapped (by functionality); abstraction simplifies in the sense that it does not introduce stochasticity.\n", " 5. relevant low-level variables can not be *'split'* across abstracted endogenous variables (by functionality); abstraction simplifies in the sense that it does not add specification of variables.\n", " \n", "- The **domain-level mapping** $\\alpha_{X'}$ allows us to control abstraction interpreted as the granularity of the outcomes of variables of interest. The definition of map $\\alpha_{X'}$ implies:\n", " 1. an abstracted variable has as many or fewer outcomes than the base variable(s) (by surjectivity); abstraction simplifies in the sense that it does not increase the number of outcomes.\n", " 2. every high-level outcome has a pre-image (by surjectivity); abstraction simplifies in the sense that new outcomes can not be created out of thin air without grounding in the base model.\n", " 3. low-level outcomes can not be ignored (by absence of restriction); abstraction here does not simplifies in the sense that we can forget some outcomes.\n", " 4. low-level outcomes are deterministically mapped (by functionality); abstraction simplifies in the sense that it does not introduce stochasticity.\n", " 5. low-level outcomes can not be *'split'* across abstracted outcomes (by functionality); abstraction simplifies in the sense that it does not add specification of outcomes." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Limitations\n", "\n", "Notice how the definition of abstraction is rooted in an idea of abstraction as a **simplification of a model wrt to the number of variables and the dimensionality of their outcomes**. Indeed in the definition of the abstraction, the variable-level mapping is concerned with variables and their number (through $R$ and $a$) while the domain-level mapping is concerned with the outcome and their number (through $\\alpha_{X'}$).\n", "\n", "No requirement on the mechanims of the model is taken into consideration in the definition. The definition is **heavily concerned with variables**, neglecting almost completely the mechanisms. This bias may make sense, as, normally, variables are we observe and what we try to abstract.\n", "\n", "However, focusing only on variables leaves open the problem whether an abstraction between two models $\\mathcal{M}$ and $\\mathcal{M'}$ as defined by $(R,a,\\alpha_X)$ captures what we intuitively means by abstraction. Specifically, we may wonder if, in spite of or by virtue of the abstraction $(R,a,\\alpha_X)$, *the behaviour of the two models is consistent*. This lead us to consider the problem of consistency.\n", "\n", "It is important to remark that this limitation is properly acknowledged in [Rischel2020], and it is not an original observation in this notebook. Here we will just make a couple of observations on the issue of consistency, leaving a detailed analysis to another notebook. " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Consistency\n", "\n", "The issue of consistency is raised and addressed [Rischel2020] through the idea of evaluating abstraction error (see the previous notebook *Categorical Abstraction.ipynb*). An abstracted model may have simplified mechanisms and may thus provide different results from a base model; a proper measure, defined abstraction error, may then be used to quantify the gap between the base model and the abstracted model.\n", "\n", "However the definition of abstraction allows for a violation in consistency between a base model and an abstracted model not only in the sense of mismatching results between two compatible models. It also allows to put into a relationship of abstractions models that are incompatible or not consistent with respect to the the directionality of the causal effects." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Example of abstraction between incompatible models\n", "\n", "The definition of abstraction that we used allows us to have an abstraction between two models that reverse cause-effect relationships. \n", "\n", "For instance, let $\\mathcal{M}$ be the SCM with underlying graph $X_1 \\rightarrow X_2$, with $\\mathcal{M}[X_1] = \\mathcal{M}[X_2]$ and arbitrary $\\mathcal{M}[\\phi_{X_1}]: * \\rightarrow \\mathcal{M}[X_1]$ and $\\mathcal{M}[\\phi_{X_2}]: \\mathcal{M}[X_1] \\rightarrow \\mathcal{M}[X_2]$.\n", "\n", "Let us consider now $\\mathcal{M'}$, a SCM with underlying graph $X'_1 \\leftarrow X'_2$, with $\\mathcal{M'}[X'_1] = \\mathcal{M'}[X_2'] = \\mathcal{M}[X_1]$ and arbitrary $\\mathcal{M'}[\\phi_{X'_1}]: \\mathcal{M'}[X'_2] \\rightarrow \\mathcal{M'}[X'_1]$ and $\\mathcal{M'}[\\phi_{X'_2}]: * \\rightarrow \\mathcal{M'}[X'_2]$.\n", "\n", "It is simple to define an abstraction between the two models $\\mathcal{M}$ and $\\mathcal{M'}$. Take $R = \\mathcal{X}_{\\mathcal{M}} = \\{X_1,X_2\\}$. Take the trivial $a$ mapping $X_1 \\mapsto X'_1$ and $X_2 \\mapsto X'_2$. Last, take the mappings $\\alpha_{X'1}$ and $\\alpha_{X'2}$ to be identities.\n", "\n", "$\\mathcal{M'}$ can be seen as an abstraction $\\mathcal{M}$, although what it mainly does is reversing cause and effect. $\\mathcal{M'}$ seems more an *alternative* model to $\\mathcal{M}$: a model, built on the same variables and outcome spaces, that proposes a different hypothetical dynamics. \n", "\n", "In a sense, then, the definition of abstraction works more as a **necessary condition for abstraction**. It says: *given a base model $\\mathcal{M}$ and a second model $\\mathcal{M'}$, if the number of variables in $\\mathcal{M'}$ is less or equal to the number of variables in $\\mathcal{M}$, and if for every variable in $\\mathcal{M'}$ its cardinality is less or equal to the cardinality of the abstracting variables in $\\mathcal{M}$, then $\\mathcal{M'}$ can be an abstraction of $\\mathcal{M}$.*\n", "\n", "However, the condition is not sufficient. Another condition vouching for the consistency of the dynamics may be in order." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Dealing with consistency\n", "\n", "Within the framework of [Rischel2020] the possibility of causality-reversing abstractions may be of little concern, as such abstractions may simply weeded out once we compute the abstraction error, which will simply result to be $\\infty$.\n", "\n", "Alternatively, we may strenghthen the definition to take into consideration a minimum requirement of consistency: not consistency of observational or interventional distributions, but simply consistency of causality direction. This form of consistency may be assessed directly from graphs. We consider this approach in another notebook." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Implementation\n", "\n", "We now consider the implementation of the ideas of SCMs and abstractions." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Setup\n", "\n", "Let us start importing basic libraries:" ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "import numpy as np\n", "import networkx as nx\n", "import itertools" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "For reproducibility, and for discussing our results in this notebook, we set a random seed to $1985$." ] }, { "cell_type": "code", "execution_count": 2, "metadata": {}, "outputs": [], "source": [ "np.random.seed(1985)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### FinStochSCM Class\n", "\n", "We start defining a class to represent our SCM objects in their $\\mathtt{FinStoch}$ representation (for a more detailed discussion of this representation see the previous notebook *Categorical Abstraction.ipynb*).\n", "\n", "An object of our class will represent a SCM $\\mathcal{M}$ and will have the following attributes:\n", "- *X*: an array of endogenous variables, each one labeled with an integer number starting from zero. Mathematically, this is the set $\\mathcal{X}_\\mathcal{M}$ of elements $X_i$.\n", "- *nX*: the length of the array of endogenous variables. Mathematically, this is the cardinality $|\\mathcal{X}_\\mathcal{M}|$.\n", "- *MX*: a list of arrays, each one corresponding to the finite set associated with one of the endogenous variable. Mathematically, each element is a set $\\mathcal{M}[X_i]$.\n", "- *links*: a list of links. This attribute is a support attribute to easily instantiate a DAG and compute mechanisms. \n", "- *DAG*: a networkx graph. This attribute provides an encoding of information about the structure of the SCM.\n", "- *MphiX*: a dictionary of stochastic matrices, one for each node/mechanism in the SCM. Mathematically, each element is a stochastic matrix $\\mathcal{M}[\\phi_{X_i}]$.\n", "\n", "The methods are:\n", "- *\\__init__()*: a versatile constructor that can either set up a specific SCM (passing a the necessary parameters) or generate a random SCM (passing random generator functions);\n", "- *set\\_...()*: a series of setters to setup manually the attributes of the SCM;\n", "- *build_DAG()*: a support method generating a networkx DAG; this DAG is used to store data about the model and retrieve it efficiently;\n", "- *copy()*: a method to create a deep copy of the model;\n", "- *plot()*: a plotting method showing the underlying DAG.\n", "\n", "**WARNING:** A properly implemented class would implement the checks that have been here left as comments. In this notebook, a proper check of the dimensionality of the parameters is left to the user." ] }, { "cell_type": "code", "execution_count": 3, "metadata": {}, "outputs": [], "source": [ "class FinStochSCM():\n", " def __init__(self,n_endogenous, \n", " sets=None, links=None, stochmatrices=None,\n", " f_sets=None, f_links=None, f_stochmatrices=None):\n", " \n", " self.X = np.arange(n_endogenous)\n", " self.nX = n_endogenous\n", " \n", " self.MX = self.set_sets(sets,f_sets)\n", " self.links = self.set_links(links,f_links) \n", " self.G = self.build_DAG()\n", " \n", " self.MphiX = self.set_stochmatrices(stochmatrices,f_stochmatrices)\n", " \n", " \n", " def set_sets(self,sets,f_sets):\n", " if sets is None:\n", " # TODO:check instantiate_random_sets is not null\n", " MX = f_sets(self.nX)\n", " else:\n", " # TODO:check sets is a list/array of length n_endogenous containing arrays\n", " MX = sets\n", " return MX\n", " \n", " def set_links(self,links,f_links):\n", " if links is None:\n", " # TODO:check instantiate_random_sets is not null\n", " L = f_links(self.X)\n", " else:\n", " # TODO:check sets is a list/array of length n_endogenous containing arrays\n", " L = links\n", " return L\n", " \n", " def set_stochmatrices(self,stochmatrices,f_stochmatrices):\n", " if stochmatrices is None:\n", " # TODO:check instantiate_random_stochmatrices is not null\n", " MphiX = f_stochmatrices(self.G,self.MX)\n", " else:\n", " # TODO:check\n", " MphiX = stochmatrices\n", " return MphiX\n", " \n", " def build_DAG(self):\n", " G = nx.DiGraph()\n", " G.graph['dpi'] = 120\n", "\n", " nodes = [str(i) for i in list(self.X)]\n", " edges = self.links\n", " G.add_nodes_from(nodes)\n", " G.add_edges_from(edges)\n", " \n", " return G\n", " \n", " def copy(self):\n", " Mcopy = FinStochSCM(self.nX, sets=self.MX.copy(), links=self.links.copy(), stochmatrices=self.MphiX.copy())\n", " return Mcopy\n", " \n", " def plot(self):\n", " _ = nx.draw_networkx(self.G)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Random SCMs functions\n", "\n", "We can now use our class to instantiate specific SCMs by defining all their attributes; however this approach is burdensome as it requires to define every node, every domain, every link, and every stochastic matrix. \n", "\n", "For convenience we define three functions to randomly instantiate SCMs:\n", "- *instantiate_random_sets()*: given a number of variables/nodes, it instantiates a set with a random finite dimension for each one.\n", "- *instantiate_random_links()*: given a set of variables, it instantiates a set of links/edges.\n", "- *instantiate_random_stochmatrices()*: given a graph and the set of the sets of variables, it instantiates a random stochastic matrix for each variable/node taking into account the incoming edges.\n", "\n", "Notice that in these implementations all the parameters regulating randomness (maximum cardinality for a set, number of links, sampling of the random matrix...) are hard-coded. Alternative functions (with an equivalent signature) may be prepared and passed seamlessly to the class FinStochSCM." ] }, { "cell_type": "code", "execution_count": 4, "metadata": {}, "outputs": [], "source": [ "def instantiate_random_sets(n_sets):\n", " cardinalities = np.random.randint(1,10,n_sets)\n", " return [np.arange(cardinalities[i]) for i in range(len(cardinalities))]\n", "\n", "def instantiate_random_links(X):\n", " n_links = np.max([2,int(np.floor(len(X)/1.5))])\n", " links = []\n", " \n", " for i in range(n_links):\n", " link = np.random.choice(X,2,replace=False)\n", " links.append((str(link[0]), str(link[1])))\n", " \n", " return links\n", "\n", "def instantiate_random_stochmatrices(G,MX):\n", " stochmatrices = {}\n", " \n", " for n in G.nodes():\n", " in_edges = (G.in_edges(n))\n", "\n", " card_domains = 1\n", " for ie in in_edges:\n", " card_domains = card_domains * len(MX[int(ie[0])])\n", " \n", " card_codomain = len(MX[int(n)])\n", " \n", " matrix = np.random.rand(card_domains,card_codomain)\n", " stochmatrix = matrix / np.sum(matrix,axis=1)[:,None]\n", " stochmatrices[n] = stochmatrix\n", " \n", " return stochmatrices" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can now generate a random SCM with 6 nodes:" ] }, { "cell_type": "code", "execution_count": 5, "metadata": {}, "outputs": [], "source": [ "M0 = FinStochSCM(6,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can check out the domain of each node (these correspond to $\\mathcal{M}[X_i]$ or set objects in $\\mathtt{FinStoch}$):" ] }, { "cell_type": "code", "execution_count": 6, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "[array([0, 1, 2, 3, 4, 5]),\n", " array([0, 1, 2, 3, 4, 5]),\n", " array([0, 1, 2, 3, 4, 5, 6]),\n", " array([0]),\n", " array([0, 1, 2, 3, 4, 5, 6, 7]),\n", " array([0])]" ] }, "execution_count": 6, "metadata": {}, "output_type": "execute_result" } ], "source": [ "M0.MX" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "and the stochastic matrices for each node (these correspond to $\\mathcal{M}[\\phi_{X_i}]$ or morphisms in $\\mathtt{FinStoch}$):" ] }, { "cell_type": "code", "execution_count": 7, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "{'0': array([[0.25574865, 0.2571311 , 0.02086243, 0.00410491, 0.2169711 ,\n", " 0.24518182]]),\n", " '1': array([[0.01187879, 0.15825818, 0.05058027, 0.34613944, 0.16955932,\n", " 0.26358401]]),\n", " '2': array([[0.18923966, 0.09861824, 0.12410694, 0.09058013, 0.00188109,\n", " 0.23076102, 0.26481291]]),\n", " '3': array([[1.]]),\n", " '4': array([[0.17781205, 0.03745636, 0.02350533, 0.00306573, 0.21872648,\n", " 0.23394995, 0.11535318, 0.19013091],\n", " [0.00783325, 0.01466399, 0.30647337, 0.00585746, 0.12370282,\n", " 0.2355525 , 0.18674618, 0.11917043],\n", " [0.18534473, 0.04345278, 0.12560718, 0.02482529, 0.1352752 ,\n", " 0.14062018, 0.19573873, 0.14913591],\n", " [0.01836164, 0.1922998 , 0.10829952, 0.07770576, 0.10132963,\n", " 0.19180102, 0.09793757, 0.21226505],\n", " [0.12046304, 0.0132817 , 0.19208454, 0.09943169, 0.12434558,\n", " 0.2135727 , 0.06119968, 0.17562106],\n", " [0.08147798, 0.13210911, 0.1012556 , 0.24896325, 0.10614989,\n", " 0.06752571, 0.03032614, 0.23219232]]),\n", " '5': array([[1.],\n", " [1.],\n", " [1.],\n", " [1.],\n", " [1.],\n", " [1.]])}" ] }, "execution_count": 7, "metadata": {}, "output_type": "execute_result" } ], "source": [ "M0.MphiX" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Finally we can plot the actual DAG for our SCM:" ] }, { "cell_type": "code", "execution_count": 8, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "M0.plot()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Variable-level mappings\n", "\n", "We now use our objects to explore variable-level mappings. As discussed above, the variable-level mapping is defined by a *relevant variables set* $R \\subseteq \\mathcal{X}_{\\mathcal{M}}$ and a surjective mapping $a: R \\rightarrow \\mathcal{X}_{\\mathcal{M'}}$." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Random variable-level mappings\n", "\n", "As before, to simplify the instantiation of variable-level mappings, we define two functions that randomly generate what we need:\n", "\n", "- *generate_random_R()*: given a model and a number of relevant variables, it randomly selects a subset of relevant variables from the model; $R$ is a sorted numpy array of relevant variables.\n", "- *generate_random_a()*: given a set of relevant variables and a model, it randomly defines a surjective function from the relevant variables to the variables in the model. $a$ is encoded as a binary matrix. " ] }, { "cell_type": "code", "execution_count": 9, "metadata": {}, "outputs": [], "source": [ "def generate_random_R(M0,nR):\n", " # Check nR is less or equal to the variables in M0\n", " return np.sort(np.random.choice(M0.X,nR,replace=False))\n", "\n", "def generate_random_a(R,M1):\n", " # Check R is greater or equal to the variables in M1\n", " diff = len(R) - M1.nX\n", " codomain = list(M1.X.copy()) + list(np.random.choice(M1.X,diff))\n", " np.random.shuffle(codomain)\n", " \n", " a = np.zeros((len(R),M1.nX))\n", " a[np.arange(len(R)),codomain] = 1\n", " \n", " return a" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We now instantiate a second model with $5$ nodes/variables." ] }, { "cell_type": "code", "execution_count": 10, "metadata": {}, "outputs": [], "source": [ "M1 = FinStochSCM(5,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This will allow us to create a variable-level mapping between the base model $\\mathcal{M}/\\mathtt{M0}$ and $\\mathcal{M'}/\\mathtt{M1}$.\n", "\n", "We start randomly sampling a subset of relevant variables in $\\mathcal{M}/\\mathtt{M0}$ of cardinality $5$:" ] }, { "cell_type": "code", "execution_count": 11, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[0 2 3 4 5]\n" ] } ], "source": [ "R = generate_random_R(M0,5)\n", "print(R)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Then we set up the mapping $a$:" ] }, { "cell_type": "code", "execution_count": 12, "metadata": { "scrolled": true }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[[0. 0. 0. 0. 1.]\n", " [0. 1. 0. 0. 0.]\n", " [0. 0. 1. 0. 0.]\n", " [0. 0. 0. 1. 0.]\n", " [1. 0. 0. 0. 0.]]\n" ] } ], "source": [ "a = generate_random_a(R,M1)\n", "print(a)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "where rows encode relevant variables and the columns variables in the model $\\mathcal{M'}/\\mathtt{M1}$." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Plotting variable-level mappings\n", "\n", "To get an intuitive feel of the variable-level mapping we setup a plotting function. This function does some not-very-important work with the networkx DAG in order to rename nodes and plot vertices and edges in different colors. " ] }, { "cell_type": "code", "execution_count": 13, "metadata": {}, "outputs": [], "source": [ "def plot_variable_level_mapping(M0,M1,R,a):\n", " G = M0.G.copy()\n", " relabel_map = {}\n", " for n in G.nodes():\n", " relabel_map[n] = 'M0_'+str(n)\n", " G0 = nx.relabel.relabel_nodes(G,relabel_map)\n", " \n", " G = M1.G.copy()\n", " relabel_map = {}\n", " for n in G.nodes():\n", " relabel_map[n] = 'M1_'+str(n)\n", " G1 = nx.relabel.relabel_nodes(G,relabel_map)\n", " \n", " U = nx.union(G0,G1)\n", " \n", " #edge_color=['k']*U.number_of_edges() + ['r']*len(a[0])\n", " \n", " edge_list = [('M0_'+str(R[i]), 'M1_'+str(np.where(a[i,:]==1)[0][0])) for i in range(a.shape[0])]\n", " U.add_edges_from(edge_list)\n", " \n", " #for i in range(len(a[0])):\n", " # U.add_edge('M0_'+str(a[0][i]), 'M1_'+str(a[1][i])) \n", " \n", " pos = nx.shell_layout(U)\n", " \n", " for k in pos.keys():\n", " if 'M1' in k:\n", " pos[k] = pos[k] + [10,0]\n", " \n", " R_list = np.array(['M0_'+str(R[i]) for i in range(len(R))])\n", " nR = np.array(list(set(M0.X)-set(R)))\n", " nR_list = np.array(['M0_'+str(nR[i]) for i in range(len(nR))])\n", " \n", " nx.draw_networkx_nodes(U,pos,nodelist=R_list,node_color='b',alpha=.5)\n", " nx.draw_networkx_nodes(U,pos,nodelist=nR_list,node_color='b',alpha=.2)\n", " nx.draw_networkx_labels(U,pos)\n", " nx.draw_networkx_edges(U,pos,edgelist=G0.edges(),edge_color='k')\n", " \n", " nx.draw_networkx_nodes(U,pos,nodelist=G1.nodes(),node_color='g',alpha=.5)\n", " nx.draw_networkx_labels(U,pos)\n", " nx.draw_networkx_edges(U,pos,edgelist=G1.edges(),edge_color='k')\n", " \n", " nx.draw_networkx_edges(U,pos,edgelist=edge_list,edge_color='r',style='dashed')\n", " #_ = nx.draw(U,pos,with_labels=True,edge_color=['k']*U.number_of_edges()) " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can now show our variable-level mapping:" ] }, { "cell_type": "code", "execution_count": 14, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "plot_variable_level_mapping(M0,M1,R,a)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Here variables of the base model are shown in blue, dark if relevant ($\\in R$) light if not relevant ($\\notin R$); variables of the abstracted model are shown in green; internal edges of each model are shown in black; the mapping $a$ is shown in dashed red." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The interpretation of this graph with respect to the category $\\mathtt{FinStoch}$ is examined in the following notebook *Abstraction Mapping in FinStoch.ipynb*." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "It is easy now to consider and visualize the different types of variable-level mapping we distinguished." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Complete isomorphic variable-level mapping\n", "\n", "A *complete isomorphic* is defined by \n", "\n", "$$|\\mathcal{X}_{\\mathcal{M}}| = R = |\\mathcal{X}_{\\mathcal{M'}}|,$$ \n", "\n", "that is (nodes in M0) = (relevant nodes) = (nodes in M1)." ] }, { "cell_type": "code", "execution_count": 15, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "M0 = FinStochSCM(6,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "M1 = FinStochSCM(6,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "\n", "R = generate_random_R(M0,6)\n", "a = generate_random_a(R,M1)\n", "\n", "plot_variable_level_mapping(M0,M1,R,a)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Notice how each node in $\\mathtt{M0}$ is relevant (dark blue) and the mapping $a$ is bijective." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Incomplete isomorphic variable-level mapping\n", "\n", "A *incomplete isomorphic* is defined by \n", "\n", "$$|\\mathcal{X}_{\\mathcal{M}}| > R = |\\mathcal{X}_{\\mathcal{M'}}|,$$ \n", "\n", "that is (nodes in M0) > (relevant nodes) = (nodes in M1)." ] }, { "cell_type": "code", "execution_count": 16, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "M0 = FinStochSCM(6,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "M1 = FinStochSCM(4,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "\n", "R = generate_random_R(M0,4)\n", "a = generate_random_a(R,M1)\n", "\n", "plot_variable_level_mapping(M0,M1,R,a)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Notice how only a subset of nodes in $\\mathtt{M0}$ is relevant (dark blue), and still the mapping $a$ between these relevant nodes and nodes in $\\mathtt{M1}$ is bijective." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Complete non-isomorphic variable-level mapping\n", "\n", "A *complete non-isomorphic* is defined by \n", "\n", "$$|\\mathcal{X}_{\\mathcal{M}}| = R > |\\mathcal{X}_{\\mathcal{M'}}|,$$ \n", "\n", "that is (nodes in M0) = (relevant nodes) > (nodes in M1)." ] }, { "cell_type": "code", "execution_count": 17, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "M0 = FinStochSCM(6,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "M1 = FinStochSCM(4,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "\n", "R = generate_random_R(M0,6)\n", "a = generate_random_a(R,M1)\n", "\n", "plot_variable_level_mapping(M0,M1,R,a)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Notice how each node in $\\mathtt{M0}$ is relevant (dark blue) and the mapping $a$ is surjective, but, by necessity, not injective." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Incomplete non-isomorphic variable-level mapping\n", "\n", "A *incomplete non-isomorphic* is defined by \n", "\n", "$$|\\mathcal{X}_{\\mathcal{M}}| > R > |\\mathcal{X}_{\\mathcal{M'}}|,$$ \n", "\n", "that is (nodes in M0) > (relevant nodes) > (nodes in M1)." ] }, { "cell_type": "code", "execution_count": 18, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "M0 = FinStochSCM(6,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "M1 = FinStochSCM(4,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "\n", "R = generate_random_R(M0,5)\n", "a = generate_random_a(R,M1)\n", "\n", "plot_variable_level_mapping(M0,M1,R,a)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Notice how only a subset of nodes in $\\mathtt{M0}$ is relevant (dark blue) and the mapping $a$ is surjective, but, by necessity, not injective." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Domain-level mappings\n", "\n", "The variable-level mapping provides only a first insight on the abstraction, telling us which relevant variables are mapped where.\n", "\n", "The domain-level mapping provides a more detailed view. Variables/nodes are now substituted by the set of outcomes underlying each variable, and the connection between base model and abstracted model is now expressed by the stochastic matrices $\\alpha_{X'}: \\mathcal{M}[a^{-1}(X')] \\rightarrow \\mathcal{M'}[X']$." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Random domain-level mapping\n", "\n", "We create here too a function to generate random domain-level mappings:\n", "\n", "- *generate_random_alphas()*: given two models and a variable-level mapping, it creates the necessary domain-level mappings alpha for each variable in the high-level model. $\\alpha$ is a dictionary with an entry for each varialbe in $\\mathtt{M1}$; each entry $\\alpha_{X'}$ is encoded as a binary matrix." ] }, { "cell_type": "code", "execution_count": 19, "metadata": {}, "outputs": [], "source": [ "def generate_random_alphas(M0,M1,R,a):\n", "\n", " alphas = {}\n", " for n in M1.X:\n", " incoming_vars = np.where(a[:,n]==1)[0]\n", "\n", " domain = M0.MX[R[incoming_vars[0]]]\n", "\n", " for v in incoming_vars[1:]:\n", " domain = [x for x in itertools.product(domain,M0.MX[R[int(v)]])]\n", "\n", " if len(domain) < len(M1.MX[n]):\n", " raise Exception('Can not define a surjective alpha with this a!')\n", " \n", " else:\n", " diff = len(domain) - len(M1.MX[n])\n", " codomain = list(M1.MX[n].copy()) + list(np.random.choice(M1.MX[n],diff))\n", " np.random.shuffle(codomain)\n", " \n", " alpha = np.zeros((len(domain),len(M1.MX[n])))\n", " alpha[np.arange(len(domain)),codomain] = 1\n", "\n", " alphas[n] = alpha\n", "\n", " return alphas" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Plotting domain-level mappings\n", "\n", "Plotting domain-level mapping is more tricky. We now have a set of functions $\\alpha_{X'}: \\mathcal{M}[a^{-1}(X')] \\rightarrow \\mathcal{M'}[X']$, where each function goes from a (Cartesian product of) set(s) to a set. We will rely for the moment on numerical outputs and printouts. " ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### First abstraction\n", "\n", "We can now instantiate two models $\\mathcal{M}/\\mathtt{M0}$ and $\\mathcal{M'}/\\mathtt{M1}$, a complete (random) abstraction defined by the variable-level mapping ($R,a$) and the domain-level mappings ($\\alpha_{X'}$).\n", "\n", "Notice that we surround the call to the generation of random $\\alpha_{X'}$ with a *try... except...* statement." ] }, { "cell_type": "code", "execution_count": 20, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Can not define a surjective alpha with this a!\n" ] } ], "source": [ "M0 = FinStochSCM(6,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "M1 = FinStochSCM(4,\n", " f_sets=instantiate_random_sets,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "\n", "R = generate_random_R(M0,5)\n", "a = generate_random_a(R,M1)\n", "\n", "try:\n", " alphas = generate_random_alphas(M0,M1,R,a)\n", "except Exception as err:\n", " print(err)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can not actually generate an abstraction in our case because one or more of the alpha mapping can not be surjective. \n", "\n", "**WARNING:** this behaviour and the following analysis written here depends on the specific random seed (1985) and may differ if the seed is changed.\n", "\n", "Let us do some troubleshooting here. Let us look at the variable-level mapping:" ] }, { "cell_type": "code", "execution_count": 21, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[[0. 0. 0. 1.]\n", " [1. 0. 0. 0.]\n", " [0. 0. 1. 0.]\n", " [0. 0. 1. 0.]\n", " [0. 1. 0. 0.]]\n" ] } ], "source": [ "print(a)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Remember that the rows are indexed by $R$, while the column are indexed by $\\mathcal{X}_{\\mathcal{M'}}$:" ] }, { "cell_type": "code", "execution_count": 22, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Row indexes: X0, X2, X3, X4, X5\n", "Col indexes: X'0, X'1, X'2, X'3\n" ] } ], "source": [ "print('Row indexes: {0}'.format(', '.join([\"X\"+str(r) for r in R])))\n", "print('Col indexes: {0}'.format(', '.join([\"X'\"+str(x) for x in M1.X])))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Let us extract from $a$ all the mappings:" ] }, { "cell_type": "code", "execution_count": 23, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Mapping alpha_X'0: X2 -> X'0\n", "Mapping alpha_X'1: X5 -> X'1\n", "Mapping alpha_X'2: X3, X4 -> X'2\n", "Mapping alpha_X'3: X0 -> X'3\n" ] } ], "source": [ "for i in range(a.shape[1]):\n", " print(\"Mapping alpha_X'{0}: {1} -> {2}\".format(i, ', '.join([\"X\"+str(r) for r in R[np.where(a[:,i]==1)[0]]]), \"X'\"+str(i)))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And let us check the cardinalities of domains and codomains in these mappings:" ] }, { "cell_type": "code", "execution_count": 24, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Cardinalities in mapping alpha_X'0: 4 -> 1\n", "Cardinalities in mapping alpha_X'1: 2 -> 2\n", "Cardinalities in mapping alpha_X'2: 28 -> 5\n", "Cardinalities in mapping alpha_X'3: 5 -> 6\n" ] } ], "source": [ "for i in range(a.shape[1]):\n", " domains = R[np.where(a[:,i]==1)[0]]\n", " card_domains = 1\n", " for d in domains:\n", " card_domains = card_domains * len(M0.MX[d])\n", " card_codomains = len(M1.MX[i])\n", " \n", " print(\"Cardinalities in mapping alpha_X'{0}: {1} -> {2}\".format(i, card_domains, card_codomains))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "It is the last mapping $\\alpha_{X'_3}$ that is problematic. In our random generation we have stumbled in a situation in which the cardinality of the domain is smaller that the cardinality of the codomain, and hence we can not have a surjective mapping." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Second abstraction\n", "\n", "Our first attempt to abstraction failed not because of a conceptual error, but because of our random generation procedure. To bypass the problem we simply re-define the function *instantiate_random_sets()*. We implement two functions one that likely generates large sets (for the low-level model $\\mathcal{M}/\\mathtt{M0}$) and one that generates small sets (for the high-level model $\\mathcal{M'}/\\mathtt{M1}$). This will not definitively solve the problem, but it will significantly increase the probability that we will be able to define a surjective mapping $\\alpha_{X'}$." ] }, { "cell_type": "code", "execution_count": 25, "metadata": {}, "outputs": [], "source": [ "def instantiate_random_sets_large(n_sets):\n", " cardinalities = np.random.randint(1,12,n_sets)\n", " return [np.arange(cardinalities[i]) for i in range(len(cardinalities))]\n", "\n", "def instantiate_random_sets_small(n_sets):\n", " cardinalities = np.random.randint(1,3,n_sets)\n", " return [np.arange(cardinalities[i]) for i in range(len(cardinalities))]" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We now re-instantiate the abstraction:" ] }, { "cell_type": "code", "execution_count": 26, "metadata": {}, "outputs": [], "source": [ "M0 = FinStochSCM(6,\n", " f_sets=instantiate_random_sets_large,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "M1 = FinStochSCM(4,\n", " f_sets=instantiate_random_sets_small,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "\n", "R = generate_random_R(M0,5)\n", "a = generate_random_a(R,M1)\n", "alphas = generate_random_alphas(M0,M1,R,a)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This time the instantiation worked. Let's have a peek at what abstraction we have defined, as we did before. We start analyzing $a$:" ] }, { "cell_type": "code", "execution_count": 27, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[[0. 1. 0. 0.]\n", " [0. 0. 0. 1.]\n", " [0. 0. 0. 1.]\n", " [1. 0. 0. 0.]\n", " [0. 0. 1. 0.]]\n" ] } ], "source": [ "print(a)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Notice that $a$ is now different. Let us look at the indexes for the rows ($R$) and the columns ($\\mathcal{X}_{\\mathcal{M'}}$):" ] }, { "cell_type": "code", "execution_count": 28, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Row indexes: X0, X2, X3, X4, X5\n", "Col indexes: X'0, X'1, X'2, X'3\n" ] } ], "source": [ "print('Row indexes: {0}'.format(', '.join([\"X\"+str(r) for r in R])))\n", "print('Col indexes: {0}'.format(', '.join([\"X'\"+str(x) for x in M1.X])))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Let us extract from $a$ all the mappings:" ] }, { "cell_type": "code", "execution_count": 29, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Mapping alpha_X'0: X4 -> X'0\n", "Mapping alpha_X'1: X0 -> X'1\n", "Mapping alpha_X'2: X5 -> X'2\n", "Mapping alpha_X'3: X2, X3 -> X'3\n" ] } ], "source": [ "for i in range(a.shape[1]):\n", " print(\"Mapping alpha_X'{0}: {1} -> {2}\".format(i, ', '.join([\"X\"+str(r) for r in R[np.where(a[:,i]==1)[0]]]), \"X'\"+str(i)))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And let us check the cardinalities of domains and codomains in these mappings:" ] }, { "cell_type": "code", "execution_count": 30, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Cardinalities in mapping alpha_X'0: 1 -> 1\n", "Cardinalities in mapping alpha_X'1: 10 -> 2\n", "Cardinalities in mapping alpha_X'2: 9 -> 2\n", "Cardinalities in mapping alpha_X'3: 40 -> 2\n" ] } ], "source": [ "for i in range(a.shape[1]):\n", " domains = R[np.where(a[:,i]==1)[0]]\n", " card_domains = 1\n", " for d in domains:\n", " card_domains = card_domains * len(M0.MX[d])\n", " card_codomains = len(M1.MX[i])\n", " \n", " print(\"Cardinalities in mapping alpha_X'{0}: {1} -> {2}\".format(i, card_domains, card_codomains))" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Now thanks to the small cardinality of the sets in the high-level model that we have imposed with the function *instantiate_random_sets_small()*, it is trivial to have surjective mappings.\n", "\n", "We can last look at the actual mappings in $\\alpha$:" ] }, { "cell_type": "code", "execution_count": 31, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "{0: array([[1.]]),\n", " 1: array([[1., 0.],\n", " [0., 1.],\n", " [0., 1.],\n", " [0., 1.],\n", " [0., 1.],\n", " [0., 1.],\n", " [0., 1.],\n", " [1., 0.],\n", " [0., 1.],\n", " [1., 0.]]),\n", " 2: array([[1., 0.],\n", " [1., 0.],\n", " [1., 0.],\n", " [0., 1.],\n", " [1., 0.],\n", " [1., 0.],\n", " [1., 0.],\n", " [0., 1.],\n", " [1., 0.]]),\n", " 3: array([[1., 0.],\n", " [1., 0.],\n", " [0., 1.],\n", " [0., 1.],\n", " [0., 1.],\n", " [0., 1.],\n", " [1., 0.],\n", " [0., 1.],\n", " [1., 0.],\n", " [0., 1.],\n", " [0., 1.],\n", " [0., 1.],\n", " [1., 0.],\n", " [0., 1.],\n", " [1., 0.],\n", " [0., 1.],\n", " [1., 0.],\n", " [0., 1.],\n", " [1., 0.],\n", " [1., 0.],\n", " [0., 1.],\n", " [0., 1.],\n", " [1., 0.],\n", " [0., 1.],\n", " [1., 0.],\n", " [0., 1.],\n", " [0., 1.],\n", " [1., 0.],\n", " [0., 1.],\n", " [1., 0.],\n", " [0., 1.],\n", " [0., 1.],\n", " [1., 0.],\n", " [1., 0.],\n", " [0., 1.],\n", " [0., 1.],\n", " [1., 0.],\n", " [1., 0.],\n", " [1., 0.],\n", " [0., 1.]])}" ] }, "execution_count": 31, "metadata": {}, "output_type": "execute_result" } ], "source": [ "alphas" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Abstraction\n", "\n", "We can now encapsulate variable-level mappings and domain-level mappings into an *Abstraction* class." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Abstraction class\n", "\n", "An abstraction object will have the following attributes:\n", "- *M0*: the base or low-level model; this is an object of class *FinStochSCM*. Mathematically, this is the SCM $\\mathcal{M}$.\n", "- *M1*: the abstracted or high-level model; this is an object of class *FinStochSCM*. Mathematically, this is the SCM $\\mathcal{M'}$.\n", "- *nR*: the number of relevant variables in M0. Mathematically, this is the cardinality $|R|$.\n", "- *R*: an array of relevant variables. Mathematically, this is the set $R$.\n", "- *a*: a binary matrix encoding the mapping between relevant variables and high-level variables. Mathematically, this is the surjective mapping $a: R \\rightarrow \\mathcal{X}_{\\mathcal{M'}}$.\n", "- *alphas*: a dictionary of binary matrix, each one encoding the mapping from outcomes of low-level variable(s) to outcomes of a high-level variable. Mathematically, this is the collection surjective mappings $\\alpha_{X'}: \\mathcal{M}[a^{-1}(X')] \\rightarrow \\mathcal{M'}[X']$.\n", "\n", "The methods are:\n", "- *\\__init__()*: a versatile constructor that can either set up a specific abstraction (passing a the necessary parameters) or generate a random abstraction (passing random generator functions);\n", "- *set\\_...()*: a series of setters to manually setup the abstraction;\n", "- *copy()*: a method to create a deep copy of the abstraction;\n", "- *is\\_...*: a series of tests on the properties of the abstraction;\n", "- *print\\_...()*: a series of function to print out details about the abstraction;\n", "- *plot\\_()*: method to plot the variable-level abstraction." ] }, { "cell_type": "code", "execution_count": 32, "metadata": {}, "outputs": [], "source": [ "class Abstraction():\n", " def __init__(self,M0,M1, nR, \n", " R=None, a=None, alphas=None,\n", " f_R=None, f_a=None, f_alphas=None):\n", " \n", " self.M0 = M0\n", " self.M1 = M1\n", " self.nR = nR\n", " \n", " self.R = self.set_R(R,f_R)\n", " self.a = self.set_a(a,f_a)\n", " self.alphas = self.set_alphas(alphas,f_alphas)\n", " \n", " def set_R(self,R,f_R):\n", " if R is None:\n", " # TODO:check nR is less or equal to length of M0.X\n", " R = f_R(self.M0,self.nR)\n", " \n", " # TODO:check length of R matches nR\n", " return R\n", "\n", " def set_a(self,a,f_a):\n", " if a is None:\n", " # TODO:check \n", " a = f_a(self.R,self.M1)\n", " \n", " # TODO:check dimensions of a\n", " return a\n", "\n", " def set_alphas(self,alphas,f_alphas):\n", " if alphas is None:\n", " # TODO:check\n", " alphas = f_alphas(self.M0,self.M1,self.R,self.a)\n", " \n", " # TODO:check dimensions of alpha\n", " return alphas\n", " \n", " def copy(self):\n", " Acopy = Abstraction(self.M0, self.M1, self.nR, \n", " R=self.R.copy(), a=self.a.copy(), alphas=self.alphas.copy())\n", " return Acopy\n", " \n", " def is_varlevel_complete(self):\n", " return self.M0.nX == self.nR\n", " \n", " def is_varlevel_isomorphic(self):\n", " return self.a.shape[0] == self.a.shape[1]\n", " \n", " def is_domlevel_isomorphic(self):\n", " for alpha in self.alphas.values():\n", " print(\"Mapping alpha_X'{0}: {1}\".format(i, alpha.shape[0]==alpha.shape[1]))\n", " \n", " def print_M0_cardinalites(self):\n", " for i in range(self.M0.nX):\n", " print('M0: cardinality of X{0}: {1}'.format(i,len(self.M0.MX[i])))\n", " \n", " def print_R_cardinalites(self):\n", " for i in range(self.nR):\n", " print('R: cardinality of X{0}: {1}'.format(self.R[i],len(self.M0.MX[R[i]])))\n", " \n", " def print_M1_cardinalites(self):\n", " for i in range(self.M1.nX):\n", " print(\"M1: cardinality of X'{0}: {1}\".format(i,len(self.M1.MX[i])))\n", " \n", " def print_relevant_vars(self):\n", " print('R = {0}'.format(', '.join(['X_'+str(r) for r in self.R])))\n", " \n", " def print_mapping_a(self):\n", " print(self.a)\n", " print('\\n')\n", " print('Row indexes: {0}'.format(', '.join([\"X\"+str(r) for r in self.R])))\n", " print('Col indexes: {0}'.format(', '.join([\"X'\"+str(x) for x in self.M1.X])))\n", " \n", " def print_mappings_alphas(self):\n", " for i in range(self.a.shape[1]):\n", " domain = self.R[np.where(self.a[:,i]==1)[0]]\n", " print(\"Mapping alpha_X'{0}: {1} -> {2}\".format(i, ', '.join([\"X_\"+str(d) for d in domain]), \"X'_\"+str(i)))\n", " \n", " def print_mappings_alphas_cardinalities(self):\n", " for i in range(self.a.shape[1]):\n", " domain = self.R[np.where(self.a[:,i]==1)[0]]\n", " card_domain = 1\n", " for d in domain:\n", " card_domain = card_domain * len(self.M0.MX[d])\n", " card_codomain = len(self.M1.MX[i])\n", "\n", " print(\"Cardinalities in mapping alpha_X'{0}: {1} -> {2}\".format(i, card_domain, card_codomain))\n", " \n", " def plot_variable_level_mapping(self):\n", " G = self.M0.G.copy()\n", " relabel_map = {}\n", " for n in G.nodes():\n", " relabel_map[n] = 'M0_'+str(n)\n", " G0 = nx.relabel.relabel_nodes(G,relabel_map)\n", "\n", " G = self.M1.G.copy()\n", " relabel_map = {}\n", " for n in G.nodes():\n", " relabel_map[n] = 'M1_'+str(n)\n", " G1 = nx.relabel.relabel_nodes(G,relabel_map)\n", "\n", " U = nx.union(G0,G1)\n", "\n", " #edge_color=['k']*U.number_of_edges() + ['r']*len(a[0])\n", "\n", " edge_list = [('M0_'+str(self.R[i]), 'M1_'+str(np.where(self.a[i,:]==1)[0][0])) for i in range(self.a.shape[0])]\n", " U.add_edges_from(edge_list)\n", "\n", " #for i in range(len(a[0])):\n", " # U.add_edge('M0_'+str(a[0][i]), 'M1_'+str(a[1][i])) \n", "\n", " pos = nx.shell_layout(U)\n", "\n", " for k in pos.keys():\n", " if 'M1' in k:\n", " pos[k] = pos[k] + [10,0]\n", "\n", " R_list = np.array(['M0_'+str(self.R[i]) for i in range(len(self.R))])\n", " nR = np.array(list(set(self.M0.X)-set(self.R)))\n", " nR_list = np.array(['M0_'+str(nR[i]) for i in range(len(nR))])\n", "\n", " nx.draw_networkx_nodes(U,pos,nodelist=R_list,node_color='b',alpha=.5)\n", " nx.draw_networkx_nodes(U,pos,nodelist=nR_list,node_color='b',alpha=.2)\n", " nx.draw_networkx_labels(U,pos)\n", " nx.draw_networkx_edges(U,pos,edgelist=G0.edges(),edge_color='k')\n", "\n", " nx.draw_networkx_nodes(U,pos,nodelist=G1.nodes(),node_color='g',alpha=.5)\n", " nx.draw_networkx_labels(U,pos)\n", " nx.draw_networkx_edges(U,pos,edgelist=G1.edges(),edge_color='k')\n", "\n", " nx.draw_networkx_edges(U,pos,edgelist=edge_list,edge_color='r',style='dashed')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can test this class by re-running the previous example:" ] }, { "cell_type": "code", "execution_count": 33, "metadata": {}, "outputs": [], "source": [ "M0 = FinStochSCM(6,\n", " f_sets=instantiate_random_sets_large,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "M1 = FinStochSCM(4,\n", " f_sets=instantiate_random_sets_small,\n", " f_links=instantiate_random_links,\n", " f_stochmatrices=instantiate_random_stochmatrices)\n", "\n", "A = Abstraction(M0,M1,5,\n", " f_R=generate_random_R,\n", " f_a=generate_random_a,\n", " f_alphas=generate_random_alphas)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The *print_...()* function of the *Abstraction* object gives us an easy way to check our abstraction:" ] }, { "cell_type": "code", "execution_count": 34, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Cardinalities in mapping alpha_X'0: 7 -> 1\n", "Cardinalities in mapping alpha_X'1: 8 -> 2\n", "Cardinalities in mapping alpha_X'2: 10 -> 1\n", "Cardinalities in mapping alpha_X'3: 48 -> 1\n" ] } ], "source": [ "A.print_mappings_alphas_cardinalities()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Example (I)\n", "\n", "We now take a look again at the running example in the notebook *Categorical Abstraction.ipynb*, which corresponded to the example in Sections 4.11-4.13 of [Rischel2020]." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Model M0\n", "\n", "First, we define model $\\mathcal{M}/\\mathtt{M0}$. We relabel the *smoking* node as $S \\mapsto 0$; the *tar deposit* node as $T \\mapsto 1$; and the *cancer* node as $C \\mapsto 2$." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Every node has a binary domain, which we define through *sets*." ] }, { "cell_type": "code", "execution_count": 35, "metadata": {}, "outputs": [], "source": [ "sets = [np.arange(2),np.arange(2),np.arange(2)]" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "In *links* we specify the edges of the underlying graph, that is $S \\rightarrow T \\rightarrow C$ or $0 \\rightarrow 1 \\rightarrow 2$." ] }, { "cell_type": "code", "execution_count": 36, "metadata": {}, "outputs": [], "source": [ "links = [('0','1'),('1','2')]" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Finally, in *stochmatrices* we define the stochastic matrices corresponding to the mechanism of every node (see the previous notebook *Categorical Abstraction.ipynb* for details on these matrices)." ] }, { "cell_type": "code", "execution_count": 37, "metadata": {}, "outputs": [], "source": [ "stochmatrices = {'0': np.array([.8,.2]),\n", " '1': np.array([[1,0],[.2,.8]]),\n", " '2': np.array([[.9,.1],[.6,.4]])}" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Finally we can instantiate the model and plot it." ] }, { "cell_type": "code", "execution_count": 38, "metadata": {}, "outputs": [], "source": [ "M0 = FinStochSCM(3, sets=sets, links= links, stochmatrices=stochmatrices)" ] }, { "cell_type": "code", "execution_count": 39, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "M0.plot()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Model M1\n", "\n", "We now follow the same approach to define model $\\mathcal{M'}/\\mathtt{M1}$. In this case we have only two nodes: the *smoking* node relabeled as $S \\mapsto 0$; and the *cancer* node relabeled as $C \\mapsto 1$." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We then define *sets*, *links*, and *stochmatrices*." ] }, { "cell_type": "code", "execution_count": 40, "metadata": {}, "outputs": [], "source": [ "sets = [np.arange(2),np.arange(2)]" ] }, { "cell_type": "code", "execution_count": 41, "metadata": {}, "outputs": [], "source": [ "links = [('0','1')]" ] }, { "cell_type": "code", "execution_count": 42, "metadata": {}, "outputs": [], "source": [ "stochmatrices = {'0': np.array([.8,.2]),\n", " '1': np.array([[.9,.1],[.66,.34]])}" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We instantiate the new model, and plot it." ] }, { "cell_type": "code", "execution_count": 43, "metadata": {}, "outputs": [], "source": [ "M1 = FinStochSCM(2, sets=sets, links= links, stochmatrices=stochmatrices)" ] }, { "cell_type": "code", "execution_count": 44, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "M1.plot()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Variable-level mapping\n", "\n", "Next, we implement an abstraction between the two models, $\\mathcal{M}/\\mathtt{M0}$ being the base or low-level model and $\\mathcal{M'}/\\mathtt{M1}$ being the abstracted or high-level model.\n", "\n", "We start defining the variable-level mapping." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "First, we need to define the restriction $R$. The node in $\\mathcal{M}/\\mathtt{M0}$ we are interested in are the *smoking* node ($0$) and the *cancer* node ($2$)." ] }, { "cell_type": "code", "execution_count": 45, "metadata": {}, "outputs": [], "source": [ "R = np.array([0,2])" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Next we need a surjective mapping $a: R \\rightarrow \\mathcal{X}_{\\mathcal{M'}}$. This is the trivial mapping that sends the *smoking* variable in $\\mathtt{M0}$ ($0$) to the *smoking* variable in $\\mathtt{M1}$ ($0$), and the *cancer* variable in $\\mathtt{M0}$ ($2$) to the *cancer* variable in $\\mathtt{M1}$ ($1$). The mapping is then given by an identity matrix (remember that while the *cancer* variable in $\\mathtt{M0}$ has index $2$, it has index $1$ in $R$). " ] }, { "cell_type": "code", "execution_count": 46, "metadata": {}, "outputs": [], "source": [ "a = np.eye(2)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Notice that, overall, we have a *variable-level mapping* that is **incomplete** (as we dropped $T$) and **isomorphic** (as we have a surjective and injective mapping between $R$ and $\\mathcal{X}_{\\mathcal{M'}}$)." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Domain-level mapping\n", "\n", "We then move to specify the domain-level mapping by defining the collection of surjective mappings $\\alpha_{X'}: \\mathcal{M}[a^{-1}(X')] \\rightarrow \\mathcal{M'}[X']$. These mappings too are trivial since they map each outcome in the low-level model to the equivalent outcome in the high-level model." ] }, { "cell_type": "code", "execution_count": 47, "metadata": {}, "outputs": [], "source": [ "alphas = {'0': np.eye(2),\n", " '1': np.eye(2)}" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Overall we have a *domain-level mapping* that is **isomorphic** for each map $\\alpha_{X'}$, since each one is surjective and injective." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Abstraction\n", "\n", "Finally, we put everything together to define our abstraction." ] }, { "cell_type": "code", "execution_count": 48, "metadata": {}, "outputs": [], "source": [ "A = Abstraction(M0,M1,2,R,a,alphas)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can now test properties of the abstraction, as well as plot the variable-level mapping." ] }, { "cell_type": "code", "execution_count": 49, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "R: cardinality of X0: 2\n", "R: cardinality of X2: 2\n" ] } ], "source": [ "A.print_R_cardinalites()" ] }, { "cell_type": "code", "execution_count": 50, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Mapping alpha_X'0: X_0 -> X'_0\n", "Mapping alpha_X'1: X_2 -> X'_1\n" ] } ], "source": [ "A.print_mappings_alphas()" ] }, { "cell_type": "code", "execution_count": 51, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "False" ] }, "execution_count": 51, "metadata": {}, "output_type": "execute_result" } ], "source": [ "A.is_varlevel_complete()" ] }, { "cell_type": "code", "execution_count": 52, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "True" ] }, "execution_count": 52, "metadata": {}, "output_type": "execute_result" } ], "source": [ "A.is_varlevel_isomorphic()" ] }, { "cell_type": "code", "execution_count": 53, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Mapping alpha_X'3: True\n", "Mapping alpha_X'3: True\n" ] } ], "source": [ "A.is_domlevel_isomorphic()" ] }, { "cell_type": "code", "execution_count": 54, "metadata": {}, "outputs": [ { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAV0AAADnCAYAAAC9roUQAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/YYfK9AAAACXBIWXMAAAsTAAALEwEAmpwYAAAojUlEQVR4nO3de1zUZdrH8c8MDDIcRI0wIEPymGJpgpoHEC2tVt11N9ss08xsbUs3t8dOPmroumZuT5ZWVrZZaaaldnCX3E3NQyfwQKuppKaIoHggUgGdGWaeP64FogAPzMxvBq7369Vr58D8uGjz6839u+/rNrlcLpRSSnmH2egClFKqIdHQVUopL9LQVUopL9LQVUopL9LQVUopLwqs7c3IyEhXy5YtvVSKUkrVD1u3bj3hcrkur+69WkO3ZcuWbNmyxTNVKaVUPWUymXJqek+nF5RSyos0dJVSyos0dJVSyos0dJVSyos0dJVSyos0dJVSyos0dJVSyotqXaerlFLuVGwrZvvR7eSfzqfEVkJIUAgx4TF0uaILoUGhRpfnFRq6SimPyzuVx7oD69iYsxG7005QQBABpgDKXGXYymxYzBZSWqaQ2jKV2MaxRpfrURq6SimPyszLZMGWBZhNZqJCo7AEWH7xNfYyOxsObmD9gfWMSxxHUmySAZV6h87pKqU8JjMvk3kZ84gMiSS2cWy1gQtgCbAQ2ziWyJBI5mXMIzMv08uVeo+GrlLKI/JO5bFgywKiw6KxWqwX9BmrxUp0WDQLti4g/3S+hys0hoauUuqSBQYGYjKZyM7OrvK61WrlyogrObbrGFmrspg9eDZpqWlM7z/9vNe0WqyYMZOakkpwcDAmk4m+fft66CfwPg1dpVSdWCwWJk+eXPF8xYoVlJWVAdDE2oTg8GA69O1Apxs7XfA1o0KjIBImPTaJK664wu01G0lDVylVJ8nJyaSnp1c8nzVrFtd1vw6Qudout3Rh8CODaX518wu+piXAwg1/vIGBYwYSHBzs9pqNpKGrlKqTAQMGYLfbWb16NTabjaysLIb8YUidr2sxW+rlvK4uGVNK1VlycjIzZ84kKyuLiIgImre68FFtTQLNgZTYS9xQnW/R0FVK1VlaWhopKSnk5eUxbNgwQoJC6nxNh9NBiKXu1/E1Or2glKqzXr16ERYWRm5uLtOnTyc6PLrO17Q77cSEx7ihOt+iI12llFusXLmSw4cPExUVRefgzoDsNHM6nNjO2nDYHQCcPXMWs9lMUEhQjdeyl9kx2UzEB8fjcrlwOBwUFRUREhJCUFDNn/MHGrpKKbfo169fxePy5jVFpUVkfJDBmhfXVLw3e/BsGoU24vHVj9d4rWPFx/jn//yTRbmLAMjJyaFp06aMGTOGhQsXeuYH8BINXaXUJXM4HOBywaxZUFwMW7fCN98Q3KMHh388zNT1U4lMjKTHbT0u+Jql9lKcONn+7XadXlBKqV+w2eDJJ8FkkgAG2LqV2MaxjEscx7yMeRe8FbjUXsqRM0cY3218vQxc0NBVStVVo0aweDGMHCmhGxICzz0HQFJsEuO7ja+2y1jGqgzSX0iv9pIvnnrRa+V7m8lV/jdTNRITE11btmzxYjlKKb9z/DgsXAhffw0bN0Lz5rBrl4x8/yv/dD7rDqxjw8EN2J12LGYLgeZAHE5HxfOUlik8/OuHKcwpJCwsjCeeeIIJEyYQGup/zc1NJtNWl8uVWO17GrpKqUtSUgJ//jN89RVkZclrN98MkyZB//7VfqTKyRH2EkIsVU+O+P3vf8/y5csBCAoKIioqipycHMxm/1rdWlvo6vSCUuriffMNDB8OXbrAhg2Vr3/ySa0fCw0KpfdVvWt8v3v37qxatQq73U5AQAAvvfSS3wXu+dSvn0Yp5VkuFzgc8OCD8MQTsGQJRES47fKdOnXC4XDQrl07rFYrCQkJbru2r9CRrlLqwhw/DqNHQ/v2sHmzR75F7969WbhwISNHjuT5559n+PDhbNq0CYul+hMn/JGOdJVS5/evf0HnztCpk6zJ9RCr1cq9995LYGAgEydOJDIyskqv3vpAR7pKqdplZ8OYMfD22/CTXWeeZjabWbRoEV26dCE1NZVbbrnFa9/bk3Skq5SqXnY23HAD5OfDoUNeDdxykZGRLFmyhNGjR5OXl+f17+8JGrpKqapcLvj736F3b9nw0LdvlTW33pacnMwf//hH7rrrropjgPyZhq5SqqqXXpIdZevXwwMPGBq45SZPnozZbGbGjBlGl1JnGrpKKbF5M6SkwF13SeMaH1quFRAQwJIlS3jllVf47LPPjC6nTjR0lWroHA546im47Tb4n/+BJk3AB3vWRkdH88YbbzBixAiOHz9udDmXTENXqYbujjtklLttGwwebHQ1tbr55psZMWIEo0aNwul0Gl3OJdHQVaqheu89mDYNZs+Wdbgx/tFKccaMGRQVFfHss88aXcol0XW6SjU0xcUwYYJ0BHv3XWjVyuiKLorFYmHp0qUkJSXRp08fevS48AbpvkBHuko1JKdOQdeu4HTKdELXrkZXdEni4uJ45ZVXGD58OEVFRUaXc1G0taNSDYHTCS++KH0TQkOhZ0+jK3KL8ePHc+TIEd577z1MPrC0rVxtrR11pKtUfXf0KNxyCyxdCtdcU28CF2DOnDns37+fl19+2ehSLpjO6SpVn23dCoMGwdixMHUqBNavP/LBwcEsW7aMXr160bNnTzp37gz8rFm6rYSQoKrN0o1Uv/4fUEqJs2dh/nzZwvvBB9C9u9EVeUzbtm2ZO3cuv//97/n4s4/5+tjXbMzZiN1pJyggiABTAGWuMmxltopjgVJbphLbONaQenVOV6n6ZvduOdWhVSuZUvDBjQ6e8MBfHuBk/EkiwiOqHID5U/YyO8eKj+F0ORmXOI6k2CSP1KJzuko1FEuXQp8+crLD++83mMDNzMukuGMx8VHxxDaOrTZwASwBFmIbxxIZEsm8jHlk5mV6uVKdXlCqfigshHXrpDnNpk1yw6yByDuVx4ItC4gOi8ZqsV7QZ6wWK9Fh0SzYuoDYxrHEhHtvY4iOdJXydxs2yKkOO3bIlt56GLiBgYGYTCays7OrvG61Wrky4kqO7TpG1qosZg+eTVpqGtP7Tz/vNa0WK2bMvLziZZo2bYrJZKJRo0Y888wznvoxAA1dpfzbtGkyf/vqq5CWZnQ1HmWxWKoc3bNixYqK/rpNrE0IDg+mQ98OdLqx0wVfMyo0iqcfeJq4lnGcPHmSCRMm8Nhjj7F79263119OQ1cpf5STA7t2QWkpbN8ON99sdEUel5ycTHp6esXzWbNmcV336wCZq+1ySxcGPzKY5lc3v+Br5mzNwXHWwVOvPkWzZs2YM2cOjRs39mjfXg1dpfzNO+9AYqKsUnjmGWh+4SHjzwYMGIDdbmf16tXYbDaysrIY8ochdbrmge0HMAeasYXYKl6Li4tj586ddS23RnojTSl/UVwsJzlkZEhXsC5djK7Ie1wu+Phjkrt1Y+bMmWRlZREREUHzVnX7C+fsmbOYA82U2EsqXgsPD6egoKCuFddIQ1cpf7B/PxQUwGWXyS6zUGN3VXmdywWbN5MWFESKzUbef/7DsDvvJCQopE6XDQ4LxulwEmKpvM7p06cJCanbdWuj0wtK+TKnU/rd3nADREXJ2WUNKXBdLhnhm0xgNtPLZiMMyC0pYfqwYUSHR9fp8vFd4nE6nASVVK5nzsnJIcGDRxXpSFcpX5WfD3ffDXY7bNkCV11ldEWe53LJDcJ334XMTPm527eX0A0JgdOnWWmxcPjWW4m66SY6ny4EZKeZ0+HEdtaGw+4A/jt1YDYTFFLzBpG4rnEEBgcyfdx0+q7ty6xZszh16hRTpkzx2I+ooauULzpxAhYvlt4JTz4JAQFGV+QZWVmQni4Bm5kp3dAGDpTwfeABSEqSEy0CA+G66+DLL+n3wQdw660AFc1rikqLyPgggzUvrqm49OzBs2kU2ojHVz9e47c/VnyMx19+nHkPz6Np06ZYLBZmz57NNR5c66y9F5TyJaWlcjjkxo3wn//4xPHnbrNtm/xc5QH75z/DsWPSWD0xUQL26qtr/pm3b5dDM+Pjq7ycdyqPqeunEhkSecE70gBK7aWcKD3BjNQZbt+RVlvvBR3pKuUrdu6UjQ4JCbKV158D95tv4KuvJFy3bZOOZ3PmQHQ03HgjPPGE7Jy7mBF8Das1YhvHMi5xHPMy5l3wVuBSeylHzhxhfLfxXt0CDDrSVcp4LheUlUH//jB6NIwa5T+B63JBdrYsY8vMlPnYuXPh3nvlL4+kJPmna1cwe/a+fWZeJgu2LMBsMlfpMpaxKoP0F9Kr/Uxt+VcXtY10NXSVMtKJExJQV18tYeXLXC7ZCbdliwTssWNwzz1w330SqklJ0KOHnExh0F8a+afzWXdgHRsObsDutGMxWwg0B+JwOiqep7RMoV98P4+OcDV0lfJFa9fKqPbOO+Evf/G9NowFBZUrCCIiZKT69NOVo9fUVOjd2+gqq1Xl5Ah7CSEW754coXO6SvmaffskcN94A266yehq4McfK0ewXbpIL97336+8wdWjh/wzYYJfTH2EBoXS+yrf/AtBQ1cpb9q3T34lnzYNcnONCbDSUlmqtXWrNMq5/36Zk+3cWQL28svl5OBXX/WLgPU3GrpKeYPLBW+9JcvBpk6VO/jeCDS7Hb79Vnrt9u8Pv/mNrJK45hoJ2JtvhmXLoGnTendopa/Sf8tKecOrr8ILL8g87rXXeuZ7OJ2wd6/c7LrqKhgzRka0V10F3brJxoM33pCz04KDPVODOi8NXaU86auv4LHH5ETe0aPdd7PM5ZLpiTNnZBXBjBkyXdCkCSQny7rYWbNkyqBx48rPRUa65/urS6ahq5QnlJXJnf5582DBAvn1vS5OnJDpiM8+g0WL5IaXywV33QUPPQSPPCI3vaKiKj+TnFy376k8QkNXKU8YMUKWXG3dCrGxF/fZM2fk1//Fi+Gf/5SA/eEHmQvu0kVuxL34IrRoUTkvfPXVbv8RlGdo6CrlTitXyrbXmTMhLu7821z/e8YXf/87bN4sAZuTI4Frs8HgwTJ10KaNx3d0Ke/Q0FXKHUpK4OGH5UbZ0qU1jzzPnpXjdsq3zWZnwxdfyP/26iXXSEgAi8Wb1Ssv0tBVqq7OnJHVAV27Sies8htXp07BP/5R2VXr8GGZLti8WdoUjhwpN7pCQuBvfzP0R1Deo9uAlbpULhe8/DK0bi3TBOfOVQZsSAiMGwcLF1bu6uraVVYXqHpPtwEr5U5FRbBmDUyZAsePy1KwK66A9eslXMePly2zl1/eII5GVxdHQ1ep2hQXy42x8jnYO+6Q0e1nn8lKgqeekt4Jl18Ojz5qdLXKD2joKlXOZpPTGjIzZW724YdhyBA5gTcpSbbu7twpHcEcDjksUqmLpKGrGqayMtizRwJ2zx7p+NWtmxwFU966MC5OGtSArC4YPlxemzQJGjUytn7ltzR0Vf3ncsGBA5WbDK6+Gn73O5mHTUqSEWvr1vJedU1fli+HBx+U9bJ/+IN23lJ1oqGr6p+jRytXEOzbJ6fpWq0SsDfdJN22cnPPv5Lghx9k3S3IHG7Hjp6uXDUAGrrKvxUVSfPtuDjZxfX669IvNilJtuLedpvMy0ZHV/3c+QJ382bpa3DXXfDXv3qqetUAaegq/1FSIqfMduggp8l++ikcOSKrCB5/XFYWjBol87J1mQKYMUN6GyxcCIMGua9+pdDQVb7Kbof9+2WE+uij8OWXMlXQsaP0pv3Nb+CPf7z4Y7xrk5sLp0/LTrLt2385OlbKDTR0lfGcTpk/LSmBOXNkTeyOHdJs++OP5UbXffdJ829PrRpYtkw2NcybJzUo5SEausq7XC5Z47p3b2Vf2G3bpIvW++/L1MBtt8H110NYmHzmnns8V09JifSj3bxZ+iIkVrtzUym30dBVnrdtG3z4YeVx3qmpsvQqPFzmYhMTZQMCwMSJ3qvr++/l1IXwcKmxPOSV8iBteKPcKzNTllmVN375wx8gIgLy8ys3HcTGGrvW1emE//s/eOYZ2LQJ2rUzrhZVL2nDG+UZW7ZIL9jMTDkh4dlnYdUqCA2VzQdPPy2bDnxpM8GRI7LCobhY5o5btjS6ItXAaOiq83O5pCdBedOXHTvglVdkO2y7dtC3rzxOSJATZ33VyZOwZIncmJsyRY8cV4bQ/+pUVeXHeJdPDxw4ANOmyc2sLl1kemDMGOjUSVoZ+oOzZ+VE3n//G7791rdG3qrB0dBtyFwuOc2gfARrsUDbtjIKLJ9/veMOab69Y4fR1V6aXbukUU27dvD55xq4ynAaug3JiROVI9h27eDrr+XX7fKAHThQmm/ffbfRldadyyWdxB58ECZMgHvv1cBVPkFDt746fVpubm3ZIg1e/vd/ZS1q+dExbdrAsGFy86u+hdHJk7KZIjbWf6ZAVIOhoVsfnD0rPQmysqS5y69+Jf1fr71WAtZqhXfflVUF9f0Y7/Xr5cDH22/XRjXKJ2no+huHA3bvhu++kxtbt98u85Zt20rA/vrXsHKljPIa2jHeBw5IV7C//13PJlM+S0PXl7lc0vSlsFDC9rHHZDQbGws9e0pv2AULpOtWSIjR1Rrn++/lcMgnnpAbg/V9NK/8mv7X6Uvy8qTT1YcfwoABsjW2Xz94+2057SAtTUJlzx4ZzTVuLHO0DTlwlyyB7t1h6FD5d6aBq3ycjnSNUlgoc63Ll8t0QGamtDOcOFHCY8IECdQrrqj8zE8fK+l3+7e/wb/+JVMtSvkB7b3gDWfPSkvCV16RY18yM+H4cXjpJQgKktUD5Qch1reVBJ6QkSE9dleulJuDekik8jHae8GbXC4Zsb7xhqyDzciQGzzr1sk62VtvlR1e7drpr8IXq6xMmtTMnSt/YTVrZnRFSl00Dd26On1a+sD+dNvs559Lr4Ju3aRXa0KCjGi7dze6Wv92zz1w6JCsPW7RwuhqlLokGroXo7BQ5g/LA9bhkBaBn34q86933ilzi6GhcsaWco8PP5TfGtLSZArGXcfzKGUAnwjd4mI5kio/Xxr5h4RATExlfhni5EkZsf5022ynTvCPf8j865QpErRNm8rWWeV+paXwyCOQng5Ll8oKDqX8nKGhm5cnU50bN8o0aFCQDGLKysBmk7X9KSly0EBsrAcLKSqqDNfMTNnVtXWrHISYlCQHIPbqJUu47rvPg4WoCsXFMh3TqZOsTY6IMLoipdzCsNULmZmyrt9shqio6jdP2e1ymorTCePGSf7VWfmwurzx9vjxsjyrUSOZg01Kkk0HepPGGC4XvPYaXHWV/JrTu7eu6FB+x+dWL2RmyqGr0dGyVLUmFouMcEtL5evHj7/I4LXbpSVhZibs3Ck3tXr2lF9Tk5KkEUyHDjJfqIx3/Lh0Azt6VG5OxsUZXZFSbuf10M3LkxHu+QL3p6xW+foFCySEY2Kq+SKnU5q8ZGbKrq3UVLjxRjldNilJflWNj5dlWzpy8j3/+Y+cOjFiBKxYIXNNStVDHgvdwMBAysrK2LNnD+1+cvBffLwVu/0so0dv4sore/L66zeQn58JQExMImPGfIW5mvWrVqtMRaxbBy3jNjF40CCKTp0iKDCQGb/9LY9+8glERkrA9u0rN7dOnLjwZFfGsNlkzW2vXrBsmUwnKFWPeXR1vsViYfLkyRXPlyxZQVlZWcXzVavu5ujR7dx339eMHZtBQcE3rFo1osbrRUXBhrnbuTk5hatLSjg5cCATbryRx5YvZ3d6ujSHefddmQA2mTRwfd3evRK269bJWmYNXNUAeDR0k5OTSU9Pr3g+Y8YsmjdPqXj+3Xcf0bHj7cTGJhETk0hCwnCysz+q8XoWCxy05lCMi48PHqTZJ58wJz2dxo0bM2P+fE/+KMrdVq6U+fV77pF1uPoXpGogPBq6AwYMwG63s3r1amw2G3v3ZpGY+FTF+zbbGVq2TK14Hh/fD7u9uNZrHjv1JYGBQcT8ZA1ZXFwcO3fudHv9ygN+/BHee0/WBa5bJ8fp6By7akA8fiMtOTmZmTNnkpWVhdUaQfPmXau8Hx4eXfE4LEweO53Oaud1Aez2HwkIqLq+LDw8nIKCAjdXrtzuiy+kyfiwYdJDQakGyOOhm5aWRkpKCnl5edxwwzB+MqULwJkzBb94XFPgAlgsEZSV2au8dvr0aUIack9Zf/DXv8Lzz8Orr8rpFko1UB5vc9WrVy/CwsLIzc1l/Pjp2GyV7wUFhXHgQOXBgQcPrsViqX3fb1RUPxwOG/n5+RWv5eTkkJCQ4PbalRvk5clxQj/8ANu2aeCqBs8rvQVXrlzJm2++Sf/+UVV2nrVtO5hdu5aRn7+FI0e2sWPHUtq1G1Ljdex2aNlyIKGhoQwZMoSioiIee+wxTp06xZQpU7zwk6iLsmIFXH+9bOOdM8fDe7mV8g9e2RzRr1+/ise9e8OiRfJ46NDFFBbu47XXugGyTnfo0MU1XufYMenFMGrUJwwaNIimTZtisViYPXs211xzjSd/BHUxSkvhT3+CtWvh449le7VSCvBg6Docjmpfv/nmYO6910VkpGx2GDs244KuV1oqm8769YOYmN4UFRW5sVrlNgcPQkGB7Cjbvl3OcVNKVfD60QWxsbJ34cgRCdILUVoqXz9uXA1bgJXxnE547jnZEdi4Mcyfr4GrVDUMaXiTlCTNa2rqMvbJJ9P5+utpv/jc229DbV3RlEEKCmSTww8/SPMg7XurVI0M66eblCSj3nXrYMMGuUlmsUBgIBw50oO+fQ/QunVLUlLKpxSMqlTV6uRJeOcdaeg+dWr1PTqVUhUMbWIeEyNNpYYOrXpyREFBIRERa5k7d4xxJ0eo2p07B48/LidpZGfrrjKlLpBPHNdT3qu6nNVqYvnyfxIaOsa4olTNdu+G4cOlVeaXX2rgKnURfPIM8E6dOrFjxw6jy1DVKSuTZvAPPCBNay67zOiKlPIrPjHS/bk2bdqQm5tLSUmJbu/1FT/8APffLz2L1641uhql/JZPjnQtFgtt27Zl165dRpeiADZtgs6dZRL+ueeMrkYpv+aToQsyxaDtGn3AoUNw++1yusPzz0NwsNEVKeXXfDZ0ExISdF7XSAcPyjlzO3ZI05pf/croipSqF3w2dPVmmoHefVf6JQwaJIdF1tJqUyl1cXzyRhro9IJhFi2S3rfp6dC163m/XCl1cXx2CNOiRQuKi4s5efKk0aU0DFu2yCnKgwbJlIIGrlIe4bOhazKZdF7XG5xOOTrn1ltl7W1kJDRqZHRVStVbPju9AJVTDH379jW6lPrr3nth3z7IzIS4OKOrUare8+nQ1ZGuB61eDZs3w5QpEraBPv2fglL1hs9OL4CuYPCI0lLpq/nggzB4MLRqpYGrlBf59J+2hIQEdu7cicvlwqRNVequtBS6d4f27eXcsqZNja5IqQbHp0P3sssuIywsjEOHDhGn842XzuWC11+XBsbz5kFysnYGU8ogPj29ADrFUGcnT8JvfyvbeNu3l5M9NXCVMoxfhK5ukrhE334rjWpatZK+t/HxRlekVIPn86GrKxgugd0uzWmKi+Uonb/9TdfeKuUjfD50dXrhIu3fL8dw/OtfkJAAffoYXZFS6id8PnQ7dOjA3r17sdvtRpfi+z74AHr0gLvuknW42gBeKZ/j06sXAKxWKy1atOC7776jY8eORpfjm06dgjVr5AbZp5/CddcZXZFSqgY+P9IFnWKo1VdfQZcucqPstts0cJXycT4/0gVdwVCjZ56BZ5+Fl1+WZWFKKZ/nF6GbkJDA22+/bXQZviM/H4qK4PhxacnYooXRFSmlLpBOL/ibDz6Q6YStW2HOHA1cpfyMX4x0W7duzdGjRzlz5gxhYWFGl2OMs2dh4kS5Yfbhh7JKQSnld/xipBsQEED79u359ttvjS7FGDk5cpqD2Qzbt2vgKuXH/CJ0oYFOMbhc8MILkJgIViu8+CJERBhdlVKqDvxiegEaYOgePw6jR8OxY7IcrHVroytSSrmB34x0y3vrNgiFhbB0KVx7rZzuoIGrVL2hI11fYrPB5MmwciXs3StzuEqpesVv/lTHxMTgcDgoKCgwuhTP+O476NkTsrPh6681cJWqp/zmT3b5kez1coqhrEzOLLv3XlkOFhlpdEVKKQ/xm+kFqJxi6N+/v9GluEdREYwbB+Hh8O9/G12NUsoL/GakC/VsXvfzz2VnWWSkLAtTSjUIfhW69WZ6IS9POoK98ALMny9rcJVSDYLfhe63336L0+k0upRLc+gQ9O8vfRPy8mDwYKMrUkp5mV+FbpMmTWjWrBkHDhwwupSL9/77kJQEAwfCoEG6OkGpBsqvbqRB5RRDq1atDPn+xcXS/iA/H0pK5EScmBiZng0NreFDixdDWpocoZOU5NV6lVK+xe9Ct/xm2q9//Wuvft+8PFi3DjZulMN2g4IgIEBWe9lsYLFASgqkpkJs7H8/tG0b/PnPsHy5zOEGB3u1ZqWU7/HL0P3444+9+j0zM2HBApkRiIqSgP05ux02bID162Hc/U6SPp8Ls2bJUehRUV6tVynlu/xuYtHbR/dkZsK8ebKyKza2+sAFeT02Vr5u3oivyHxjB2RkwJ13eq1WpZTv87uRbvv27fn+++85d+4cjRo18uj3ysuTEW509IWv6rJaITr1GhbYFxLbKIAYj1aolPI3fjfSbdSoEfHx8ezZs8ct1wsMDMRkMpGdnV3ldavVypVXmjh2bDONGjl57bXupKWZSUsz89pr3WpdtmaNacqPp/dw7bVxBAQEYDKZaNy4Ma+//rpbalZK+S+/C11w/xSDxWJh8uTJFc9XrFhBWVkZAE2awKpVd3P06Hbuu+9rxo7NoKDgG1atGlHrNYODjxMa2pnNm7dy7tw5hgwZwtixYzl69Kjb6lZK+R+/DN2EhAS3bgdOTk4mPT294vmsWbO47roUQOZqv/vuIzp2vJ3Y2CRiYhJJSBhOdvZHtV6zdeu+pKZ+SFlZZ4KCgli8eDEul4tPP/3UbXUrpfyPX4auu3swDBgwALvdzurVq7HZbGRlZTFkyFMV79tsZ2jZMrXieXx8P+z24vNe12KR9bwAy5YtAyTglVINl9/dSAPPrGBITk5m5syZZGVlERERQfPmXau8Hx4eXfE4LEweO51OzLXsLAsMlA0Uhw8fZtSoUQwYMICrrrrKrXUrpfyLX4ZufHw8J0+e5McffyTCTQc1pqWlkZKSQl5eHsOGDSMkpOr7Z84U/OJxbYEL4HCA01lIQkICLVu2ZM2aNW6pVSnlv/xyesFsNtOhQwe3jnZ79epFWFgYubm5TJ8+nejKgS1BQWEcOLC+4vnBg2uxWGra81upuPgUEye2pUmTJvWjO5pSqs78MnTBM1MMK1eu5M033yQqKorOneU1ux3ath3Mrl3LyM/fwpEj29ixYynt2g2p9VrFxSWsWtUGq9XCnj17CAz0y18qlFJu5rdJ4O4VDAD9+vWreFzevKaoCIYOXUxh4T5ee60bADExiQwdurjWa23e/Bpnzx7j7FlZ81tu3rx5PPTQQ26tWynlP/w2dDt16sQHH3xQ5+s4HI5qXw8ODubwYRdTp8K5czB2bMYFX7O0FDp0+BMrVvyJGN2SppT6Cb+fXnC5XB77HrGxcoTZkSMSpBeitFS+ftw4NHCVUr/gtyPdqKgozGYzR44cIcZD6bZ9+3ZGjLiD++9/lV27Un7RZSwjYz7p6eOr/exbb3nuLwOllP/y29A1mUwVmyTcHbo7d+5k0qRJrF27FrvdTo8egQwfLv10N2yQm2sWC8TFPcR99z1U8TwlBfr10xGuUqpmfhu6UDnFMHDgQLdd87nnnmPSpEm4XC6cTicBAQFcf/31WK0wYgQMHXoJJ0copdR/+XXoJiQk8Pnnn7v1moMGDWL+/PkV57BFRUVVWX0QGgq9e7v1WyqlGhC/vZEG7u/BANCmTRtSUlKIj4/HbDaTkJDg1usrpRo2vx7pduzYkd27d1NWVkZAQIBbrvnuu++yadMmsrKyWLduHaE6Z6CUciO/Dt3w8HCaN2/O/v37adu2bZ2vt2/fPsaPH8+aNWsIDw/3+uGXSqn6z6+nF8B9Uwznzp3jjjvuYOrUqVx//fVuqEwppX6pXoSuO3owPP7447Ro0UK36CqlPMqvpxdAQvf999+v0zU++ugjVq1axbZt2zCZTG6qTCmlfsnvR7p1bXyTm5vL2LFjeeedd2jWrJkbK1NKqV/y+9Bt164dhw4dovRCmyP8hMPhYPjw4UycOJGePXt6oDqllKrK70PXYrHQpk0bdu/efdGfnTZtGqGhoTz66KMeqEwppX7J7+d0oXKKoVWrVlitVoKCgs77mU8//ZRFixaxbdu28x67o5RS7uLXaZOfn88jjzzCF198wbhx42jSpAnPPffceT9XUFDAyJEjeeutt2jevLkXKlVKKeHXI93CwkLmzp2L0+kEICwsjD59+tT6GafTyYgRIxgzZgz9+/f3RplKKVXBr0e6CQkJzJo1q6Ihjclkonv37rV+5umnn+bcuXNMmzbNGyUqpVQVfh26AJMmTaoI2tTU1Fp7MHz++ee88MILvPPOO3pQpFLKEH4fuiaTiffeew+LxUJKSkqNX1dYWMidd97JwoULufLKK71YoVJKVaoXw70mTSLJyjqKxdKUPXsgMBDCwiAyUh67XC5Gjx7N7373OwYNGmR0uUqpBsyvQ7e4GA4fhpwccDqbERgIZjM4nXKkTkAAxMXBhx++RH5+Pu+9957RJSulGji/Dd3jx2HbNgnWJk3kf3+urAwOHYKNG8t48cXlF7R+VymlPMkvQ/f4ccjMhKZNobYcDQiAZs1g8uQJnDghn7v8cu/VqZRSP+d3N9KKi2WEe77A/amgIPn6bdvkMEmllDKK34Xu4cMygr3YmYKgIJnvzc31TF1KKXUhfDZ0AwMDMZlMZGdnV7zmcMC111q56SYT27dvxul0MmpUd5KSzCQlmRk5slvF7rTqNG4sN9169+5DcHAwJpOJvn37euGnUUop4bOhC9JBbPLkyRXP33xzBU5nWcXzqVPvJjt7O4sWfc2bb2awd+83TJkyosbrBQbKzbWWLdvz5JNPcsUVV3i0fqWU+jmfDt3k5GTS09Mrns+dO4tOnSo3QGzc+BE33XQ7HTsm0aFDIgMGDGfjxo9qvabFAk899RpTp04lODjYY7UrpVR1fDp0BwwYgN1uZ/Xq1dhsNnbtyuKee56qeL+k5AyJiakVz5OS+lFaWlzrNc1mmaZQSikj+PySseTkZGbOnElWVhbh4RG0bt21yvuRkdG/eOx0Omvsket0yjSDUkoZwefjJy0tjZSUFPLy8hg8eBh2e9X3T54sqHhcWCiPa2tKbrfLFmGllDKCT08vAPTq1YuwsDByc3OZPXt6lZ1nISFhbNmyvuJ5ZuZarNbQGq/lcMhys8hIT1aslFI18/mRLsDKlSs5fPgwMTFRHD9+tuL1Pn0G8+9/L+OOOyZgNpv55JOl9Ov32xqvc+qU9GKw2Uo4c8aGy+XC4XBQVFRESEiIbhNWSnmcX4Ruv379Kh6Xd2V0OGDGjMXk5u5j5MhuAHTokMiMGYurvYbNJvO5LVrAtddey/79+wHIycmhadOmjBkzhoULF3r2B1FKNXg+G7qOGpYYXHZZMMeOucjMlOB9662M817LZoMffoCkJAgJgX379rm7XKWUuiA+P6dbncsvlwA9dQoKC2XDQ3UcDnn/1Cn5em12o5Qyms+OdM/n8suhTx/ppZCTI8Frscg63FWr5jN//vhqP+dyubxcqVJKVTLVFkKJiYmuLVu2eLGcS+NwwIkTcOaMPP75yRFKKeVNJpNpq8vlSqzuvXoRSYGBoG0UlFL+wC/ndJVSyl9p6CqllBdp6CqllBdp6CqllBfVunrBZDIdB3K8V45SStULcS6Xq9qdAbWGrlJKKffS6QWllPIiDV2llPIiDV2llPIiDV2llPIiDV2llPKi/wePn0cw5e4O2gAAAABJRU5ErkJggg==\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "A.plot_variable_level_mapping()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Example (II)\n", "\n", "We can also implement and have a look to the example that we introduced in our discussion above about the limitations of the definition of abstraction." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Model M0\n", "\n", "Model $\\mathcal{M}/\\mathtt{M0}$ is a simple model defined over to binary variables with arbitrary stochastic matrices." ] }, { "cell_type": "code", "execution_count": 55, "metadata": {}, "outputs": [], "source": [ "sets = [np.arange(2),np.arange(2)]" ] }, { "cell_type": "code", "execution_count": 56, "metadata": {}, "outputs": [], "source": [ "links = [('0','1')]" ] }, { "cell_type": "code", "execution_count": 57, "metadata": {}, "outputs": [], "source": [ "rvals = np.random.randn(3)\n", "\n", "stochmatrices = {'0': np.array([rvals[0],1-rvals[0]]),\n", " '1': np.array([[rvals[1],1-rvals[1]],[rvals[2],1-rvals[2]]])}" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Finally we can instantiate the model and plot it." ] }, { "cell_type": "code", "execution_count": 58, "metadata": {}, "outputs": [], "source": [ "M0 = FinStochSCM(2, sets=sets, links= links, stochmatrices=stochmatrices)" ] }, { "cell_type": "code", "execution_count": 59, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "M0.plot()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Model M1\n", "\n", "Model $\\mathcal{M'}/\\mathtt{M1}$ is identical to $\\mathcal{M}/\\mathtt{M0}$ except that it reverts the direction of the causality." ] }, { "cell_type": "code", "execution_count": 60, "metadata": {}, "outputs": [], "source": [ "sets = [np.arange(2),np.arange(2)]" ] }, { "cell_type": "code", "execution_count": 61, "metadata": {}, "outputs": [], "source": [ "links = [('1','0')]" ] }, { "cell_type": "code", "execution_count": 62, "metadata": {}, "outputs": [], "source": [ "rvals = np.random.randn(3)\n", "\n", "stochmatrices = {'0': np.array([rvals[0],1-rvals[0]]),\n", " '1': np.array([[rvals[1],1-rvals[1]],[rvals[2],1-rvals[2]]])}" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We instantiate the new model, and plot it." ] }, { "cell_type": "code", "execution_count": 63, "metadata": {}, "outputs": [], "source": [ "M1 = FinStochSCM(2, sets=sets, links= links, stochmatrices=stochmatrices)" ] }, { "cell_type": "code", "execution_count": 64, "metadata": {}, "outputs": [ { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAV0AAADnCAYAAAC9roUQAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/YYfK9AAAACXBIWXMAAAsTAAALEwEAmpwYAAAXnElEQVR4nO3de1RUdQIH8O8gJBoSx0dq4DoZi5Azg4APfEulHDVrd0Wzcs+evBBKPjP1KOUed7fOdnpoqSinti0z05W0QjEJBRSBeDMzKiKW4gMIJEQeA/O4+0fF6vLIB3PvPL6f/5yX37++53t+3LmjEEURREQkDRe5AxAROROWLhGRhFi6REQSYukSEUmIpUtEJCHXrp7s37+/qFQqJYpCROQY8vPza0RRHNDRc12WrlKpRF5ennVSERE5KIVCcbGz53i8QEQkIZYuEZGEWLpERBJi6RIRSYilS0QkIZYuEZGEWLpERBJi6RIRSajLL0cQEdmjmoYWJORfRkllPeoNJni6u8J/kCfmhvign0dPWbOxdInIYRRfqsO2tDKkl1YDAFpMlrbn3F0rsSmlFFOHD0DMFF8EDvGSJSNLl4gcwq7sC3g9qQQGkxkd/SCO4ZcCTj5dheOlNYid6Y8FoUppQ4KlS0QO4OfCPYNmo+U3XyuKQLPRjNeTzgCA5MXLP6QRkV0rvlSH15NKbqtwb9ZstOD1pBJoL9dZJ1gnWLpEZNe2pZXBYDK3e9zcfAM/fvEPlL8zB5fjXkDjqbR2rzGYzIhLK5Mg5f/weIGI7FZNQwvSS6s7PMOtTd4ORQ83+Czdhdaq7/Fjwka4Pfgw7hswtO01ogiknq3GtYYWya5q4NIlIruVkH+5w8ctrQY0nc2E1+QFcLmvF9yHjEBv37FoPJXa7rUKAAkFHX+ONbB0ichulVTW33JZ2K9MtVegcHGBW1/vtsfcHnwYxur29xY3mCwoqbhh1Zw3Y+kSkd2qN5g6fNxibIaiZ+9bHnPp2RuW1uZOPsfY7dk6w9IlIrvl6d7xn6Vc3HpBbLm1YMWWJrjc16uTz3Hr9mydYekSkd3yH+SJnq7ta8y1rzdEixnG2ittj7X++APcbvoj2q/cXV3gP7iPVXPejKVLRHYrIsSnw8dd7nNH7+HjUHfiM1haDTBcPo2msu9w/4iwdq8VAUQEd/w51sDSJSK71d+jJ6b4DYBC0f65vtNjIJpacXnL86j5+i30mx5zy+ViAKBQAGHDB0h6Exxep0tEdqG5uRlbt27F6dOncf78eZw7dw7V1dX45GAaTpzrgWbjrV+Q6NGrDx6c82qXn+nu2gMxU32tGbsdli4R2QWj0YiNGzeisbGx7TGlUonnwidA9Lp42/de+FUvNxfEzvSHxsfLCmk7x+MFIrILnp6eiI6OhuKXswR3d3fs378fCoUCC0KViJ0ZgF5uPTo8ariZQgH0cuuB2JkBvMsYEVFHampqsHLlSmRkZECtVuPUqVOYN28egoKC2l6zIFQJjY8X4tLKkHq2Ggr873aOwM9XKYj4+Qw3Zqqv5Av3VyxdIrJZoihi3759WL58OebPnw+9Xo9r164hIiIC77zzTrvXa3y8sGPBKFxraEFCwWWUVNxAvcEIT3c3+A/ug4hg/nIEEVGHrl69ipiYGJw7dw4HDhxAaGgoAOD+++9HTk5Ol+/t59ET0ZMfkSLmHeOZLhHZFFEU8eGHHyIwMBCBgYEoKChoK1xHwKVLRDbj+++/R1RUFOrr63H06FFoNBq5I3U7Ll0ikp3ZbMamTZswZswYzJgxA1lZWQ5ZuACXLhHJ7NSpUxAEAe7u7sjOzoavr7RfVpAaly4RyaK1tRV/+9vfMHXqVLzwwgs4duyYwxcuwKVLRDLIzc3FwoULMXToUBQWFsLHR7obzsiNS5eIJNPU1IRXXnkFs2fPxvr165GYmOhUhQuwdIlIImlpadBoNLh69Sp0Oh2effbZtq/0OhMeLxCRVV2/fh1r1qxBUlIS4uLiMHv2bLkjyYpLl4is5uDBg1CpVAAAvV7v9IULcOkSkRVUV1dj+fLlyMnJwc6dOxEW1v4XG5wVly4RdRtRFLF7926o1Wp4e3tDq9WycP8Ply4RdYvLly9j8eLFuHDhAr7++muMGTNG7kg2iUuXiO6JxWJBfHw8goKCMHr0aOTn57Nwu8ClS0R3raysDFFRUWhqakJqamrbH82oc1y6RHTHTCYT3n77bYSGhuKpp55CZmYmC/c2cekS0R3R6XQQBAF9+vTBd999h0cesc2bhdsqLl0iui0tLS3461//isceewwvvvgiUlJSWLh3gUuXiH5TdnY2BEGAr68vioqK4O3tLXcku8XSJaJONTY24rXXXsPnn3+OzZs3Y968eU55v4TuxOMFIurQ0aNHoVarUV1dDZ1Oh2eeeYaF2w24dInoFnV1dVi9ejWOHDmC7du3Y9asWXJHcihcukTU5quvvoJKpYKbmxv0ej0L1wq4dIkIVVVVWLZsGQoLC7F7925MnjxZ7kgOi0uXyImJoohdu3ZBo9FAqVSiuLiYhWtlXLpETqq8vByLFi3ClStXcOjQIYwaNUruSE6BS5fIyVgsFmzfvh0hISEYP3488vLyWLgS4tIlciKlpaWIjIyE0WhEeno6Hn30UbkjOR0uXSInYDKZ8Oabb2L8+PGIiIhARkYGC1cmXLpEDq64uBgLFy5E3759kZubi4cffljuSE6NS5fIQRkMBrz66quYNm0alixZguTkZBauDeDSJXJAmZmZEAQBAQEBKC4uxuDBg+WORL9g6RI5kIaGBsTGxmLfvn14//33MWfOHN4vwcbweIHIQSQnJ0OtVuP69evQ6XSIiIhg4dogLl0iO/fTTz/h5ZdfRmpqKuLj4xEeHi53JOoCly6RHdu/fz9UKhU8PDyg0+lYuHaAS5fIDlVWVmLJkiXQ6/XYu3cvJk6cKHckuk1cukR2RBRFfPLJJ9BoNPDz80NRUREL185w6RLZiYsXLyI6OhpVVVX45ptvEBwcLHckugtcukQ2zmKxYOvWrQgJCcGUKVOQk5PDwrVjXLpENqykpASRkZEAgIyMDPj7+8uciO4Vly6RDTIajXjjjTcwceJEzJ8/H8ePH2fhOgguXSIbU1hYiIULF2LgwIHIz8/H0KFD5Y5E3YhLl8hGGAwGrFu3DuHh4VixYgUOHz7MwnVAXLpENiAjIwOCIECj0UCr1WLQoEFyRyIrYekSyejGjRtYt24dDhw4gC1btuBPf/qT3JHIyni8QCSTb775BiqVCk1NTdDr9SxcJ8GlSySxa9eu4eWXX8bx48fx4YcfYtq0aXJHIglx6RJJRBRFJCQkQK1Ww8vLCzqdjoXrhLh0iSRQUVGBl156CWfOnEFCQgLGjx8vdySSCZcukRWJooiPPvoIgYGBePTRR1FYWMjCdXJcukRW8sMPP+DFF19EbW0tkpOTMXLkSLkjkQ3g0iXqZmazGe+99x5Gjx6NadOm4bvvvmPhUhsuXaJudPr0aURGRsLV1RWZmZnw8/OTOxLZGC5dom5gNBrxj3/8A1OmTMGf//xnpKWlsXCpQ1y6RPcoPz8fCxcuhLe3N/Lz8/G73/1O7khkw7h0ie5Sc3Mz1q5di5kzZ2L16tU4dOgQC5d+E0uX6C6kp6dDo9Hg4sWL0Ol0WLBgARQKhdyxyA7weIHoDtTX12Pt2rVITEzEtm3b8PTTT8sdiewMly7RbUpKSoJKpYLJZIJer2fh0l3h0iX6DTU1NVixYgWysrLw73//G48//rjckciOcekSdUIURezduxdqtRoPPvggtFotC5fuGZcuUQeuXLmCmJgYlJWV4cCBAwgNDZU7EjkILl2im4iiiA8++AAjR45EUFAQCgoKWLjUrbh0iX5x/vx5REVF4caNGzh27BjUarXckcgBcemS0zObzXj33XcxduxYzJo1C1lZWSxcshouXXJqer0egiCgV69eyM7Ohq+vr9yRyMFx6ZJTam1txcaNGxEWFgZBEHDs2DEWLkmCS5ecTk5ODgRBgFKpRGFhIXx8fOSORE6EpUtOo6mpCRs2bMCuXbuwadMmzJ8/n/dLIMnxeIGcQmpqKjQaDSoqKqDT6fDss8+ycEkWXLrk0K5fv441a9YgKSkJcXFxmD17ttyRyMlx6ZLDSkxMhEqlgkKhgF6vZ+GSTeDSJYdTXV2N5cuXIycnBzt37kRYWJjckYjacOmSwxBFEbt374ZarYa3tze0Wi0Ll2wOly45hEuXLmHx4sUoLy9HYmIiRo8eLXckog5x6ZJds1gsiI+PR3BwMMaMGYO8vDwWLtk0Ll2yW+fOnUNUVBQMBgPS0tIwYsQIuSMR/SYuXbI7JpMJb7/9NsaNG4enn34aJ0+eZOGS3eDSJbui1WohCAI8PT2Rk5ODYcOGyR2J6I5w6ZJdaGlpwYYNG/D4449j0aJFSElJYeGSXeLSJZuXnZ0NQRDw+9//HsXFxXjooYfkjkR011i6ZLMaGxvx6quvYs+ePXjvvfcwd+5c3i+B7B6PF8gmHT16FGq1GjU1NdDr9Zg3bx4LlxwCly7ZlLq6OrzyyitITk7Gjh07MHPmTLkjEXUrLl2yGV9++SVUKhV69uwJvV7PwiWHxKVLsquqqsLSpUtRVFSE3bt3Y/LkyXJHIrIaLl2SjSiK+PTTT6HRaDBs2DAUFxezcMnhcemSLMrLy7Fo0SJcvXoVSUlJCAkJkTsSkSS4dElSFosFcXFxCAkJwYQJE5Cbm8vCJafCpUuSKS0tRWRkJEwmE44fP46AgAC5IxFJjkuXrM5kMuHNN9/E+PHjERERgRMnTrBwyWlx6ZJVFRUVQRAE9OvXD3l5eVAqlXJHIpIVly5ZhcFgQGxsLKZPn46lS5fiyJEjLFwicOmSFWRmZkIQBAQEBKC4uBiDBw+WOxKRzWDpUrdpaGjA+vXrkZCQgC1btmDOnDlyRyKyOTxeoG6RnJwMtVqN+vp66PV6Fi5RJ7h06Z7U1tZi1apVSE1NRXx8PMLDw+WORGTTuHTprn3xxRdQqVTw8PCATqdj4RLdBi5dumOVlZVYsmQJ9Ho9/vOf/2DixIlyRyKyG1y6dNtEUcTHH38MjUYDPz8/FBUVsXCJ7hCXLt2WCxcuIDo6Gj/++COOHDmCoKAguSMR2SUuXeqSxWLBli1bMGrUKISFhSEnJ4eFS3QPuHSpU2fOnEFkZCRcXFxw8uRJDB8+XO5IRHaPS5faMRqNeOONNzBp0iQ899xzSE9PZ+ESdRMuXbpFQUEBBEHAwIEDkZ+fj6FDh8odicihcOkSAKC5uRnr1q3DjBkzsHLlShw+fJiFS2QFXLqEjIwMCIIAjUYDrVaLgQMHyh2JyGGxdJ3YjRs3sG7dOhw4cABbt27FH//4R7kjETk8Hi84qcOHD0OlUqG5uRl6vZ6FSyQRLl0nc+3aNaxcuRInTpzAv/71LzzxxBNyRyJyKly6TkIURezbtw8qlQp9+/aFTqdj4RLJgEvXCVRUVCAmJgZnz57F/v37MW7cOLkjETktLl0HJooiPvroIwQGBkKlUqGwsJCFSyQzLl0H9f333yM6Oho//fQTvv32WwQGBsodiYjApetwzGYzNm/ejDFjxmD69OnIzs5m4RLZEC5dB3L69GkIgoD77rsPmZmZ8PPzkzsSEf0fLl0H0Nrair///e+YMmUK/vKXvyA1NZWFS2SjuHTtXF5eHgRBgLe3NwoKCjBkyBC5IxFRF7h07VRzczPWrFmDWbNmYc2aNTh06BALl8gOsHTtUHp6OjQaDS5dugSdTofnn38eCoVC7lhEdBt4vGBH6uvrsXbtWiQmJiIuLg5PPfWU3JGI6A5x6dqJQ4cOQaVSwWw2Q6/Xs3CJ7BSXro2rqanBihUrkJWVhY8//hiPPfaY3JGI6B5w6dooURSxZ88eqFQqDBw4EFqtloVL5AC4dG3QlStXEBMTg7KyMnz11VcYO3as3JGIqJtw6doQURTxwQcfYOTIkQgKCkJBQQELl8jBcOnaiPPnzyMqKgoNDQ04duwY1Gq13JGIyAq4dGVmNpvx7rvvYuzYsZg1axaysrJYuEQOjEtXRnq9HoIgoHfv3sjOzoavr6/ckYjIyrh0ZdDa2oqNGzciLCwMgiDg6NGjLFwiJ8GlK7GcnBwIggClUonCwkL4+PjIHYmIJMTSlUhTUxNee+01fPbZZ9i8eTOeeeYZ3i+ByAnxeEECqampUKvVqKyshF6vx/z581m4RE6KS9eKrl+/jtWrV+Pw4cPYvn07nnzySbkjEZHMuHStJDExESqVCi4uLtDr9SxcIgLApdvtqqursWzZMuTm5uLTTz/F1KlT5Y5ERDaES7ebiKKIzz77DGq1GkOGDIFWq2XhElE7XLrd4NKlS1i8eDHKy8tx8OBBjBo1Su5IRGSjuHTvgcViwY4dOxAcHIyxY8ciLy+PhUtEXeLSvUvnzp1DVFQUDAYD0tLSMGLECLkjEZEd4NK9QyaTCW+99RbGjRuHP/zhDzh58iQLl4huG5fuHdBqtRAEAQ888ABycnIwbNgwuSMRkZ3h0r0NLS0t2LBhA5544gksWrQI3377LQuXiO4Kl+5vyMrKgiAI8PPzQ1FRER566CG5IxGRHWPpdqKxsRGxsbHYu3cv3n//fURERPB+CUR0z3i80IGUlBSo1WrU1tZCr9dj7ty5LFwi6hZcujepq6vDqlWrkJKSgh07dmDGjBlyRyIiB8Ol+4svv/wSI0aMgLu7O3Q6HQuXiKzC6ZduVVUVli5diqKiInz++eeYPHmy3JGIyIE57dIVRRE7d+6ERqPBI488guLiYhYuEVmdUy7d8vJyREdHo6KiAklJSQgJCZE7EhE5CadauhaLBdu2bUNwcDAmTZqE3NxcFi4RScpplu7Zs2cRGRkJs9mMEydOICAgQO5IROSEHH7pGo1G/POf/8SECRMwb948Fi4Rycqhl25hYSEEQUD//v2Rl5cHpVIpdyQicnIOuXQNBgNiY2MRHh6OZcuW4ciRIyxcIrIJDrd0T548CUEQMGLECGi1WgwaNEjuSEREbRymdBsaGrB+/XokJCRgy5YtmDNnjtyRiIjacYjjheTkZKhUKtTX10Ov17Nwichm2cTSrWloQUL+ZZRU1qPeYIKnuyv8B3libogP+nn07PR9tbW1WLVqFVJTUxEfH4/w8HAJUxMR3TlZS7f4Uh22pZUhvbQaANBisrQ95+5aiU0ppZg6fABipvgicIjXLe/94osvsHTpUkRERECv18PDw0PK6EREd0W20t2VfQGvJ5XAYDJDFNs/b/ilgJNPV+F4aQ1iZ/pjQagSFRUVWLJkCU6dOoV9+/ZhwoQJEicnIrp7spzp/ly4Z9Bs7LhwbyaKQLPRjNeTzmDZ+/sQGBgIf39/FBUVsXCJyO5IvnSLL9Xh9aQSNBsttzxen5+IRt1RtFZfwP0BU9D/yZW3PN9stODQ1Z6I23MQEY+NkTIyEVG3kXzpbksrg8Fkbve4q0c/PDD+GXhopnX6XotLD6RcdYgLLojISUnaYDUNLUgvre7wSKH38PHo7TcOLr08O32/KAKpZ6txraHFiimJiKxH0tJNyL98z5+hAJBQcO+fQ0QkB0lLt6Sy/pbLwu6GwWRBScWNbkpERCQtSUu33mDqps8xdsvnEBFJTdLS9XTvnoslPN3duuVziIikJmnp+g/yRE/Xjv9L0WKGaGoFLGZAtEA0tUK0tL/Kwd3VBf6D+1g7KhGRVUh6nW5EiA82pZR2+Nz1k3tw/eTnbf9uPJWKByY8C69Jz9/yOhFARLCPNWMSEVmNpKXb36MnpvgNwLdnqtpdNuY16fl2Bfv/FAogbPiALm+CQ0RkyyT/psFLU33h7trjrt7r7toDMVN9uzkREZF0JC/dwCFeiJ3pj15ud/Zf93JzQexMf2h8vKwTjIhIArLcZWxBqBIAurzL2K8Uip8X7q93GSMismey3dpxQagSGh8vxKWVIfVsNRT43+0cgZ+vUhDx8xluzFRfLlwicgiy3sRc4+OFHQtG4VpDCxIKLqOk4gbqDUZ4urvBf3AfRAR3/csRRET2xiZ+rqefR09ET35E7hhERFbH+yQSEUmIpUtEJCGWLhGRhFi6REQSYukSEUmIpUtEJCGWLhGRhFi6REQSUohd3PhAoVBUA7goXRwiIocwVBTFAR090WXpEhFR9+LxAhGRhFi6REQSYukSEUmIpUtEJCGWLhGRhP4LWiSVn0+hUqYAAAAASUVORK5CYII=\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "M1.plot()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Variable-level mapping\n", "\n", "Next, we implement the abstraction between the two models that we described above, starting with the variable-level mapping." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The restriction $R$ is simply the whole set of variables in the base model." ] }, { "cell_type": "code", "execution_count": 65, "metadata": {}, "outputs": [], "source": [ "R = np.array([0,1])" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The surjective mapping $a: R \\rightarrow \\mathcal{X}_{\\mathcal{M'}}$ is then given by an identity matrix, mapping variables $0 \\mapsto 0$ and $1 \\mapsto 1$. " ] }, { "cell_type": "code", "execution_count": 66, "metadata": {}, "outputs": [], "source": [ "a = np.eye(2)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Overall, this is a *variable-level mapping* that is **complete** and **isomorphic**." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Domain-level mapping\n", "\n", "The domain-level mapping $\\alpha_{X'}: \\mathcal{M}[a^{-1}(X')] \\rightarrow \\mathcal{M'}[X']$ is simply a collection of identity matrices." ] }, { "cell_type": "code", "execution_count": 67, "metadata": {}, "outputs": [], "source": [ "alphas = {'0': np.eye(2),\n", " '1': np.eye(2)}" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Overall the *domain-level mapping* that is **isomorphic**." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Abstraction\n", "\n", "Finally, we put everything together to define our abstraction." ] }, { "cell_type": "code", "execution_count": 68, "metadata": {}, "outputs": [], "source": [ "A = Abstraction(M0,M1,2,R,a,alphas)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can now test properties of the abstraction, as well as plot the variable-level mapping." ] }, { "cell_type": "code", "execution_count": 69, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "R: cardinality of X0: 2\n", "R: cardinality of X1: 2\n" ] } ], "source": [ "A.print_R_cardinalites()" ] }, { "cell_type": "code", "execution_count": 70, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Mapping alpha_X'0: X_0 -> X'_0\n", "Mapping alpha_X'1: X_1 -> X'_1\n" ] } ], "source": [ "A.print_mappings_alphas()" ] }, { "cell_type": "code", "execution_count": 71, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "True" ] }, "execution_count": 71, "metadata": {}, "output_type": "execute_result" } ], "source": [ "A.is_varlevel_complete()" ] }, { "cell_type": "code", "execution_count": 72, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "True" ] }, "execution_count": 72, "metadata": {}, "output_type": "execute_result" } ], "source": [ "A.is_varlevel_isomorphic()" ] }, { "cell_type": "code", "execution_count": 73, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Mapping alpha_X'3: True\n", "Mapping alpha_X'3: True\n" ] } ], "source": [ "A.is_domlevel_isomorphic()" ] }, { "cell_type": "code", "execution_count": 74, "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "A.plot_variable_level_mapping()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The definition of abstraction is legitimate then, although, as clear from the plot, our abstraction ends up distorting the directionality of cause and effect." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Conclusion\n", "\n", "In this notebook we have dived deep in the definition of abstraction proposed in [Rischel2020]. We have split the idea of abstraction in two levels, a *variable-level mapping* and a *domain-level mapping*, and we have discussed properties and implications of each mapping. We have also highlighted some limitations implicit in the definition, which introduced us to the further issue of *consistency among causal models*. Finally, we have provided class implementations for SCMs and abstractions that offer a programmatic way to analyze abstractions between causal models." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Bibliography\n", "\n", "[Rischel2020] Rischel, Eigil Fjeldgren. \"The Category Theory of Causal Models.\" (2020).\n", "\n", "[Pearl2009] Pearl, Judea. Causality. Cambridge university press, 2009.\n", "\n", "[Peters2017] Peters, Jonas, Dominik Janzing, and Bernhard Schölkopf. Elements of causal inference: foundations and learning algorithms. The MIT Press, 2017.\n", "\n", "[Spivak2014] Spivak, David I. Category theory for the sciences. MIT Press, 2014.\n", "\n", "[Fong2018] Fong, Brendan, and David I. Spivak. \"Seven sketches in compositionality: An invitation to applied category theory.\" arXiv preprint arXiv:1803.05316 (2018)." ] } ], "metadata": { "kernelspec": { "display_name": "Python 3 (ipykernel)", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.9.10" }, "toc": { "base_numbering": 1, "nav_menu": {}, "number_sections": true, "sideBar": true, "skip_h1_title": false, "title_cell": "Table of Contents", "title_sidebar": "Contents", "toc_cell": false, "toc_position": { "height": "calc(100% - 180px)", "left": "10px", "top": "150px", "width": "219.429px" }, "toc_section_display": true, "toc_window_display": true } }, "nbformat": 4, "nbformat_minor": 4 }