From 3cc2a0c2a79814b69aae421da88581888a956271 Mon Sep 17 00:00:00 2001 From: Margherita Molaro <48129834+marghe-molaro@users.noreply.github.com> Date: Wed, 28 Feb 2024 17:21:23 +0000 Subject: [PATCH 1/4] Minor change to clarify meaning of parameter (#1285) --- src/tlo/methods/healthsystem.py | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/tlo/methods/healthsystem.py b/src/tlo/methods/healthsystem.py index 470242262c..6838f56705 100644 --- a/src/tlo/methods/healthsystem.py +++ b/src/tlo/methods/healthsystem.py @@ -531,7 +531,7 @@ class HealthSystem(Module): ' to the module initialiser.'), 'policy_name': Parameter( - Types.STRING, "Name of priority policy assumed to have been adopted until policy switch"), + Types.STRING, "Name of priority policy adopted"), 'year_mode_switch': Parameter( Types.INT, "Year in which mode switch in enforced"), @@ -625,7 +625,7 @@ def __init__( and priority :param ignore_priority: If ``True`` do not use the priority information in HSI event to schedule - :param policy_name: Name of priority policy that will be adopted if any + :param policy_name: Name of priority policy adopted :param capabilities_coefficient: Multiplier for the capabilities of health officers, if ``None`` set to ratio of initial population to estimated 2010 population. From d7538a3078e5fe2c926f5343fc55968c7484b2f0 Mon Sep 17 00:00:00 2001 From: Matt Graham Date: Wed, 6 Mar 2024 09:10:59 +0000 Subject: [PATCH 2/4] Change write-up link for Contraception module to article (#1276) * Change write-up link for Contraception module to article * keep link to original documentation --------- Co-authored-by: Tim Hallett <39991060+tbhallett@users.noreply.github.com> --- docs/writeups.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/writeups.rst b/docs/writeups.rst index 422c80fcd4..ba7b3bb1c6 100644 --- a/docs/writeups.rst +++ b/docs/writeups.rst @@ -35,7 +35,7 @@ Representation of the Healthcare System Contraception, Maternal and Newborn Health =================================== -* **Contraception**: Determines fecundity, the usage of contraception (including switching between contraceptives) and the onset of pregnancy. :download:`.docx <./write-ups/Contraception.docx>` +* **Contraception**: Determines fecundity, the usage of contraception (including switching between contraceptives) and the onset of pregnancy. :download:`.docx <./write-ups/Contraception.docx>` `Journal article (Studies in Family Planning) ` * **Maternal and Newborn Health** Represents the antenatal period of pregnancy (the period from conception to the termination of pregnancy), labour, birth, the postnatal period, associated complications and healthcare delivered through routine and emergency maternity services. :download:`.pdf <./write-ups/MaternalNewbornHealth.pdf>` From b958728b3832fbb7195b3cf1b62e3084e777a660 Mon Sep 17 00:00:00 2001 From: Tim Hallett <39991060+tbhallett@users.noreply.github.com> Date: Wed, 6 Mar 2024 02:11:11 -0700 Subject: [PATCH 3/4] Add Individual-based modelling course to website (#1282) --- docs/ibm_course.rst | 81 +++++++++++++++++++++++++++ docs/index.rst | 2 +- docs/{background.rst => learning.rst} | 7 ++- 3 files changed, 88 insertions(+), 2 deletions(-) create mode 100644 docs/ibm_course.rst rename docs/{background.rst => learning.rst} (95%) diff --git a/docs/ibm_course.rst b/docs/ibm_course.rst new file mode 100644 index 0000000000..067d8a5035 --- /dev/null +++ b/docs/ibm_course.rst @@ -0,0 +1,81 @@ +.. _ibm_course: + +=========================================== +Building and Understanding Individual Based Models to Inform Health Policy +=========================================== + +Welcome to this tutorial to help you self-learn how to build individual-based models to inform health policy. This is intended to be an accessible introduction which requires no existing knowledge. + +What is an Individual-based Model? +==================================== + +Each time the model program is run it generates values of variables that represent the characteristics of individuals and simulates how these change over time. By building a model that accurately reflects real changes in people over time, we can evaluate the potential effects of a policy of introducing a health intervention. + +`Here `_ is a video describing individual-based models to inform health care policy: + +(You don’t need to have watched this video to get started on the tutorial!) + +Get started +==================================== +We will use a programming language called Python. We will use Google Colaboratory (“Colab”) which is a website which makes it easy to get started. + +The links to click for all the content are below. + +You may want to watch `this very brief video `_ that shows you what to expect when you click on the first link. + + +Building an individual-based model +==================================== + +* Part 1: Introduction to Colab, time steps, variables, print function, range function, "for" loops. [`Start `_] + +* Part 2: Python dictionaries, accessing and updating dictionaries [`Start `_] + +* Part 3: Time step loop, population loop, combining loops and using dictionaries [`Start `_] + +* Part 4: Generating random numbers/ages, round function, "if" statements, updating variable values, the first time step, all other time steps [`Start `_] + +* Part 5: Random choice method, pandas and using tables, using probabilities, "else" statements [`Start `_] + +* Part 6: Adding body mass index (BMI), "elif" statements, creating and calling a function, docstrings [`Start `_] + +* Part 7: Refactoring updating rules into functions [`Start `_] + +* Part 8: Visualizing changes in variable distribution over time, matplotlib and pyplot, values method [`Start `_] + +* Part 9: Adding blood pressure, ordering and data selection, append method [`Start `_] + +* Part 10: Adding mortality, age-specific death rate, booleans, integrating deaths into the model [`Start `_] + +* Part 11: CVD death risk, the math.exp method, adding cause of death, "None" keyword [`Start `_] + +* Part 12: Life years (person-years at risk), CVD death rate, simulating health policy intervention [`Start `_] + +* Part 13: Adding time of death, running model with intervention, comparing results between groups [`Start `_] + + +Building a transmission model +==================================== +* Part 14: Introduction and breakdown of new model structure [`Start `_] + +* Part 15: Exercise: Adding vaccination variable to the new model [`Start `_] + +* Part 16: Adding interactions to the model, the random sample method [`Start `_] + +* Part 17: Adding infection variables to the model (Section 1) [`Start `_] + +* Part 18: Adding infection variables to the model (Section 2) [`Start `_] + +* Part 19: Finalizing our basic transmission model [`Start `_] + + + +Acknowledgments +==================================== +This content was created by George Phillips, `Loveleen Bansi-Matharu `_ and `Andrew Phillips `_. + +Suggested Citation +==================================== +Phillips G, Bansi-Matharu, Phillips AN. (2024) Building and Understanding Individual Based Models to Inform Health Policy. Available on www.tlomodel.org + + diff --git a/docs/index.rst b/docs/index.rst index 2bb1927f52..c45cef72b7 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -45,7 +45,7 @@ Contents azure_batch reference/index resources/index - background + learning publications contributors contributing diff --git a/docs/background.rst b/docs/learning.rst similarity index 95% rename from docs/background.rst rename to docs/learning.rst index 151bfebfd2..147c664798 100644 --- a/docs/background.rst +++ b/docs/learning.rst @@ -1,10 +1,15 @@ ================= -Background +Learning Resources ================= We provide here resources that provide a background to the type of modelling and health-economics work we are undertaken. + +Online Course in Individual-Based Modelling +=========================================== +:ref:`ibm_course` + Health-Economics ================ From 25dce3d1345cfd15512d55b706e7fc78f5f5b244 Mon Sep 17 00:00:00 2001 From: Tim Hallett <39991060+tbhallett@users.noreply.github.com> Date: Wed, 6 Mar 2024 02:11:30 -0700 Subject: [PATCH 4/4] Add link to latest release to tlomodel.org homepage (#1291) --- docs/index.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/index.rst b/docs/index.rst index c45cef72b7..18362b728c 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -21,6 +21,13 @@ It is developed in a collaboration between: It benefits from a close partnership between this team and the Ministry of Health, Malawi. +Latest Release +============== +The latest release of our code is available `here `_ and citable as: + +**The Thanzi La Onse Model. v0.1, Zenodo, 16 Nov. 2023, doi:10.5281/zenodo.10144016.** + + Open Source Code Repository ================= Our code base is open source and available for review and usage at ``_