-
-
Notifications
You must be signed in to change notification settings - Fork 0
Improve documentation for consciousness equation parameters #2
Copy link
Copy link
Open
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomers
Description
Summary
The consciousness equation (IIT Φ computation) in symthaea-core/src/hdc/consciousness_equation.rs has many tunable parameters but limited documentation on their effects.
What needs documenting
Add rustdoc comments explaining:
- Each parameter's role in the Φ computation
- Valid ranges (many are 0.0–1.0 but some have different semantics)
- Impact on Φ scores — which parameters are most sensitive
- Substrate feasibility interaction — how
substrate_feasibilitymodulates the final score - Default values and why they were chosen
References
- Tononi, G. (2004). An information integration theory of consciousness. BMC Neuroscience.
- Our HAI paper in
papers/latex/hai_paper.tex ConsciousnessEquationV2is the current implementationConsciousnessStateV2holds the input parameters
Getting started
- Read
symthaea-core/src/hdc/consciousness_equation.rs - Look at how parameters are populated in
src/cognitive_loop/consciousness_engine/ - Add
///doc comments to each field inConsciousnessStateV2 - Verify docs build:
cargo doc -p symthaea-core --no-deps
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
documentationImprovements or additions to documentationImprovements or additions to documentationgood first issueGood for newcomersGood for newcomers