Developer Guide

For people who change HemoCell itself: how it works inside, the conventions the code follows, how to add models, outputs and tests, and what is known not to work yet. Build and test commands are summarised in AGENTS.md and in Compiling HemoCell from source; the contribution workflow is in Contributing.

• Architecture and internals
  • Object structure
  • One time step
  • Particle ownership and caches
  • Force components
  • Cell IDs and periodicity
  • Communication
  • Output
  • Checkpoints
• Coding conventions
  • Formatting
  • Naming
  • Units
  • Performance rules
  • Parallel correctness
  • Errors and logging
  • Documentation
  • Building and testing
• Extending HemoCell
  • Adding a mechanical model
  • Adding an output field
  • Adding a configuration setting
  • Adding a case
  • Adding tests
• Known limitations
  • Features with restrictions
  • Numerical and modelling notes
  • Software constraints