pythia
A customizable hardware prefetching framework using online reinforcement learning as described in the MICRO 2021 paper by Bera et al. (https://arxiv.org/pdf/2109.12021.pdf).
Science Score: 75.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 7 DOI reference(s) in README -
✓Academic publication links
Links to: arxiv.org, zenodo.org -
○Academic email domains
-
✓Institutional organization owner
Organization cmu-safari has institutional domain (safari.ethz.ch) -
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.0%) to scientific vocabulary
Keywords
Repository
A customizable hardware prefetching framework using online reinforcement learning as described in the MICRO 2021 paper by Bera et al. (https://arxiv.org/pdf/2109.12021.pdf).
Basic Info
- Host: GitHub
- Owner: CMU-SAFARI
- License: mit
- Language: C++
- Default Branch: master
- Homepage: https://arxiv.org/pdf/2109.12021.pdf
- Size: 3.48 MB
Statistics
- Stars: 132
- Watchers: 8
- Forks: 45
- Open Issues: 2
- Releases: 5
Topics
Metadata Files
README.md
A Customizable Hardware Prefetching Framework Using Online Reinforcement Learning
Table of Contents
What is Pythia?
Pythia is a hardware-realizable, light-weight data prefetcher that uses reinforcement learning to generate accurate, timely, and system-aware prefetch requests.
Pythia formulates hardware prefetching as a reinforcement learning task. For every demand request, Pythia observes multiple different types of program context information to take a prefetch decision. For every prefetch decision, Pythia receives a numerical reward that evaluates prefetch quality under the current memory bandwidth utilization. Pythia uses this reward to reinforce the correlation between program context information and prefetch decision to generate highly accurate, timely, and system-aware prefetch requests in the future.
Pythia is presetend at MICRO 2021.
Rahul Bera, Konstantinos Kanellopoulos, Anant V. Nori, Taha Shahroodi, Sreenivas Subramoney, Onur Mutlu, "Pythia: A Customizable Hardware Prefetching Framework Using Online Reinforcement Learning", In Proceedings of the 54th Annual IEEE/ACM International Symposium on Microarchitecture (MICRO), 2021
About The Framework
Pythia is implemented in ChampSim simulator. We have significantly modified the prefetcher integration pipeline in ChampSim to add support to a wide range of prior prefetching proposals mentioned below:
- Stride [Fu+, MICRO'92]
- Streamer [Chen and Baer, IEEE TC'95]
- SMS [Somogyi+, ISCA'06]
- AMPM [Ishii+, ICS'09]
- Sandbox [Pugsley+, HPCA'14]
- BOP [Michaud, HPCA'16]
- SPP [Kim+, MICRO'16]
- Bingo [Bakshalipour+, HPCA'19]
- SPP+PPF [Bhatia+, ISCA'19]
- DSPatch [Bera+, MICRO'19]
- MLOP [Shakerinava+, DPC-3'19]
- IPCP [Pakalapati+, ISCA'20]
Most of the prefetchers (e.g., SPP [1], Bingo [2], IPCP [3]) reuse codes from 2nd and 3rd data prefetching championships (DPC). Others (e.g., AMPM [4], SMS [5]) are implemented from scratch and shows similar relative performance reported by previous works.
Prerequisites
The infrastructure has been tested with the following system configuration: * G++ v6.3.0 20170516 * CMake v3.20.2 * md5sum v8.26 * Perl v5.24.1
Installation
- Install necessary prequisites
bash sudo apt install perl - Clone the GitHub repo
bash
git clone https://github.com/CMU-SAFARI/Pythia.git
2. Clone the bloomfilter library inside Pythia home directory
bash
cd Pythia
git clone https://github.com/mavam/libbf.git libbf
3. Build bloomfilter library. This should create the static libbf.a library inside build directory
```bash
cd libbf
mkdir build && cd build
cmake ../
make clean && make
```
- Build Pythia for single/multi core using build script. This should create the executable inside
bindirectory.
bash
cd $PYTHIA_HOME
# ./build_champsim.sh <l1_pref> <l2_pref> <llc_pref> <ncores>
./build_champsim.sh multi multi no 1
Please use build_champsim_highcore.sh to build ChampSim for more than four cores.
Set appropriate environment variables as follows:
bash source setvars.sh
Preparing Traces
[Update: Dec 18, 2024] The trace will be downloaded in two phases: (1) all traces, except Ligra and PARSEC workloads, will be downloaded using the automated script, and (2) the Ligra and PARSEC traces needs to be downloaded manually from Zenodo repository mentioned below.
Use the
download_traces.plperl script to download all traces, except Ligra and PARSEC.bash mkdir $PYTHIA_HOME/traces/ cd $PYTHIA_HOME/scripts/ perl download_traces.pl --csv artifact_traces.csv --dir ../traces/Note: The script should download 138 traces. Please check the final log for any incomplete downloads.
Once the trace download completes, please verify the checksum as follows. Please make sure all traces pass the checksum test.
bash cd $PYTHIA_HOME/traces md5sum -c ../scripts/artifact_traces.md5Download the Ligra and PARSEC traces from these repositories:
- Ligra: https://doi.org/10.5281/zenodo.14267977
- PARSEC 2.1: https://doi.org/10.5281/zenodo.14268118
If the traces are downloaded in some other path, please change the full path in
experiments/MICRO21_1C.tlistandexperiments/MICRO21_4C.tlistaccordingly.
More Traces
- Our simulation infrastructure is completely compatible with all prior ChampSim traces used in CRC-2 and DPC-3. One can also convert the CVP-2 traces (courtesy of Qualcomm Datacenter Technologies) to ChampSim format using the following converter. The traces can be found in the follwing websites:
- CRC-2 traces: http://bit.ly/2t2nkUj
- DPC-3 traces: http://hpca23.cse.tamu.edu/champsim-traces/speccpu/
- CVP-2 traces: https://www.microarch.org/cvp1/cvp2/rules.html
Experimental Workflow
Our experimental workflow consists of two stages: (1) launching experiments, and (2) rolling up statistics from experiment outputs.
Launching Experiments
- To create necessary experiment commands in bulk, we will use
scripts/create_jobfile.pl create_jobfile.plrequires three necessary arguments:exe: the full path of the executable to runtlist: contains trace definitionsexp: contains knobs of the experiements to run
Create experiments as follows. Please make sure the paths used in tlist and exp files are appropriate.
bash cd $PYTHIA_HOME/experiments/ perl ../scripts/create_jobfile.pl --exe $PYTHIA_HOME/bin/perceptron-multi-multi-no-ship-1core --tlist MICRO21_1C.tlist --exp MICRO21_1C.exp --local 1 > jobfile.shGo to a run directory (or create one) inside
experiementsto launch runs in the following way:bash cd experiments_1C source ../jobfile.shIf you have slurm support to launch multiple jobs in a compute cluster, please provide
--local 0tocreate_jobfile.pl
Rolling-up Statistics
- To rollup stats in bulk, we will use
scripts/rollup.pl rollup.plrequires three necessary arguments:tlistexpmfile: specifies stat names and reduction method to rollup
Rollup statistics as follows. Please make sure the paths used in tlist and exp files are appropriate.
bash cd experiements_1C/ perl ../../scripts/rollup.pl --tlist ../MICRO21_1C.tlist --exp ../MICRO21_1C.exp --mfile ../rollup_1C_base_config.mfile > rollup.csvExport the
rollup.csvfile in you favourite data processor (Python Pandas, Excel, Numbers, etc.) to gain insights.
HDL Implementation
We also implement Pythia in Chisel HDL to faithfully measure the area and power cost. The implementation, along with the reports from umcL65 library, can be found the following GitHub repo. Please note that the area and power projections in the sample report is different than what is reported in the paper due to different technology.
Code Walkthrough
Pythia was code-named Scooby (the mistery-solving dog) during the developement. So any mention of Scooby anywhere in the code inadvertently means Pythia.
- The top-level files for Pythia are
prefetchers/scooby.ccandinc/scooby.h. These two files declare and define the high-level functions for Pythia (e.g.,invoke_prefetcher,register_fill, etc.). - The released version of Pythia has two types of RL engine defined: basic and featurewise. They differ only in terms of the QVStore organization (please refer to our paper to know more about QVStore). The QVStore for basic version is simply defined as a two-dimensional table, whereas the featurewise version defines it as a hierarchichal organization of multiple small tables. The implementation of respective engines can be found in
src/andinc/directories. inc/feature_knowledge.handsrc/feature_knowldege.ccdefine how to compute each program feature from the raw attributes of a deamand request. If you want to define your own feature, extend the enumFeatureTypeininc/feature_knowledge.hand define its correspondingprocessfunction.inc/util.handsrc/util.cccontain all hashing functions used in our evaluation. Play around with them, as a better hash function can also provide performance benefits.
Citation
If you use this framework, please cite the following paper:
@inproceedings{bera2021,
author = {Bera, Rahul and Kanellopoulos, Konstantinos and Nori, Anant V. and Shahroodi, Taha and Subramoney, Sreenivas and Mutlu, Onur},
title = {{Pythia: A Customizable Hardware Prefetching Framework Using Online Reinforcement Learning}},
booktitle = {Proceedings of the 54th Annual IEEE/ACM International Symposium on Microarchitecture},
year = {2021}
}
License
Distributed under the MIT License. See LICENSE for more information.
Contact
Rahul Bera - write2bera@gmail.com
Acknowledgements
We acklowledge support from SAFARI Research Group's industrial partners.
Owner
- Name: SAFARI Research Group at ETH Zurich and Carnegie Mellon University
- Login: CMU-SAFARI
- Kind: organization
- Email: omutlu@gmail.com
- Location: ETH Zurich and Carnegie Mellon University
- Website: https://safari.ethz.ch/
- Repositories: 97
- Profile: https://github.com/CMU-SAFARI
Site for source code and tools distribution from SAFARI Research Group at ETH Zurich and Carnegie Mellon University.
Citation (CITATION.cff)
cff-version: 1.2.0
message: "If you use our framework to evaluate Pythia, please cite the work as follows."
authors:
- family-names: "Bera"
given-names: "Rahul"
- family-names: "Kanellopoulos"
given-names: "Konstantinos"
title: "Pythia: A Customizable Hardware Prefetching Framework Using Online Reinforcement Learning"
version: 1.3
doi: 10.5281/zenodo.5520125
date-released: 2021-09-22
url: "https://github.com/CMU-SAFARI/Pythia"
preferred-citation:
title: "Pythia: A Customizable Hardware Prefetching Framework Using Online Reinforcement Learning"
type: proceedings
year: 2021
conference:
name: "54th International Symposium on Microarchitecture(MICRO)"
authors:
- family-names: "Bera"
given-names: "Rahul"
- family-names: "Kanellopoulos"
given-names: "Konstantinos"
- family-names: "Nori"
given-names: "Anant V."
- family-names: "Shahroodi"
given-names: "Taha"
- family-names: "Subramoney"
given-names: "Sreenivas"
- family-names: "Mutlu"
given-names: "Onur"
doi: "10.1145/3466752.3480114"
GitHub Events
Total
- Issues event: 4
- Watch event: 28
- Issue comment event: 6
- Push event: 3
- Pull request event: 2
- Fork event: 13
- Create event: 1
Last Year
- Issues event: 4
- Watch event: 28
- Issue comment event: 6
- Push event: 3
- Pull request event: 2
- Fork event: 13
- Create event: 1
Dependencies
- ExtUtils::MakeMaker 0