This repository contains the Obsidian Observer, the primary Visualization engine for the HCSN-Nexus workspace.
Caution
Scientific Integrity & The Unidirectional Rule The HCSN-Rust engine operates on pure topological graph rewrites. It has no concept of 3D space, light, or inertia. To make this data intelligible, the Obsidian Observer introduces several Cinematic Artificial Constructs.
Crucially: These visual components exist only for observation. There is a strict Unidirectional Data Flow—the visualizer receives state from the engine, but no conclusions or forces from the visualizer are ever imported back into the core hcsn-rust engine physics.
The following features were added in the visualizer purely for aesthetic refinement and human spatial comprehension:
The raw engine data has no coordinates. The visualizer assigns 3D positions based on:
- Knot Centroids: Synthetic centers for topological motifs.
- Artificial Repulsion: A Coulomb-based layout algorithm to prevent 3D visual "balls" from overlapping.
- Spring Attraction: Hyperedges are interpreted as physical springs to pull connected motifs together for easier spatial tracking.
Individual vertices ("The White Nodes") are rendered with a soft, recursive starlight falloff. This is a purely visual post-processing step to represent Structural Coherence (
Ambient deep-space backgrounds and the UnrealBloomPass HDR glow are artifical layers designed to provide scale and cinematic energy. These are powered by the RTX 2050 hardware pipeline and have no basis in the engine's topological equations.
The smooth camera interpolation (orbit.targetR) and focus-locking are UI artifacts designed to allow researchers to "dive" into specific high-mass structures without breaking the observer's tether.
- Engine: Decoupled Rust backend via Warp WebSockets.
- Renderer: Three.js WebGL with GPU Post-Processing.
- Requirement: NVIDIA RTX 2000-series (or equivalent) recommended for full bloom shader support.
Observe the emergence. Do not touch the physics.