Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -32,4 +32,7 @@ env.bak/
venv.bak/

# Local simulations
Suite_*/
LOCAL_EXP_PATH.txt
docker_suites/
local_python/container_assets/Eradication
local_python/container_assets/schema.json
31 changes: 9 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# EMOD-Generic-Scripts

See documentation at https://emod-hub.github.io/EMOD-Generic-Scripts/ for additional information.
See documentation at https://emod.idmod.org/EMOD-Generic-Scripts for additional information.


## Contents:
Expand All @@ -9,19 +9,17 @@ See documentation at https://emod-hub.github.io/EMOD-Generic-Scripts/ for additi
| --- | --- |
| env_Alma10 <br /> env_Amazon2023 <br /> env_Debian13 <br /> env_Fedora42 <br /> env_Rocky10 <br /> env_Ubuntu26 | Definition files for Apptainer containers with various operating systems. Produces the the EMOD executable and schema file; creates an environment for running EMOD on COMPS with the python packages available to the embedded python interpreter. All files remain on COMPS and are provided to the various workflows as Asset Collection IDs. |
| local_python | Contains additional python scripts with helper functions common to all of the workflows. |
| model_covariance01 | [Demonstration simulations for heterogeneity in individual behavior.](https://docs.idmod.org/projects/emod-generic-scripts/en/latest/examples/model_covariance01.html) |
| model_covid01 | Baseline simulations for SARS-CoV-2 in EMOD. Collab with MvG. |
| model_covariance01 | [Demonstration simulations for heterogeneity in individual behavior.](https://emod.idmod.org/EMOD-Generic-Scripts/examples/model_covariance01/) |
| model_covid01 | Baseline simulations for SARS-CoV-2 in EMOD. |
| model_demographics01 | Example demographics for UK measles simulations. |
| model_demographics_wpp01 | [Example demographics using UN WPP data as inputs.](https://docs.idmod.org/projects/emod-generic-scripts/en/latest/examples/model_demographics_wpp01.html) |
| model_demographics_wpp01 | [Example demographics using UN WPP data as inputs.](https://emod.idmod.org/EMOD-Generic-Scripts/examples/model_demographics_wpp01/) |
| model_measles | [Estimates of measles burden under various policies for age of MCV1.](https://emod.idmod.org/EMOD-Generic-Scripts/examples/model_measles/) |
| model_measles_cod01 | Documentation. |
| model_measles_gha01 | [Examination of RDT use and measles outbreak response using Ghana as an example context.](https://docs.idmod.org/projects/emod-generic-scripts/en/latest/examples/model_measles_gha01.html) |
| model_measles_nga01 | Documentation. |
| model_measles_nga02 | Documentation. |
| model_measles01 | [Estimates of measles burden under various policies for age of MCV1.](https://docs.idmod.org/projects/emod-generic-scripts/en/latest/examples/model_measles01.html) |
| model_network01 | [Demonstration simulations for transmission of infectivity on a network.](https://docs.idmod.org/projects/emod-generic-scripts/en/latest/examples/model_network01.html) |
| model_measles_gha01 | [Examination of RDT use and measles outbreak response using Ghana as an example context.](https://emod.idmod.org/EMOD-Generic-Scripts/examples/model_measles_gha01/) |
| model_network01 | [Demonstration simulations for transmission of infectivity on a network.](https://emod.idmod.org/EMOD-Generic-Scripts/examples/model_network01/) |
| model_polio_nga01 | [Example outbreak simulations for cVDPV2 in Nigeria.](https://docs.idmod.org/projects/emod-generic-scripts/en/latest/examples/model_polio_nga01.html) |
| model_rubella01 | [Projections of rubella infections and estimates of CRS burden following RCV introduction.](https://docs.idmod.org/projects/emod-generic-scripts/en/latest/examples/model_rubella01.html) |
| model_transtree01 | [Demonstration of the infector labeling feature and generation of explicit transmission networks.](https://docs.idmod.org/projects/emod-generic-scripts/en/latest/examples/model_transtree01.html) |
| model_rubella01 | [Projections of rubella infections and estimates of CRS burden following RCV introduction.](https://emod.idmod.org/EMOD-Generic-Scripts/examples/model_rubella01/) |
| model_transtree01 | [Demonstration of the infector labeling feature and generation of explicit transmission networks.](https://emod.idmod.org/EMOD-Generic-Scripts/examples/model_transtree01/) |
| refdat_mcv1 | IHME MCV1 coverage estimates used to construct input files for EMOD simulations. |
| refdat_namesets | Namesets used for region identification. |
| refdat_poppyr | UN WPP age structured population estimates used to construct input files for EMOD simulations. |
Expand Down Expand Up @@ -69,17 +67,6 @@ To build the documentation locally, do the following:
---------------------


## Disclaimer

The code in this repository was developed by IDM and other collaborators to support our
joint research on flexible agent-based modeling. We've made it publicly available under
the MIT License to provide others with a better understanding of our research and an
opportunity to build upon it for their own work. We make no representations that the code
works as intended or that we will provide support, address issues that are found, or accept
pull requests. You are welcome to create your own fork and modify the code to suit your own
modeling needs as permitted under the MIT License.


## Project status

EMOD-Hub projects are provided as open source software under the MIT License for
Expand Down
16 changes: 0 additions & 16 deletions docker/emod_env/Dockerfile

This file was deleted.

31 changes: 0 additions & 31 deletions docker/emod_exe/Dockerfile

This file was deleted.

10 changes: 5 additions & 5 deletions docker/emodpy/Dockerfile
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
FROM ubuntu:24.04
FROM ubuntu:26.04
#
RUN apt-get update
RUN apt-get -y upgrade
#
RUN apt-get -y install python3
RUN apt-get -y install python3-pip
RUN apt-get -y install python3-venv
RUN apt-get install -y python3
RUN apt-get install -y python3-pip
RUN apt-get install -y python3-venv
#
RUN apt-get clean
#
Expand All @@ -14,4 +14,4 @@ RUN python3 -m venv $PY_VENV
ENV PATH="$PY_VENV/bin:$PATH"
#
RUN pip3 install pip --upgrade
RUN pip3 install emodpy~=3.1
RUN pip3 install emodpy~=3.2
15 changes: 6 additions & 9 deletions docs/bib.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,7 @@
[emod-api]: https://emod-hub.github.io/emod-api/
[emod-generic]: https://emod-hub.github.io/EMOD-Generic/
[emodpy]: https://emod-hub.github.io/emodpy/
[emodpy-hiv]: https://emod-hub.github.io/emodpy-hiv/
[emodpy-malaria]: https://emod-hub.github.io/emodpy-malaria/
[emod-api]: https://emod.idmod.org/emod-api/
[emod-generic]: https://emod.idmod.org/EMOD-Generic/
[emodpy]: https://emod.idmod.org/emodpy/
[emodpy-hiv]: https://emod.idmod.org/emodpy-hiv/
[emodpy-malaria]: https://emod.idmod.org/emodpy-malaria/
[idmod]: https://www.idmod.org/
[idmtools]: https://docs.idmod.org/projects/idmtools/
[idmtools_cli]: https://docs.idmod.org/projects/idmtools/en/latest/cli/cli_index.html
[idmtools_config]: https://docs.idmod.org/projects/idmtools/en/latest/configuration.html
[idm_pypi]: https://packages.idmod.org/
[idmtools]: https://docs.idmod.org/idmtools/
Binary file modified docs/examples/figures/ref_gha_obr_contours.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/examples/figures/ref_gha_timeseries.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes.
4 changes: 2 additions & 2 deletions docs/examples/model_measles_gha01.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ Measles infectivity moved between nodes based on a gravity-type network model. A

Each agent represented 25 individuals. Prevalence could fall to zero during the simulation, but exogeneous importation ensured long-term elimination did not occur. Importation probability was proportional to population. Simulations started in 2008. Outputs prior to 2011 were ignored because initial measles immunity is only roughly approximate and a few years of simulated time are required to establish internal consistency. Each simulation time step represents 5 days.

Parameters in the baseline model were adjusted to fit observed timeseries of measles incidence. A Poisson-based likelihood function was maximized over one free parameter that scales total incidence and was interpreted as a reporting rate.
Parameters in the baseline model were adjusted to fit observed timeseries of measles incidence. A Poisson-based likelihood function was maximized over two free parameters that scale total incidence; this scaling was interpreted as a reporting rate.

![Figure 3: Baseline timeseries and reporting rate](figures/ref_gha_timeseries.png)

Posterior estimates suggest around 4% of measles infections are captured in case reports.
Posterior estimates suggest around 2% of measles infections are captured in case reports, and a modest annual improvement to the reporting rate.

Test scenarios implemented hypothetical regional outbreak response SIAs starting in 2022. These responses were triggered based on varying thresholds of observed cases. Spatially heterogeneous reporting rates were assumed with a mean reporting rate of 4%

Expand Down
1 change: 0 additions & 1 deletion docs/examples/model_measles_nga01.md

This file was deleted.

1 change: 0 additions & 1 deletion docs/examples/model_measles_nga02.md

This file was deleted.

3 changes: 3 additions & 0 deletions local_python/container_assets/Dockerfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
FROM ghcr.io/emod-hub/emod-ubuntu-runtime:latest
#
RUN pip3 install emod-api~=3.1
Binary file removed local_python/container_assets/Eradication
Binary file not shown.
7 changes: 7 additions & 0 deletions local_python/container_assets/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
## Local execution

This directory is the destination for an executable and schema extracted to from the emod-generic Python package.
These files are only used when running locally via Docker Desktop, and require the `local` optional dependencies
to also be installed.

The Dockerfile in this directory is used to add the emod-api package to the default EMOD-Hub runtime environment.
Loading