English Documentation

Last updated: 2026-03-26

PyBCA is an open-source Brownian Cellular Automaton simulator with an accompanying BCL cellspace description language. For new code, the recommended execution entry point is PyBCA.api.Engine.

Main Pages

• PyBCA Guide
• Simulation Logic
• States and Rules
• Engine API
• GUI Tools Guide
• BCL Guide

Documentation Policy

• put usage first
• explain the update and computation logic explicitly
• treat BCL and GUI as tooling around the simulation workflow
• keep migration and parity notes as supplementary material

Common Entry Points

• New execution code: PyBCA.api.Engine
• Legacy-compatible simulator import: PyBCA.cli_simClass.BCA_Simulator
• BCL compilation: bcl INPUT.bcl -o OUTPUT.yaml
• GUI tools: bcl-editor, python -m BCL.rule_editor, python -m PyBCA._legacy.guitools

Supplementary Notes

• Implementation Parity Audit
• PyBCA Dev Memo

---

Table of contents

• PyBCA Guide
• Engine API
• Simulation Logic
• States and Rules
• BCL Guide
• GUI Tools Guide