← Return to CRV Science Apps / App Preprints • APP-PREPRINT-20
Preprint ID: APP-PREPRINT-20 (v0.9.3 Software Preprint) Zenodo Concept DOI: 10.5281/zenodo.24359107 q-bio.PE • cs.GR • cs.MA

TrophicHearth: Nine-Biome 3D Living Trophic Diorama, Fire-Pit Hearth, and Bioacoustic Ecosystem Simulator in Rust

By Bryan P. White (ORCID: 0000-0003-4191-3511) • CRV Science Labs • 6 Pages • 8 min read

Overview

TrophicHearth (v0.9.3) is an open-source, GPU-accelerated 3D ecological diorama and trophic energy simulator implemented in safe Rust under GPL-3.0-or-later licensing. Spanning nine marine, benthic, freshwater, and terrestrial biomes—Rocky Intertidal Tidepool, Cold-Seep Brine Pool, Midwater Pelagic Rift, Pacific Northwest Salmon Creek, Deep-Sea Hydrothermal Vent, Temperate Freshwater Lake, Indo-Pacific Coral Reef, Pacific Giant Kelp Forest, and Neotropical Rainforest—the application couples continuous-time autonomous foraging, predator-prey encounters, and benthic/terrestrial decomposition directly to a Lindeman five-tier energetic ledger (L0 autotrophs through L4 decomposers) and diurnal solar or hydrothermal hearth forcing. A 2D diffusing pheromone substrate, 44.1 kHz stereo procedural bioacoustic soundscape engine, SQLite WAL state snapshots, and deterministic CLI sweeps enable reproducible multi-biome experiments without external cloud dependencies. Across 24-hour seeded CLI simulations (dt = 0.05 s, seed = 20261116, 2,880 steps per biome), Deep-Sea Hydrothermal Vent sustained the highest cumulative primary production at 653.46 kcal GPP through continuous chemosynthetic hearth flux, compared against 411.85 kcal in Giant Kelp Forest and 383.09 kcal in Coral Reef, while standing total trophic biomass ranged from 5,970.04 kcal (Tidepool) to 8,110.67 kcal (Salmon Creek) with 6,213.31 to 6,821.60 mg of closed-loop nutrient mineralization and 14/14 integration checks passing. Source repositories, documentation, and peer applications are hosted at https://crvscience.com/apps.

1. Introduction

Conceptual ecology courses frequently present ecosystem energetics through static triangular pyramids, hiding the continuous physical mechanisms that govern real biological communities: diurnal solar angle, tidal surge and thermal plume gradients, olfactory chemical trails, predator-prey search energetics, and microbial detrital remineralization[1,3]. Conversely, real-time 3D graphics engines rarely enforce thermodynamic accounting—organisms move across decorative scenery without tracking kilocalories assimilated, basal respiration lost, or elemental nutrients recycled to autotrophs[2,4].

TrophicHearth (v0.9.3) bridges spatial simulation and quantitative ecosystem modeling inside a single cross-sectional "living hearth" cut-away observatory implemented in safe Rust (#![forbid(unsafe_code)]). Designed for offline classroom exploration, evolutionary ecology demonstrations, and reproducible CLI sweeps, TrophicHearth integrates nine contrasting biomes under the CRV Science Open-Source Apps ecosystem[6–25].

2. Architecture & Trophic-Hearth Physics

Every biome occupies an aquarium-style or terrestrial cross-section containing stratified physical substrates (canopy or euphotic water column, benthic or forest floor, sediment/soil porewater, and a central campfire or black-smoker hydrothermal hearth), paired with deterministic organism kinematics and stereo bioacoustic synthesis[5] (Table 1). Across the Lindeman hierarchy, autotrophic primary producers (L0) fix solar photosynthetically active radiation (PAR) in diurnal biomes or hydrogen sulfide / methane vent enthalpy in abyssal biomes. Primary herbivores and filter-feeders (L1) graze L0 stocks and detrital snow, supporting mesopredators (L2) and apex consumers (L3), while detritivores and fungi (L4) remineralize organic detritus back into bioavailable inorganic nutrients.

Table 1. Core Rust Modules Inside crvscience-trophic-hearth v0.9.3
Source FileSubsystem Role
src/trophic.rsNine BiomeKind definitions, keystone guilds, five-tier (L0–L4) energy ledger, GPP/respiration & nutrient budgets.
src/organisms.rsSpecies life-history catalog across terrestrial canopy, kelp, reef, lake, tidepool, brine seep, and abyssal vents.
src/world.rsFixed-step ecological integration loop, foraging decisions, predation, keystone removal scenarios, and event stream.
src/pheromone.rs2D spatially diffused alarm, courtship, grazing, and detrital chemotaxis gradient fields on the habitat floor.
src/physics.rsDiurnal solar irradiance, precipitation/foliage wetness, tidal surge, plume updrafts, and vegetated habitat geometry.
src/audio.rs44.1 kHz stereo procedural bioacoustic soundscape synthesis and stereo WAV export synchronized to ecological events.
src/models_3d.rs & src/renderer.rsProcedural anatomical 3D mesh builders and native wgpu HDR/offscreen framebuffer renderer (1600 × 1000 PNG capture).
src/persistence.rs & src/main.rsBundled SQLite WAL checkpoint slots, JSON simulation snapshots, and headless CLI simulate harness.
Figure 1. Offscreen Headless GPU Capture (1600 × 1000 RGBA): Rocky Intertidal Tidepool
TrophicHearth v0.9.3 Rocky Intertidal Tidepool 3D Diorama

3. Multi-Biome 24-Hour Validation Benchmarks

Running compiled release CLI sweeps (19_Trophic-Hearth.exe simulate --hours 24 --dt 0.05 --seed 20261116, 2,880 integration steps per biome) quantifies divergent production regimes across aquatic, intertidal, deep-sea, and forested ecosystems (Table 2; Figure 2). Continuous chemosynthetic oxidation at the 2,600 m black smoker vent sustained 653.46 kcal cumulative GPP over 24 hours without nocturnal photosynthetic shutoff, surpassing Giant Kelp Forest (411.85 kcal), Indo-Pacific Coral Reef (383.09 kcal), and Neotropical Rainforest (360.12 kcal). Closed-loop microbial and invertebrate decomposition mineralized 6,213.31 mg to 6,821.60 mg of inorganic nutrients per 24-hour cycle, supporting total standing community energy budgets between 5,970.04 kcal (Tidepool, 46 organisms) and 8,110.67 kcal (PNW Salmon Creek, 30 organisms).

Table 2. Deterministic 24-Hour Nine-Biome Benchmarks (dt = 0.05 s, Seed 20261116, 2,880 Steps)
CLI BiomeEcosystemOrgs / SppL0 (kcal)L1 (kcal)L2+L3 (kcal)Total Biomass (kcal)Cum. GPP (kcal)Mineralized (mg)
tidepoolRocky Intertidal Tidepool46 / 84903921.014255970.04109.876213.31
brineCold-Seep Brine Pool (1,050 m)49 / 86404620.913706756.90240.546213.31
riftMidwater Pelagic Rift48 / 105404480.915106686.86265.216213.31
pnwPNW Old-Growth Salmon Creek30 / 105806422.710008110.67282.736432.90
ventDeep-Sea Hydrothermal Vent45 / 106205182.413007234.45653.466382.93
lakeTemperate Freshwater Lake40 / 144404682.110856325.09221.206449.64
coralIndo-Pacific Coral Reef45 / 144604383.712756266.66383.096821.60
kelpPacific Giant Kelp Forest50 / 135105624.011307388.98411.856478.82
rainforestNeotropical Lowland Rainforest42 / 134204852.18506210.12360.126701.21
Figure 2. Multi-Biome 24h Primary Production & Coupled L0–L4 Architecture
TrophicHearth 9-Biome 24h GPP and L0-L4 Architecture

4. Interactive Biome Gallery & Bioacoustic Synthesis

Two additional 1600 × 1000 headless GPU captures illustrate geometric and metabolic diversity across euphotic reefs and abyssal vents (Figures 3–4). In sunlit shallow lagoons (Indo-Pacific Coral Reef), GFP-fluorescent scleractinian heads anchor multi-guild herbivorous scraping by parrotfish alongside apex blacktip reef sharks, whereas 2,600 m black-smoker chimneys drive hydrothermal shrimp grazing, tube-worm mutualisms, and benthic chimaera patrols powered entirely by hearth geochemistry.

Figure 3. Headless Biome View: Indo-Pacific Shallow Fore-Reef & Lagoon
TrophicHearth Indo-Pacific Coral Reef Biome
Figure 4. Headless Biome View: Deep-Sea Hydrothermal Vent (2,600 m Black Smoker)
TrophicHearth Deep-Sea Hydrothermal Vent Biome

5. Discussion

Unifying 3D behavioral animation with strict kilocalorie conservation exposes trophic constraints often obscured in qualitative diagrams: in every simulated biome, herbivore and detritivore biomass (L1: 3,921.04–6,422.67 kcal) exceeds combined predator biomass (L2+L3: 850–1,510 kcal), while steady detrital remineralization stabilizes nutrient pools against premature washout[1,4]. All 14 integration tests in tests/simulation_tests.rs confirm deterministic state transitions, SQLite checkpoint serialization, WAV bioacoustic generation, and keystone-predator perturbation bookkeeping. Current parameterizations intentionally use compartmental guild pools rather than spatial reaction-diffusion biogeochemistry or multi-year life-history demography—domains explored dynamically alongside seasonal population fluctuations in companion CRV Science tools.

6. Software Availability & Network Integration

TrophicHearth (v0.9.3) is released in full safe Rust source under the GNU General Public License v3.0 or later (GPL-3.0-or-later) through the isolated CRV Science Open-Source Apps hub at https://crvscience.com/apps[6–25]. Within the twenty-application Rust network, TrophicHearth pairs naturally with PopBio-Studio for population elasticity and adaptive landscapes, SonoWing for spectrogram bioacoustics, OSABT for ecophysiology, AeroFlyway for nocturnal aeroecology, and ITME for deep-time macroevolutionary transitions.

References

  1. [1] Lindeman, R. L. (1942). The Trophic-Dynamic Aspect of Ecology. Ecology, 23(4), 399–417. https://doi.org/10.2307/1930126
  2. [2] Paine, R. T. (1966). Food Web Complexity and Species Diversity. The American Naturalist, 100(910), 65–75. https://doi.org/10.1086/282400
  3. [3] Odum, E. P. (1969). The Strategy of Ecosystem Development. Science, 164(3877), 262–270. https://doi.org/10.1126/science.164.3877.262
  4. [4] Polis, G. A., & Strong, D. R. (1996). Food Web Complexity and Community Dynamics. The American Naturalist, 147(5), 813–846. https://doi.org/10.1086/285880
  5. [5] Sueur, J., Farina, A., Gasc, A., Pieretti, N., & Pavoine, S. (2014). Acoustic Indices for Biodiversity Assessment and Landscape Investigation. Acta Acustica united with Acustica, 100(4), 772–781. https://doi.org/10.3813/aaa.918757
  6. [6] White, B. P. (2026). The CRV Science App Network: Twenty Open-Source Rust Programs for Science, Data, and Simulation. CRV Science App Preprint APP-PREPRINT-01 [cs.SE, cs.CE, q-bio.QM], v1.1.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222398
  7. [7] White, B. P. (2026). AeroFlyway: Tracking Bird Migration with Weather Radar, Skyglow Maps, and Nighttime Flight Calls. CRV Science App Preprint APP-PREPRINT-13 [q-bio.PE, physics.ao-ph, cs.GR], v0.6.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222366
  8. [8] White, B. P. (2026). BeoFold: Simulating How Proteins Fold Using Distributed Computing and State Networks. CRV Science App Preprint APP-PREPRINT-02 [q-bio.BM, physics.chem-ph, cs.DC], v1.4.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222370
  9. [9] White, B. P. (2026). Calc-Lab: Interactive Calculus, Linear Algebra, and Differential Equation Solver Workbench. CRV Science App Preprint APP-PREPRINT-03 [math.NA, cs.MS, cs.CY], v0.5.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222372
  10. [10] White, B. P. (2026). Causal-Atlas: Tracing How Genes and Drugs Turn Biological Pathways On and Off. CRV Science App Preprint APP-PREPRINT-04 [q-bio.MN, q-bio.GN, stat.ML], v0.2.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222376
  11. [11] White, B. P. (2026). Cit-Atlas: Mapping Citation Networks and Research Impact Across Scientific Papers. CRV Science App Preprint APP-PREPRINT-05 [cs.DL, cs.SI, physics.soc-ph], v1.8.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222380
  12. [12] White, B. P. (2026). EpiLedger: Privacy-Safe Disease Tracking, Clinical Text Screening, and Outbreak Monitoring. CRV Science App Preprint APP-PREPRINT-06 [cs.CR, q-bio.PE, stat.AP], v2.0.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222382
  13. [13] White, B. P. (2026). ITME: Modeling Evolutionary Regimes, Contingency, and Substrate Complexity Across Molecular, Hominid, and AI Worlds. CRV Science App Preprint APP-PREPRINT-07 [q-bio.PE, nlin.AO, physics.bio-ph], v2.3.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222386
  14. [14] White, B. P. (2026). OSABT: A 20-Module Biology and Biostatistics Workbench for Molecular Labs, Genetics, Kinetics, and Ecology. CRV Science App Preprint APP-PREPRINT-08 [q-bio.QM, stat.AP, cs.SE], v2.0.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222388
  15. [15] White, B. P. (2026). SAR-Atlas: Drug Design, Body Distribution Modeling, and Candidate Screening in Rust. CRV Science App Preprint APP-PREPRINT-09 [physics.chem-ph, q-bio.BM, cs.LG], v3.8.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222390
  16. [16] White, B. P. (2026). TerraTwin: Fast Climate Projections for Global Warming, Sea-Level Rise, and Arctic Change. CRV Science App Preprint APP-PREPRINT-10 [physics.ao-ph, cs.CE, stat.AP], v2.5.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222392
  17. [17] White, B. P. (2026). Urban-Grid: Modeling City Traffic, Emergency Response Coverage, and Earthquake Evacuation. CRV Science App Preprint APP-PREPRINT-11 [physics.soc-ph, cs.MA, cs.CE], v5.2.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222394
  18. [18] White, B. P. (2026). WildFront BattleGrounds: Turn-Based Hex Strategy Game with Voxel Graphics and Procedural Map Generation. CRV Science App Preprint APP-PREPRINT-12 [cs.GT, cs.GR, math.CO], v3.4.1. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24222396
  19. [19] White, B. P. (2026). HelioProbe: Simulating Spacecraft Orbits, Deep-Space Telescopes, and Comet Tails in 3D. CRV Science App Preprint APP-PREPRINT-14 [astro-ph.EP, astro-ph.IM, cs.GR], v2.3.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24244083
  20. [20] White, B. P. (2026). PopBio-Studio: Interactive Population Biology, Adaptive Landscapes, and Genetic Skyline Simulator. CRV Science App Preprint APP-PREPRINT-15 [q-bio.PE, q-bio.QM, stat.AP], v1.2.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24244085
  21. [21] White, B. P. (2026). QuantaCrypt-Studio: Simulating Quantum Circuits, Quantum Key Distribution, and Post-Quantum Cryptography. CRV Science App Preprint APP-PREPRINT-16 [quant-ph, cs.CR, cs.MS], v2.2.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24244089
  22. [22] White, B. P. (2026). SonoWing: Analyzing Bat Echolocation and Bird Calls with Spectrograms and Harmonic Tracking. CRV Science App Preprint APP-PREPRINT-17 [q-bio.NC, q-bio.PE, cs.SD], v1.1.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24244091
  23. [23] White, B. P. (2026). SwarmForge: 3D Isometric Automated Factory and Swarm Robotics Simulation Game. CRV Science App Preprint APP-PREPRINT-18 [cs.MA, cs.RO, cs.GT], v1.3.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24244093
  24. [24] White, B. P. (2026). NeuroSpace Lab: 3D Neural Network Topology, Structural Plasticity, and Six-Layered Cerebral Cortex Simulation in Rust. CRV Science App Preprint APP-PREPRINT-19 [q-bio.NC, cs.NE, cs.GR], v1.6.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24263468
  25. [25] White, B. P. (2026). ConnectomeAtlas: Standalone 3D Multi-Scale Brain Connectome, Persistent Homology, and Lesion Workstation in Rust. CRV Science App Preprint APP-PREPRINT-21 [q-bio.NC, cs.SI, cs.GR], v0.8.0. Hosted via CRV Science Apps Hub (https://crvscience.com/apps). https://doi.org/10.5281/zenodo.24359109