Anthill: A harvester ant colony built from the published science (1.0.0)
An agent-based model of one colony of the Florida harvester ant, Pogonomyrmex badius, from the day a mated queen lands to the death of the colony. It runs in a web browser and, unchanged, headless in Node for replicate studies.
What the ants do: a claustral queen digs her own shaft and raises the first workers on her reserves; workers dig the nest under local rules, with no ant holding a plan; a one-way, age-based division of labour set by the season of birth, which no shortage reverses; trunk-trail foraging with site fidelity and recruitment; seed storage, opening and germination in the chambers, which is what feeds the larvae; daily weather from the climate normals of the study site, with drought years; nuptial flights after heavy rain; corpse removal; alarm at a disturbance on the foraging ground; and annual nest relocation, in which the store and then the brood are carried along the trail to a new nest the colony digs.
Every value in the model is tagged as measured in this species, borrowed from another ant, or invented, with its source, in a single parameter file. The model is deterministic: one seeded stream per system and a fixed one-minute timestep, so a seed reproduces a run bit for bit in the browser and in Node, which a test pins. A study writes a methods report listing the invented values the results rest on and the acceptance tests the model fails.
Known limits, stated in full in the repository: colonies that pass 700 workers fall back the following year, where real colonies hold about 4300; foraging peaks in July where the field maximum is May to June; the alarm scent is shorter-lived and shorter-ranged than one step of the model.
The biology comes from three decades of field work by Walter R. Tschinkel and Christina L. Kwapich in the Apalachicola National Forest, north Florida. Cite them, not this software, for any claim about the ants.
Release Notes
Version 1.0.0, the final version. The colony digs its nest, forages on trunk trails, stores and germinates seeds, weathers drought years, sends out mating flights, carries out its dead, raises the alarm at a disturbance on the ground, and moves house along a trail, carrying the seed store and then the brood.
Every value carries its source and its tag: measured in this species, borrowed from another ant, or invented. Known limits are listed in VALIDATION.md and repeated in the report each study writes. The main one: colonies that pass 700 workers fall back the following year, where real colonies hold about 4300.
Runs in a browser at https://adiezc.github.io/ANThill-Sim/ and headless in Node for replicate studies.
Associated Publications
Anthill: A harvester ant colony built from the published science 1.0.0
An agent-based model of one colony of the Florida harvester ant, Pogonomyrmex badius, from the day a mated queen lands to the death of the colony. It runs in a web browser and, unchanged, headless in Node for replicate studies.
What the ants do: a claustral queen digs her own shaft and raises the first workers on her reserves; workers dig the nest under local rules, with no ant holding a plan; a one-way, age-based division of labour set by the season of birth, which no shortage reverses; trunk-trail foraging with site fidelity and recruitment; seed storage, opening and germination in the chambers, which is what feeds the larvae; daily weather from the climate normals of the study site, with drought years; nuptial flights after heavy rain; corpse removal; alarm at a disturbance on the foraging ground; and annual nest relocation, in which the store and then the brood are carried along the trail to a new nest the colony digs.
Every value in the model is tagged as measured in this species, borrowed from another ant, or invented, with its source, in a single parameter file. The model is deterministic: one seeded stream per system and a fixed one-minute timestep, so a seed reproduces a run bit for bit in the browser and in Node, which a test pins. A study writes a methods report listing the invented values the results rest on and the acceptance tests the model fails.
Known limits, stated in full in the repository: colonies that pass 700 workers fall back the following year, where real colonies hold about 4300; foraging peaks in July where the field maximum is May to June; the alarm scent is shorter-lived and shorter-ranged than one step of the model.
The biology comes from three decades of field work by Walter R. Tschinkel and Christina L. Kwapich in the Apalachicola National Forest, north Florida. Cite them, not this software, for any claim about the ants.
Release Notes
Version 1.0.0, the final version. The colony digs its nest, forages on trunk trails, stores and germinates seeds, weathers drought years, sends out mating flights, carries out its dead, raises the alarm at a disturbance on the ground, and moves house along a trail, carrying the seed store and then the brood.
Every value carries its source and its tag: measured in this species, borrowed from another ant, or invented. Known limits are listed in VALIDATION.md and repeated in the report each study writes. The main one: colonies that pass 700 workers fall back the following year, where real colonies hold about 4300.
Runs in a browser at https://adiezc.github.io/ANThill-Sim/ and headless in Node for replicate studies.