How firefly174/detm works
DETM is a research simulator for discrete entropy-time dynamics on a lattice, with headless and interactive workflows. The main path is launch/configure → create a session → advance model state → collect subscriber outputs and artifacts. The graph also preserves analysis, ComfyUI integration, and the documented fabric/coordination capability. Several fabric and UI internals are unsampled; their links are shown only where documented or left unverified, rather than inferred from directory names.
Main entry points: core.py Runtime API · main.py Headless Runner · controller.py Napari Controls · session Simulation Session
Components 21
Launch and UI
- Launcher
main.py - Headless Runner
detm_app/runner/headless/main.py - Napari Controls
detm_app/ui/napari/interactive/controller.py - Graph View
detm_app/ui/napari/interactive/flow/graph.py - Field Rendering
detm_app/ui/napari/interactive/flow/render.py
Model Runtime
- Simulation Session
detm_app/runtime/session - Runtime API
detm/runtime/api/core.py - Model State
detm/runtime/state.py - Lattice Fields
detm/core/fields.py - Entropy Dynamics
detm/core/entropy.py - Compute Backends
detm/runtime/backends - Refinement Pipeline
detm/runtime/refinement/pipeline/orchestrator.py
Analysis and Results
- Runtime Subscribers
detm_app/runtime/subscribers - State Serialization
detm/runtime/serialization/__init__.py - Diagnostics
detm/runtime/diagnostics/attractors.py - Experiment Protocols
experiments/marker_protocol.py
Integration and Fabric
- Coordination Fabric
detm/runtime/fabric - Viz Transport
detm_app/transport/client.py - ComfyUI Nodes
comfyui_nodes/DETM/core.py - ACGS Backend
detm/integrations/acgs_backend.py
Other components
- Researcher
Connections 25
- Researcher → Launcher: launches
README.md - Launcher → Headless Runner: routes to
main.py - Researcher → Headless Runner: runs batch
README.md - Headless Runner → Simulation Session: creates
detm_app/runner/headless/main.py - Headless Runner → Runtime Subscribers: attaches
detm_app/runner/headless/main.py - Simulation Session → Runtime API: advances via
- Runtime API → Model State: updates
- Model State → Lattice Fields: uses
detm/runtime/state.py - Model State → Entropy Dynamics: uses
detm/runtime/state.py - Runtime API → State Serialization: serializes
detm/runtime/api/__init__.py - Runtime API → Compute Backends: selects
- Simulation Session → Refinement Pipeline: applies
- Runtime Subscribers → Diagnostics: collects
- Headless Runner → Experiment Protocols: supports runs
- Researcher → Napari Controls: opens UI
README.md - Launcher → Napari Controls: routes to
main.py - Napari Controls → Graph View: updates
detm_app/ui/napari/interactive/controller.py - Napari Controls → Field Rendering: renders
detm_app/ui/napari/interactive/controller.py - Napari Controls → Simulation Session: steps
- Researcher → ComfyUI Nodes: uses nodes
- ComfyUI Nodes → Runtime API: calls
comfyui_nodes/DETM/core.py - Runtime API → Coordination Fabric: configures
- Researcher → Coordination Fabric: enables handshake
README.md - Researcher → Viz Transport: connects viz
- ACGS Backend → Runtime API: adapts runtime
detm/integrations/acgs_backend.py