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

1.9 KiB

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:

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:

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:

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:

python custom_stack/superfluid_semantic_adapter.py

SuperfluidSemanticKernel.lean

A Lean-side fixed-point gate kernel defining:

SuperfluidSemanticState
GateScope
routeAdmissible
superfluid_mass_q16
superfluid_density_q16
superfluid_torsion_q16
superfluid_basin_q16
superfluid_gate_scope

Boundary

These modules do not claim:

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:

particle dynamics -> dimensionless semantic diagnostics -> custom ontology/render stack

Intended next bridge

simulation.py / adapter
-> semantic state JSON or Q16.16 values
-> WebGPU ontology renderer
-> Lean/Wasm receipt gate
-> FAMM / Inverted FAMM route memory