Plots¶
Commands of the plots chapter of the database, 2 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.
SAVE_PLOT_TO_FILE¶
Phase export, layout inline. Manual: SRC-003 p.361.
Writes the plot currently shown to a text file, the path on the next line. It takes no plot type, so which plot is written depends on the last SET_PLOT_TYPE, or on whatever the application was showing if the script never set one. WHAT THE FILE HOLDS, measured on 26.124 (RPT-067): the plotted SERIES as text, not an image. The run header the loads export prints, the column names, then one row per point of the plot (for RESIDUALS and LOADS, one per solver iteration; for SECTIONS_CP, one x/Cp column pair per section), then the units footer. The solver prints nothing when it saves. A PLOT IS A DISPLAY OF THE SOLVE AND NEVER A SOURCE OF A COEFFICIENT: the last plotted lift equalled the exported CL, the plotted induced drag was close to the exported CDi without equalling it, and the plotted pitching moment (-0.897) was not the exported CMy (-0.0247) at all. The run wrote to an absolute path; a save before a solve, and a path whose folder does not exist, were not tried.
| Argument | Specification |
|---|---|
file |
path |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.320, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.333, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.332, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.355, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.360, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.361 |
| 26.121 | documented | SRC-740 p.364, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.367, unchanged from SRC-750 p.367 |
| 26.124 | verified | reports/compat/CMP-26124_2026-09-24_plots.yaml; SRC-752 p.367, the SRC-751 file, carried from 26.123 |
SET_PLOT_TYPE¶
Phase export, layout inline. Manual: SRC-003 p.361.
Selects which plot the pane shows. THE MANUAL PRINTS THE VALUES AS PARAMETER ROWS RATHER THAN AS A CLOSED SET, one row per token with N/A in the value column, so this reads at a glance as a command with 23 parameters. It has one argument taking one of 23 tokens, which is what the sample passing a single token shows. Twenty-three, not twenty-four: RESIDUALS is printed TWICE in the list, in the four editions read then. A duplicate in a closed set is dropped rather than recorded, there being nothing a second identical token could mean. The eighteen AXIS tokens pair one of six coefficients with one of three axes, which is why CL_AXIS_X and CL_AXIS_Y are two plots of one coefficient rather than two coefficients. RUN ON 26.124 WITH THREE OF THE 23 (RPT-067, 2026-09-24): RESIDUALS, LOADS and SECTIONS_CP, each followed by SAVE_PLOT_TO_FILE after the exports of a solved steady point. The other twenty tokens were not run on any build.
| Argument | Specification |
|---|---|
plot_type |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.320, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.333, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.332, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.355, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.360, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.361 |
| 26.121 | documented | SRC-740 p.364, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.367, unchanged from SRC-750 p.367 |
| 26.124 | verified | reports/compat/CMP-26124_2026-09-24_plots.yaml; SRC-752 p.367, the SRC-751 file, carried from 26.123 |