{"id":17358615,"url":"https://github.com/babak2/outbreak_analyser","last_synced_at":"2026-05-03T04:40:04.434Z","repository":{"id":216715949,"uuid":"742123241","full_name":"babak2/outbreak_analyser","owner":"babak2","description":null,"archived":false,"fork":false,"pushed_at":"2024-01-28T21:55:10.000Z","size":262,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-01T19:45:07.390Z","etag":null,"topics":["infectious-disease-models","matplotlib","numpy","outbreak-data-analysis","outbreak-detection","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/babak2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-11T20:06:25.000Z","updated_at":"2025-01-16T00:18:41.000Z","dependencies_parsed_at":"2024-12-06T11:41:32.966Z","dependency_job_id":"78697db1-8a00-47c5-93e3-bca1b1577082","html_url":"https://github.com/babak2/outbreak_analyser","commit_stats":null,"previous_names":["babak2/outbreak_analyser"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/babak2%2Foutbreak_analyser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/babak2%2Foutbreak_analyser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/babak2%2Foutbreak_analyser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/babak2%2Foutbreak_analyser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/babak2","download_url":"https://codeload.github.com/babak2/outbreak_analyser/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245878924,"owners_count":20687297,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["infectious-disease-models","matplotlib","numpy","outbreak-data-analysis","outbreak-detection","python3"],"created_at":"2024-10-15T19:06:11.598Z","updated_at":"2026-05-03T04:40:04.337Z","avatar_url":"https://github.com/babak2.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Outbreak Analyser\n\nThis project provides an investigation tool for analysing the outbreak of infectious diseases based on reported cases and a gridded representation of the population.\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Features](#features)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n- [Usage](#usage)\n- [Model Output](#model-output) \n- [Plot](#plot)\n- [Future Extensions](#future-extensions)\n- [License](#license)\n- [Author](#Author)\n\n## Introduction\n\nThe Outbreak Analyser is a Python-based tool designed to study the dynamics of an infectious disease outbreak within a population. Using reported cases and population data, the tool determines the outbreak centre, calculates affected populations, and visualizes the population distribution.\n\n### Problem to Solve\n\nIn the context of infectious diseases, understanding the spatial and population dynamics of an outbreak is crucial for effective public health planning. This tool addresses key questions such as:\n\n1. **Outbreak Center:** Where is the outbreak's centre, and what is the impact on the surrounding population?\n\n2. **Affected Population:** What percentage of the population is affected by the outbreak?\n\n3. **Population Visualization:** How can we visualize the population distribution and the outbreak centre?\n\n### Features\n\n- Analysis of infectious disease outbreaks based on reported case locations and population distribution.\n- Determination of the outbreak centre.\n- Calculation of affected population and percentage.\n- Visualization of the population distribution with the outbreak centre.\n\n\n## Getting Started\n\nTo get started with the Outbreak Analyser, follow these steps:\n\n### Prerequisites\n\nBefore running the model, make sure you have the following installed:\n\n- [Python](https://www.python.org/) (\u003e=3.6)\n- [NumPy](https://numpy.org/)\n- [Matplotlib](https://matplotlib.org/)\n\n### Installation\n\n1. Clone the repository:\n\n   ```bash\n   git clone https://github.com/babak2/outbreak_analyser.git\n\nNavigate to the project directory:\n\n`cd outbreak_analyser`\n\n## Usage\n\nIf Python 3 is the only Python version installed on your machine, you can use the Python command. For example:\n\n```python outbreak_analyser.py ```\n\nIf both Python 2 and 3 are installed, it's important to specify Python 3 using the python3 command. For example:\n\n\n```python3 outbreak_analyser.py ```\n\n\n## Model Output\n\nAfter running the outbreak_analyser, you can expect to see the following output in the console:\n\n\u003cimg src=\"./images/console-output.png\" alt=\"model console output\" width=\"400\"/\u003e\n\n\nThese values provide information about the outbreak, including the geographical centre, total population, affected population, and the percentage of the population affected. \n\nThis information is important for understanding the impact and scope of the simulated outbreak.\n\n\n## Plot\n\nThe plot of the result will be saved in the output directory (default name is outbreak_plot.png). \n![model visualization](./images/outbreak_plot.png)\n\n## Future Extensions\n\n- **Customizable Output Formats:** Provide options to export model results in various formats for further analysis and reporting.\n- **Interactive Visualization:** Create interactive visualization to explore better the dynamics of the outbreak.\n- **Geographical Visualization:** Enhance visualization capabilities to include geographical maps with overlays of disease spread, population density, and other relevant information. \n- **GIS Integration:** Integrate with Geographic Information System (GIS) data to obtain real-world geographical features such as roads, population density, and healthcare facilities.\n- **Intervention Strategies:** Implement intervention strategies, such as vaccination campaigns, social distancing, or lockdowns, and analyze their impact on the spread of the disease.\n- ...\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n\n## Author \n\nBabak Mahdavi Ardestani\n\nbabak.m.ardestani@gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbabak2%2Foutbreak_analyser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbabak2%2Foutbreak_analyser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbabak2%2Foutbreak_analyser/lists"}