Learn R Programming

ExpBites: Analyze Human Exposure to Mosquito Bites

Overview

ExpBites is an R package to compute mosquito biting exposure based on hourly human and mosquito behavior. It is designed for entomological modeling and malaria vector control analysis, particularly in the context of insecticide-treated net (ITN) usage.

Features

  • Simulate individual human behavior (outdoors, indoors awake, asleep, under bed net) over 24-hour cycles (for test purpose).
  • Simulate mosquito biting activity indoors and outdoors (for test purpose).
  • Estimate exposure to mosquito bites for bednet users and non-users.
  • Calculate proportions of exposure prevented by nets.
  • Calculate proportions of exposure indoors or during specified time intervals.
  • Visualize exposure and behavior patterns over time.

Installation

You can install the development version of ExpBites from GitHub:

# install.packages("devtools")
devtools::install_github("Nmoiroux/ExpBites")

Make sure you have the required dependencies:

install.packages(c("dplyr", "tidyr", "ggplot2", "Rdpack")) 

Example

library(ExpBites) 

# Generate simulated human and mosquito data (for test purpose)
df <- gen_df_human(n_individuals = 100) 
df_bites <- gen_df_mosquito() 

# Calculate hourly exposure to mosquito bites 
exp_result <- calculate_Exp(df, df_bites) 

# Summarize exposure for entire day and a specific time window (e.g., 22h to 5h) 
summary_tbl <- summarise_exposure(exp_result, interval = c(22, 5))

print(summary_tbl) 

# Plot exposure patterns 
plot_exposure(exp_result) 

# Plot mosquito and human behavior patterns 
plot_behaviors(exp_result) 

References

This package builds upon and extends the models described in:

  • Killeen et al. (2006). Quantifying behavioural interactions between humans and mosquitoes... BMC Infectious Diseases
  • Geissbühler et al. (2007). Interdependence of domestic malaria prevention measures... Malaria Journal
  • Moiroux et al. (2014). Human exposure to early morning Anopheles biting... PLoS One

License

This package is released under the GPL-3 License.

Copy Link

Version

Install

install.packages('ExpBites')

Version

0.1.3

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Nicolas Moiroux

Last Published

December 1st, 2025

Functions in ExpBites (0.1.3)

gen_df_human

Generate a Simulated Dataset of Human Behavioral States Over 24 Hours
summarise_exposure

Summarize Exposure to Mosquito Bites Over 24h and a Time Interval
ExpBites-package

ExpBites: Analyzing Human Exposure to Mosquito Biting
plot_exposure

Plot Exposure to Mosquito Bites by Hour for Bednet Users
calculate_Exp

Calculate Hourly Mosquito Biting Exposure for Bednet Users and Non-Users
gen_df_mosquito

Generate a Simulated Dataset of Hourly Mosquito Biting Rates
plot_behaviors

Plot Human and Mosquito Behaviors by Hour