Model Scripts
Create a complete model from a few lines of text: nodes, members, plates, supports, load cases, loads and combinations. Write the script yourself, or ask an AI assistant to write it from the guide.
Creating a model from a script
Model scripts need you to be signed in.
- Open the File Manager (
Ctrl+O) and choose Import → Model script. - Type or paste the script, or start from Insert example: a 2D portal frame, a 3D two-storey frame, an imperial two-span beam, a flat slab with openings, and a reference building that uses every line and option.
- Click Create model.
The script is checked first. If it has problems, nothing is created and each problem is listed with its line number and a hint on how to fix it. Fix the lines and click Create model again.
When the script passes, the model is saved as a new project in the File Manager. A message then lists the library sections and materials the script picked, any warnings, and anything left for you to do (for example, sections still to pick).
To replace the model in the file you have open instead, click Model Script in the ribbon, next to the Structure Wizard. If the file is empty, the model is simply created in it. If it already has a model, you are asked to confirm, and the script's model then replaces the current one, including its sections, materials, loads, load cases and combinations. Analysis settings and plate analysis settings go back to their defaults and results are cleared. This can't be undone with Ctrl+Z, but the saved file is not changed until you save.
A first script
A 6 m wide, 4 m high portal frame with fixed bases, dead and roof live load on the rafter, and two combinations:
units metric
library Australia
name "Portal frame"
section COL "Columns" lib="UC_310x97_G300"
section RAF "Rafter" lib="UB_360x51_G300"
material STEEL "Steel" lib="Australia/Steel/STEEL"
node N1 0 0 0 support=fixed
node N2 0 4 0
node N3 6 4 0
node N4 6 0 0 support=fixed
member C1 N1 N2 COL
member R1 N2 N3 RAF
member C2 N4 N3 COL
case G "Dead"
case Q "Roof live"
selfweight G
udl G R1 wy=-2
udl Q R1 wy=-1.5
combo ULS1 "1.2G + 1.5Q" G=1.2 Q=1.5 uls
combo SLS1 "G + 0.7Q" G=1 Q=0.7 slsEach line is one item. The first word says what it is (node, member, udl, ...), followed by its id and values. Lines starting with # are comments.
Using an AI assistant
The guide tells an AI assistant (ChatGPT, Claude, Gemini and others) exactly how to write a valid script, including the library names it may use.
- Click Copy guide for AI in the Model script dialog, or open the AI assistant guide and copy it from there. An assistant that can read web pages can be given the link to the plain-text guide, /model-script-guide.txt, instead.
- Paste it into the assistant and describe your structure underneath: spans, heights, supports, sections or the country whose sections to use, loads and combinations. Say whether you work in metric or imperial.
- Paste the script it returns into the dialog and click Create model. If problems are listed, paste them back to the assistant and ask it to fix the script.
Always check the created model: geometry, supports, load directions and the library picks. The script check catches format and stability problems, not engineering intent.
Rules of the format
- The first line is
units metricorunits imperial. Metric numbers are m, kN, kN·m, kN/m and kPa; plate thickness is in mm and settlement in mm. Imperial uses ft, kip, kip·ft, kip/ft and ksf, with thickness and settlement in inches. - Coordinates and directions use the app's global axes with Y up (next section).
- Ids such as
N1,C1orGuse letters, digits and. _ : -with no spaces. Names with spaces go in double quotes. - Define everything before it is used. The usual order is sections and materials, then nodes, members, plates and openings, then load cases, loads and combinations.
- Plain numbers only: no arithmetic and no units after numbers. Positions along a member (
at=,from=,to=) are a fraction of its length (0.5), a percentage (50%) or a distance from the start node (2m/6ft). - Options are written
key=valuewith no spaces around=. - Ids are case-sensitive. Each point gets one node: two nodes at the same coordinates are not merged. Every node needs a member, plate or support.
- Every node and member is written out; there are no loops or arrays.
Axes and coordinates
Scripts use the same right-handed global axes as the rest of the app. Y is vertical, pointing up; X and Z are horizontal, so the floor plan is in X and Z and heights are Y.
Front view Plan, seen from above
+Y (up) +----------> +X
^ |
| |
+-------> +X v
/ +Z
+Z (toward you)node N1 x y z gives the node's global coordinates in that order, in m (ft for imperial). A 4 m column standing on the origin is node A 0 0 0 to node B 0 4 0; a 6 m beam along X at that height ends at node C 6 4 0. Placing the building with a corner at the origin and the long side along X keeps every coordinate positive and easy to read.
| In the script | Meaning |
|---|---|
dx dy dz | Movement along global X, Y, Z (supports, springs, settlement) |
rx ry rz | Rotation about X, Y, Z. In release= they are about the member's own axes |
fx fy fz, wx wy wz | Force and line load, positive along +X, +Y, +Z. Gravity is negative: fy=-10, wy=-5 |
mx my mz | Moment about X, Y, Z by the right-hand rule: thumb along the positive axis, fingers curl in the positive direction. A positive mz turns anticlockwise in the front view |
axis=local | The same names in the member's own axes: local x from the start node to the end node, local y up from a horizontal or sloping member (columns: see Members) |
Results (reactions, member forces and plate stresses) follow the app's Sign Conventions. After import, turn on the global axes and member local frames from the left sidebar to check orientations.
What a script can contain
| Line | Creates | Example |
|---|---|---|
units | Units of the numbers in the script | units metric |
name, description | Project name and description | name "Warehouse" |
library | Country whose section library lib= names are looked up in | library Australia |
section | A section, picked from the library or left to pick later | section COL "Columns" lib="UC_310x97_G300" |
material | A material, picked from the library or left to pick later | material STEEL "Steel" lib="Australia/Steel/STEEL" |
node | A node, with optional support, spring and settlement | node N1 0 0 0 support=fixed |
member | A beam, column or brace between two nodes | member C1 N1 N2 COL |
plate | A slab or wall from 3 or 4 corner nodes, meshed by the app | plate S1 A B C D thickness=200 mesh=0.5 |
opening | A circular, rectangular or polygonal hole in a plate | opening H1 S1 rect w=1 h=1 at=3,4,2 |
diaphragm | A rigid floor tying a set of nodes | diaphragm D1 A1 B1 C1 D1 |
link | A node link: one node follows another in the directions of a six-letter F/R code, e.g. a scissor joint where two braces cross | link L1 X Xb FFFRRR |
case | A load case | case G "Dead" |
selfweight | Self-weight of all members and plates in a case | selfweight G |
nodeload | Forces and moments at a node | nodeload W N2 fx=10 |
udl | Uniform, varying or partial line load on a member | udl Q R1 wy=-5 |
pointload | Point force or moment along a member | pointload Q R1 at=50% fy=-20 |
temperature | Uniform temperature change or gradient on a member; uniform change or face-to-face difference on a plate | temperature T R1 dt=20 |
pressure | Uniform or linearly varying pressure on a plate | pressure G S1 p=-4 dir=y |
pressureload | Floor, wall or roof pressure carried by the framing members | pressureload Q p=3 members=B1,B2,B3,B4 |
combo | A load combination | combo ULS1 "1.2G + 1.5Q" G=1.2 Q=1.5 uls |
The full guide lists every option of every line.
Sections and materials
Sections and materials always come from the library, never from numbers typed into the script, so each one has its shape, properties and design data. There are two ways to give them:
- Name a library item with
lib=. Library names are file names such asUB_310x40_G300orW_12x26. Set the country once withlibrary Australia, or per section withcountry=Europe. Where the same name is in more than one folder (for example two steel grades), put the folder in front:lib="RHS_Rectangular_350/RHS_100x50x3". Materials take their folder path:lib="Australia/Steel/STEEL". - Use a placeholder. Without
lib=, the section or material is created with its name only, as a placeholder that members and plates refer to. Pick what it should be after import (below).
A name that matches no library item, or more than one, is reported on its line with what to write instead.
Placeholders: picking after import
Placeholders let a script describe the model now and leave the exact section for later: when the size isn't decided yet, when you want your own custom section, or when an AI assistant isn't sure a library name exists. Give each one a name that says what it is:
section COL "Columns"
section RAF "Rafter (size TBC)"
material STEEL "Steel"
member C1 N1 N2 COL
member R1 N2 N3 RAFAfter the model is created, the confirmation message says how many sections and materials are still to pick. Then:
- Click Sections (or Materials) in the ribbon. Each placeholder is a row named as in the script.
- Click the row's book icon and select a library item, or one of your own: a parametric custom section or material, or a section drawn in the Custom Section Builder.
- Every member or plate using that placeholder updates at once.
The model opens and draws straight away, but it can't be analysed or designed until every placeholder that members or plates use has been picked. Model Health lists any that are left. Custom sections and materials can only be chosen this way; a script can't name them or give section or material properties.
Supports
| Written as | Meaning |
|---|---|
support=fixed | All six directions held |
support=pinned | X, Y and Z held, free to rotate |
support=roller | Vertical (Y) held only |
support=FFFRRR | Six letters for DX DY DZ RX RY RZ; F = held, R = free |
support=dx,dy,dz | List of held directions |
spring=dy:5000 | Spring support (kN/m or kN·m/rad) |
settle=dy:-10 | Support settlement (mm or in; radians for rotations) on a held direction. It acts in every load case and combination at full value. |
A plate edge can be supported along its whole length with edge=A-B:pinned on the plate line, and hinged with hinge=A-B.
Members
member <id> <start> <end> <section>, with optional:
material=STEEL(needed when more than one material is declared)hingedfor a member pinned at both ends, orrelease=start:rz,release=end:ry,rz,release=both:rzroll=90,roll=180orroll=270to turn the section about its own axis (quarter turns only)behaviour=tensionorbehaviour=compressionfor tension-only or compression-only membersecc=x,y,z(orecc1=/ecc2=) to offset the ends, in global axes or in member axes witheccaxis=localhaunch=0.6,0.36(orhaunch1=/haunch2=) for haunches at the ends, ortaper=0.6,0.3for a web-tapered member (below)spring=rz:20000(orspring1=/spring2=) for semi-rigid ends (below)
Members connect only where they share a node. Where a beam meets a column part-way up, add a node there and split the column into two members. X-braces can either share a node where they cross, or cross unconnected (a warning reminds you).
- Sections are upright unless you give a roll: an I-beam's web is vertical and a purlin stands upright.
roll=90turns the section so its local y becomes the old local z;roll=180turns it upside down (an angle's legs flip);roll=270is the other side. - Columns: draw them bottom to top. Local y then points along −X and local z along +Z, so an I-section column has its web along X and is strong against sway in X; add
roll=90to turn it to Z. A column drawn top to bottom flips local y, so local loads on it flip too. - hinged releases bending (
ry,rz) at both ends and keeps torsion. Never release torsion (rx) at both ends. For a pin-jointed truss, keep the chords continuous and hinge the webs.
Haunches and tapers
haunch=<length>,<depth> adds depth at both member ends, running out to nothing at length, measured along the member (also on a sloping rafter); haunch1= is the start only, haunch2= the end only. Add ,top for the top face (default bottom). taper=<start depth>,<end depth> varies the overall depth linearly, flanges as the section; add ,top or ,bottom to slope one face only. Lengths and depths are in m (ft), like coordinates.
# 600 mm eaves haunches adding 356 mm, the rafter depth
member R1 N2 N3 RAF haunch=0.6,0.356
# Built-up column, 300 mm deep at the base to 600 mm at the top
member C1 N1 N2 WB taper=0.3,0.6Use them on I-sections with parallel flanges or solid rectangles, on normal members (not tension- or compression-only); a member has haunches or a taper, not both. Design checks are not available for these members. See Members.
Semi-rigid member ends
spring=<direction>:<stiffness>,... replaces a fixed connection with a spring at both member ends; spring1= is the start only, spring2= the end only. Directions are the member's own, as in release=; stiffness in kN/m and kN·m/rad (kip/ft, kip·ft/rad).
# Semi-rigid beam-to-column joints, 20000 kN-m/rad at both ends
member B1 N2 N3 BM spring=rz:20000A direction is fixed, released or a spring, never two (hinged with spring=rz is an error). Tension- and compression-only members can't have dy, dz or rx springs; angles and Z sections need equal y and z springs. A semi-rigid joint between two members (a splice, or a continuous beam over a support) is one spring on one of them: springs on both act one after the other, so two of 20000 make 10000. See Members.
Plates and openings
A plate is a slab or wall from 3 or 4 corner nodes (a 4-corner plate must be a rectangle) with a thickness in mm (inches in imperial). The app meshes it exactly as if you had drawn it. mesh= is the target element size; each edge is split into a power-of-two number of equal elements (table below). An 8 m edge with mesh=0.5 gets 16 elements of 0.5 m; a 6 m edge also gets 16, of 0.375 m.
Beams along a plate edge on the same corner nodes are connected automatically. A column under a slab must sit on a mesh point, and plates that share an edge need the same number of elements along it. Where a node has its own support= and also sits on a supported edge=, the two combine direction by direction: anything either one holds is held.
hinge=A-B,C-D hinges whole plate edges, named by their corner nodes as in edge=; an edge may have both. The hinge belongs to the plate it is written on. See Hinged plate edges.
Edge length / mesh= | Elements along the edge |
|---|---|
| under 1.5 | 1 |
| 1.5 to 2.5 | 2 |
| 2.5 to 5.5 | 4 |
| 5.5 to 11.5 | 8 |
| 11.5 to 23.5 | 16 |
| 23.5 to 47.5 | 32 |
| 47.5 and over | 64 (the most) |
A plate's local axes (for kx/ky and rectangular openings) are: floors and roofs x = +X, y = −Z, z = +Y; walls in the X-Y plane x = +X, y = +Y, z = +Z; walls in the Y-Z plane x = +Z, y = −Y, z = +X.
Each plate also has a face direction, which sets the sign of its pressure: the positive global axis closest to its normal. Floors and roofs up to 45° face +Y; steeper plates (walls) face +X or +Z, whichever they face more, so a wall along X faces +Z.
Openings are written on their own lines in global coordinates on the plate:
plate ROOF A B C D thickness=200 mesh=0.5
opening STAIR ROOF rect w=2 h=1 at=3,7,2
opening DUCT ROOF circle d=0.4 at=5,7,1.5
opening VOID ROOF polygon points=1,7,3;2,7,3;1.5,7,3.8The app refines the mesh around each opening, and one opening can add several hundred elements. Use few openings, not much smaller than mesh=; a very small hole produces many tiny elements.
Loads
- Loads act in global axes unless
axis=localis given, with the signs in Axes and coordinates: downward is negative Y, e.g.nodeload G N2 fy=-10,udl G R1 wy=-5. A global line load on a sloping member is per metre of member length. - An eccentric load is the force plus its moment. A 4 kN pipe hung 0.3 m off a beam along X, toward +Z, is
pointload P B1 at=1m fy=-4 mx=1.2. - A varying line load gives both end values:
udl G R1 wy=-2 wy2=-6. - Temperature:
dt> 0 is warmer. Gradients (gy=,gz=) make the member's local +y or +z face hotter and are in °C per metre of section depth (°F per ft in imperial), not the temperature difference: 30 °C across a 0.3 m deep beam isgy=100. - Plate temperature:
temperature T SLAB dt=15 diff=10.dtis the uniform change;diffis the face side (a floor's top, a wall's +X or +Z side) minus the other side, the full difference, not per thickness. A negativedtmodels shrinkage. See Plate Loads. - Combinations list the load cases with their factors. Mark each one
ulsorslsso design checks use it for the right limit state.
Area loads: pressure and pressureload
There are two ways to apply an area load, and they have opposite signs:
pressure | pressureload | |
|---|---|---|
| Loads | A plate (slab or wall elements) | The framing members around a floor, wall or roof, with no plate; the same as the app's Pressure Load tool |
Positive p | Along the plate's face direction (+Y on a floor), or along the positive global axis given by dir= | Into the surface: down on a floor, toward −X / −Z on a wall facing +X / +Z. Negative is suction |
| 3 kPa down on a floor | pressure G S1 p=-3 | pressureload G p=3 members=B1,B2,B3,B4 |
pressureloadlists every member in one flat surface, including interior beams, purlins and joists; a member left out gets none of the load. One line can cover a whole multi-bay floor or roof plane.- A varying plate pressure gives the value at each end along an axis:
pressure H WALL p=20 p2=0 rise=yfor water against a wall. - Imperial pressures are in ksf: 20 psf is
p=0.02.
What stays in the app
Scripts describe geometry, supports, loads and combinations. Design settings (effective lengths, lateral restraints, the design code), pattern loading, custom sections and materials, and analysis options are set in the app after import.
When a script is rejected
| Message about | Usually means |
|---|---|
| An id that is not defined | A node, section or case is used before (or without) its own line, or is misspelt |
| A library name | The name isn't in the library, or is in more than one folder. The message lists what to write |
| Stability | Not enough supports, or releases that leave a node free to spin |
| A node on a plate | The node is inside the plate but not on a mesh point, or inside an opening |
| Plates not lining up | Neighbouring plates get a different number of elements along their shared edge; adjust mesh= |