How amirbehbahanian/simulator works
JEV Simulator turns point-cloud scene inputs into a rigid-body simulation, then exports step data for interactive playback or video. The principal workflow is CLI orchestration → scene loading → broad/narrow collision processing → contact response and integration → penetration-controlled timestep acceptance → export and visualization. Jev is the optional remote narrow-phase classifier; proximity is an offline alternative. The graph follows the documented world pipeline and sampled call sites; less-visible wiring is omitted where evidence is limited.
Main entry points: world.py World coordinator · main.py Simulation runner · detector.py Jev detector · rigid_body.py Rigid body state
Components 26
Run orchestration
- Simulation runner
app/src/main.py - Scene loading
app/src/scene_io.py
Physics engine
- World coordinator
app/src/physics/world.py - Broad phase
app/src/physics/broad_phase.py - Contact generation
app/src/physics/contact.py - Impulse resolution
app/src/physics/resolver.py - Motion integration
app/src/physics/integrator.py - Adaptive timestep
app/src/physics/timestep.py - Rigid body state
app/src/physics/rigid_body.py - Step metrics
app/src/physics/metrics.py
Collision classification
- Jev detector
app/src/jev/detector.py - Pair encoder
app/src/jev/encoder.py - Detector interface
app/src/jev/interface.py - TypeSafe client
app/src/jev/client.py - Jev configuration
app/src/jev/config.py - Proximity detector
app/src/jev/mock.py
Results and playback
- Run export
app/src/export.py - Viewer generation
app/src/postprocess.py - Video rendering
app/src/render_video.py
Shared foundations
- Geometry operations
app/src/utils/geometry.py - Serialization helpers
app/src/utils/serialization.py - Tensor conventions
app/src/utils/tensor_ops.py - Rigid transforms
app/src/utils/transforms.py - Secret loading
app/src/utils/env.py
Other components
- CLI user
- TypeSafe System One
Connections 30
- CLI user → Simulation runner: runs
README.md - Simulation runner → Scene loading: loads scene
app/src/main.py - Scene loading → Rigid body state: creates bodies
app/src/scene_io.py - Simulation runner → World coordinator: runs simulation
app/src/main.py - Simulation runner → Jev detector: selects detector
app/src/main.py - Simulation runner → Proximity detector: selects offline
app/src/main.py - World coordinator → Broad phase: finds candidates
app/src/physics/world.py - World coordinator → Jev detector: classifies pairs
app/src/physics/world.py - World coordinator → Contact generation: generates contacts
app/src/physics/world.py - World coordinator → Motion integration: integrates velocity
app/src/physics/world.py - World coordinator → Impulse resolution: resolves impulses
app/src/physics/world.py - World coordinator → Adaptive timestep: controls retries
app/src/physics/world.py - World coordinator → Step metrics: records metrics
app/src/physics/world.py - Jev detector → Pair encoder: encodes pairs
app/src/jev/detector.py - Jev detector → TypeSafe client: requests decisions
app/src/jev/detector.py - Jev detector → Detector interface: implements
app/src/jev/detector.py - Proximity detector → Detector interface: implements
app/src/jev/mock.py - TypeSafe client → Jev configuration: uses settings
app/src/jev/client.py - TypeSafe client → TypeSafe System One: sends requests
app/src/jev/client.py - Jev configuration → Secret loading: loads credentials
app/src/jev/config.py - Simulation runner → Run export: writes results
app/src/main.py - Simulation runner → Viewer generation: builds viewer
app/src/main.py - Run export → Serialization helpers: serializes data
app/src/export.py - Viewer generation → Run export: reads step data
app/src/postprocess.py - Video rendering → Viewer generation: reuses processing
app/src/render_video.py - Contact generation → Geometry operations: measures contact
app/src/physics/contact.py - Rigid body state → Geometry operations: derives bounds
app/src/physics/rigid_body.py - Rigid body state → Rigid transforms: transforms points
app/src/physics/rigid_body.py - Geometry operations → Tensor conventions: uses operations
app/src/utils/geometry.py - Rigid transforms → Tensor conventions: uses conventions
app/src/utils/transforms.py