Getting Started for ASPLOS 2023 Tutorial

From Source Code

Install Prerequisites

Please install dependencies shown below, according to your operating system.

Debian/Ubuntu

Using apt.

# For ASTRA-sim
sudo apt -y install \
    vim gcc g++ make cmake \
    libboost-dev libboost-program-options-dev \
    python3 python3-pip git csh

# For Plotting in Exercises
pip3 install --upgrade pip
pip3 install pandas matplotlib seaborn

macOS

Using homebrew.

# For ASTRA-sim
brew install boost cmake coreutils

# For Plotting in Exercises
brew install python3
pip3 install --upgrade pip
pip3 install pandas matplotlib seaborn

Windows

Please use Windows Subsystem for Linux. WSL

Clone ASTRA-sim Tutorial

git clone https://github.com/astra-sim/tutorials.git

Clone ASTRA-sim

cd tutorials/asplos2023
./clone_astra_sim.sh

Build ASTRA-sim (analytical backend)

./build_analytical.sh

Build ASTRA-sim (congestion-aware analytical backend)

./build_congestion.sh

Run Exercise 1-1

./exercise_1/exercise_1-1.sh

When execution fails, please check if ASTRA-sim is successfully compiled.

From Prebuilt Docker Image

Pull Docker Image

docker pull astrasim/tutorial-asplos2023

Run Container

docker run -it astrasim/tutorial-asplos2023

Build ASTRA-sim (analytical backend)

./build_analytical.sh

Build ASTRA-sim (congestion-aware analytical backend)

./build_congestion.sh

Run Exercise 1-1

./exercise_1/exercise_1-1.sh