{"id":16571344,"url":"https://github.com/aariq/bumbl","last_synced_at":"2026-03-15T22:07:46.868Z","repository":{"id":48050404,"uuid":"200284602","full_name":"Aariq/bumbl","owner":"Aariq","description":"R package for modeling bumblebee colony growth.","archived":false,"fork":false,"pushed_at":"2025-07-29T20:38:35.000Z","size":1709,"stargazers_count":3,"open_issues_count":5,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-29T20:39:11.368Z","etag":null,"topics":["bumblebee","demography","glm","switchpoint"],"latest_commit_sha":null,"homepage":"","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Aariq.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-08-02T19:01:16.000Z","updated_at":"2025-07-29T20:38:39.000Z","dependencies_parsed_at":"2025-08-27T11:01:58.724Z","dependency_job_id":null,"html_url":"https://github.com/Aariq/bumbl","commit_stats":{"total_commits":286,"total_committers":3,"mean_commits":95.33333333333333,"dds":0.006993006993006978,"last_synced_commit":"2d88995985f6927eb601b8c91527517f10a63217"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/Aariq/bumbl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aariq%2Fbumbl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aariq%2Fbumbl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aariq%2Fbumbl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aariq%2Fbumbl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aariq","download_url":"https://codeload.github.com/Aariq/bumbl/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aariq%2Fbumbl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272323745,"owners_count":24914264,"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","status":"online","status_checked_at":"2025-08-27T02:00:09.397Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bumblebee","demography","glm","switchpoint"],"created_at":"2024-10-11T21:22:09.058Z","updated_at":"2025-10-29T03:06:13.470Z","avatar_url":"https://github.com/Aariq.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\",\n  out.width = \"100%\"\n)\n```\n\n# Tools for modeling bumblebee colony growth\n\n\u003c!-- badges: start --\u003e\n\n[![R-CMD-check](https://github.com/Aariq/bumbl/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/Aariq/bumbl/actions/workflows/R-CMD-check.yaml)\n[![Codecov test coverage](https://codecov.io/gh/Aariq/bumbl/graph/badge.svg)](https://app.codecov.io/gh/Aariq/bumbl)\n[![Project Status: Inactive – The project has reached a stable, usable state but is no longer being actively developed; support/maintenance will be provided as time allows.](https://www.repostatus.org/badges/latest/inactive.svg)](https://www.repostatus.org/#inactive)\n[![CRAN status](https://www.r-pkg.org/badges/version/bumbl)](https://CRAN.R-project.org/package=bumbl)\n[![metacran downloads](https://cranlogs.r-pkg.org/badges/grand-total/bumbl)](https://cran.r-project.org/package=bumbl)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4545782.svg)](https://doi.org/10.5281/zenodo.4545782) \n\n\u003c!-- badges: end --\u003e\n\n\n`bumbl` implements a model for bumblebee colony growth described in Crone and Williams 2016^1^.\nIt models colony growth as having a switchpoint at some time, *tau*, where the colony switches from growth and worker production to gyne production and decline.\nCurrently `bumbl()` works by fitting a separate switchpoint model to each colony, optimizing the switchpoint, *tau*.\nIt returns the optimal switchpoint, growth, and decline rates for each colony.\nBecause the current version of `bumbl()` works by fitting a separate GLM to each colony, if covariates are included, their estimates could vary significantly among colonies.\nStay tuned for future developments that may allow estimating a single value of a covariate but different values of growth and decline rates and *tau* for each colony.\n\n## Contributing\n\nI'm looking for collaborators who know (or are willing to let me teach them) how to use git and GitHub and who have an interest in taking over as maintainer of this package.\nI'm not a bumblebee biologist, so I would especially love a collaborator who works on bumblebees or other organisms with a similar growth, switch, decline lifecycle.\n\nI also welcome contributions including bug-fixes, improvement of documentation, additional features, or new functions relating to bumblebee ecology and demography from anyone!\n\n### Roadmap\n\n-   [x] Write `bumbl()` function to model colony growth with switchpoint\n-   [x] Finish documentation and vignette(s)\n-   [x] [rOpenSci review](\u003chttps://github.com/ropenscilabs/statistical-software-review/issues/2\u003e)\n-   [x] Regroup with Elizabeth Crone to discuss current behavior of `bumbl()`\n-   [x] Release v0.1.0 and archive on Zenodo\n-   [x] Bug fixes\n-   [x] Submit v1.0.0 of package to CRAN\n-   [x] Write a manuscript for JOSS ([desk-reject](https://github.com/openjournals/joss-reviews/issues/3532), out of scope)\n-   [x] Release minor version to CRAN to update citation\n-   [ ] Possibly re-work internals of `bumbl()`? (see [\\#58](https://github.com/Aariq/bumbl/issues/58) and [notes](https://github.com/Aariq/bumbl/blob/master/notes/single-model-rework-notes.Rmd))\n-   [ ] Submit v2.0.0 of package to CRAN\n\nOther possible areas of improvement:\n\n-   Extend `bumbl()` to work with GLMMs\n-   Test significance of switchpoint (see [\\#62](https://github.com/Aariq/bumbl/issues/62))\n-   Extend `bumbl()` to work with dates, datetimes, or other timeseries classes (see [\\#46](https://github.com/Aariq/bumbl/issues/46))\n\n## Installation\n\nYou can install `bumbl` with:\n\n``` r\ninstall.packages(\"bumbl\")\n```\n\nOr install the development version with:\n\n``` r\ndevtools::install_github(\"Aariq/bumbl\", build_vignettes = TRUE)\n```\n\n## Getting started\n\nView the package vignette with:\n\n``` r\nlibrary(bumbl)\nvignette(\"bumbl\")\n```\n\n```{r include=FALSE}\n# library(bumbl)\ndevtools::load_all()\n```\n\nView the `bomubs` dataset\n\n```{r}\nhead(bombus)\n```\n\n### Example use\n\nUsing a subset of the `bombus` dataframe to estimate the week (tau) that colonies switch to reproduction\n\n```{r}\nbombus2 \u003c- bombus[bombus$colony %in% c(9, 82, 98, 35), ]\nresults \u003c- bumbl(bombus2, colonyID = colony, t = week, formula = d.mass ~ week)\nresults\n```\n\nPlot the results\n\n```{r}\npar(mfrow = c(2, 2))\nplot(results)\npar(mfrow = c(1, 1))\n```\n\n# References\n\n^1^Crone, E.\nE., and Williams, N. M.\n(2016).\nBumble bee colony dynamics: quantifying the importance of land use and floral resources for colony growth and queen production.\nEcol.\nLett.\n19, 460–468.\n\u003chttps://doi.org/10.1111/ele.12581\u003e\n\n------------------------------------------------------------------------\n\nPlease note that the `bumbl` project is released with a [Contributor Code of Conduct](https://github.com/Aariq/bumbl/blob/master/CODE_OF_CONDUCT.md).\nBy contributing to this project you agree to abide by its terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faariq%2Fbumbl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faariq%2Fbumbl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faariq%2Fbumbl/lists"}