Merge pull request #2 from polca/dev_da

Dev da
polca · May 23, 2024 · 7328d9f · 7328d9f
2 parents 7d1ca43 + 7458e6e
commit 7328d9f
Show file tree

Hide file tree

Showing 7 changed files with 3,035 additions and 69 deletions.
diff --git a/example/example.ipynb b/example/example.ipynb
@@ -313,6 +313,7 @@
     "    * `years`: list[int]. Years for which you want to calculate the impacts.\n",
     "    * `multiprocessing`: bool. Multiprocessing may accelerate the process, as it processes each year in parallel.\n",
     "    * `demand_cutoff`: float. Between 0 and 1. Defines a ratio below which demand values are ignored. The default is 0.001.\n",
+    "    * `double_accounting`:list[list[str]]. List of predefined category paths to be adjusted to prevent double counting of activities. Each path indicates the hierarchical categories involved.\n",
     "    * `use_distributions`: bool. Number of iterations to use for Monte Carlo analyses. The default is 0 (i.e., regular analysis)."
    ]
   },
@@ -576,13 +577,91 @@
     "![cobalt projection](figures/fig5.png)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "a2f864f8-c9ef-492b-a8cb-23064abec5b0",
+   "metadata": {},
+   "source": [
+    "### Avoiding double counting"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "925b92d4-82c6-4943-aa80-a7022717f722",
+   "metadata": {},
+   "source": [
+    "When working with IAM/ESM, the focus s in the **total** quantity (e.g., electricity production, transport, etc.) coming from the IAM/ESM output and not on our examination of the supply chain as provided by LCA. To avoid double counting, we need to identify activities modeled by the IAM/ESM and set their inputs to all activities to zero. \n",
+    "\n",
+    "`pathways` allows users to select the categories to be considered in the double-counting adjustment. The predefined categories are illustrated below:"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "45d3389d-ad9c-4224-886c-e3320110faa5",
+   "metadata": {},
+   "source": [
+    "![LCA_system_diagram](figures/categories.png)"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "f1aa7bd6-3ec6-4dda-a05f-cb8aec156e7f",
+   "metadata": {},
+   "source": [
+    "This adjustment can be applied using the argument double_accounting."
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "b926a237-22e3-487c-9203-d83b6fafa41c",
+   "id": "d1c84257-461b-4814-af6b-a0b4d625f81d",
    "metadata": {},
    "outputs": [],
-   "source": []
+   "source": [
+    "p.calculate(\n",
+    "    methods=['EF v3.1 EN15804 - climate change - global warming potential (GWP100)',],\n",
+    "    regions=[\"EU\",],\n",
+    "    scenarios=[\n",
+    "        \"Scenario A\",\n",
+    "        \"Scenario B\",\n",
+    "    ],\n",
+    "    variables=[\n",
+    "        \"technology A\",\n",
+    "    ],\n",
+    "    years=[\n",
+    "        2020,\n",
+    "        2030,\n",
+    "        2040,\n",
+    "        2050\n",
+    "    ],\n",
+    "    use_distributions=500,\n",
+    "    multiprocessing=True\n",
+    "    double_accounting = [[\"Energy\"]]\n",
+    ")"
+   ]
+  },
+  {
+   "attachments": {},
+   "cell_type": "markdown",
+   "id": "fcdc26f9-8964-4beb-a4a6-7e01bc10e2eb",
+   "metadata": {},
+   "source": [
+    "Some examples would be:\n",
+    "\n",
+    "- If we are interested in zeroing \"Electricity, industrial\"\n",
+    "\n",
+    "  `double_accounting = [[\"Energy\", \"Electricity\", \"Industrial\"]]`\n",
+    "\n",
+    "- To zero \"Electricity, industrial\", \"Electricity, residential\" and \"Freight\"\n",
+    "\n",
+    "  `double_accounting = [[\"Energy\", \"Electricity\"], [\"Transport\", \"Freight\"]]`\n",
+    "\n",
+    "- To adjust for energy (both heat and electricity)\n",
+    "\n",
+    "  `double_accounting = [[\"Energy\"]]`"
+   ]
   }
  ],
  "metadata": {