Cad create¶
Commands of the cad_create chapter of the database, 37 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_CREATE_AUTO_ANNULAR_CROSS_SECTIONS¶
Phase geometry, layout inline. Manual: SRC-003 p.292.
The annular counterpart of CAD_CREATE_AUTO_CROSS_SECTIONS, cutting around a body rather than along an axis, which is why it takes neither an axis nor a growth scheme. What the ring is centred on is not stated: the command takes a FRAME and a body and nothing that names an axis of revolution.
| Argument | Specification |
|---|---|
frame |
int |
sections |
int |
body_index |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.257, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.277, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.276, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.286, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.291, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.292 |
| 26.121 | documented | SRC-740 p.295, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.296, unchanged from SRC-750 p.296 |
| 26.124 | documented | SRC-752 p.296, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_AUTO_CROSS_SECTIONS¶
Phase geometry, layout inline. Manual: SRC-003 p.292.
Sweeps a body along an axis and writes a series of cross-section curves. EIGHT arguments, and the signature parser reports seven: the heading WRAPS in every edition and CAD_MESH sits alone on the second line. The sample passes eight tokens, which is what settles it. GROWTH_SCHEME is a numbered choice of four and the numbers are the tokens: 1 uniform, 2 successive, 3 dual-successive, 4 reverse-successive (SRC-003 p.292). It is spelled as a closed set rather than as an integer because an out-of-range scheme would silently change the mesh, and it must be passed as a string (PLN-20260806-1130). GROWTH_RATE is the rate that scheme uses, and 1.0 is the uniform spacing the manual names. SYMMETRY takes a plane to produce HALF sections, or NONE for full ones, so it is not the same vocabulary as the PLANE argument elsewhere in this chapter even though three of its four tokens match. CAD_MESH is typed as free text, deliberately. The manual describes it in prose as saying whether BODY_INDEX names a CAD component or a mesh boundary, and enumerates nothing; the only spelling any edition prints is MESH, in the sample. Writing an enumeration here would mean inventing the other token, which is the mistake this chapter has already made twice, so the value set is a probe question rather than a citation.
| Argument | Specification |
|---|---|
frame |
int |
axis |
enum in |
sections |
int |
body_index |
int |
growth_scheme |
enum in |
growth_rate |
float |
symmetry |
enum in |
cad_mesh |
str |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.257, this edition's own grammar; see the note below |
| 25.100 | documented | SRC-748 p.276, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.275, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.286, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.291, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.292 |
| 26.121 | documented | SRC-740 p.295, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.296, unchanged from SRC-750 p.296 |
| 26.124 | documented | SRC-752 p.296, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_BOX¶
Phase geometry, layout inline. Manual: SRC-003 p.290.
X, Y and Z are the FIRST CORNER VERTEX rather than the centre, and the three lengths run from that corner along the frame's axes (SRC-003 p.290). A box centred on a point is that point minus half each length.
| Argument | Specification |
|---|---|
frame |
int |
x |
float |
y |
float |
z |
float |
len_x |
float |
len_y |
float |
len_z |
float |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.284, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.289, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.290 |
| 26.121 | documented | SRC-740 p.293, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.294, unchanged from SRC-750 p.294 |
| 26.124 | documented | SRC-752 p.294, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CONNECT_CURVES¶
Phase geometry, layout bare. Manual: SRC-003 p.294.
Joins the selected virtual curves into ONE curve. The manual gives it a sample and no parameter table, so what it does with curves that do not meet, and which end joins which, is not documented.
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.288, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.293, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.294 |
| 26.121 | documented | SRC-740 p.297, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.298, unchanged from SRC-750 p.298 |
| 26.124 | documented | SRC-752 p.298, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CROSS_SECTION¶
Phase geometry, layout inline. Manual: SRC-003 pp.292-293.
Slices one mesh body with a plane and writes the intersection as a virtual curve. OFFSET moves the plane along its own normal, in the length units of FRAME, which the command does not state and this entry therefore does not either. QUADRANT IS 0 OR 1 TO 4, AND 1 TO 4 MEAN DIFFERENT AXES PER PLANE. Zero asks for no preferred quadrant. The other four are read from a table the manual prints against the chosen PLANE (SRC-003 p.293): on YZ they are the positive and negative Y then the positive and negative Z; on XZ the positive and negative X then the positive and negative Z; on XY the positive and negative X then the positive and negative Y. So the same integer selects a different half depending on the PLANE argument three positions earlier, which is why it is recorded here rather than left to the page. It is typed as an integer and not an enumeration of five: the manual presents 0 as a distinct instruction rather than as a fifth quadrant, and the solver owns the range.
| Argument | Specification |
|---|---|
frame |
int |
plane |
enum in |
offset |
float |
body_index |
int |
quadrant |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.257, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.277, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.276, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.286, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.291, same grammar as 26.120 |
| 26.120 | documented | SRC-003 pp.292-293 |
| 26.121 | documented | SRC-740 p.295, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.296, unchanged from SRC-750 p.296 |
| 26.124 | documented | SRC-752 p.296, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CURVE_ARC¶
Phase geometry, layout inline. Manual: SRC-003 p.293.
NINE coordinates in three triples, and the FIRST is the arc's ORIGIN rather than a vertex on it: origin, then the two vertices the arc runs between (SRC-003 p.293). The manual's own sample is a quarter circle of radius one about the coordinate origin, from (-1, 0, 0) to (0, 1, 0). Reading the first triple as a vertex draws a different arc that the solver accepts, so the order is worth checking against that sample rather than against the argument names, which do not distinguish them.
| Argument | Specification |
|---|---|
x0 |
float |
y0 |
float |
z0 |
float |
x1 |
float |
y1 |
float |
z1 |
float |
x2 |
float |
y2 |
float |
z2 |
float |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.258, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.278, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.277, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.287, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.292, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.293 |
| 26.121 | documented | SRC-740 p.296, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.297, unchanged from SRC-750 p.297 |
| 26.124 | documented | SRC-752 p.297, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CURVE_DELETE_ALL¶
Phase geometry, layout bare. Manual: SRC-003 p.296.
Deletes every virtual curve, selected or not.
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.259, 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.290, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.295, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.296 |
| 26.121 | documented | SRC-740 p.299, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.300, unchanged from SRC-750 p.300 |
| 26.124 | documented | SRC-752 p.300, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CURVE_DELETE_SELECTED¶
Phase geometry, layout bare. Manual: SRC-003 p.296.
Deletes the curves currently selected, which is the state CAD_CREATE_CURVE_SELECT builds.
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.259, 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.291, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.295, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.296 |
| 26.121 | documented | SRC-740 p.299, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.300, unchanged from SRC-750 p.300 |
| 26.124 | documented | SRC-752 p.300, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CURVE_DELETE_UNSELECTED¶
Phase geometry, layout bare. Manual: SRC-003 p.296.
Deletes everything NOT selected, which is how a script keeps a subset: select what it wants, then delete the rest.
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.259, 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.291, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.295, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.296 |
| 26.121 | documented | SRC-740 p.299, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.300, unchanged from SRC-750 p.300 |
| 26.124 | documented | SRC-752 p.300, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CURVE_EXPORT_CCS¶
Phase geometry, layout param_lines. Manual: SRC-003 pp.294-295.
Writes the SELECTED virtual curves to a file, the command name on one line and the path on the next. CCS is the vendor's cross-sectional geometry format and the manual's own example names a .csv, so the extension does not identify the content. Its phase is GEOMETRY and not export, although it writes a file, which follows EXPORT_SURFACE_MESH rather than the export commands it is named like. The phase is not a statement about what a command does; it is the position the ordering rule assigns it, and the builder refuses anything whose phase precedes the highest reached. Filing a curve export under export would let it be emitted once and then refuse every remaining CAD Create command, which is the opposite of how curves are built: export a set, keep going, export another.
| Argument | Specification |
|---|---|
filename |
path |
| 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.289, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.293, same grammar as 26.120 |
| 26.120 | documented | SRC-003 pp.294-295 |
| 26.121 | documented | SRC-740 p.297, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.298, unchanged from SRC-750 p.298 |
| 26.124 | documented | SRC-752 p.298, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CURVE_LINE¶
Phase geometry, layout inline. Manual: SRC-003 p.293.
A straight curve between two vertices, given in order: the direction from the first to the second is the curve's own, which CAD_CREATE_CURVE_REVERSE flips and which the loft commands read.
| Argument | Specification |
|---|---|
x1 |
float |
y1 |
float |
z1 |
float |
x2 |
float |
y2 |
float |
z2 |
float |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.258, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.277, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.276, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.287, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.292, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.293 |
| 26.121 | documented | SRC-740 p.296, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.297, unchanged from SRC-750 p.297 |
| 26.124 | documented | SRC-752 p.297, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CURVE_POINT¶
Phase geometry, layout inline. Manual: SRC-003 p.293.
A curve of one vertex. It is a curve rather than a point in the interface's own vocabulary, which is why it is selected, reordered and lofted with the others.
| Argument | Specification |
|---|---|
x |
float |
y |
float |
z |
float |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.258, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.277, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.276, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.287, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.292, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.293 |
| 26.121 | documented | SRC-740 p.296, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.297, unchanged from SRC-750 p.297 |
| 26.124 | documented | SRC-752 p.297, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CURVE_REVERSE¶
Phase geometry, layout inline. Manual: SRC-003 p.294.
Flips a curve's direction; -1 flips every one (SRC-003 p.294). It acts on the curve rather than on the selection, so it takes an index where the delete commands below take none.
| Argument | Specification |
|---|---|
curve_index |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.259, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.278, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.277, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.288, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.293, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.294 |
| 26.121 | documented | SRC-740 p.297, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.298, unchanged from SRC-750 p.298 |
| 26.124 | documented | SRC-752 p.298, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CURVE_SELECT¶
Phase geometry, layout inline. Manual: SRC-003 p.294.
Adds one virtual curve to the selection by its 1-based creation index; -1 selects every existing curve (SRC-003 p.294). Selection is what CAD_CREATE_CURVE_DELETE_SELECTED and the loft commands read, so it is state carried between lines rather than an argument.
| Argument | Specification |
|---|---|
curve_index |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.258, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.278, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.277, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.288, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.293, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.294 |
| 26.121 | documented | SRC-740 p.297, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.298, unchanged from SRC-750 p.298 |
| 26.124 | documented | SRC-752 p.298, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CURVE_UNSELECT¶
Phase geometry, layout inline. Manual: SRC-003 p.294.
Removes one curve from the selection; -1 removes every one (SRC-003 p.294).
| Argument | Specification |
|---|---|
curve_index |
int |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.259, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.278, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.277, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.288, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.293, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.294 |
| 26.121 | documented | SRC-740 p.297, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.298, unchanged from SRC-750 p.298 |
| 26.124 | documented | SRC-752 p.298, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_CYLINDER¶
Phase geometry, layout inline. Manual: SRC-003 p.290.
R1 and R2 are the radii at the two ends, so a cone is a cylinder with unequal radii and there is no separate cone command. The axis is not a choice: LEN runs along the X AXIS of the frame (SRC-003 p.290), so a cylinder along another direction needs a coordinate system oriented for it, which the phase note at the top of this file says cannot currently be created before it.
| Argument | Specification |
|---|---|
frame |
int |
x |
float |
y |
float |
z |
float |
r1 |
float |
r2 |
float |
len |
float |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.284, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.289, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.290 |
| 26.121 | documented | SRC-740 p.293, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.294, unchanged from SRC-750 p.294 |
| 26.124 | documented | SRC-752 p.294, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_FUSELAGE_MESH_FROM_CCS¶
Phase geometry, layout inline. Manual: SRC-003 p.302.
Lofts a fuselage mesh boundary from the CCS fuselage component. Here LOFT_TYPE_U is RADIAL and LOFT_TYPE_V is AXIAL, which is NOT what the same two argument names mean on the wing command above, where they are chordwise and spanwise. The letters index the parametric directions of the component, and the component decides what those are, so a value carried across from one command to the other means something else.
| Argument | Specification |
|---|---|
name |
str |
close_ends |
enum in |
loft_type_u |
enum in |
loft_type_v |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.297, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.301, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.302 |
| 26.121 | documented | SRC-740 p.305, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.306, unchanged from SRC-750 p.306 |
| 26.124 | documented | SRC-752 p.306, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_IMPORT_CURVE_CCS¶
Phase geometry, layout inline. Manual: SRC-003 p.291.
Reads cross-sections from a CCS file, which the manual says may carry either the .CCS or the .CSV extension, so the extension does not identify the format. COMPONENT_INDEX loads one component by its index, and -1 loads every component at once (SRC-003 p.291); this is the same -1 convention the curve index commands use, on a different kind of index. 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 |
|---|---|
units |
enum in |
frame |
int |
component_index |
int |
file |
path |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.285, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.290, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.291 |
| 26.121 | documented | SRC-740 p.294, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.295, unchanged from SRC-750 p.295 |
| 26.124 | documented | SRC-752 p.295, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_IMPORT_CURVE_P3D¶
Phase geometry, layout inline. Manual: SRC-003 pp.291-292.
Reads curves from a Plot3D structured grid. SWAP_DIRECTION chooses which way the walk over the grid's node data proceeds when building curves from it, so it changes the ORDER the curves come out in and therefore what a later loft joins to what. It is an enumeration of TRUE and FALSE rather than a bool, because a bool in this database is the presence keyword of a keyword_block and this is an inline token the solver reads as a word.
| Argument | Specification |
|---|---|
units |
enum in |
swap_direction |
enum in |
frame |
int |
component_index |
int |
file |
path |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.285, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.290, same grammar as 26.120 |
| 26.120 | documented | SRC-003 pp.291-292 |
| 26.121 | documented | SRC-740 p.294, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.295, unchanged from SRC-750 p.295 |
| 26.124 | documented | SRC-752 p.295, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_IMPORT_CURVE_TXT¶
Phase geometry, layout inline. Manual: SRC-003 p.291.
Reads curve points from a text file. DIMENSIONS decides what the two arguments after it mean: under 2D the points are two-dimensional and are placed on PLANE of the coordinate system FRAME names, and under 3D they carry their own three coordinates in FRAME and the manual says PLANE is IGNORED (SRC-003 p.291). Nothing enforces that. PLANE is required here because the schema has no conditional, so a 3D import must still pass one and the value is discarded by the solver rather than by this package (PLN-20260806-1150 covers the family of documented conditionals this database cannot express). The manual's own sample for this command cites frame 2, and this package refuses it unless the script declares that the opened project already carries the frame, because CREATE_NEW_COORDINATE_SYSTEM is a setup command and cannot precede a geometry one.
declare_existing(frames=2)is the way through, and the underlying phase question is PLN-20260806-0900. This is the third CAD family to meet it, so it is recorded here rather than only in the chapter header.
| Argument | Specification |
|---|---|
units |
enum in |
dimensions |
enum in |
frame |
int |
plane |
enum in |
file |
path |
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.256, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.276, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.275, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.285, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.290, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.291 |
| 26.121 | documented | SRC-740 p.294, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.295, unchanged from SRC-750 p.295 |
| 26.124 | documented | SRC-752 p.295, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_INITIALIZE¶
Phase geometry, layout bare. Manual: SRC-003 p.289.
Opens the CAD Create pane. Whether the commands below REQUIRE it first is not stated by the manual and is not asserted here; the samples show it opening the pane and nothing says the others fail without it.
| Version | Status | Evidence |
|---|---|---|
| 25.000 | documented | SRC-749 p.256, same grammar as 26.120 |
| 25.100 | documented | SRC-748 p.276, same grammar as 26.120 |
| 26.000 | documented | SRC-747 p.275, same grammar as 26.120 |
| 26.100 | documented | SRC-741 p.283, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.288, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.289 |
| 26.121 | documented | SRC-740 p.292, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.293, unchanged from SRC-750 p.293 |
| 26.124 | documented | SRC-752 p.293, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_MIRROR_CURVES¶
Phase geometry, layout inline. Manual: SRC-003 p.295.
Mirrors the SELECTED virtual curves across a plane. It takes no curve index: which curves are mirrored comes from the selection made by CAD_CREATE_CURVE_SELECT, so a script that mirrors without selecting acts on whatever was selected before. THE SAMPLE CALLS THE COMMAND BY A DIFFERENT NAME. Every edition prints the heading as CAD_CREATE_MIRROR_CURVES and the sample line beneath it as CAD_CREATE_MIRROR_CURVE, without the S. The heading is recorded, because the Script Index agrees with it and because a command name is the one thing a sample cannot be right about on its own; PLN-20260808-2300 carries the probe. RETAIN_CURVE decides whether the originals survive, so DELETE makes this a move rather than a copy.
| Argument | Specification |
|---|---|
frame |
int |
plane |
enum in |
retain_curve |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.289, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.294, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.295 |
| 26.121 | documented | SRC-740 p.298, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.299, unchanged from SRC-750 p.299 |
| 26.124 | documented | SRC-752 p.299, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_PROJECT_CURVE¶
Phase geometry, layout inline. Manual: SRC-003 pp.295-296.
Projects ONE virtual curve, named by index rather than taken from the selection, onto a plane of the given coordinate system, along a direction the caller supplies. TWO FRAMES ARE IN PLAY AND THEY ARE NOT THE SAME ONE. The parameter table puts PLANE in the coordinate system FRAME names and NX, NY, NZ in the GLOBAL reference system (SRC-003 p.296). Reading the direction as being in FRAME projects along the wrong vector whenever FRAME is not the reference system, and the solver has no way to object: the result is a curve in the right plane and the wrong place. The -1 convention applies here too, and the row describing it talks about reversing every virtual curve rather than projecting one: the CAD_CREATE_CURVE_REVERSE row left behind by an edit. Read as project.
| Argument | Specification |
|---|---|
curve_index |
int |
frame |
int |
plane |
enum in |
nx |
float |
ny |
float |
nz |
float |
retain_curve |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.290, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.294, same grammar as 26.120 |
| 26.120 | documented | SRC-003 pp.295-296 |
| 26.121 | documented | SRC-740 p.298, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.299, unchanged from SRC-750 p.299 |
| 26.124 | documented | SRC-752 p.299, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_PROJECT_MULTI_CURVE¶
Phase geometry, layout inline. Manual: SRC-003 p.296.
THE TWO INDICES ARE NOT INTERCHANGEABLE. The FIRST curve is the one projected; the SECOND is a guide, used to hold the sweep angle along both curves, and it is not itself projected (SRC-003 p.296). Swapping them projects the wrong curve, which is why the argument names carry the order. It takes no projection vector, where CAD_CREATE_PROJECT_CURVE above does: the guide curve supplies the direction. RETAIN_CURVE governs the original, and the manual does not say whether that means the first curve or both.
| Argument | Specification |
|---|---|
curve_index_1 |
int |
curve_index_2 |
int |
frame |
int |
plane |
enum in |
retain_curve |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.290, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.295, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.296 |
| 26.121 | documented | SRC-740 p.299, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.300, unchanged from SRC-750 p.300 |
| 26.124 | documented | SRC-752 p.300, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_REORDER_CURVES¶
Phase geometry, layout inline. Manual: SRC-003 p.296.
Sorts the selected curves along an axis, and the token is SIGNED: the six values are the three axes each way round, so a leading minus is part of the token and not a negation of anything. The parameter table lists the six signed forms and no bare letter; whether the solver would also take one is unprobed, and the table's value list has already been measured non-exhaustive elsewhere in this chapter, so the absence is not a refusal. Order matters downstream rather than here: the loft commands consume the curves in sequence, so a loft across curves built in the wrong order is what this fixes.
| Argument | Specification |
|---|---|
frame |
int |
sorting_direction |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.290, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.295, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.296 |
| 26.121 | documented | SRC-740 p.299, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.300, unchanged from SRC-750 p.300 |
| 26.124 | documented | SRC-752 p.300, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_REVOLVE_MESH_FROM_CCS¶
Phase geometry, layout inline. Manual: SRC-003 p.305.
Lofts a body of revolution from the CCS revolve component. EIGHT arguments, and the signature parser reports seven for the same reason as CAD_CREATE_AUTO_CROSS_SECTIONS: the heading wraps and LOFT_TYPE_V sits alone on the second line. The sample passes eight. FRAME supplies the ORIGIN of the rotation axis and AXIS the direction, so the two together are the axis and neither is it alone. The angles are in degrees and run in the rotational direction, so a full body is 0 to 360; what a negative or a reversed pair does is not stated. LOFT_TYPE_U is RADIAL and LOFT_TYPE_V is AXIAL, as on the fuselage command and unlike the wing one.
| Argument | Specification |
|---|---|
name |
str |
frame |
int |
axis |
enum in |
start_angle |
float [deg] |
end_angle |
float [deg] |
close_ends |
enum in |
loft_type_u |
enum in |
loft_type_v |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.300, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.304, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.305 |
| 26.121 | documented | SRC-740 p.308, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.309, unchanged from SRC-750 p.309 |
| 26.124 | documented | SRC-752 p.309, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_ROTATE_CURVES¶
Phase geometry, layout inline. Manual: SRC-003 p.295.
Rotates the selected virtual curves about one axis of the given coordinate system. Frame 1 is the reference system, which the parameter table states. AXIS takes the index as well as the letter, for the reason recorded at CAD_BODY_ROTATE: the table names X, Y or Z and the sample beneath it passes 2, in the four editions read then, and two other tables in this chapter state the dual form outright (PLN-20260806-1130). The index may be passed as the integer 2 or as the string "2"; the emitter prints either as the digit (PFS-2003.04).
| Argument | Specification |
|---|---|
frame |
int |
axis |
enum in |
angle |
float [deg] |
retain_curve |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.289, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.294, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.295 |
| 26.121 | documented | SRC-740 p.298, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.299, unchanged from SRC-750 p.299 |
| 26.124 | documented | SRC-752 p.299, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_SCALE_CURVES¶
Phase geometry, layout inline. Manual: SRC-003 p.295.
ONE scale value for all three axes: the command has no per-axis form, so a non-uniform scaling is not available here. What the scaling is about, the origin or the curve's own centroid, is not stated in any edition.
| Argument | Specification |
|---|---|
scale |
float |
retain_curve |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.289, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.294, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.295 |
| 26.121 | documented | SRC-740 p.298, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.299, unchanged from SRC-750 p.299 |
| 26.124 | documented | SRC-752 p.299, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_SELF_MEDIAN_FROM_CURVES¶
Phase geometry, layout bare. Manual: SRC-003 p.294.
Builds the median curve of each selected virtual curve, which is the camber line of a closed airfoil-like curve: the manual's own comment calls the result thin. It is the curve-level counterpart of collapsing a closed section to a single surface, and the family that lofts a mesh from curves is what consumes it.
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.288, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.293, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.294 |
| 26.121 | documented | SRC-740 p.297, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.298, unchanged from SRC-750 p.298 |
| 26.124 | documented | SRC-752 p.298, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_SHEET¶
Phase geometry, layout inline. Manual: SRC-003 p.290.
A flat rectangle in one plane of the frame. OFFSET moves it along that plane's normal and MAY BE NEGATIVE, which the manual states explicitly; zero puts the sheet exactly in the plane. LEN1 and LEN2 run along the plane's two directions (SRC-003 p.290). WHICH length goes with which direction is not stated on that page, so the order implied by the plane name is a reading and not a citation.
| Argument | Specification |
|---|---|
frame |
int |
plane |
enum in |
offset |
float |
len1 |
float |
len2 |
float |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.284, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.289, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.290 |
| 26.121 | documented | SRC-740 p.293, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.294, unchanged from SRC-750 p.294 |
| 26.124 | documented | SRC-752 p.294, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_SPHERE¶
Phase geometry, layout inline. Manual: SRC-003 p.290.
X, Y and Z are the CENTRE here, unlike the box above, which takes a corner. The two commands sit on one manual page and differ on this point, which is worth carrying because the argument names do not say so.
| Argument | Specification |
|---|---|
frame |
int |
x |
float |
y |
float |
z |
float |
radius |
float |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.284, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.289, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.290 |
| 26.121 | documented | SRC-740 p.293, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.294, unchanged from SRC-750 p.294 |
| 26.124 | documented | SRC-752 p.294, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_TRANSLATE_CURVES¶
Phase geometry, layout inline. Manual: SRC-003 p.295.
Translation vector for the selected virtual curves. It takes NO frame argument, unlike the rotation and the mirror, and the manual states why in the parameter row rather than in the signature: the vector is read in the REFERENCE coordinate system. A script that built its curves against a local frame has to convert.
| Argument | Specification |
|---|---|
x |
float |
y |
float |
z |
float |
retain_curve |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.289, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.294, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.295 |
| 26.121 | documented | SRC-740 p.298, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.299, unchanged from SRC-750 p.299 |
| 26.124 | documented | SRC-752 p.299, the SRC-751 file, carried from 26.123; not run on 26.124 |
CAD_CREATE_WING_MESH_FROM_CCS¶
Phase geometry, layout inline. Manual: SRC-003 p.300.
Lofts a wing mesh boundary from the CCS wing component, and NAME is the boundary name the rest of a script cites it by. LOFT_TYPE_U is CHORDWISE and LOFT_TYPE_V is SPANWISE, which the manual states and which the argument names do not: U and V alone would leave a caller guessing, and the two carry different documented defaults in the interface, C2 chordwise and C0 spanwise. TE_GEOMETRY's OPEN means the trailing edge itself is left unclosed, which is a different question from CLOSE_ENDS, the argument two positions later that closes the wing's TIPS. The two are easy to read as one setting because both spell a token about closing.
| Argument | Specification |
|---|---|
name |
str |
mark_trailing_edges |
enum in |
te_geometry |
enum in |
close_ends |
enum in |
loft_type_u |
enum in |
loft_type_v |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.294, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.299, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.300 |
| 26.121 | documented | SRC-740 p.303, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.304, unchanged from SRC-750 p.304 |
| 26.124 | documented | SRC-752 p.304, the SRC-751 file, carried from 26.123; not run on 26.124 |
SET_CAD_CREATE_MERGE_TOLERANCE¶
Phase geometry, layout inline. Manual: SRC-003 p.289.
How close two curve ends must be to merge, as a PERCENTAGE of the curve length rather than an absolute distance, so the same value behaves differently on a long curve and a short one. Greater than zero (SRC-003 p.289).
| Argument | Specification |
|---|---|
tolerance |
float [percent of curve length] |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.283, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.288, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.289 |
| 26.121 | documented | SRC-740 p.292, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.293, unchanged from SRC-750 p.293 |
| 26.124 | documented | SRC-752 p.293, the SRC-751 file, carried from 26.123; not run on 26.124 |
SET_CAD_CREATE_SPLINE_LOFT¶
Phase geometry, layout inline. Manual: SRC-003 p.289.
Continuity of the loft through a curve: C2 is curvature continuous and C0 is position continuous, so C0 admits a crease where C2 smooths it. The same two tokens appear per direction on the mesh commands built from cross-sections.
| Argument | Specification |
|---|---|
loft_type |
enum in |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.283, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.288, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.289 |
| 26.121 | documented | SRC-740 p.292, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.293, unchanged from SRC-750 p.293 |
| 26.124 | documented | SRC-752 p.293, the SRC-751 file, carried from 26.123; not run on 26.124 |
SET_CAD_CREATE_SPLINE_SEGMENTS¶
Phase geometry, layout inline. Manual: SRC-003 p.289.
Spline nodes used to discretize a curve. Integer greater than 10 (SRC-003 p.289); the lower bound is the manual's own and is not enforced here, because the database records grammar and the solver owns the range.
| Argument | Specification |
|---|---|
num_pts |
int |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.283, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.288, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.289 |
| 26.121 | documented | SRC-740 p.292, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.293, unchanged from SRC-750 p.293 |
| 26.124 | documented | SRC-752 p.293, the SRC-751 file, carried from 26.123; not run on 26.124 |
SET_CAD_CURVATURE_REFINEMENT¶
Phase geometry, layout inline. Manual: SRC-003 p.289.
Subdivisions around a full circle, used as the reference for how finely a curved region is refined. It is the same quantity the NUM_CURVATURE argument of the CAD import carries (SRC-003 p.286), and the two share the documented default of 80. That command is not in this database yet, so the comparison is to the manual page rather than to an entry.
| Argument | Specification |
|---|---|
num_pts_per_circle |
int |
| Version | Status | Evidence |
|---|---|---|
| 26.100 | documented | SRC-741 p.283, same grammar as 26.120 |
| 26.101 | documented | SRC-725 p.288, same grammar as 26.120 |
| 26.120 | documented | SRC-003 p.289 |
| 26.121 | documented | SRC-740 p.292, same grammar as 26.120 |
| 26.123 | documented | SRC-751 p.293, unchanged from SRC-750 p.293 |
| 26.124 | documented | SRC-752 p.293, the SRC-751 file, carried from 26.123; not run on 26.124 |