This repository contains the VRS motion quality dataset, source code for CaMoJAB metric and ALSaRR method described in our SIGGRAPH paper:
Akshay Jindal, Krzysztof Wolski, Karol Myszkowski and Rafał K. Mantiuk. 2021. Perceptual Model for Adaptive Local Shading and Refresh Rate. ACM Trans. Graph. (Proc. of SIGGRAPH Asia 2021), 40, 6, Article 280 (December 2021), 18 pages. https://doi.org/10.1145/3478513.3480514
The paper and videos can be found on the project web page: https://www.cl.cam.ac.uk/research/rainbow/projects/alsarr/
Repository structure (see individual file for usage and dependencies):
CaMoJAB/
| File | Description |
|---|---|
| camojab.m | content-aware motion quality metric |
| camojab_fits.mat | prefitted metric parameters |
| model_Dst.m | core logic of camojab metric |
| sample_texture.png | Sample image for example |
| example.m | example usage of camojab metric |
| fits/train_camojab.m | Paper Figure 7(a-b) |
| fits/test_camojab.m | Paper Figure 7(c) |
| fits/ablation_camojab.m | Supplementary Table 1 |
| paper_plots/plot_luminance_vs_persistence.m | Paper Figure 9 |
| paper_plots/plot_ppd_vs_fps_vs_vel.m | Paper Figure 8(b) |
| paper_plots/plot_ppd_vs_vel_vs_fps.m | Paper Figure 8(a) |
ALSaRR/
| File | Description |
|---|---|
| adaptive_fps.m | (example) calculate optimal fps vs vel LUT |
| adaptive_vrs.m | (example) calculate optimal VRS map |
| vrs_dp.m | optimal solution to VRS knapsack problem |
| vrs_greedy.m | near optimal solution to VRS knapsack problem |
| polyfit_quality.m | (example) how to fit polynomial to camojab |
| sample_data/ | sample data for above scripts |
Experiment_data/
| File | Description |
|---|---|
| vrs_exp_data.csv | Pairwise comparision data from Experiment 1 |
| scale_pwc2jnd.m | Script to scale data to JND units |
| vrs_exp_data_jnd.mat | PWC data scaled to JND |
| vrs_exp_stimulus.mat | Textures used in the experiment |
| alsarr_validation_experiment.csv | Validation experiment results |
| external_data/marrr_exp1_jnds.mat | Data from [Denes et al. 2020] Experiment 1 |
| external_data/marrr_exp3_jnds.mat | Data from [Denes et al. 2020] Experiment 3 |
Utils/: collection of helper functions