What is Cool-3D
Quick Start
Tutorials
How to Cite

Cool-3D is an end-to-end thermal-aware framework built for early-phase design space exploration (DSE) of microfluidic cooling equipped 3DICs. It is built on top of mainstream computer architecture simulators gem5, McPAT, CACTI, and HotSpot. Given architectural, stacking, thermal related information as inputs, this framework will efficiently output thermal traces with visualization results.

1. Install all the dependencies listed in gem5 dependencies
2. Install SuperLU library for quick HotSpot steady simulation by

   apt-get install libsuperlu-dev

3. Install python packages

   pip install -r requirements.txt

1. Clone this repo and all the submodules

   git clone --recurse-submodules https://github.com/iCAS-SJTU/Cool-3D.git

2. Setup environment variables

   cd Cool-3D
   source setenv.sh

   Notice that every time you start a new terminal you will need to rerun this command. You can also add the commands in setenv.sh to your shell configuration file to save this effort.

3. Build all the simulators

   source build.sh

If you have Splash2 benchmark downloaded and compiled in your host, you can run

python3 scripts/run_design.py --input-file=examples/example_0/inputs.yaml

If not, you can simply run a hello-world program to test whether Cool-3D is build successfully

python3 scripts/run_design.py --input-file=examples/example_0/inputs-hello.yaml

Coming Soon:)

Please use our dedicated template to file bug reports. This helps us diagnose issues faster.

If you use this code, please cite:

Wang, R., Wang, Z., Lin, T., Raby, J. M., Stan, M. R., & Guo, X. (2025). Cool-3D: An End-to-End Thermal-Aware Framework for Early-Phase Design Space Exploration of Microfluidic-Cooled 3DICs. arXiv preprint arXiv:2503.07297.

  @article{wang2025cool,
     title={Cool-3D: An End-to-End Thermal-Aware Framework for Early-Phase Design Space Exploration of Microfluidic-Cooled 3DICs},
     author={Wang, Runxi and Wang, Ziheng and Lin, Ting and Raby, Jacob M and Stan, Mircea R and Guo, Xinfei},
     journal={arXiv preprint arXiv:2503.07297},
     year={2025}
  }