Metadata-Version: 2.4
Name: emodpy-malaria
Version: 5.1.3
Summary: IDM's malaria-specific EMOD-API binding code
Author-email: Sharon Chen <sharon.chen@gatesfoundation.org>, Zhaowei Du <zhaowei.du@gatesfoundation.org>, Clark Kirkman IV <clark.kirkmand@gatesfoundation.org>, Daniel Bridenbecker <daniel.bridenbecker@gatesfoundation.org>, Svetlana Titova <svetlana.titova@gatesfoundation.org>, Ye Chen <ye.chen@gatesfoundation.org>
License-Expression: MIT
Project-URL: Repository, https://github.com/EMOD-Hub/emodpy-malaria
Project-URL: Issues, https://github.com/EMOD-Hub/issues-and-discussions/issues
Keywords: modeling,IDM
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: emodpy~=1.16
Requires-Dist: chardet<6.0.0
Requires-Dist: emod-malaria~=2.34.0
Provides-Extra: docs
Requires-Dist: sphinxext.remoteliteralinclude~=0.4; extra == "docs"
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: pydata-sphinx-theme; extra == "docs"
Requires-Dist: plantweb~=1.2; extra == "docs"
Requires-Dist: sphinxcontrib-programoutput~=0.17; extra == "docs"
Requires-Dist: nbsphinx~=0.9; extra == "docs"
Requires-Dist: jupyterlab~=4.0; extra == "docs"
Requires-Dist: myst-parser~=2.0; extra == "docs"
Requires-Dist: readthedocs-sphinx-search~=0.3; extra == "docs"
Requires-Dist: sphinx-copybutton~=0.5; extra == "docs"
Requires-Dist: pygithub~=1.57; extra == "docs"
Requires-Dist: sphinxcontrib-jquery~=4.1; extra == "docs"
Provides-Extra: lint
Requires-Dist: flake8; extra == "lint"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-xdist; extra == "test"
Requires-Dist: pytest-runner; extra == "test"
Requires-Dist: pytest-timeout; extra == "test"
Requires-Dist: pytest-cache; extra == "test"
Requires-Dist: flake8; extra == "test"
Requires-Dist: coverage; extra == "test"
Requires-Dist: py-make; extra == "test"
Requires-Dist: snakemake~=8.30; extra == "test"
Dynamic: license-file

# emodpy-malaria

Python module for use as user-space front-end for doing research easily with EMOD (MALARIA_SIM) via idmtools.

![mosquito](media/jorussell-mosquito.png)

![license](https://img.shields.io/badge/License-MIT-brightgreen.svg)

## Description

This package provides a Python scriptable interface for configuring EMOD for malaria modeling. This Python interface abstracts the process of creating JSON formatted files for parameter specification, demographics specification and intervention specification along as well as abstracting the process of creating binary climate and migration files.

## Getting started

Before installing `emodpy_malaria`, please see the [Getting Started page](getting_started.md).
It can guide you through trying EMOD before you try it on your own machine.

## Get `emodpy-malaria`

The `emodpy-malaria` package (and its supporting packages) is currently hosted on IDM's Python package repository.

```shell
python3 -m pip install emodpy-malaria
```

Note: you may need to only use `python` on Windows machines rather than `python3`.

## Documentation

Documentation available at https://emod-hub.github.io/emodpy-malaria

To build the documentation locally, do the following:

1. Create and activate a venv.
2. Navigate to the root directory of the repo and enter the following:

    ```
    pip install -e[docs] .
    python -m sphinx -T --keep-going -b html ./docs ./site
    ```
The HTML documentation will be output to the 'site' directory.

## FAQ

Frequently asked questions are answered in https://emod-hub.github.io/emodpy-malaria/faq.html

## Community

Have a question or a comment? Check out our [Discussions](https://github.com/EMOD-Hub/issues-and-discussions) space.


## Support and Contributions

The code in this repository was developed by IDM to support our research in disease
transmission and managing epidemics. 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 contemplated under the MIT License.

If you have feature requests, issues, or new code, please see our
[CONTRIBUTING](https://github.com/InstituteforDiseaseModeling/emodpy-malaria/blob/main/CONTRIBUTING.rst) page
for how to provide your feedback.

### Developer Installation
There are several options if you are modifying the code locally.

Option 1:
install in the `emodpy-malaria` directory:
```
pip install -e .
```

Option 2:
You will need to install 'build':
```
pip install build 
```
Each time you make a change you want to use, you'll need to build a new .whl file and install it:
```
python -m build
pip install dist\emodpy_malaria-XXXX.whl
```

# 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.

