MATLAB post-processing companion for the Q-less randomized QR (CQRRT) least-squares work in
RandLAPACK: campaign plotting for the FEM2
iteratively-refined LSQ, Toeplitz LS, rspec, and diagnostic benchmark families, plus the FEM
test-matrix generators. The C++ benchmarks themselves live in RandLAPACK
(benchmark/bench_CQRRT/); results are produced on a cluster and staged into results/
here for plotting.
run_all.m (MATLAB) is the plotting entry point. It renders every configured
campaign era into tabbed figure groups and exports each tab as a PDF into figures/,
wiping all prior PDFs first so figures/ always holds exactly the current run. Campaign
eras are declared in descriptor tables at the top of the script and are marked in the figure
name, tab title, in-plot super-title, and PDF filename prefix. Read the header block before
adding a campaign: wall-clock comparability caveats across hardware eras are documented
there.
Test matrices are generated by utils/gen_fem2_*.m (PDE Toolbox required for some) into
matrices/ (not in git; regeneration commands are in .gitignore). tests/ contains the
generator verification script.
All BallisticLA benchmark repos share one layout convention (folder roles are fixed; file names within folders may vary):
| Folder | Role |
|---|---|
plotting/ |
Plot drivers (plot_*_results.m) and helpers (aggregate_runs.m, ...) |
results/ |
Campaign outputs staged from the cluster (<family>_<era>/<cell>/...csv) |
figures/ |
Exported PDFs (regenerated on every run_all.m run) |
matrices/ |
Generated FEM/Toeplitz test matrices, ~2.8 GB (not tracked; regenerable) |
utils/ |
Matrix generators, fem_gen/ FEM machinery, misc scripts |
tests/ |
Generator verification |
archive/YYYY-MM-DD-<reason>/ |
Retired material (created on first use) |
run_all.m |
Plotting entry point |
Data policy: this repo is code-only while campaigns are active — results/ and
figures/ are not tracked (raw data lives on the cluster and in local working trees). When
a campaign freezes for a paper, its final results are committed deliberately as the
permanent record.