How hpcclab/felare works
FELARE is a discrete-event simulator for fair scheduling of machine-learning workloads across heterogeneous edge machines. The main workflow initializes configuration and machines, loads a workload into arrival events, dispatches events through a selected scheduler, and reports simulation results; a GUI can drive and visualize the same simulation. Scheduling, task/machine execution, workload generation, and analysis are distinct product areas. The README identifies the research goal, while source excerpts show only part of runtime wiring; unsampled report and scheduler relationships are therefore not inferred.
Main entry points: simulator.py Event simulator · machine.py Edge machine · main.py Run driver · gui.py Simulation GUI
Components 22
Run and visualize
- Run driver
CODE/main.py - Simulation GUI
CODE/gui.py
Simulation runtime
- Configuration
CODE/utils/config.py - Event simulator
CODE/utils/simulator.py - Event model
CODE/utils/event.py - Event queue
CODE/utils/event_queue.py - Task state
CODE/utils/task.py - Task types
CODE/utils/task_type.py - Edge machine
CODE/utils/machine.py - Machine base
CODE/utils/base_machine.py - Task queue
CODE/utils/queue.py
Scheduling policies
- Scheduler base
CODE/utils/base_scheduler.py - Energy-efficient policy
CODE/utils/schedulers/EE.py - Fair energy policy
CODE/utils/schedulers/FEE.py - MMU policy
CODE/utils/schedulers/MMU.py - Other policies
CODE/utils/schedulers
Workload modeling
- Workload generator
CODE/workload_generator.py - Workload model
CODE/utils/workload.py - Sampling and timing
CODE/utils/random_sample.py - Execution estimates
CODE/utils/execution_time.py
Results analysis
- Analysis reports
CODE/utils/report
Other components
- Operator
Connections 34
- Operator → Run driver: starts
CODE/main.py - Operator → Simulation GUI: interacts
CODE/gui.py - Run driver → Configuration: initializes
CODE/main.py - Run driver → Edge machine: creates
CODE/main.py - Run driver → Event simulator: runs
CODE/main.py - Run driver → Simulation GUI: opens
CODE/main.py - Simulation GUI → Event simulator: controls
CODE/gui.py - Configuration → Event queue: creates
CODE/utils/config.py - Configuration → Task types: creates
CODE/utils/config.py - Event simulator → Event model: creates
CODE/utils/simulator.py - Event simulator → Task state: loads
CODE/utils/simulator.py - Event simulator → Event queue: queues arrivals
CODE/utils/simulator.py - Event simulator → Scheduler base: dispatches events
CODE/utils/simulator.py - Event simulator → Energy-efficient policy: selects policy
CODE/utils/simulator.py - Event simulator → Fair energy policy: selects policy
CODE/utils/simulator.py - Event simulator → MMU policy: selects policy
CODE/utils/simulator.py - Event simulator → Other policies: selects policy
CODE/utils/simulator.py - Event simulator → Edge machine: handles events
CODE/utils/simulator.py - Edge machine → Machine base: extends
CODE/utils/machine.py - Edge machine → Task queue: uses
CODE/utils/machine.py - Edge machine → Event model: schedules execution
CODE/utils/machine.py - Energy-efficient policy → Scheduler base: extends
CODE/utils/schedulers/EE.py - Fair energy policy → Scheduler base: extends
CODE/utils/schedulers/FEE.py - MMU policy → Scheduler base: extends
CODE/utils/schedulers/MMU.py - Energy-efficient policy → Edge machine: maps tasks
CODE/utils/schedulers/EE.py - Fair energy policy → Edge machine: admits tasks
CODE/utils/schedulers/FEE.py - MMU policy → Edge machine: maps tasks
CODE/utils/schedulers/MMU.py - Workload generator → Workload model: generates
CODE/workload_generator.py - Workload generator → Configuration: initializes
CODE/workload_generator.py - Workload generator → Execution estimates: imports
CODE/workload_generator.py - Workload model → Sampling and timing: samples
CODE/utils/workload.py - Workload model → Execution estimates: estimates
CODE/utils/workload.py - Event simulator → Analysis reports: writes results
CODE/utils/simulator.py - Simulation GUI → Analysis reports: requests report
CODE/gui.py