How bithabib/flash_ssd_simulator_web works
EyanaSSD is a web-based educational and research SSD simulator. A user uploads or selects a workload, the server parses and replays it through a conventional, FDP, or ZNS model, and the application streams or presents SSD behavior and metrics for exploration. The repository also includes synthetic and real-trace workload support, a comprehensive evaluation harness, and educational content. The graph reflects documented and indexed source references; unsampled subsystem details and unshown UI-to-backend wiring are left unasserted.
Main entry points: full_eval.py Cross-engine evaluation · simulator.py Conventional simulator · zns_device.py ZNS device · app.py Flask application
Components 23
Web experience
- Flask application
app.py - Trace upload and streaming
views/simulate_stream.py - Trace visualization reader
views/api/trace_file_reader.py - Simulator and site views
views - Interactive visualizers
static/src/js
Simulation engine
- SSD configuration
eyana_engine/config.py - Conventional simulator
eyana_engine/simulator.py - Flash device state
eyana_engine/device.py - Page allocation
eyana_engine/allocation.py - Garbage collection policies
eyana_engine/gc - FDP placement engine
eyana_engine/fdp/fdp_engine.py - Conventional stream runner
eyana_engine/stream_sim.py - FDP stream runner
eyana_engine/fdp_stream.py
ZNS simulation
- ZNS stream runner
eyana_engine/zns_stream.py - ZNS simulator
eyana_engine/zns/zns_simulator.py - ZNS device
eyana_engine/zns/zns_device.py - Host FTL and reclaim
eyana_engine/zns/host_ftl.py - Zone state
eyana_engine/zns/zone.py
Workload evaluation
- Workload generators
eyana_engine/workloads.py - Simulation metrics
eyana_engine/metrics.py - Cross-engine evaluation
eyana_engine/full_eval.py
Learning content
- SSD and ZNS lessons
views/blog_content.py
Other components
- Learner / researcher
Connections 35
- Learner / researcher → Flask application: uses
README.md - Flask application → Trace upload and streaming: registers routes
app.py - Flask application → Trace visualization reader: registers routes
app.py - Flask application → Simulator and site views: registers views
app.py - Trace upload and streaming → Conventional stream runner: runs conventional
views/simulate_stream.py - Trace upload and streaming → FDP stream runner: runs FDP
views/simulate_stream.py - Trace upload and streaming → ZNS stream runner: runs ZNS
views/simulate_stream.py - Conventional stream runner → Conventional simulator: replays through
eyana_engine/stream_sim.py - Conventional stream runner → Workload generators: parses traces
eyana_engine/stream_sim.py - Conventional stream runner → SSD configuration: configures
eyana_engine/stream_sim.py - FDP stream runner → FDP placement engine: replays through
eyana_engine/fdp_stream.py - FDP stream runner → Workload generators: uses
eyana_engine/fdp_stream.py - FDP stream runner → SSD configuration: configures
eyana_engine/fdp_stream.py - ZNS stream runner → ZNS device: uses
eyana_engine/zns_stream.py - ZNS stream runner → Host FTL and reclaim: uses
eyana_engine/zns_stream.py - ZNS stream runner → Workload generators: uses
eyana_engine/zns_stream.py - Conventional simulator → SSD configuration: uses
eyana_engine/simulator.py - Conventional simulator → Flash device state: updates
eyana_engine/simulator.py - Conventional simulator → Page allocation: allocates through
eyana_engine/simulator.py - Conventional simulator → Garbage collection policies: selects policy
eyana_engine/simulator.py - FDP placement engine → SSD configuration: uses
eyana_engine/fdp/fdp_engine.py - ZNS simulator → ZNS device: uses
eyana_engine/zns/zns_simulator.py - ZNS simulator → Host FTL and reclaim: uses
eyana_engine/zns/zns_simulator.py - ZNS device → SSD configuration: validates geometry
eyana_engine/zns/zns_device.py - ZNS device → Zone state: tracks state
eyana_engine/zns/zns_device.py - Host FTL and reclaim → ZNS device: appends and resets
eyana_engine/zns/host_ftl.py - Host FTL and reclaim → Zone state: uses state
eyana_engine/zns/host_ftl.py - Cross-engine evaluation → Conventional simulator: evaluates
eyana_engine/full_eval.py - Cross-engine evaluation → FDP placement engine: evaluates
eyana_engine/full_eval.py - Cross-engine evaluation → ZNS device: evaluates
eyana_engine/full_eval.py - Cross-engine evaluation → Host FTL and reclaim: evaluates
eyana_engine/full_eval.py - Cross-engine evaluation → Workload generators: generates inputs
eyana_engine/full_eval.py - Cross-engine evaluation → Simulation metrics: uses metrics
eyana_engine/full_eval.py - Flask application → SSD and ZNS lessons: registers blog
app.py - Learner / researcher → Interactive visualizers: explores metrics
README.md