GR-raytracing/benchmarks/psf_event_sink_reference.md

PSF event-sink image references

Run date: 2026-09-04

Purpose: fixed pixel-comparison references before replacing the sink consumer with HIP. The renderer used the default CPU PSF_EVENT_SINK=1 path. There was no adaptive refinement. The catalog is the repository test catalog, not an all-sky tile snapshot. This is not a performance benchmark.

Environment:

• Git HEAD: ab56e23 (worktree contains the uncommitted event-sink change)
• Build: BUILD_TYPE=Release, ENABLE_HDR=1, ENABLE_PNG=1, OpenMP
• Host worker setting: OMP_NUM_THREADS=16
• Images: 640 x 360 px; Moffat FWHM 2.7 px, beta 4.5
• Observer: radius 30, inward speed 0; ICRS look direction RA 1 deg, Dec 1 deg

The explicit 1e300 magnification cap is the practical command-line spelling of the normal unlimited default. --draw-mesh and --psf-direct are absent, therefore disabled. All refinement thresholds are included even though level zero prevents refinement, so later default changes cannot affect this run.

Minkowski

Build:

make -B SPACETIME=minkowski ENABLE_HDR=1 PSF_EVENT_SINK=1 backend

Render:

OMP_NUM_THREADS=16 build/Release/minkowski_sky --catalog assets/sky_grid_5deg.csv --output tests/data/psf_event_sink_reference/minkowski_ra1_dec1_640x360.png --hdr-output --width 640 --height 360 --fov-deg 30 --look-ra-deg 1 --look-dec-deg 1 --exposure 0.1 --observer-radius 30 --observer-inward-speed 0 --psf-fwhm-pixels 2.7 --psf-moffat-beta 4.5 --max-magnification 1e300 --max-cache-psf-flux 1 --psf-relative-tail 1e-8 --psf-min-y 0 --coarse-cell-pixels 16 --refine-max-level 0 --refine-angle-abs-deg 0.001 --refine-angle-rel 0.1 --refine-jacobian-min 1e-3 --refine-min-edge-pixels 0.5 --refine-min-area-pixels2 0.25 --catalog-load-workers 4

Result: 35 images from 5,654 catalog stars; 35 cached, 0 wing-clipped, 0 direct fallback, 0 min-Y discarded.

Versioned reference outputs:

• tests/data/psf_event_sink_reference/minkowski_ra1_dec1_640x360.png
• tests/data/psf_event_sink_reference/minkowski_ra1_dec1_640x360_HDR.fits

Analytic Schwarzschild

This reference uses a 60 deg horizontal field of view. At radius 30, the former 30 deg framing mostly contained the shadow and high-order images inside the Einstein ring, without enough field to test the first-image star field.

Build:

make -B SPACETIME=schwarzschild ENABLE_HDR=1 PSF_EVENT_SINK=1 backend

Render:

OMP_NUM_THREADS=16 build/Release/schwarzschild_sky --catalog assets/sky_grid_5deg.csv --output tests/data/psf_event_sink_reference/schwarzschild_ra1_dec1_fov60_640x360.png --hdr-output --width 640 --height 360 --fov-deg 60 --look-ra-deg 1 --look-dec-deg 1 --exposure 0.1 --observer-radius 30 --observer-inward-speed 0 --psf-fwhm-pixels 2.7 --psf-moffat-beta 4.5 --max-magnification 1e300 --max-cache-psf-flux 1 --psf-relative-tail 1e-8 --psf-min-y 0 --coarse-cell-pixels 16 --refine-max-level 0 --refine-angle-abs-deg 0.001 --refine-angle-rel 0.1 --refine-jacobian-min 1e-3 --refine-min-edge-pixels 0.5 --refine-min-area-pixels2 0.25 --catalog-load-workers 4

Result: 5,206 images from 5,654 catalog stars; 5,206 cached, 0 wing-clipped, 0 direct fallback, 0 min-Y discarded. This is a visual regression reference, not a performance result.

Versioned reference outputs:

• tests/data/psf_event_sink_reference/schwarzschild_ra1_dec1_fov60_640x360.png
• tests/data/psf_event_sink_reference/schwarzschild_ra1_dec1_fov60_640x360_HDR.fits