Cad¶
Commands of the cad chapter of the database, 8 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.
CAD_BODY_DELETE¶
Phase geometry, layout inline. Manual: SRC-003 p.287.
Deletes one CAD body by its 1-based index; -1 deletes every one of them (SRC-003 p.287). The parameter table row for this index is the one written for CAD_BODY_SCALE, describing the body being scaled rather than the body being deleted: a description carried across between neighbouring commands, not a grammar difference.
| Argument | Specification |
|---|---|
body_index |
int |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.281, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.286, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.287 |
| 26.121 | documented | SRC-740 p.290, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.291, unchanged from SRC-750 p.291 |
| 26.124 | documented | SRC-752 p.291, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_BODY_MIRROR¶
Phase geometry, layout inline. Manual: SRC-003 p.287.
Mirrors one CAD body across a plane OF THE REFERENCE COORDINATE SYSTEM, not of a frame the caller chooses: this command takes no frame argument, unlike CAD_BODY_SELECT_BY_THRESHOLD below (SRC-003 p.287).
| Argument | Specification |
|---|---|
body_index |
int |
plane |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.281, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.286, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.287 |
| 26.121 | documented | SRC-740 p.290, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.291, unchanged from SRC-750 p.291 |
| 26.124 | documented | SRC-752 p.291, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_BODY_ROTATE¶
Phase geometry, layout inline. Manual: SRC-003 p.287.
Rotates one CAD body about an axis of the reference coordinate system. The angle is in DEGREES, which the manual states and which is worth carrying because the solver's own motion definitions take degrees too while the far-field and probe layers of this package work in radians. AXIS takes the axis INDEX as well as the letter, and this entry carried the letters alone until 2026-08-06. The parameter table names only X, Y or Z, in every edition, and the sample printed beneath that same table passes 2, also in every edition, so the stated value set refused the manual's own call. Two tables in this chapter state the dual form outright (SET_MOTION_ROTOR_AXIS at SRC-003 p.333, ROTATE_COORDINATE_SYSTEM at p.330), which makes the index the product's convention and this table incomplete rather than the sample a typo. Which letter each index denotes is written nowhere: 1, 2, 3 in frame order is the only sensible reading and it is unverified, so a script that means the Y axis is clearer written Y. The index must be passed as the string "2"; the emitter matches enum values as text and a bare integer raises (PLN-20260806-1130).
| Argument | Specification |
|---|---|
body_index |
int |
axis |
enum in |
angle |
float [deg] |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.281, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.286, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.287 |
| 26.121 | documented | SRC-740 p.290, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.291, unchanged from SRC-750 p.291 |
| 26.124 | documented | SRC-752 p.291, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_BODY_SCALE¶
Phase geometry, layout inline. Manual: SRC-003 p.287.
Uniform scale factor, dimensionless and greater than zero (SRC-003 p.287). It scales the BODY, so a body scaled after its cross-sections were read carries no relation to them.
| Argument | Specification |
|---|---|
body_index |
int |
scale |
float |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.281, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.286, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.287 |
| 26.121 | documented | SRC-740 p.290, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.291, unchanged from SRC-750 p.291 |
| 26.124 | documented | SRC-752 p.291, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_BODY_SELECT_BY_THRESHOLD¶
Phase geometry, layout inline. Manual: SRC-003 p.288.
Selects or deletes the CAD faces on one side of a coordinate threshold. FRAME is the 1-based index of the coordinate system the threshold is measured in, 1 being the reference frame. The threshold value is in that frame's own length units, which the command does not state and this database therefore does not either (SRC-003 p.288). A LIMIT of this package rather than of the solver, found while writing the entry: FRAME can only be the reference frame here. This command is phase geometry and CREATE_NEW_COORDINATE_SYSTEM is phase setup, so the ordering check refuses a local frame created before it, and a frame created after cannot be cited by a line already emitted. Whether the SOLVER accepts a coordinate system defined before a CAD operation is unmeasured, so the phase is left where the rest of the CAD family sits rather than moved on a guess (PLN-20260806-0900).
| Argument | Specification |
|---|---|
frame |
int |
parameter |
enum in |
value |
float |
logic |
enum in |
action |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.282, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.287, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.288 |
| 26.121 | documented | SRC-740 p.291, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.292, unchanged from SRC-750 p.292 |
| 26.124 | documented | SRC-752 p.292, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_BODY_TRANSLATE¶
Phase geometry, layout inline. Manual: SRC-003 p.287.
Translation vector in the reference coordinate system, with its own UNITS argument rather than the simulation length units: this command states the units of its three components and does not inherit them (SRC-003 p.287). The three components carry no unit field here because the unit is the fifth argument rather than a fact about the command.
| Argument | Specification |
|---|---|
body_index |
int |
x |
float |
y |
float |
z |
float |
units |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.281, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.286, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.287 |
| 26.121 | documented | SRC-740 p.290, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.291, unchanged from SRC-750 p.291 |
| 26.124 | documented | SRC-752 p.291, the SRC-751 file, carried from 26.123; not run on 26.124 |
CONVERT_CAD_TO_MESH¶
Phase geometry, layout inline. Manual: SRC-003 p.286.
Transfers a CAD body into the simulation's mesh, which is the step that makes an imported CAD file something the solver acts on, and the point at which mesh boundary indices come into existence. -1 transfers every body, which the sample passes. It is a CAD body index, an object the script builder does not track, so the -1 is in this note rather than declared as a sentinel.
| Argument | Specification |
|---|---|
body_index |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.260, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.279, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.278, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.280, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.285, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.286 |
| 26.121 | documented | SRC-740 p.289, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.290, unchanged from SRC-750 p.290 |
| 26.124 | documented | SRC-752 p.290, the SRC-751 file, carried from 26.123; not run on 26.124 |
IMPORT_CAD¶
Phase geometry, layout inline. Manual: SRC-003 p.286.
Imports a CAD file, the path on the line after the inline arguments. The result is a CAD body, not a mesh: CONVERT_CAD_TO_MESH is what puts it where the solver can see it. NUM_CURVATURE IS A COUNT AROUND A CIRCLE AND NOT A LENGTH. The manual defines it as the number of tessellation subdivisions around a full circle, default 80, so it refines curved faces and does nothing to flat ones. It is the argument that decides whether an imported fillet is a polygon. The manual gives all three defaults, MEDIUM, TRUE and 80, and all three are required here: no edition prints a call omitting any of them, so a shorter form would be inferred rather than read. THE THREE PRE-26.100 EDITIONS WRITE THIS COMMAND IN A DIFFERENT LAYOUT and carry no row here because of it. They print the command name alone on its line with each parameter on a line after it, where 26.100 onward prints the arguments inline. A version row can override the argument grammar and cannot override the layout, so a row for those editions would emit the newer shape under an older build's citation, which is worse than refusing to emit at all. The reading exists and is withheld deliberately; the schema gap is PLN-20260810-1200.
| Argument | Specification |
|---|---|
tessellation_density |
enum in |
unreferenced_patches |
enum in |
num_curvature |
int |
file |
path |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.280, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.285, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.286 |
| 26.121 | documented | SRC-740 p.289, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.290, unchanged from SRC-750 p.290 |
| 26.124 | documented | SRC-752 p.290, the SRC-751 file, carried from 26.123; not run on 26.124 |