Mesh operations¶
Commands of the mesh_operations chapter of the database, 23 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_SURFACE_FROM_SELECTION¶
Phase geometry, layout bare. Manual: SRC-003 p.311.
Promotes the currently selected faces into a surface of their own, which is what makes SURFACE_SELECT_BY_THRESHOLD useful as more than a highlight. It takes no argument because the selection is the state it reads.
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.265, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.285, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.284, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.306, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.310, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.311 |
| 26.121 | documented | SRC-740 p.314, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.314, unchanged from SRC-750 p.314 |
| 26.124 | documented | SRC-752 p.314, the SRC-751 file, carried from 26.123; not run on 26.124 |
DELETE_DEGENERATE_FACES¶
Phase geometry, layout bare. Manual: SRC-003 p.313.
Deletes every degenerate face in the simulation. What counts as degenerate is not defined on the page, and this entry does not guess; it acts on the whole model rather than on a selection.
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.268, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.287, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.286, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.308, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.312, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.313 |
| 26.121 | documented | SRC-740 p.316, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.317, unchanged from SRC-750 p.317 |
| 26.124 | documented | SRC-752 p.317, the SRC-751 file, carried from 26.123; not run on 26.124 |
DELETE_SELECTED_FACES¶
Phase geometry, layout bare. Manual: SRC-003 p.312.
Deletes the faces currently selected, the destructive counterpart of CREATE_NEW_SURFACE_FROM_SELECTION and the other reason the threshold selection exists.
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.267, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.287, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.286, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.308, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.311, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.312 |
| 26.121 | documented | SRC-740 p.315, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.316, unchanged from SRC-750 p.316 |
| 26.124 | documented | SRC-752 p.316, the SRC-751 file, carried from 26.123; not run on 26.124 |
ROTATE_SURFACE¶
Phase setup, layout payload_lines. Manual: SRC-750 p.313.
Rotates surfaces about an axis of the named frame. First documented by the 26.122 edition, which is also the first to stop printing SURFACE_ROTATE. IT IS NOT THAT COMMAND UNDER A NEW NAME, which is why it is entered as its own command rather than recorded as a rename. SURFACE_ROTATE is a keyword block of eight arguments; this takes six, five of them on the command line and the surface indices on the line after it, which is the payload_lines layout rather than the inline one. SPLIT_VERTICES and ADAPTIVE_MESH have no equivalent here, and whether DETACH_NORMAL_TO_AXIS and this command's DETACH_VERTICES are one option renamed is read from their position on the page and is not measured, so a script porting forward loses two options for certain and possibly three, rather than changing a word. SURFACES is a COUNT and not an index, followed by the indices on the next line, and -1 selects every surface and takes no index line at all. It is spelled in the plural, unlike the manual's own SURFACE placeholder and unlike the sibling TRANSLATE_SURFACE_IN_FRAME, where the same word is a single index: the emitter checks a count against the list it introduces only for a recognised count spelling, and the singular is already in use for the other meaning on the same page. The 26.121 entry for the older command spells this same count the same way.
| Argument | Specification |
|---|---|
frame |
int |
axis |
enum in |
angle |
float [deg] |
surfaces |
int |
detach_vertices |
enum in |
surface_indices |
int_list (optional) |
| Version | Status | Evidence |
|---|---|---|
| 26.122 | documented | SRC-750 p.313, the first edition to document it |
| 26.123 | documented | SRC-751 p.313, unchanged from SRC-750 p.313 |
| 26.124 | documented | SRC-752 p.313, the SRC-751 file, carried from 26.123; not run on 26.124 |
SELECT_GEOMETRY_BY_ID¶
Phase geometry, layout inline. Manual: SRC-741 p.305.
The February 2026 spelling of SURFACE_SELECT_BY_ID above, documented in that edition alone and in none after it. Recorded rather than dropped because 26.100 is a registered build and a script written for it needs the name that edition documents. Its status is documented and not removed, deliberately: this database promotes a command to removed when a manual STATES the removal, and no edition states one here. What happened is that the name stopped appearing, which is a weaker fact and is recorded as the absence of later version rows.
| Argument | Specification |
|---|---|
surface |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.265, same grammar as 26.100 |
| 25.100 | documented | SRC-748 p.284, same grammar as 26.100 |
| 26.000 | documented | SRC-747 p.283, same grammar as 26.100 |
| 26.100 | documented | SRC-741 p.305 |
SELECT_MESH_NODE¶
Phase geometry, layout inline. Manual: SRC-003 p.313.
Selects one mesh vertex by its node id, which is a different index space from the surface indices the rest of this chapter uses: the manual says node ID and nothing about its base, so this entry says nothing either.
| Argument | Specification |
|---|---|
node_id |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.100 | documented | SRC-748 p.287, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.286, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.308, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.312, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.313 |
| 26.121 | documented | SRC-740 p.316, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.317, unchanged from SRC-750 p.317 |
| 26.124 | documented | SRC-752 p.317, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_AUTO_HOLE_FILL¶
Phase geometry, layout inline. Manual: SRC-003 p.312.
Fills the holes in one surface. The manual states no -1 form here, unlike its neighbours, so this entry does not claim one either.
| Argument | Specification |
|---|---|
surface |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.267, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.286, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.285, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.307, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.311, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.312 |
| 26.121 | documented | SRC-740 p.315, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.316, unchanged from SRC-750 p.316 |
| 26.124 | documented | SRC-752 p.316, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_CIRCULAR_COPY_PASTE¶
Phase geometry, layout inline. Manual: SRC-003 p.312.
Copies a surface around an axis, and NUM_COPIES INCLUDES THE ORIGINAL: the manual's own worked case is a two-blade propeller from one blade at a value of 2, so asking for 2 copies gives two blades and not three. AXIS IS UNTYPED HERE ON PURPOSE. Its parameter table enumerates nothing at all, and the only value any edition prints is the index 1. SURFACE_ROTATE, four entries above in this same chapter, documents the dual letter-or-index form outright, so the likely set is not a mystery; it is simply not cited for THIS command, and writing an enumeration would mean inventing a value set, which this database has now done once by accident and refuses to do on purpose.
| Argument | Specification |
|---|---|
surface |
int |
coordinate_system |
int |
axis |
str |
num_copies |
int |
angle |
float [deg] |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.266, this edition's own grammar; see the note below |
| 25.100 | documented | SRC-748 p.286, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.285, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.307, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.311, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.312 |
| 26.121 | documented | SRC-740 p.315, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.316, unchanged from SRC-750 p.316 |
| 26.124 | documented | SRC-752 p.316, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_CLEARALL¶
Phase geometry, layout bare. Manual: SRC-003 p.313.
Deletes every surface in the simulation. Documented in three editions and in none after, with DELETE_SURFACES carrying the every-surface form in SRC-740. The same two things hold as for SURFACE_DELETE above: no edition states a removal, and 26.121 inherits the 26.120 record, so the emitter accepts this command for a build whose manual does not document it (PLN-20260807-1010).
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.268, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.287, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.286, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.308, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.312, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.313 |
SURFACE_COMBINE¶
Phase geometry, layout payload_lines. Manual: SRC-003 p.312.
Merges several surfaces into one. The count sits on the command line and the indices follow on the next, comma separated, which this page states explicitly and which is why it is the reference for the same shape inside SURFACE_ROTATE's keyword block.
| Argument | Specification |
|---|---|
surface_count |
int |
surface_indices |
int_list |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.267, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.286, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.285, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.307, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.311, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.312 |
| 26.121 | documented | SRC-740 p.315, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.316, unchanged from SRC-750 p.316 |
| 26.124 | documented | SRC-752 p.316, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_CUT_BY_PLANE¶
Phase geometry, layout keyword_block. Manual: SRC-003 p.311.
Cuts surfaces with a plane of the named frame, offset along the plane normal. A value of -1 on SURFACE cuts every surface, which the manual's own sample does. The parameter table spells the second plane ZX where every other plane argument in the manual and in this database spells it XZ, and the sample on the same page passes XZ. The XZ spelling is recorded; the table's is read as a transposition rather than a third plane, since ZX and XZ name the same plane and no command anywhere accepts both.
| Argument | Specification |
|---|---|
frame |
int |
plane |
enum in |
offset |
float |
surface |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.265, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.285, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.284, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.306, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.310, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.311 |
| 26.121 | documented | SRC-740 p.314, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.315, unchanged from SRC-750 p.315 |
| 26.124 | documented | SRC-752 p.315, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_DELETE¶
Phase geometry, layout keyword_block. Manual: SRC-003 p.312.
Deletes one surface by index, as a keyword block with a single keyword line rather than as an inline argument, which is the manual's shape and not a choice made here. Documented in three editions and in none after. SRC-740 carries the inline DELETE_SURFACES instead, and states no replacement and no removal: it simply stops printing this command, which is absence rather than a statement, so the status stays documented and no 26.121 row is written. READ WHAT THAT DOES NOT ACHIEVE. 26.121 is a real hotfix of 26.120 and inherits its records, so the emitter ACCEPTS this command for 26.121 even with no row of its own. Inheritance is per version and cannot be denied per command, so a database that knows the 26.121 manual dropped this one has no way to say so (PLN-20260807-1010). Whether the solver still answers to it on that build is a probe question, and until it is asked the emitter is permissive here rather than wrong.
| Argument | Specification |
|---|---|
surface |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.267, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.287, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.286, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.308, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.311, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.312 |
SURFACE_INVERT¶
Phase geometry, layout inline. Manual: SRC-003 p.310.
Flips the surface normals of one surface, or of every surface at -1. Its argument is named Index rather than SURFACE, which is the manual's own inconsistency and is mirrored here.
| Argument | Specification |
|---|---|
index |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.264, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.284, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.283, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.305, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.309, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.310 |
| 26.121 | documented | SRC-740 p.313, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.314, unchanged from SRC-750 p.314 |
| 26.124 | documented | SRC-752 p.314, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_LINEAR_COPY_PASTE¶
Phase geometry, layout inline. Manual: SRC-003 pp.311-312.
Copies a surface along a vector, NUM_COPIES times. The translation vector follows UNITS here and precedes it on TRANSLATE_SURFACE_IN_FRAME, so the two commands take the same five values in a different order.
| Argument | Specification |
|---|---|
surface |
int |
num_copies |
int |
frame |
int |
units |
enum in |
x |
float |
y |
float |
z |
float |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.266, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.285, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.284, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.306, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.310, same grammar as 26.120 |
| 26.120 | documented | SRC-003 pp.311-312 |
| 26.121 | documented | SRC-740 p.314, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.315, unchanged from SRC-750 p.315 |
| 26.124 | documented | SRC-752 p.315, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_MIRROR¶
Phase geometry, layout inline. Manual: SRC-003 p.311.
MIRROR_PLANE IS AN INDEX AND NOT A PLANE NAME. The manual gives 1 for YZ, 2 for XZ and 3 for XY (SRC-003 p.311), so this is the one plane argument in the database that does not take the two-letter token, and passing XZ here is refused while passing 2 means it. Recorded because every neighbouring command spells a plane with letters. COMBINE_FLAG decides whether the mirrored geometry joins the source and DELETE_SOURCE_FLAG whether the source survives, so the two together choose between four outcomes and neither implies the other.
| Argument | Specification |
|---|---|
surface |
int |
coordinate_system |
int |
mirror_plane |
int |
combine_flag |
enum in |
delete_source_flag |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.266, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.285, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.284, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.306, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.310, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.311 |
| 26.121 | documented | SRC-740 p.314, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.315, unchanged from SRC-750 p.315 |
| 26.124 | documented | SRC-752 p.315, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_RENAME¶
Phase geometry, layout inline. Manual: SRC-003 p.310.
Renames a surface, which is worth doing early: the name is what a reader of the emitted script sees, and this package's own entity labels are a separate mechanism that never reaches the solver. The parameter table's description of the index is the one written for SURFACE_INVERT and talks about inverting rather than renaming, a row carried across between neighbouring commands, as happens on CAD_BODY_DELETE. It states no -1 form, and renaming every surface to one name would be a strange thing to offer, so none is recorded.
| Argument | Specification |
|---|---|
index |
int |
name |
str |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.264, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.284, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.283, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.305, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.309, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.310 |
| 26.121 | documented | SRC-740 p.313, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.314, unchanged from SRC-750 p.314 |
| 26.124 | documented | SRC-752 p.314, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_ROTATE¶
Phase setup, layout keyword_block. Manual: SRC-003 p.309.
Rotates surfaces about an axis of a coordinate system. AXIS carries the dual form, letters or indices, and here the manual states it outright rather than leaving it to a sample as CAD_BODY_ROTATE does. THE KEYWORD IS SPELLED TWO WAYS ON ONE PAGE, AND THE SAMPLE IS RIGHT. The parameter table names the row SURFACE and the sample writes SURFACES. A keyword is emitted literally, so unlike an enumeration this cannot accept both. The plural was recorded on the reasoning that the sample is the only form the vendor has written as a runnable line; a 2026-08-08 probe then measured it (RPT-021), the solver accepting SURFACES and refusing SURFACE at that line. The count keyword is followed by the indices on the next line, EXCEPT at -1, which the page states selects every surface for rotation and which takes no index line; the list is optional for that reason. The separator is read from SURFACE_COMBINE, the one command in this chapter that states it (comma separated, SRC-003 p.312), because this page shows a single index and a one-element list looks the same under either rule.
| Argument | Specification |
|---|---|
frame |
int |
axis |
enum in |
angle |
float [deg] |
surfaces |
int |
surface_indices |
int_list (optional) |
split_vertices |
enum in |
adaptive_mesh |
enum in |
detach_normal_to_axis |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.263, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.283, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.282, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.304, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.308, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.309 |
| 26.121 | documented | SRC-740 p.312, same grammar as 26.120 |
| 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: while its Script Index at pp.384-390 still names it and does not name ROTATE_SURFACE. The body is the reading recorded, on the rule that a script is written from a signature heading and an index entry only points at one, so an index lagging 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. The same edition is the first to print ROTATE_SURFACE, which rotates surfaces about an axis of a named frame exactly as this does. Recorded as removed rather than left to inheritance, unlike the THREE of the five commands 26.121 stopped printing that carry no record on the builds inheritance reaches past: those went quiet with nothing standing in their place, which is a fact about a document, while here the capability is on the page under another name. The other two of the five carry rows for a different reason, a negative record on 26.121 that inheritance from the base would have overturned, and this note counted all five of them as left to inheritance before those rows were written in the same change. The whole split is PLN-20260810-1600. THE SUCCESSOR IS NOT A DROP-IN. It takes six arguments, five on the command line and the surface indices on the next, where this is a keyword block of eight, and it has no equivalent of SPLIT_VERTICES or ADAPTIVE_MESH. Whether its DETACH_VERTICES is this command's DETACH_NORMAL_TO_AXIS renamed is read from their position on the page and no probe has asked, so the count of options a port loses is two for certain and possibly three. No probe has asked the 26.122 solver whether it still answers this name.; Successor: ROTATE_SURFACE |
SURFACE_SCALE¶
Phase geometry, layout inline. Manual: SRC-003 p.310.
PER-AXIS scaling, unlike CAD_CREATE_SCALE_CURVES which takes one factor for all three. Each must be greater than zero, which the manual states and the database does not enforce, and -1 on SURFACE scales every surface.
| Argument | Specification |
|---|---|
frame |
int |
scale_x |
float |
scale_y |
float |
scale_z |
float |
surface |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.264, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.284, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.283, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.305, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.309, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.310 |
| 26.121 | documented | SRC-740 p.313, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.313, unchanged from SRC-750 p.313 |
| 26.124 | documented | SRC-752 p.313, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_SELECT_BY_ID¶
Phase geometry, layout inline. Manual: SRC-003 p.310.
Selects one surface by its 1-based index, or every surface at -1. The February 2026 edition calls the same command SELECT_GEOMETRY_BY_ID, with the same single argument, the same description and the same sample; the two are recorded separately with their own version rows, because the manual RENAMES it without ever stating a removal and this database records what each edition documents.
| Argument | Specification |
|---|---|
surface |
int |
| Version | Status | Evidence |
|---|---|---|
| 26.101 | documented | SRC-725 p.309, the first edition to carry this name |
| 26.120 | documented | SRC-003 p.310 |
| 26.121 | documented | SRC-740 p.313, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.314, unchanged from SRC-750 p.314 |
| 26.124 | documented | SRC-752 p.314, the SRC-751 file, carried from 26.123; not run on 26.124 |
SURFACE_SELECT_BY_THRESHOLD¶
Phase geometry, layout keyword_block. Manual: SRC-003 p.310.
Selects mesh FACES, not surfaces, by a scalar threshold. RANGE decides which of MIN_VALUE and MAX_VALUE are read, so a range of ABOVE_MIN leaves MAX_VALUE unused; both are required here because the schema has no conditional, and the unused one is discarded by the solver rather than by this package. THRESHOLD mixes geometric and SOLVED quantities in one vocabulary: AREA and QUALITY are properties of the mesh, and VELOCITY, CP and MACH exist only after a solution. Selecting on those before the solver has run is not refused here and the manual does not say what it does. SUBSET narrows what the threshold is applied to, so a selection can be refined by running the command twice with SELECTED_FACES.
| Argument | Specification |
|---|---|
frame |
int |
threshold |
enum in |
min_value |
float |
max_value |
float |
range |
enum in |
subset |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.265, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.284, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.283, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.305, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.309, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.310 |
| 26.121 | documented | SRC-740 p.313, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.314, unchanged from SRC-750 p.314 |
| 26.124 | documented | SRC-752 p.314, the SRC-751 file, carried from 26.123; not run on 26.124 |
TRANSFORM_SELECTED_NODES¶
Phase geometry, layout inline. Manual: SRC-003 p.313.
Moves the selected nodes. TRANSLATION_TYPE decides what X, Y and Z MEAN: under ABSOLUTE they are the node's new coordinates and under TRANSLATION they are increments added to the current ones. The same three numbers therefore place a node somewhere different depending on a token two arguments earlier, and the argument names cannot say so. It carries no unit argument, unlike the surface translations, so the values are read in the named coordinate system's own units.
| Argument | Specification |
|---|---|
coordinate_system |
int |
translation_type |
enum in |
x |
float |
y |
float |
z |
float |
| Version | Status | Evidence |
|---|---|---|
| 25.100 | documented | SRC-748 p.287, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.286, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.308, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.312, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.313 |
| 26.121 | documented | SRC-740 p.316, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.317, unchanged from SRC-750 p.317 |
| 26.124 | documented | SRC-752 p.317, the SRC-751 file, carried from 26.123; not run on 26.124 |
TRANSLATE_SURFACE_BY_FRAME¶
Phase geometry, layout inline. Manual: SRC-003 p.309.
Moves a surface by the transform that carries FRAME1 onto FRAME2, so the two frames are the instruction and there is no vector. ZERO selects all surfaces, as on TRANSLATE_SURFACE_IN_FRAME above, and -1 is an ordinary out-of-range index here rather than an all-form.
| Argument | Specification |
|---|---|
frame1 |
int |
frame2 |
int |
surface |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.264, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.283, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.282, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.304, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.308, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.309 |
| 26.121 | documented | SRC-740 p.312, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.313, unchanged from SRC-750 p.313 |
| 26.124 | documented | SRC-752 p.313, the SRC-751 file, carried from 26.123; not run on 26.124 |
TRANSLATE_SURFACE_IN_FRAME¶
Phase setup, layout inline. Manual: SRC-003 p.309.
Translates one surface by a vector in the named frame, with the vector's own UNITS argument rather than the simulation length units. ZERO SELECTS ALL SURFACES HERE, not -1. This command and TRANSLATE_SURFACE_BY_FRAME below are the two in the chapter that use zero. Seven other surface indices use -1 and six state no all-form at all, and the manual states each per command without ever contrasting them. Passing -1 here names surface -1 rather than all of them, and the emitter refuses it for that reason.
| Argument | Specification |
|---|---|
frame |
int |
x |
float |
y |
float |
z |
float |
units |
enum in |
surface |
int |
split_vertices |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.263, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.283, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.282, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.304, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.308, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.309 |
| 26.121 | documented | SRC-740 p.312, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.313, unchanged from SRC-750 p.313 |
| 26.124 | documented | SRC-752 p.313, the SRC-751 file, carried from 26.123; not run on 26.124 |