How pankajn-git/neupims-project works
NeuPIMs is a configurable simulator for neural-network inference on NPU/PIM hardware. Its main workflow parses configuration, initializes operation and memory-address state, constructs a model, launches it in the simulator, and runs the simulation. The repository also includes DRAM and interconnect simulation components. The excerpts show the entry-point workflow, but not most simulator internals or how the integrated simulators are invoked, so those relationships are left unverified rather than presented as established calls.
Main entry points: main.cc Program entry · Simulator.h Simulator · Scheduler.cc Scheduling · neupims_controller.cc DRAM controller
Components 21
Simulation runtime
- CLI parsing
NeuPIMs/src/helper/CommandLineParser.h - Program entry
NeuPIMs/src/main.cc - Simulator
NeuPIMs/src/Simulator.h - Shared configuration
NeuPIMs/src/Common.h - Request client
NeuPIMs/src/client/Client.cc - Request generation
NeuPIMs/src/RequestGenerator.h
Model execution
- Model definition
NeuPIMs/src/Model.cc - Model program
NeuPIMs/src/ModelProgram.cc - Stage program
NeuPIMs/src/StageProgram.cc - Scheduling
NeuPIMs/src/scheduler/Scheduler.cc - Inference operations
NeuPIMs/src/operations/Operation.cc - Tensor representations
NeuPIMs/src/tensor/NPUTensor.cc
Memory simulation
- Address allocation
NeuPIMs/src/allocator/AddressAllocator.h - DRAM controller
NeuPIMs/extern/NewtonSim/src/neupims_controller.cc - DRAM channel state
NeuPIMs/extern/NewtonSim/src/channel_state.h - PIM command queue
NeuPIMs/extern/NewtonSim/src/neupims_command_queue.cc
Interconnect simulation
- Interconnect API
NeuPIMs/extern/booksim/include/booksim2/Interconnect.hpp - Traffic manager
NeuPIMs/extern/booksim/src/GNNTrafficManager.cpp - Input-queued router
NeuPIMs/extern/booksim/src/routers/iq_router.cpp - Network statistics
NeuPIMs/extern/booksim/src/stats.hpp
Other components
- Simulation user
Connections 21
- Simulation user → Program entry: starts
- Program entry → CLI parsing: parses options
NeuPIMs/src/main.cc - Program entry → Shared configuration: sets configuration
NeuPIMs/src/main.cc - Program entry → Inference operations: initializes operations
NeuPIMs/src/main.cc - Program entry → Simulator: constructs and runs
NeuPIMs/src/main.cc - Program entry → Model definition: creates and launches
NeuPIMs/src/main.cc - Program entry → Address allocation: initializes allocators
NeuPIMs/src/main.cc - Request client → Request generation: uses
- Scheduling → Model definition: uses model program
- Scheduling → Model program: uses
- Scheduling → Stage program: uses
- Scheduling → Tensor representations: uses tensors
NeuPIMs/src/scheduler/Scheduler.cc - Simulator → Request client: coordinates requests
- Simulator → Scheduling: dispatches work
- Simulator → DRAM controller: uses DRAM model
- Simulator → Interconnect API: uses network model
- DRAM controller → DRAM channel state: uses channel state
- DRAM controller → PIM command queue: uses command queue
- Interconnect API → Traffic manager: dispatches traffic
NeuPIMs/extern/booksim/src/GNNTrafficManager.cpp - Traffic manager → Input-queued router: routes flits
- Traffic manager → Network statistics: records statistics