feat(init_cond): fixed typos

Author: TomMonks

content/14_initial_conditions.ipynb

@@ -5,20 +5,36 @@
    "id": "0be7dabf-cb34-4faf-abb1-e2c8e735beda",
    "metadata": {},
    "source": [
-    "# Setting initial conditions\n",
+    "# Setting Initial Conditions\n",
     "\n",
+    "An alternative to including a warm-up period in a model is to set initial conditions.  In our stroke example this would mean adding patients to beds and if required the admission queue.  \n",
     "\n",
-    "**IMPORTANT: There is still an initialisation bias problem:**\n",
+    "🎓 **Why use Initial-Conditions over a Warm-Up?**\n",
+    "\n",
+    "* While warm-up periods are simpler to code, they can also increase how long it takes to run your model.  Setting initial conditions is in theory computationally more efficient (no wasted run-time).\n",
+    "\n",
+    "* Setting initial-conditions also allows you to test specific starting scenarios, such as \"What happens if the day begins with a full ward?\"\n",
+    "\n",
+    "**In general, adding initial conditions is more complex than including a warm-up period.**\n",
+    "\n",
+    "Initial conditions could be \n",
+    "\n",
+    "1. Fixed i.e. the same number of patients for each replication.\n",
+    "2. Random i.e. sampled from a discrete distribution specified by a user.\n",
+    "\n",
+    "In this notebook we will learn how to add initial conditions to a SimPy model.  We will again use the acute stroke pathway model.\n",
+    "\n",
+    "## IMPORTANT: There is still an initialisation bias problem\n",
     "\n",
     "* We load patients into the model before we begin the run. \n",
     "* If there are $n$ acute stroke beds then the first $n$ patients loaded into the queue will begin service immediately and have a zero queuing time.\n",
     "* This applies if we have one queue in the model or if we have multiple queues and activities: the time in system metrics will be biased for initial condition patients.\n",
     "* This is the same problem faced when starting the model from time zero with no patients.\n",
     "\n",
     "**Some Options:**\n",
-    "* Include a setting in a process to switch results collection on and off.\n",
-    "* Code a seperate process for initial conditions that does not include results collection.\n",
-    "* Mixed initial conditions and (a shorter) warm-up period.\n",
+    "1. Include a setting in a process to switch results collection on and off.\n",
+    "2. Code a seperate process for initial conditions that does not include results collection.\n",
+    "3. Mixed initial conditions and (a shorter) warm-up period.\n",
     "    * You will need to do some analysis to ensure this is working acceptably.\n",
     "    * The warm-up pushes patients into service and also resets results collection. (deletes an initial transient)."
    ]
@@ -83,7 +99,7 @@
     "\n",
     "# Acute LoS (Lognormal)\n",
     "ACUTE_LOS_MEAN = 7.0\n",
-    "ACUTE_LOC_STD = 1.0\n",
+    "ACUTE_LOS_STD = 1.0\n",
     "\n",
     "# initial conditions for acute queue + service \n",
     "# if there are 9 beds then 10 = 1 queuing\n",
@@ -129,7 +145,7 @@
    "source": [
     "def trace(msg):\n",
     "    \"\"\"\n",
-    "    Turing printing of events on and off.\n",
+    "    Turning printing of events on and off.\n",
     "\n",
     "    Params:\n",
     "    -------\n",
@@ -166,7 +182,7 @@
     "        n_streams=N_STREAMS,\n",
     "        iat_strokes=IAT_STROKES,\n",
     "        acute_los_mean=ACUTE_LOS_MEAN,\n",
-    "        acute_los_std=ACUTE_LOC_STD,\n",
+    "        acute_los_std=ACUTE_LOS_STD,\n",
     "        n_acute_beds=N_ACUTE_BEDS,\n",
     "        init_cond_params=INIT_COND_PARAMS,  \n",
     "    ):\n",
@@ -273,7 +289,7 @@
     "    Parameters:\n",
     "    ----------\n",
     "    warm_up_period: float\n",
-    "        Duration of warm-up period in simultion time units\n",
+    "        Duration of warm-up period in simulation time units\n",
     "\n",
     "    env: simpy.Environment\n",
     "        The simpy environment\n",
@@ -296,7 +312,7 @@
     "\n",
     "The key things to recognise are \n",
     "\n",
-    "* We include a optional parameter called `collection_results` that defaults to `True`. We may set this `False` in our functions that setup initial conditions"
+    "* We include a optional parameter called `collect_results` that defaults to `True`. We may set this `False` in our functions that setup initial conditions"
    ]
   },
   {
@@ -402,8 +418,8 @@
     "    \"\"\"Set up initial conditions with patients already in the acute\n",
     "    stroke queue\n",
     "\n",
-    "    Parmaters:\n",
-    "    ---------\n",
+    "    Parameters:\n",
+    "    -----------\n",
     "    env: simpy.Environment\n",
     "       The simpy environment for the simulation\n",
     "\n",