Sweeper¶
Commands of the sweeper chapter of the database, 10 entries. The status words are defined once, on the compatibility matrix, which says what each rests on and what the script builder does with it. Read it before this page: broken and removed are refusals, so a row here can be telling you the emitter will not write that command for that version.
EXECUTE_SOLVER_SWEEPER¶
Phase exec, layout param_lines. Manual: SRC-741 p.354.
Configures and runs a whole parameter sweep in ONE command, where the SWEEPER_ family of later editions splits the same job across ten. DOCUMENTED BY THE FEBRUARY 2026 EDITION ALONE, so one version row and a citation of SRC-741. It is the largest such command in the database, twenty-one parameters, and it is the clearest evidence that the sweeper was redesigned between February and May rather than extended: nothing in the SWEEPER_ family has this shape. THE VELOCITY SWEEP HAS TWO SPELLINGS AND THE MANUAL PRINTS BOTH SAMPLES. The parameter rows read VELOCITY_START / MACH_START and so on, one pair of keywords per limit, and the two samples use one set each. Both are optional here and nothing refuses passing both: the page states the alternation without saying what the solver does when given both, and a refusal would be this database inventing the rule. The VELOCITY toggle above governs whichever is used, so it does not resolve the choice either. TWO PATHS ARE WRITTEN AS BARE LINES, in different places. The first follows EXPORT_SURFACE_DATA_PER_STEP and is a FOLDER for the per-step boundary data, omitted when that parameter is DISABLE, which the manual states in its row. The second is the last line of the block and is the sweep results FILE. A reader seeing two unlabelled paths cannot tell them apart by shape, only by position.
| Argument | Specification |
|---|---|
angle_of_attack |
enum in |
side_slip_angle |
enum in |
velocity |
enum in |
angle_of_attack_start |
float [deg] |
angle_of_attack_stop |
float [deg] |
angle_of_attack_delta |
float [deg] |
side_slip_angle_start |
float [deg] |
side_slip_angle_stop |
float [deg] |
side_slip_angle_delta |
float [deg] |
velocity_start |
float [simulation velocity units] (optional) |
velocity_stop |
float [simulation velocity units] (optional) |
velocity_delta |
float [simulation velocity units] (optional) |
mach_start |
float (optional) |
mach_stop |
float (optional) |
mach_delta |
float (optional) |
export_surface_data_per_step |
enum in |
export_folder |
path (optional) |
clear_solution_after_each_run |
enum in |
reference_velocity_equals_freestream |
enum in |
append_to_existing_sweep |
enum in |
file |
path |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.319, same grammar as 26.100 |
| 25.100 | documented | SRC-748 p.332, same grammar as 26.100 |
| 26.000 | documented | SRC-747 p.331, same grammar as 26.100 |
| 26.100 | documented | SRC-741 p.354 |
SWEEPER_CLEAR_SOLUTION¶
Phase init, layout inline. Manual: SRC-003 p.359.
Controls solution reuse between sweep runs. The manual gives it a sample and no parameter table, so the two tokens are read from the signature placeholder and the sample rather than from prose.
| Argument | Specification |
|---|---|
mode |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.101 | documented | SRC-725 p.358, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.359 |
| 26.121 | documented | SRC-740 p.362, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.365, unchanged from SRC-750 p.365 |
| 26.124 | documented | SRC-752 p.365, the SRC-751 file, carried from 26.123; not run on 26.124 |
SWEEPER_EXPORT_SPREADSHEET¶
Phase export, layout inline. Manual: SRC-003 p.359.
| Argument | Specification |
|---|---|
filename |
path |
| Version | Status | Evidence |
|---|---|---|
| 26.101 | verified | reports/compat/CMP-26101_2026-08-08_full.yaml |
| 26.120 | verified | reports/compat/CMP-26120_2026-08-08_full.yaml |
| 26.121 | verified | reports/compat/CMP-26121_2026-08-08_full.yaml |
| 26.122 | verified | reports/compat/CMP-26122_2026-08-11_full.yaml |
| 26.123 | verified | reports/compat/CMP-26123_2026-08-17_full-sim.yaml; SRC-751 p.365, unchanged from SRC-750 p.365 |
| 26.124 | verified | reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.365, the SRC-751 file, carried from 26.123 |
SWEEPER_POST_RUN_SCRIPT¶
Phase init, layout inline. Manual: SRC-003 p.359.
Per-run post-processing script executed after each sweep point, for example a surface section extraction script. The path is omissible under DISABLE, which the parameter table states.
| Argument | Specification |
|---|---|
mode |
enum in |
script_path |
path (optional) |
| Version | Status | Evidence |
|---|---|---|
| 26.101 | verified | reports/compat/CMP-26101_2026-08-08_full.yaml |
| 26.120 | verified | reports/compat/CMP-26120_2026-08-08_full.yaml |
| 26.121 | verified | reports/compat/CMP-26121_2026-08-08_full.yaml |
| 26.122 | verified | reports/compat/CMP-26122_2026-08-11_full.yaml |
| 26.123 | verified | reports/compat/CMP-26123_2026-08-17_full-sim.yaml; SRC-751 p.365, unchanged from SRC-750 p.365 |
| 26.124 | verified | reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.365, the SRC-751 file, carried from 26.123 |
SWEEPER_REF_VELOCITY_SAME¶
Phase init, layout inline. Manual: SRC-003 p.360.
Keeps the reference velocity equal to the free-stream velocity at every sweep point. The 26.121 abort recorded above now has a documentary counterpart: SRC-740 documents no such command at all, while SRC-725 p.359 and SRC-003 p.360 both do. The probe measured the behaviour and the manual explains it, which is a stronger record than either alone; the status stays broken because that is what was measured, and only a probe promotes it.
| Argument | Specification |
|---|---|
mode |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.101 | documented | SRC-725 p.359, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.360 |
| 26.121 | broken | reports/compat/CMP-26121_2026-08-08_full.yaml; script processing aborted at the command: the log exported before it exists, the one after it never appeared (END sentinel missing) |
| 26.122 | removed | SRC-750 pp.283-383, the scripting reference of the 26.122 edition, does not print this command anywhere, AND THAT EDITION'S INDEX DISAGREES WITH ITS OWN BODY: The Script Index at pp.384-390 of the same document still names it, and does not name any replacement. The body is the reading recorded here, on the rule that a signature heading is what a script is written from and an index entry is a pointer to one; an index that lags its own body is a defect of that document rather than a second opinion about the solver. The index is incomplete in BOTH directions and neither half of it carries much: counted over the ten commands this edition is the first to document, five are in it and five are not, and it keeps four of the seven names this edition stops printing relative to 26.120, plus at least one token that is no command at all, SOLVER_INITIALIZATION. Read the four with that scope: counted without it the kept names are five, DISABLE_ACTUATOR having left the body at 26.101 and stayed in the index. So the body wins here on the rule and not on any property of this index. A first draft of this note said the index was maintained by addition, which was one observation generalised and the count refutes it. THIS ROW EXISTS BECAUSE INHERITANCE WOULD SAY THE OPPOSITE. 26.122 inherits from the base release 26.120, not from the sibling hotfix, so without a row here the emitter would resolve 26.120's documented record and write a command that the 26.121 row above records as broken, its script aborting at that line. That row is about 26.121 and this one is not, which is why it carries no report of its own and rests on the edition's silence; silence alone is the weakest of the three routes to this status, and it is still a better answer than the opposite one inheritance would give. |
SWEEPER_SET_AOA_SWEEP¶
Phase init, layout inline. Manual: SRC-003 p.358.
Angle of attack axis of the sweeper. Three modes with three different tails: UNIFORM takes exactly three numbers, CUSTOM takes either the value list inline or the path of a file holding it, and DISABLE takes nothing. NOTHING ENFORCES THAT PAIRING, and this note said the sweep helper did until 2026-08-06, which was false in a place a reader consults. Both tails are declared optional because ArgSpec has
requiredand no conditional, so the emitter accepts UNIFORM with no tail, UNIFORM with two numbers of three, DISABLE with a tail, and CUSTOM with both tails at once. Every one of those is decidable from the bound mode and none of them is decided; they reach the solver (PLN-20260806-1100). Stated rather than implied, because the equivalent gap on NEW_CCS_WING_CONTROL_SURFACE is written down the same way and a claim of enforcement is worse than an admitted gap. THE THIRD UNIFORM NUMBER IS AN INCREMENT, not a count of points, although the parameter table labels the triple START/STOP/STEPS: the sibling Mach command's own sample passes 0.05 there (SRC-003 p.359), which no count can be, the toolbox narrative calls it the increment (SRC-003 p.266), and the 26.100 predecessor API named the same field DELTA (SRC-741 p.354). Whether the stop value is inclusive is not stated anywhere and is not assumed here.
| Argument | Specification |
|---|---|
mode |
enum in |
values |
float_list [deg] (optional) |
filename |
path (optional) |
| Version | Status | Evidence |
|---|---|---|
| 26.101 | verified | reports/compat/CMP-26101_2026-08-08_full.yaml |
| 26.120 | verified | reports/compat/CMP-26120_2026-08-08_full.yaml |
| 26.121 | verified | reports/compat/CMP-26121_2026-08-08_full.yaml |
| 26.122 | verified | reports/compat/CMP-26122_2026-08-11_full.yaml |
| 26.123 | verified | reports/compat/CMP-26123_2026-08-17_full-sim.yaml; SRC-751 p.364, unchanged from SRC-750 p.364 |
| 26.124 | verified | reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.364, the SRC-751 file, carried from 26.123 |
SWEEPER_SET_BETA_SWEEP¶
Phase init, layout inline. Manual: SRC-003 p.358.
Side-slip axis of the sweeper, with the grammar of SWEEPER_SET_AOA_SWEEP above and the same reading of its third UNIFORM number.
| Argument | Specification |
|---|---|
mode |
enum in |
values |
float_list [deg] (optional) |
filename |
path (optional) |
| Version | Status | Evidence |
|---|---|---|
| 26.101 | verified | reports/compat/CMP-26101_2026-08-08_full.yaml |
| 26.120 | verified | reports/compat/CMP-26120_2026-08-08_full.yaml |
| 26.121 | verified | reports/compat/CMP-26121_2026-08-08_full.yaml |
| 26.122 | verified | reports/compat/CMP-26122_2026-08-11_full.yaml |
| 26.123 | verified | reports/compat/CMP-26123_2026-08-17_full-sim.yaml; SRC-751 p.364, unchanged from SRC-750 p.364 |
| 26.124 | verified | reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.364, the SRC-751 file, carried from 26.123 |
SWEEPER_SET_MACH_SWEEP¶
Phase init, layout inline. Manual: SRC-003 p.359.
Mach number axis of the sweeper, dimensionless. Absent from this database until 2026-08-06 for the same reason the UNIFORM mode was: the worked example the chapter was drafted from sweeps angle of attack, side-slip and velocity, and never Mach. Its sample is the one that settles what the third UNIFORM number means, since 0.05 cannot be a number of steps. Whether a velocity sweep and a Mach sweep can be enabled together, and which wins, is not documented.
| Argument | Specification |
|---|---|
mode |
enum in |
values |
float_list (optional) |
filename |
path (optional) |
| Version | Status | Evidence |
|---|---|---|
| 26.101 | documented | SRC-725 p.358, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.359 |
| 26.121 | documented | SRC-740 p.362, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.365, unchanged from SRC-750 p.365 |
| 26.124 | documented | SRC-752 p.365, the SRC-751 file, carried from 26.123; not run on 26.124 |
SWEEPER_SET_VELOCITY_SWEEP¶
Phase init, layout inline. Manual: SRC-003 p.358.
Free-stream velocity axis of the sweeper. It used to declare the file path alone, which made it the one axis that could not take an inline list; the manual gives all four axes the same table and the same three samples, so the asymmetry came from the worked example this chapter was first read from and not from the grammar. The unit is this repository's convention rather than a manual statement: SRC-003 p.358 names none, and whether the axis follows the solver's configured velocity unit is a probe question.
| Argument | Specification |
|---|---|
mode |
enum in |
values |
float_list [m/s] (optional) |
filename |
path (optional) |
| Version | Status | Evidence |
|---|---|---|
| 26.101 | documented | SRC-725 p.357, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.358 |
| 26.121 | documented | SRC-740 p.361, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.364, unchanged from SRC-750 p.364 |
| 26.124 | documented | SRC-752 p.364, the SRC-751 file, carried from 26.123; not run on 26.124 |
SWEEPER_START¶
Phase exec, layout bare. Manual: SRC-003 p.360.
| Version | Status | Evidence |
|---|---|---|
| 26.101 | verified | reports/compat/CMP-26101_2026-08-08_full.yaml |
| 26.120 | verified | reports/compat/CMP-26120_2026-08-08_full.yaml |
| 26.121 | verified | reports/compat/CMP-26121_2026-08-08_full.yaml |
| 26.122 | verified | reports/compat/CMP-26122_2026-08-11_full.yaml |
| 26.123 | verified | reports/compat/CMP-26123_2026-08-17_full-sim.yaml; SRC-751 p.366, unchanged from SRC-750 p.366 |
| 26.124 | verified | reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.366, the SRC-751 file, carried from 26.123 |