{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Heating Network Example"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In the following a simple heat network with a [pump](https://pandapipes.readthedocs.io/en/latest/components/pump/pump_component.html) and a [heat exchanger](https://pandapipes.readthedocs.io/en/latest/components/heat_exchanger/heat_exchanger_component.html) is presented. In the case of the heat exchanger, the heat flow that is feed into the system from outside must be specified (`qext_w`). For the pump, a characteristic curve must be selected or newly defined. Here `qext_w` is set to 3000 and the pump characteristic curve `\"P1\"` is selected. Additionally, `add_stdtypes` must be set to True. The general aspects to consider when creating a pandapipes heating network can be found in the tutorial [\"Creation of a pandapipes Heating Network\"](https://github.com/e2nIEE/pandapipes/blob/master/tutorials/creating_a_heating_network.ipynb)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "import pandapipes\n",
    "\n",
    "# create empty network\n",
    "net = pandapipes.create_empty_network(\"net\", add_stdtypes=True)\n",
    "\n",
    "# create fluid\n",
    "pandapipes.create_fluid_from_lib(net, \"water\", overwrite=True)\n",
    "\n",
    "# create junctions\n",
    "junction1 = pandapipes.create_junction(net, pn_bar=3, tfluid_k=288.15, name=\"Junction 1\", geodata=(0, 0))\n",
    "junction2 = pandapipes.create_junction(net, pn_bar=3, tfluid_k=288.15, name=\"Junction 2\", geodata=(2, 0))\n",
    "junction3 = pandapipes.create_junction(net, pn_bar=3, tfluid_k=288.15, name=\"Junction 3\", geodata=(2, 2))\n",
    "junction4 = pandapipes.create_junction(net, pn_bar=3, tfluid_k=288.15, name=\"Junction 4\", geodata=(0, 2))\n",
    "\n",
    "pandapipes.create_ext_grid(net, junction=junction1, p_bar=3, t_k=358.15, name=\"External Grid\", type=\"pt\")\n",
    "pandapipes.create_sink(net, junction=junction3, mdot_kg_per_s=1, name=\"Sink\")\n",
    "pandapipes.create_source(net, junction=junction2, mdot_kg_per_s=3, name=\"Source\")\n",
    "\n",
    "# create pipes\n",
    "pandapipes.create_pipe_from_parameters(net, from_junction=junction1, to_junction=junction2, length_km=1,\n",
    "                                       diameter_m=0.07, k_mm=0.03, sections=4, alpha_w_per_m2k=50,\n",
    "                                       text_k=303.15, name=\"Pipe 1\", geodata=[(0, 0), (2, 0)])\n",
    "\n",
    "pandapipes.create_pipe_from_parameters(net, from_junction=junction4, to_junction=junction1, length_km=3,\n",
    "                                       diameter_m=0.05, k_mm=0.02, sections=7, alpha_w_per_m2k=150,\n",
    "                                       text_k=303.15, name=\"Pipe 2\", geodata=[(0, 2), (0, 0)])\n",
    "# create pump\n",
    "pandapipes.create_pump(net, from_junction=junction2, to_junction=junction3, std_type=\"P1\", name=\"Pump\")\n",
    "\n",
    "# create heat exchanger\n",
    "pandapipes.create_heat_exchanger(net, from_junction=junction3, to_junction=junction4, diameter_m=0.05,\n",
    "                                 qext_w=3000, name=\"Heat Exchanger\")\n",
    "\n",
    "# run pipeflow\n",
    "pandapipes.pipeflow(net, stop_condition=\"tol\", iter=100, friction_model=\"nikuradse\",\n",
    "                    mode=\"all\", transient=False, nonlinear_method=\"automatic\", tol_p=1e-4,\n",
    "                    tol_v=1e-4, ambient_temperature=303.15)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<img src=\"pics/heat_network_example.png\">"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The results of the calculations for the heat exchanger and the pump can be called up in the same way as for the junctions and pipes:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "net.res_heat_exchanger\n",
    "net.res_pump"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "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.7.4"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}