Research-Stack/2-Search-Space/simulations/Newtonian-Superfluid-Simulation/custom_stack/README.md

94 lines
1.9 KiB
Markdown

# Custom Stack Modules
These modules adapt the Newtonian Superfluid Simulation into the broader semantic-mass / geometric ontology stack.
## Source model
The repository simulation is particle-based. The README describes a fluid model of particles interacting through attraction, repulsion, and spin-like/tangential dynamics, where force-balance changes produce dynamic micro-to-macro patterns.
The current `simulation.py` implements a finite 2D particle system with:
```text
N_particles = 350
box_size = 50.0
dt = 0.04
k_gravity = 100.0
k_repel = 100.0
softening = 1.2
R_max = 10.0
damping = 0.95
max_vel = 12.0
```
with local attraction and repulsion:
```text
F_grav = k_gravity / (r^2 + softening)
F_repel = -k_repel / (r^4 + 0.1)
```
## Added modules
### `superfluid_semantic_adapter.py`
A Python adapter that runs finite probes and exports dimensionless semantic diagnostics:
```text
mass_number
semantic_density
torsion
kinetic_pressure
basin_strength
receipt_coverage
gate
```
It also exports Q16.16-compatible values for browser/Lean/Wasm bridge use.
Run:
```bash
python custom_stack/superfluid_semantic_adapter.py
```
### `SuperfluidSemanticKernel.lean`
A Lean-side fixed-point gate kernel defining:
```text
SuperfluidSemanticState
GateScope
routeAdmissible
superfluid_mass_q16
superfluid_density_q16
superfluid_torsion_q16
superfluid_basin_q16
superfluid_gate_scope
```
## Boundary
These modules do **not** claim:
```text
semantic mass is SI physical mass
the particle simulation is a literal validated superfluid model
visualization proves ontology
high mass_number proves a claim
```
They provide a finite adapter layer:
```text
particle dynamics -> dimensionless semantic diagnostics -> custom ontology/render stack
```
## Intended next bridge
```text
simulation.py / adapter
-> semantic state JSON or Q16.16 values
-> WebGPU ontology renderer
-> Lean/Wasm receipt gate
-> FAMM / Inverted FAMM route memory
```