solprop.calibration#

Calibrating the native backend to its machine (SEP 46).

The native backend’s CPU execution settings (how each operation threads, how idle threads wait, how wide the team is) are fitted to the machine by a bounded, one-off measurement, kept in a per-user store and applied by every later run, which records the settings it used in its metadata (calibration). Without a profile the native backend runs its built-in table. This package’s own functions read, show, export, import and clear profiles without loading the native extension: MachineProfile, profile, store_directory, export_profile, import_profile, clear, and calibrate, which measures one.

Modules: controller (the measurement: children, rounds, deadline, publication), child (one candidate’s timing process), selection (the statistical rule), grain (operation-grain candidates), problems (the synthetic problems), first_use (calibrating on first use and for a scan), refine (fitting one simulation) and command (solprop calibrate). The manual page is docs/guide/performance/calibration.md; the design is docs/dev/backends.md (section 3.4a).

Modules

child

A calibration child: one candidate's process settings, timed on request (SEP 46).

command

solprop calibrate: measure, show, export, import or forget a profile (SEP 46).

controller

The calibration controller: children, rounds, a deadline and publication (SEP 46).

first_use

Calibrating automatically on first use (SEP 46 sections 5 and 6.10).

grain

Operation-grain candidates from the work sizes the calibration problems run (SEP 46).

problems

The calibration's synthetic problems (SEP 46 section 6.3).

refine

Stage 2: refine the workspace settings for one simulation (SEP 46 section 6.6).

selection

The calibration's statistical rule: which setting replaces the table (SEP 46).