Files
Raptor/artifact/README.md
T
Niccolò Nicolosi 66db4b66da
Validate Operations / validate-operations (push) Has been cancelled
add paper artifact
2026-11-03 14:37:25 +01:00

33 lines
1.3 KiB
Markdown

# Raptor paper artifact
Raptor is fixed to commit `4a1fe710b2f0e4e9c0504f4fd9b4c4dd3df53b7d`.
Requires Docker on Linux or WSL2. The build downloads dependencies and uses Clang 19 and mold.
Install the host dependencies:
```bash
sudo apt install -y docker.io docker-cli docker-buildx git
sudo systemctl enable --now docker
sudo usermod -aG docker "$USER"
newgrp docker
```
Log out and back in, then run from this directory:
```bash
bash artifact.sh build
bash artifact.sh reproduce
```
Open `results/full/index.html` to view the plots and result tables.
The page also links to the CSV files and logs. Failed numerical validation remains visible in the results.
For a small VGG8 run, use `bash artifact.sh smoke` and open `results/smoke/index.html`.
Build jobs, run jobs, and threads per job default to the available logical processor count.
Override with `BUILD_JOBS`, `JOBS`, and `THREADS_PER_JOB`, or run `bash artifact.sh reproduce --jobs 8 --threads-per-job 4`.
For another run, set `OUTPUT_DIR` to a new directory.
To prepare the paper attachment, run `bash artifact/artifact.sh package` from the repository root.
The archive is written to `artifact/dist/` and includes the pinned sources and models.
Updated scheduling code is included separately; compiler and simulator sources stay pinned.