Ecosystem¶
Biosiglib coordinates a small ecosystem of repositories with separate responsibilities.
| Repository | Role |
|---|---|
| Biosiglib | Source of truth for language-independent specifications, shared fixtures, conformance cases, validation tools, and release propagation metadata. |
| Biosigmat | MATLAB implementation of the Biosiglib specifications. |
| Biosigpy | Python implementation of the Biosiglib specifications. |
Biosigmat and Biosigpy may expose idiomatic language-specific APIs. They do not need identical internal architecture, but they must preserve the normative behavior defined by Biosiglib.
Release Propagation¶
Biosiglib releases are propagated downstream so each implementation can declare exactly which specification release and commit it conforms to.
The release path is:
- Biosiglib release.
- Biosigmat propagation pull request.
- Biosigpy propagation pull request.
The downstream pull requests update each implementation repository's conformance.json file. The implementations remain independently versioned, so a Biosigmat or Biosigpy release declares its supported Biosiglib version instead of sharing the Biosiglib version number.
Source Of Truth¶
When behavior is unclear, Biosiglib is the place to resolve it. Existing implementation behavior can inform a specification, especially when mature code already exists, but no implementation is automatically the authority. Disagreements should be analyzed against the Biosiglib specification, fixtures, conformance cases, and scientific references.