Actuators
Commands of the actuators chapter of the database, 12 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.
CREATE_NEW_ACTUATOR
Phase setup, layout inline. Manual: SRC-003 p.323.
SUBTYPE selects the thrust profile model and applies only to the PROPELLER type. CUSTOM imports a radial force distribution; ELLIPTICAL is specified by net thrust and RPM (SRC-003 p.185).
| Argument |
Specification |
type |
enum in |
subtype |
enum in {CUSTOM, ELLIPTICAL} (optional) |
name |
str |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.280, same grammar as 26.120 |
| 25.100 |
documented |
SRC-748 p.297, same grammar as 26.120 |
| 26.000 |
documented |
SRC-747 p.296, same grammar as 26.120 |
| 26.100 |
verified |
reports/compat/CMP-26100_2026-08-08_enableactuator.yaml |
| 26.101 |
documented |
SRC-725 p.322, same grammar as 26.120 |
| 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.327, unchanged from SRC-750 p.327 |
| 26.124 |
verified |
reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.327, the SRC-751 file, carried from 26.123 |
DELETE_ACTUATOR
Phase setup, layout inline. Manual: SRC-003 p.324.
| Argument |
Specification |
actuator_index |
int |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.282, same grammar as 26.120 |
| 25.100 |
documented |
SRC-748 p.298, same grammar as 26.120 |
| 26.000 |
documented |
SRC-747 p.297, same grammar as 26.120 |
| 26.100 |
documented |
SRC-741 p.319, same grammar as 26.120 |
| 26.101 |
documented |
SRC-725 p.323, same grammar as 26.120 |
| 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.328, unchanged from SRC-750 p.328 |
| 26.124 |
verified |
reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.328, the SRC-751 file, carried from 26.123 |
DISABLE_ACTUATOR
Phase setup, layout inline. Manual: SRC-741 p.319.
Disables an actuator disc without deleting it, the counterpart of ENABLE_ACTUATOR. DOCUMENTED BY THE FEBRUARY 2026 EDITION ALONE. No later edition prints it anywhere, which is why the entry carries one version row and cites SRC-741 rather than the flagship. It is the mirror image of SET_WAKE_DECAY_CONSTANT, which exists in the newest edition only. Its page prints the heading with NO placeholder and a parameter table reading N/A, while the sample two lines below passes an actuator index. That is the same contradiction the neighbouring ENABLE_ACTUATOR carries on the same page, and it is read the same way: the one-argument form is recorded, because recording zero would refuse the only runnable line the edition prints. Unlike ENABLE_ACTUATOR this one has NOT been measured against the solver, so the reading rests on the page and on its neighbour's probe.
| Argument |
Specification |
actuator_index |
int |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.282, same grammar as 26.100 |
| 25.100 |
documented |
SRC-748 p.298, same grammar as 26.100 |
| 26.000 |
documented |
SRC-747 p.297, same grammar as 26.100 |
| 26.100 |
documented |
SRC-741 p.319 |
ENABLE_ACTUATOR
Phase setup, layout inline. Manual: SRC-003 p.324.
FEBRUARY 2026 IS THE ONE EDITION WHOSE HEADING AND SAMPLE DISAGREE ABOUT WHETHER THIS COMMAND TAKES AN ARGUMENT. SRC-741 p.319 prints the bare name and a parameter table of N/A, and the sample beneath it passes an actuator index. Every later edition documents ACTUATOR_INDEX in the heading and the table. The one-argument form is recorded for that build too, and this is not a reading of the page: a probe on 2026-08-08 emitted it against the February solver and the script ran past it with no abort and no logged error. The status stays documented rather than verified because the enable flag is stored in binary form and no instrument observes it, so what is measured is that the ARGUMENT is accepted, not that the actuator was enabled. Recording zero arguments would have refused the only runnable line the edition prints, which is the defect class this database keeps finding, and would have made a call that works on three builds refused on the fourth on the strength of a table reading N/A. The neighbouring DISABLE_ACTUATOR carries the same N/A on the same page, so it is the page's habit rather than a statement about this command.
| Argument |
Specification |
actuator_index |
int |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.281, same grammar as 26.120 |
| 25.100 |
documented |
SRC-748 p.298, same grammar as 26.120 |
| 26.000 |
documented |
SRC-747 p.297, same grammar as 26.120 |
| 26.100 |
documented |
SRC-741 p.319 prints the heading with NO placeholder and a parameter table reading N/A, while its own sample passes an index. The one-argument form is recorded and was MEASURED on this build: reports/compat/CMP-26100_2026-08-08_enableactuator records the solver accepting it without abort or logged error. |
| 26.101 |
documented |
SRC-725 p.323, same grammar as 26.120 |
| 26.120 |
documented |
SRC-003 p.324 |
| 26.121 |
documented |
SRC-740 p.327, same grammar as 26.120 |
| 26.123 |
documented |
SRC-751 p.328, unchanged from SRC-750 p.328 |
| 26.124 |
documented |
SRC-752 p.328, the SRC-751 file, carried from 26.123; it ran on 26.124 without abort or logged error in reports/compat/CMP-26124_2026-09-14_full-sim.yaml, its effect not observable there (unprobed), so it stays documented |
SET_ACTUATOR_AXIS
Phase setup, layout inline. Manual: SRC-003 p.323.
Places the actuator disc on an axis of a local coordinate system (frame index greater than 1); the frame must exist before this call, which is the pre-solver definition discipline the builder enforces at M2.
| Argument |
Specification |
actuator_index |
int |
frame |
int |
axis |
enum in |
offset |
float [simulation length units] |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.280, same grammar as 26.120 |
| 25.100 |
documented |
SRC-748 p.297, same grammar as 26.120 |
| 26.000 |
documented |
SRC-747 p.296, same grammar as 26.120 |
| 26.100 |
documented |
SRC-741 p.318, same grammar as 26.120 |
| 26.101 |
documented |
SRC-725 p.322, same grammar as 26.120 |
| 26.120 |
documented |
SRC-003 p.323 |
| 26.121 |
verified |
reports/compat/CMP-26121_2026-08-08_savedstate2.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.327, unchanged from SRC-750 p.327 |
| 26.124 |
verified |
reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.327, the SRC-751 file, carried from 26.123 |
SET_ACTUATOR_NAME
Phase setup, layout inline. Manual: SRC-003 p.323.
| Argument |
Specification |
actuator_index |
int |
name |
str |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.280, same grammar as 26.120 |
| 25.100 |
documented |
SRC-748 p.297, same grammar as 26.120 |
| 26.000 |
documented |
SRC-747 p.296, same grammar as 26.120 |
| 26.100 |
documented |
SRC-741 p.318, same grammar as 26.120 |
| 26.101 |
documented |
SRC-725 p.322, same grammar as 26.120 |
| 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.327, unchanged from SRC-750 p.327 |
| 26.124 |
verified |
reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.327, the SRC-751 file, carried from 26.123 |
SET_ACTUATOR_RADIUS
Phase setup, layout inline. Manual: SRC-003 p.323.
| Argument |
Specification |
actuator_index |
int |
r_tip |
float [simulation length units] |
r_hub |
float [simulation length units] |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.280, same grammar as 26.120 |
| 25.100 |
documented |
SRC-748 p.297, same grammar as 26.120 |
| 26.000 |
documented |
SRC-747 p.296, same grammar as 26.120 |
| 26.100 |
documented |
SRC-741 p.318, same grammar as 26.120 |
| 26.101 |
documented |
SRC-725 p.322, same grammar as 26.120 |
| 26.120 |
documented |
SRC-003 p.323 |
| 26.121 |
verified |
reports/compat/CMP-26121_2026-08-08_savedstate2.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.327, unchanged from SRC-750 p.327 |
| 26.124 |
verified |
reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.327, the SRC-751 file, carried from 26.123 |
SET_ACTUATOR_WAKE_TYPE
Phase setup, layout inline. Manual: SRC-750 p.328.
Chooses whether a propeller actuator's wake holds its prescribed shape or relaxes onto the local flow. First documented by the 26.122 edition. The page states the actuator must be of the propeller type. Nothing here can check that: the actuator type is set by another command and the database records grammar, so passing the index of an actuator of another type is a refusal the solver makes and this emitter does not.
| Argument |
Specification |
actuator_index |
int |
type |
enum in |
| Version |
Status |
Evidence |
| 26.122 |
documented |
SRC-750 p.328, the first edition to document it |
| 26.123 |
documented |
SRC-751 p.328, unchanged from SRC-750 p.328 |
| 26.124 |
documented |
SRC-752 p.328, the SRC-751 file, carried from 26.123; not run on 26.124 |
SET_PROP_ACTUATOR_PROFILE
Phase setup, layout inline. Manual: SRC-003 pp.323-324.
Imports a custom radial thrust profile; the TXT file path follows on the line after the inline arguments. UNITS_TYPE gives the force unit used inside the file. THE FILE FORM 26.124 READS (RPT-070): two numbers per line, r and F separated by one comma, no header, no count line, and NO final newline, since every line is read as a point: a final newline adds one more, and the file is refused. A matrix row's run writes its own copy of the user's file in that form where the point runs and names the copy (G06).
| Argument |
Specification |
actuator_index |
int |
units_type |
enum in |
n_blades |
int |
file_name |
path |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.281, this edition's own grammar; see the note below |
| 25.100 |
documented |
SRC-748 p.298, this edition's own grammar; see the note below |
| 26.000 |
documented |
SRC-747 p.297, same grammar as 26.120 |
| 26.100 |
documented |
SRC-741 p.319, same grammar as 26.120 |
| 26.101 |
documented |
SRC-725 p.322, same grammar as 26.120 |
| 26.120 |
documented |
SRC-003 pp.323-324 |
| 26.121 |
documented |
SRC-740 p.326, same grammar as 26.120 |
| 26.123 |
documented |
SRC-751 p.327, unchanged from SRC-750 p.327 |
| 26.124 |
documented |
SRC-752 p.327, the SRC-751 file, carried from 26.123; ran on 26.124 under a licensed probe (reports/RPT-070_the-gui-rows-volume-section-and-actuator-disc_2026-09-24.md): eleven rows r,F ending in a final newline were read as twelve points, the log said the solver failed to read the custom radial thrust profile file, and a modal dialog refused the file and held the run until a person closed it; a count or a header line first was read as one point more and every value read as zero; CR LF line ends, a space or tab separator and a dimensional radius changed nothing; the same eleven rows with NO final newline were read as eleven points, with no dialog and no refusal logged, and the saved simulation carries the radii and forces |
SET_PROP_ACTUATOR_RPM
Phase setup, layout inline. Manual: SRC-003 p.323.
Sign selects the rotation direction about the actuator axis.
| Argument |
Specification |
actuator_index |
int |
rpm |
float [rev/min] |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.281, same grammar as 26.120 |
| 25.100 |
documented |
SRC-748 p.297, same grammar as 26.120 |
| 26.000 |
documented |
SRC-747 p.296, same grammar as 26.120 |
| 26.100 |
documented |
SRC-741 p.318, same grammar as 26.120 |
| 26.101 |
documented |
SRC-725 p.322, same grammar as 26.120 |
| 26.120 |
documented |
SRC-003 p.323 |
| 26.121 |
verified |
reports/compat/CMP-26121_2026-08-08_savedstate2.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.327, unchanged from SRC-750 p.327 |
| 26.124 |
verified |
reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.327, the SRC-751 file, carried from 26.123 |
SET_PROP_ACTUATOR_SWIRL
Phase setup, layout inline. Manual: SRC-003 p.324.
Fraction between 0 and 1 of the swirl velocity kept downstream; values below 1 mimic a stator de-swirling the slipstream (SRC-003 p.186).
| Argument |
Specification |
actuator_index |
int |
swirl_factor |
float |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.281, same grammar as 26.120 |
| 25.100 |
documented |
SRC-748 p.298, same grammar as 26.120 |
| 26.000 |
documented |
SRC-747 p.297, same grammar as 26.120 |
| 26.100 |
documented |
SRC-741 p.319, same grammar as 26.120 |
| 26.101 |
documented |
SRC-725 p.323, same grammar as 26.120 |
| 26.120 |
documented |
SRC-003 p.324 |
| 26.121 |
verified |
reports/compat/CMP-26121_2026-08-08_savedstate2.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.328, unchanged from SRC-750 p.328 |
| 26.124 |
verified |
reports/compat/CMP-26124_2026-09-14_full-sim.yaml; SRC-752 p.328, the SRC-751 file, carried from 26.123 |
SET_PROP_ACTUATOR_THRUST
Phase setup, layout inline. Manual: SRC-003 p.324.
Net thrust of the disc. The manual warns to verify that the coefficient convention matches the solver formulation and recommends dimensional thrust to avoid ambiguity (SRC-003 p.187).
| Argument |
Specification |
actuator_index |
int |
ct |
float |
thrust_type |
enum in |
| Version |
Status |
Evidence |
| 25.000 |
documented |
SRC-749 p.281, same grammar as 26.120 |
| 25.100 |
documented |
SRC-748 p.298, same grammar as 26.120 |
| 26.000 |
documented |
SRC-747 p.297, same grammar as 26.120 |
| 26.100 |
documented |
SRC-741 p.319, same grammar as 26.120 |
| 26.101 |
documented |
SRC-725 p.323, same grammar as 26.120 |
| 26.120 |
documented |
SRC-003 p.324 |
| 26.121 |
documented |
SRC-740 p.327, same grammar as 26.120 |
| 26.123 |
documented |
SRC-751 p.328, unchanged from SRC-750 p.328 |
| 26.124 |
documented |
SRC-752 p.328, the SRC-751 file, carried from 26.123; it ran on 26.124 without abort or logged error in reports/compat/CMP-26124_2026-09-14_full-sim.yaml, its effect not observable there (unprobed), so it stays documented |