Consumers
Grazers
Grazers are animals that eat algae, bacteria, and other small organisms. They are consumers — they cannot make their own food from light and must eat to survive. All grazers share several common traits: their activity slows when oxygen or salinity falls outside tolerable ranges; they maintain fixed body composition ratios (C:N and N:P) by excreting excess nitrogen as ammonium and excess phosphorus as phosphate; they die of starvation when food intake is insufficient; they suffer toxicity from high ammonia levels; and they respire, consuming oxygen and producing CO₂. Feeding follows Holling Type II functional response kinetics: intake rate increases with food availability but saturates at a maximum. Grazers are less active at night and when oxygen is low. Undigested food is egested as fecal pellets that become detritus.
Sloppy feeding. When a consumer captures and handles prey, some cell contents spill into the water before being ingested — cells rupture, cytoplasm leaks out, fragments break off. About 10% of all egested material dissolves directly into the water as dissolved organic matter (DOM) rather than forming particulate fecal pellets (Moller 2005). Of that dissolved fraction, 95% becomes labile DOM (cytoplasmic contents like amino acids and sugars that bacteria consume rapidly) and 5% becomes refractory DOM (cell-wall fragments and recalcitrant polymers that turn over slowly). This 10% rate applies uniformly to all consumers. Sloppy feeding is ecologically important because it short-circuits the detritus pathway: instead of carbon and nutrients being locked in fecal pellets that must settle and decompose, a fraction goes directly to dissolved organics that bacteria can use immediately. In systems with active grazing, sloppy feeding becomes a significant source of labile DOM that fuels the microbial loop.
Respiratory quotient. When a consumer respires, it consumes O₂ and produces CO₂, but not necessarily in a 1:1 ratio. The respiratory quotient (RQ) is the ratio of CO₂ produced to O₂ consumed, and it depends on the biochemical composition of the substrates being catabolized. Lipid-rich catabolism gives a low RQ (~0.7), carbohydrate catabolism gives RQ = 1.0, and protein catabolism falls in between (~0.8). Most consumers have an RQ of 0.85, reflecting the mixed protein-and-lipid diet typical of crustacean zooplankton. The two protist consumers — ciliates and nanoflagellates — have a slightly higher RQ of 0.90, because protists catabolize a broader mix of substrates including carbohydrates from bacterial cell walls and cytoplasmic contents, shifting their respiratory gas exchange closer to 1:1. The RQ affects the dissolved CO₂ and O₂ budgets: a higher RQ means more CO₂ returned to the water per unit of oxygen consumed, which in turn influences pH (more CO₂ lowers pH) and the balance between photosynthetic carbon supply and respiratory carbon return.
Oxygen-limited carbon excretion. When dissolved oxygen is too low for a consumer to aerobically metabolize all the carbon it has assimilated, a surplus of unmetabolized carbon accumulates. What happens to this excess depends on the species. Most consumers (Copepods, bladder snail, Neocaridina, ostracod, rotifer, ciliate, nanoflagellate) excrete it as simple organic waste products analogous to lactate or ethanol from anaerobic fermentation. Bacteria rapidly mineralize these waste products into dissolved inorganic carbon (CO₂ and bicarbonate). Daphnia instead egest the excess as organic particles that join the suspended detritus, reflecting their tendency to package undigested material into fecal matter rather than excrete dissolved waste. This distinction matters most during hypoxic episodes: species that excrete dissolved waste return carbon to the inorganic pool immediately (available for photosynthesis), while species that produce particulate waste create a delayed recycling pathway that must pass through bacterial decomposition first.
- Bladder Snail
- Ramshorn Snail
- Malaysian Trumpet Snail (Melanoides tuberculata)
- Cherry Shrimp (Neocaridina davidi)
- Rotifer
- Daphnia
- Copepod
- Ostracod
The wider invertebrate roster
The eleven pages above are hand-written, one animal at a time, from that animal's own literature. Beside them the engine carries 44 further invertebrates — the snails, shrimp, crayfish, crabs and the freshwater mussel a keeper can pick from the stocking chart — built from one uniform rule rather than one page each. Every number in them is derived: the temperature and pH bands from the animal's published keeping range, its size from a published adult length where one exists, and its ingestion, crowding and moulting from allometries fitted on the five hand-written animals. Twenty-three of the 44 have no published length, and those carry the median of their group instead — a real median over at least three measured relatives, not a stand-in for a measurement — so their mass and appetite are "about the size of a crab" rather than "the size of this crab". Every row in the parameter reference says which of the two it is.
What separates one of them from another is mostly what it eats, and that falls into seven habits.
| Habit | What it eats | Examples |
|---|---|---|
| Biofilm rasper | Rasps algae and biofilm off every surface it can climb | Nerite, Yoda snail |
| Deposit feeder | Works settled detritus and the bacteria in it, mostly out of sight | Japanese trapdoor, pagoda, rabbit snail |
| Omnivore scavenger | Picks over surfaces and substrate and eats most of what it finds | Amano, ghost shrimp, dwarf crayfish, most freshwater crabs |
| Macrophyte herbivore | Grazes surfaces and takes bites out of living plants | Apple, mystery and spixi snails; the large crayfish |
| Fan filterer | Fans suspended particles out of the water, and scrapes when there is no current | Bamboo, vampire and green lace fan shrimp; the Thai micro crab |
| Filter feeder | Draws water across its gills and keeps whatever is suspended | The freshwater mussel |
| Snail predator | Hunts other snails | Assassin snail |
Two of those habits are worth reading before stocking them.
Plant-eaters really do eat plants. Until this roster no consumer in the model could take a bite out of a living macrophyte — it could graze the film growing on a leaf, but the leaf itself was untouchable, so an apple snail was modelled as harmless. It is not. In a 70-litre planted tank a single apple snail takes about half the shoot mass of an Amazon sword over sixty days, while a nerite in the same tank leaves it alone. The model now separates the two, and the difference is the habit rather than the animal being a snail.
Fan shrimp and mussels are hard to feed, and the model says so. A fan shrimp filters suspended particles out of moving water. A still aquarium does not carry many: a full-grown bamboo shrimp would have to strain about fourteen litres an hour to cover its own maintenance on what an ordinary tank holds in suspension, and a published filtration rate for a freshwater suspension feeder is closer to two. It survives by scraping, which is exactly why keepers are told to target-feed them. The freshwater mussel has no such fallback, so it slowly starves. That is the real answer rather than a modelling gap, and it is the reason mussels are not kept in aquaria.
Predators
Predators capture and consume other animals rather than algae or detritus. Unlike grazers, predators are gape-limited (they can only handle prey of certain size and morphology), so they reshape the prey community structure rather than simply reducing total biomass — typically driving a trophic cascade where suppressed grazers allow algae to rebound.
Microzooplankton
Microzooplankton — the single-celled protist grazers (ciliates and heterotrophic nanoflagellates) that occupy the microbial loop, linking bacteria and dissolved organic matter to larger consumers — are catalogued with the rest of the Microbes, since their ecology is bound up with the bacterial and fungal loop rather than the invertebrate grazers above.