Skip to content

The BEEHAVE honeybee model, re-implemented with Go and ECS

License

Notifications You must be signed in to change notification settings

mlange-42/beecs

Repository files navigation

beecs

Test status Go Report Card Go Reference GitHub

Work-in-progress re-implementation of the BEEHAVE model in Go using the Arche Entity Component System (ECS).

All the hard work to develop, parameterize and validate the original BEEHAVE model was done by Dr. Matthias Becher and co-workers. I was not involved in that development in any way, and just re-implement the model following its ODD Protocol and the NetLogo code.

Beecs is currently at a state where it implements BEEHAVE's basic colony and foraging models. Colony dynamics already mimic BEEHAVE quite well, but there are still differences that need to be addressed. See the tests.

Usage

Command line app

A command line interface for beecs is provided in beecs-cli. It also supports basic visualizations. See there for details.

Graphical user interface

A graphical user interface for beecs is provided in beecs-ui. It features configurable visualizations and parameter manipulation in a single window or in a web browser.

Library

To add beecs as a dependency to an existing Go project, run this in the project's root folder:

go get github.com/mlange-42/beecs

Usage examples can be found in folder _examples.

Exploring the model

To explore the model code, start with reading files model/default.go and params/default.go. Given that the model is developed with ECS, the structure should be quite obvious.

  • comp contains all components.
  • sys contains all systems.
  • params contains model parameters (as ECS resources).
  • globals contains global variables (as ECS resources).

Also check out the examples.