How adicksonlab/wepy works
wepy is a modular framework for weighted-ensemble molecular-dynamics simulations. The principal workflow assembles a simulation from a snapshot and configuration, advances walker dynamics, applies boundary conditions and resampling, then reports results for persistent storage and analysis. OpenMM and multiprocessing are supported runtime integrations; WExplore and REVO are documented resampling choices. The excerpts show the simulation manager’s cycle and reporting responsibilities and orchestration’s call into it. Several important subsystems are represented from the README and source tree, but their internal connections are omitted where sampled evidence does not establish them.
Main entry points: sim_manager.py Simulation manager · sim_makers System makers · openmm.py Dynamics runner · resampler.py Resampling interface
Components 23
Simulation setup
- System makers
src/wepy_tools/sim_makers - Configuration
src/wepy/orchestration/configuration.py - Simulation snapshot
src/wepy/orchestration/snapshot.py - Orchestrator
src/wepy/orchestration/orchestrator.py
Simulation runtime
- Simulation manager
src/wepy/sim_manager.py - Walkers and state
src/wepy/walker.py - Dynamics runner
src/wepy/runners/openmm.py - Boundary conditions
src/wepy/boundary_conditions/boundary.py - Resampling interface
src/wepy/resampling/resamplers/resampler.py - WExplore
src/wepy/resampling/resamplers/wexplore.py - REVO
src/wepy/resampling/resamplers/revo.py - Work mapper
src/wepy/work_mapper/mapper.py - Task mapper
src/wepy/work_mapper/task_mapper.py - OpenMM engine
Reporting and storage
- Reporter interface
src/wepy/reporter/reporter.py - HDF5 reporter
src/wepy/reporter/hdf5.py - HDF5 datasets
src/wepy/hdf5.py - HDF5 and run CLI
src/wepy/orchestration/cli.py
Analysis and monitoring
- Trajectory analysis
src/wepy/analysis/parents.py - Network analysis
src/wepy/analysis/network.py - Run dashboards
src/wepy/reporter/dashboard.py - Prometheus monitoring
src/wepy_tools/monitoring/prometheus.py
Other components
- Simulation user
Connections 21
- Simulation user → System makers: configures
- System makers → Configuration: assembles
src/wepy_tools/sim_makers/openmm/sim_maker.py - System makers → Simulation snapshot: creates
src/wepy_tools/sim_makers/openmm/sim_maker.py - System makers → Orchestrator: uses
src/wepy_tools/sim_makers/openmm/sim_maker.py - System makers → Dynamics runner: constructs
src/wepy_tools/sim_makers/openmm/sim_maker.py - Orchestrator → Simulation manager: runs cycles
src/wepy/orchestration/orchestrator.py - Simulation manager → Dynamics runner: advances dynamics
src/wepy/sim_manager.py - Simulation manager → Boundary conditions: applies boundaries
src/wepy/sim_manager.py - Simulation manager → Resampling interface: resamples walkers
src/wepy/sim_manager.py - Simulation manager → Reporter interface: reports cycle
src/wepy/sim_manager.py - Dynamics runner → Work mapper: maps work
src/wepy/runners/openmm.py - Work mapper → Task mapper: dispatches tasks
src/wepy/work_mapper/task_mapper.py - WExplore → Resampling interface: implements
src/wepy/resampling/resamplers/wexplore.py - REVO → Resampling interface: implements
src/wepy/resampling/resamplers/revo.py - HDF5 reporter → Reporter interface: extends
src/wepy/reporter/hdf5.py - HDF5 reporter → HDF5 datasets: writes
src/wepy/reporter/hdf5.py - HDF5 and run CLI → HDF5 datasets: queries datasets
- Trajectory analysis → HDF5 datasets: reads datasets
- Run dashboards → Reporter interface: extends
src/wepy/reporter/dashboard.py - Simulation user → OpenMM engine: selects engine
- Simulation manager → Prometheus monitoring: emits metrics