DSL scripting reference
WebCAE's geometry preparation, boundary conditions, meshing, and solver settings all run through a unified command layer — usable from the graphical interface, from automated scripts, or via MCP tool calls. This reference documents every command as implemented in the current codebase: syntax, arguments, unit systems, supported finite elements, and verified operational boundaries.
On this page6 sections · 29 topics
- ›Geometry primitives and CAD import
- ›Body transformations
- ›Boolean operations, splitting, and curve imprinting
- ›Features, defeaturing, and repair
- ›Generative sketch modeling
- ›Meshing, boundary layer inflation, and mid-surface extraction
- ›Advanced constitutive materials (`material`)
- ›Section and stiffener assignment, 2D section FEM
- ›Boundary conditions, loads, and follower pressure
- ›Contacts, couplings, preloads, and cyclic symmetry
- ›Solvers and multiphysics analysis (`solve`)
- ›High-performance compute and GPU acceleration
- ›3D Fracture mechanics (`fracture evaluate`)
- ›Rotor dynamics (`rotor`) and parametric DOE (`doe`)
- ›Specialized multiphysics modules
- ›Postprocessing and inspection
Introduction
WebCAE operates through a unified command layer: every user interaction in the graphical interface — importing and preparing geometry, setting boundary conditions and loads, meshing, running linear, nonlinear, or multiphysics solvers, and inspecting fields — maps directly to a statement in a domain-specific scripting language (DSL). The ribbon buttons, context menus, and wizard panels execute the exact same command routines as scripts. Anything built by hand can be scripted, reproduced deterministically, and version-controlled as plain text.
You can execute scripts in two ways:
- In the application — open the Terminal panel inside WebCAE and type or paste commands. Each command executes immediately against the active model.
- Through the MCP server — the
cae_run_scripttool accepts DSL scripts as strings and returns printed logs, recorded values, and status codes. This enables external AI agents and automated testing pipelines to control WebCAE headlessly.
A script is plain UTF-8 text with one command per line. Blocks and loops use { }. Comments begin with # or //.
Finite element families and modeling workflows
WebCAE provides complete, verified support for modern industrial finite element families across 3D solids, 2D shells, 1D beams, and transitional interfaces:
1. 3D Solid elements:
- tet4: linear 4-node tetrahedra for fast geometry approximation.
- tet10: quadratic 10-node tetrahedra (order=2) with midside nodes for high-accuracy stress, vibration, and thermal gradient analysis.
- hex8: linear 8-node hexahedral bricks for regular prismatic subdomains.
- hex20: quadratic 20-node serendipity hexahedral bricks for structured volume discretization.
- hex27: triquadratic 27-node Lagrange hexahedra (8 corners, 12 midsides, 6 face centers, 1 interior body center), providing complete 3D quadratic tensor interpolation and completely eliminating parasitic shear locking in pure and transverse bending.
- pyr5 / pyr13: conformal 5-node linear and 13-node quadratic pyramid transition elements based on Bedrosian–Bergot rational shape functions, connecting structured hexahedral boundary layers (Hex20/Hex27) directly to unstructured tetrahedral cores (Tet10) without non-conforming hanging nodes or artificial MPC constraint equations.
- wedge6: linear 6-node prismatic wedges for structured near-wall boundary layer inflation.
2. 2D Shell elements:
- MITC4 (Mixed Interpolation of Tensorial Components) 4-node quadrilaterals and 3-node triangles with formulation-level protection against shear and membrane locking in thin-to-moderate structures.
3. 1D Beam elements:
- 3D Timoshenko beam members with 6 degrees of freedom per node ($u_x, u_y, u_z, heta_x, heta_y, heta_z$), accounting for axial, bending, transverse shear, and Saint-Venant torsional stiffness.
4. 2D Arbitrary Cross-Section FEM (`section solve_2d`):
- High-precision 2D finite element solver for arbitrary open, closed, thin-walled, or solid cross-sectional profiles. Computes Saint-Venant torsional constant $J_t$, shear center coordinates $(y_{sc}, z_{sc})$, Vlasov sectorial warping inertia $I_omega$, and Timoshenko energetic shear correction factors $(k_y, k_z)$.
5. Coupled stiffened panels:
- Thin-walled shell sheets reinforced by 3D beam stiffeners (assign beam edges=) sharing identical finite element nodes, with Steiner parallel-axis eccentric offsets and thickness-aware moment transfer.
Geometry entity addressing (unified numbering journal)
All CAD/B-Rep surfaces, edges, vertices, and bodies are addressed strictly by numbers assigned by the document tree:
fix surface number 1
load surface number 2 force=5000 component=z
fix edge number 4
assign beam edges=12,14 section=rect w=10 h=30 flush=outerDirectional bounding-box face directions (such as +X, -Z, face_pos_x, bbox_face_1) and positional forms without the keyword number (such as surface 1) are rejected with an explicit syntax error. To inspect entity numbers, coordinates, and surface normals for any body in your script, run list faces of <body-id> or list edges of <body-id>.
Quick start: cantilever bar, start to finish
This verified example sets up a rectangular bar, meshes it with quadratic tetrahedra (tet10), clamps one end face, applies a 5000 N axial tension on the opposite end face, solves linear statics, and verifies reaction equilibrium:
units mm
material E=200e9 nu=0.3 density=7850
primitive box dx=20 dy=20 dz=100
mesh tet size=6 order=2
fix surface number 1
load surface number 2 force=5000 component=z
solve static
reactions
probe displacement_magnitude target="surface number 2"
minmax vonMisesExecution steps:
1. units mm — declares the length unit for procedural commands (beam, shell, mass, mesh refinement zones).
2. material — sets Young's modulus (200 GPa), Poisson's ratio (0.3), and density (7850 kg/m³) in SI units.
3. primitive box dx=20 dy=20 dz=100 — creates a 20×20×100 mm solid bar (body1).
4. mesh tet size=6 order=2 — generates an adaptive quadratic tetrahedral mesh (tet10) with a 6 mm target element size.
5. fix surface number 1 — fully clamps surface number 1 (the base end at $z=0$).
6. load surface number 2 force=5000 component=z — applies 5000 N along +z on surface number 2 (the opposite end at $z=100$).
7. solve static — triggers linear static FEA solution.
8. reactions — queries reaction forces at constraints.
9. probe displacement_magnitude — verifies that tip elongation matches $delta = FL/(EA) = 6.25 imes 10^{-6} ext{ м}$ within analytical tolerance.
Language basics
Units
units <m|mm|in> sets the length unit used by procedural commands (beam, shell, mass, refine zone). When omitted, the default is millimetres (mm). Imported CAD files and OCCT primitives carry native coordinates; units does not rescale them. The solver boundary always operates in standard SI units: metres, newtons, pascals, and kilograms.
Variables, control flow, functions
let x = 10
let faces = list faces of body1
if x > 5 {
print "large"
} else {
print "small"
}
for i in [0..3] {
print i
}
let n = 0
while n < 3 {
n = n + 1
}
func square(v) {
return v * v
}
print square(4)let name = exprdeclares or reassigns variables.if / else,for x in <range or list>,whileprovide control flow. Ranges use[from..to]or[from..to:step].func name(params) { ... return expr }creates reusable functions.- Safety limits: loop execution caps at 1,000,000 iterations; recursion depth caps at 64 calls.
- Value types: numbers, strings, booleans, arrays, objects (e.g. entries returned from
list faces of ...with.id,.number,.area,.centroid,.normal), andnull.
Built-in functions
abs, sqrt, min, max, floor, ceil, round, len, str, num, basename.
print / record
print <value...> writes to the execution console. record <value...> stores values in the script structured output payload, accessible programmatically via MCP.
Vector arguments
Named arguments accept 3D vectors as comma-separated numbers: origin=0,0,10, force=1000,0,0, points=0,0,0, 10,0,0, 10,10,0. Single numbers are evaluated as scalars.
Command reference
Geometry primitives and CAD import
`units [length=]<m|mm|in>` — sets length unit for procedural commands. Default is mm.
`box dx dy dz` — creates an axis-aligned box with one corner at origin. Supports positional arguments or dx=/dy=/dz=.
`primitive <shape> [params...]` — creates parametric solids: box, cylinder, sphere, cone, torus, wedge, pipe, hollowBox.
``dsl
primitive cylinder r=10 h=50
``
`import "<path>" [format=step|iges]` — imports external CAD files. Paths must be quoted.
``dsl
import "bracket.step"
``
Body transformations
- `body translate [dx= dy= dz=]` — translates the most recently created body.
- `move <target> dx dy dz` (or
delta=x,y,z) — translates a named body. - `rotate <target> angle= [axis=] [at=]` — rotates a body about an axis through a point.
- `mirror <target> [normal=] [at=]` — mirrors a body across a plane.
- `scale <target> factor= [at=]` — scales a body uniformly about a center.
- `pattern <linear|circular> <target> count= [step=] [axis=] [at=] [angle=]` — duplicates bodies in linear or circular arrays.
Boolean operations, splitting, and curve imprinting
- `boolean <union|cut|intersect> target= tool=` — standard Boolean modeling between two solid bodies.
- `imprint <target> points=x0,y0,z0,x1,y1,z1,...` — imprints 3D polyline curves onto a sheet body or solid face, splitting faces and producing conformal B-Rep edges with document numbers without splitting the solid volume.
- `imprint <target> plane point=x,y,z normal=x,y,z` — imprints a datum plane onto faces of a sheet or solid.
- `split target=<body> plane=<name>` or `split target=<body> point= normal=` — cuts a body into multiple separate solids.
- `sew <a> <b>`, `union <a> <b>` — low-level topology sewing and union.
- `remove <target...>` / `delete <target...>` — deletes bodies from the model.
Features, defeaturing, and repair
- `fillet <target> radius= [edges=i,j]` — applies fillet radius to edges.
- `chamfer <target> distance= [edges=]` — applies chamfers to edges.
- `hollow <target> thickness= [openFaces=]` — shells a solid to uniform wall thickness.
- `defeature <target> [maxHoleRadius=] [maxFaceArea=] [faces=i,j]` — suppresses small holes, fillets, and sliver faces before meshing.
- `repair <target> [merge] [heal] [tolerance=]` — runs geometric healing on imperfect CAD boundaries.
Generative sketch modeling
- `sketch points=x0,y0,z0,x1,y1,z1,... [as=face|wire] [closed=true]` — defines planar polygons or wires.
- `extrude <target> [delta=x,y,z | dx= dy= dz=]` — extrudes profiles into prismatic solids.
- `revolve <target> angle= [axis=x,y,z] [at=x,y,z]` — revolves profiles about an axis.
- `sweep <profile> path=<body>` — sweeps sections along 3D guide trajectories.
- `loft <section1> <section2> [...]` — blends smooth volumes through section profiles.
Meshing, boundary layer inflation, and mid-surface extraction
`mesh [all|build|hex|tet|shell] [size=h] [order=1|2] [surface=tri|quad]` — builds the finite element mesh.
- mesh tet size=h order=1 — linear 4-node tetrahedral mesh (tet4).
- mesh tet size=h order=2 — quadratic 10-node tetrahedral mesh with midside nodes (tet10).
- mesh hex nx=N ny=M nz=K — structured 8-node (hex8) or 20-node (hex20) hexahedral mesh.
- mesh tet size=h surface=quad — quad-dominant shell sheet meshing using MITC4 elements.
- refine zone at=x,y,z radius=r size=h — defines local spherical mesh sizing zones.
- refine sweep source="surface number A" target="surface number B" layers=N — structured sweep meshing between opposing faces.
`mesh inflate surface number N layers=K first_height=h1 growth_rate=r` — generates structured prismatic (Wedge6) or hexahedral (Hex8) boundary layer inflation along wall surfaces. Uses multi-iteration Laplacian normal smoothing at corners to prevent self-intersection and evaluates Gauss-point Jacobians to guarantee $det J > 0$ with zero inverted elements.
``dsl
mesh inflate surface number 3 layers=5 first_height=0.15 growth_rate=1.2
``
`geometry midsurface pair="surface number A,surface number B" [max_thickness=t]` — automatically detects opposed thin-walled face pairs with anti-parallel normals, constructs the medial shell surface, and assigns local thickness fields $t(mathbf{x}) = |mathbf{x}_{top} - mathbf{x}_{bot}|$. Verifies mass parity ($|M_{shell} - M_{solid}|/M_{solid} < 0.1%$) and flexural rigidity equivalence $D = rac{Et^3}{12(1-
u^2)}$.
``dsl
geometry midsurface pair="surface number 1,surface number 2"
``
`mesh io format=inp|bdf|msh|unv|vtk|stl_deformed [export="path"] [import="path"] [scale=alpha]` — bidirectional mesh exchange and deformed shape export:
- Formats: Abaqus (.inp), Nastran (.bdf), Gmsh (.msh v2.2 and v4.1), and VTK (.vtu / .vtk) across Tet4, Tet10, Hex8, Hex20, Wedge6, Tri3, Quad4. Preserves named physical sets mapped to surface number N.
- export="deformed.stl" scale=10.0: exports deformed mesh geometry $mathbf{x} + alpha mathbf{u}$ with automatic negative-Jacobian guards that prevent element inversion.
``dsl
mesh io format=inp export="model.inp"
mesh io format=stl_deformed export="deformed.stl" scale=5.0
``
Advanced constitutive materials (material)
WebCAE includes a complete suite of verified constitutive material models:
- Isotropic linear elasticity:
``
dsl material E=200e9 nu=0.3 density=7850 alpha=1.2e-5 kappa=50 material preset=steel``
- 3D Orthotropic solid:
``
dsl material orthotropic E1=140e9 E2=10e9 E3=10e9 nu12=0.3 nu23=0.4 nu13=0.3 G12=5e9 G23=3.5e9 G13=5e9 density=1600 orientation surface number 1 axis=1,0,0 angle=45``
- $J_2$ (von Mises) elastoplasticity:
``
dsl material plastic yield=250e6 hardening=1e9 density=7850``
- Hyperelasticity (6 verified models):
-
neo_hookean:c10=,d1=-mooney_rivlin:c10=,c01=,d1=-yeoh:c10=,c20=,c30=,d1=-ogden:mu1=,alpha1=,mu2=,alpha2=,d1=-arruda_boyce:mu=,lambda_m=,d1=-gent:mu=,jm=,d1=``dsl material hyperelastic model=mooney_rivlin c10=400000 c01=100000 d1=1e-7 material hyperelastic model=arruda_boyce mu=280000 lambda_m=7.0 d1=1e-7``
- Creep (Norton–Bailey law $dot{arepsilon}_{cr} = A sigma^n t^m$):
``
dsl material creep model=norton_bailey A=1e-16 n=4.5 m=-0.2``
- Rate-dependent viscoplasticity (Perzyna overstress model):
``
dsl material viscoplastic model=perzyna yield=250e6 eta=1e6 m=2.0``
- Viscoelasticity (Prony series relaxation $E(t) = E_infty + sum E_i e^{-t/ au_i}$):
``
dsl material viscoelastic model=prony g1=0.3 tau1=10.0 g2=0.2 tau2=100.0``
- Pressure-sensitive geomechanics (Drucker–Prager cone/apex return-mapping):
``
dsl material drucker_prager cohesion=2.5e6 phi=30 psi=10``
- Porous metal plasticity (Gurson–Tvergaard–Needleman GTN model):
``
dsl material gtn q1=1.5 q2=1.0 q3=2.25 f0=0.005 fc=0.04 fF=0.15 fn=0.04 sn=0.1 epsn=0.3``
- Coupled thermo-elastoplasticity with piezocaloric effect:
``
dsl material thermo_elastoplastic E=200e9 nu=0.3 yield=300e6 gough_joule=on beta_tq=0.9``
Captures elastic Gough–Joule piezocaloric cooling under tension ($Delta T < 0$) transitioning into Taylor–Quinney plastic dissipation heating ($eta_{TQ} = 0.9$, $Delta T > 0$) post-yield.
- Functionally Graded Materials (FGM) and Spatial Material Fields (`material fgm` / `material spatial`):
``dsl
# Exponential gradation
material fgm id=mat_fgm target="solid:1" cs=cs_local E="210e9 * exp(0.5 * x)" nu="0.3" rho="7850 * (1 - 0.1*x)" alpha="1.2e-5 * (1 + 0.5*z)" kappa="50 * exp(0.8 * x)"
# Power-law gradation
material fgm id=mat_power target="solid:1" cs=cs_local E="70e9 + (380e9 - 70e9) * (z / 0.1)^2" nu="0.25"
# Curvilinear orthotropic gradation in local cylindrical CS
material fgm id=mat_cyl target="solid:1" cs=cs_cyl E1="150e9 * (r / 0.1)^0.5" E2="10e9" E3="10e9" nu12=0.25 G12=5e9
``
Section and stiffener assignment, 2D section FEM
- `section shell t=<thickness>` — sets shell wall thickness.
- `section solve_2d points=x0,y0,x1,y1,...` — solves cross-sectional Poisson/Laplace boundary value problems for arbitrary profiles, outputting $J_t$, $(y_{sc}, z_{sc})$, $I_omega$, $k_y$, and $k_z$.
- `assign beam edges=n1,n2,... [section=rect|circle|pipe|ibeam|tee] flush=outer|inner [ecc=...]` — attaches Timoshenko beam stiffeners along B-Rep edges of a sheet body with eccentric offsets.
Boundary conditions, loads, and follower pressure
`fix surface number N [component=all|x|y|z|normal] [value=]` — imposes zero or prescribed displacement on a surface from the model tree.
``dsl
fix surface number 1
``
`fix edge number N`, `fix vertex number N` — clamps edge curves or vertices.
`load surface number N [pressure=|force=|distributed_force=|accel=] [component=x|y|z|normal]` — applies mechanical loads.
``dsl
load surface number 2 force=5000 component=z
load surface number 2 pressure=1000000
``
`load follower_pressure surface number N pressure=P` — applies large-deformation follower pressure updating the facet normal $mathbf{n}(mathbf{X} + mathbf{u}) , dA$ dynamically, with an exact unsymmetric load-stiffness tangent matrix $K_{ ext{load}}(mathbf{u})$ ensuring quadratic Newton–Raphson convergence.
``dsl
load follower_pressure surface number 3 pressure=2000000
``
`remote load surface number N point=x,y,z force=fx,fy,fz [moment=mx,my,mz]` — applies forces/moments at an offset coordinate, coupled to target surfaces.
- `coord_system id= kind=cartesian|cylindrical|spherical origin=x,y,z axis_z=zx,zy,zz axis_x=xx,xy,xz [euler=r,p,y]` — defines local orthonormal coordinate systems. In expressions, automatically exposes Cartesian ($x, y, z$), Cylindrical ($r, heta, heta_{ ext{deg}}, z$), Spherical ($R, heta, phi, phi_{ ext{deg}}$), and global ($X, Y, Z$) coordinates.
``
dsl coord_system id=cs_cyl kind=cylindrical origin="0,0,0" axis_z="0,0,1" axis_x="1,0,0" coord_system id=cs_local kind=cartesian origin="10,20,0" euler="0,0,45"``
- `load spatial surface number N kind=pressure|traction expr="..." [component=r|theta|z|x|y] [cs=...]` — applies coordinate-dependent surface pressure (such as hydrostatic $p(z) =
ho g max(0, H - z)$) or directional traction (such as azimuthal bearing load $p( heta) = p_0 cos heta$) without eval.
``
dsl load spatial surface number 2 kind=pressure expr="9810 * max(0, 5.0 - z)" cs=cs_local load spatial surface number 2 kind=traction component=x expr="10e6 * cos(theta)" cs=cs_cyl``
- `load spatial solid:1 kind=body_force component=r expr="..." [cs=...]` — applies spatially varying body forces, such as centrifugal force $b_r =
ho omega^2 r$.
``
dsl load spatial solid:1 kind=body_force component=r expr="7850 * (100^2) * r" cs=cs_cyl``
- `bc spatial surface number N kind=displacement component=r|theta|z|x|y expr="..." [cs=...]` — imposes curvilinear prescribed displacement fields (such as torsional twist $u_ heta = omega r z$), generating exact point-wise multipoint constraint (MPC) equations at boundary nodes.
``
dsl bc spatial surface number 1 kind=displacement component=theta expr="0.005 * r * z" cs=cs_cyl``
- `thermal spatial surface number N kind=temperature|heat_flux|convection expr="..." [cs=...]` and `thermal spatial solid:1 kind=heat_generation expr="..." [cs=...]` — applies coordinate-dependent thermal boundary conditions and Gaussian volumetric heat generation $Q(r) = Q_0 e^{-r^2 / w^2}$.
``
dsl thermal spatial surface number 1 kind=temperature expr="300" thermal spatial surface number 2 kind=heat_flux expr="5000 * cos(theta)" cs=cs_cyl thermal spatial solid:1 kind=heat_generation expr="1e7 * exp(-(r^2) / 0.0025)" cs=cs_cyl``
Contacts, couplings, preloads, and cyclic symmetry
- `contact tied|penalty|friction master="surface number N" slave="surface number M" [mu=0.2]` — unilateral Mortar contact and 3D Coulomb frictional stick-slip contact.
- `contact czm master="surface number N" slave="surface number M" kn= kt= tn0= tt0= g1c= g2c= eta=` — bilinear mixed-mode Cohesive Zone Model (CZM) with Benzeggagh–Kenane (BK) fracture energy criteria and Duvaut–Lions viscous regularization.
- `contact thermal_cmy master="surface number N" slave="surface number M" h0= hcmy= hmicro= kgas=` — pressure- and gap-dependent Cooper–Mikic–Yovanovich (CMY) thermal contact conductance dynamically coupled with mechanical contact pressure $p_n$.
- `contact beam_shell beam_edge="edge number N" shell_surface="surface number M" [mu=0.2]` — thickness-aware contact enforcement with offset gap $g_n = (mathbf{x}_s - mathbf{x}_m)cdotmathbf{n} - (R_{ ext{beam}} + rac{1}{2}t_{ ext{shell}})$ and work-conjugate eccentric moment transfer onto beam/shell rotational DOFs.
- `coupling rbe mode=rbe2_rigid|rbe2_pinned|rbe3 master="vertex number N" slave="surface number M"` — multipoint constraint kinematic couplings:
-
rbe2_rigid: locks all 6 DOFs. -rbe2_pinned: couples translations ($u_x, u_y, u_z$) while leaving slave rotations entirely unconstrained, preventing artificial moment locking. -rbe3: distributing coupling using tributary moments of inertia without artificial structural stiffening. - `bolt preload master="surface number N" slave="surface number M" preload=F diameter=d` — ISO 898-1 / VDI 2230 virtual bolt pre-tensioning evaluating working force, bolt stress, and safety factor.
- `cyclic_symmetry sectors=Ns nodal_diameter=k master="surface number N" slave="surface number M"` — harmonic cyclic symmetry for bladed disks and impellers across all nodal diameters $k ge 0$:
- $k=0$: single sector with periodic boundary tying.
- $1 le k < N_s/2$: coupled twin-sector $(cos, sin)$ block-circulant reduction.
- $k=N_s/2$: single sector with anti-periodic boundary tying.
-
expand_full_wheel=on: analytical $360^circ$ multi-sector field reconstruction.
Solvers and multiphysics analysis (solve)
`solve <analysis_type> [options...]` executes the finite element solution:
- `solve static` — linear static stress, strain, and displacement analysis.
- `solve nonlinear [steps=N] [method=nr|arclength]` — incremental Newton–Raphson or Crisfield cylindrical arc-length post-buckling continuation.
- `solve modal [nmodes=k] [prestress=on|off]` — eigenvalue extraction for natural frequencies and mode shapes. Supports differential stress stiffening (
prestress=on) ontet4,tet10,hex8, andhex20. - `solve buckling [nmodes=k]` — linear eigenvalue stability analysis for critical load multipliers $lambda_{ ext{cr}}$.
- `solve thermal [kind=steady|transient] [dt=] [steps=] [radiation=on]` — steady-state and transient thermal conduction with nonlinear $kappa(T)$ and surface radiation.
- `solve thermoelastic` — coupled thermal stress analysis driven by temperature gradients.
- `solve transient method=hht|newmark|explicit dt= steps= [alpha=-0.05]` — implicit HHT-$alpha$ / Newmark structural dynamics or explicit central-difference dynamics with element erosion.
- `solve harmonic fmin= fmax= steps= [method=direct|modal|rom]` — harmonic frequency response. With
method=rom, executes fast frequency sweeps via multi-point second-order Krylov (SOAR) and Padé rational transfer function approximations, matching full-order solves at $> 300 imes$ speedup. - `solve psd dir=x|y|z damping= psd=[(f1,g1),...] [method=cqc]` — random vibration power spectral density analysis using Der Kiureghian Complete Quadratic Combination (CQC) cross-modal correlation, Segalman–Fulcher modal von Mises stress RMS, and Dirlik fatigue life estimation.
- `solve vibroacoustic fmin= fmax= steps= wet_surface="surface number N"` — monolithic two-way coupled complex fluid-structure $mathbf{u} ext{–}p$ Helmholtz system, calculating fluid added-mass $M_{ ext{added}}$, wet eigenfrequencies, and Sound Transmission Loss (
STL) matching analytical acoustic mass laws. - `solve fsi_map cfd_source="flow.vtu" wet_surface="surface number N"` — conservative one-way aerothermal
CFD -> FSI/CHTload mapping using Gauss quadrature virtual work, ensuring machine-precision force and heat-flux conservation (discrepancy $le 10^{-12}$) and strict moment balance. - `solve adaptive [tol=2.0] [max_passes=4]` — tolerance-driven multi-pass Zienkiewicz–Zhu ($h$-adaptive) convergence loop. Evaluates superconvergent patch recovery (SPR) energy norm errors $eta_e$, applies Babuška–Rheinboldt error equidistribution, and clusters refinement zones until $eta_{ ext{rel}} le eta_{ ext{tol}}$.
- `solve spatial_fem [length=] [width=] [height=] [nx=]` and `solve spatial_thermal [length=] [nx=]` — solves continuum models with functionally graded materials (FGM), spatial pressure, centrifugal loads, and curvilinear boundary conditions with multi-point Gauss quadrature and closed-form analytical benchmarking.
High-performance compute and GPU acceleration
`gpu_solve [precision=mixed] [amg=on] [matrix_free=on]` or `solve static backend=gpu`:
- Mixed-precision $f64/f32$ defect correction: uses single-precision $f32$ factorization / iteration in WebGPU compute shaders, coupled with double-precision $f64$ residual correction $mathbf{r} = mathbf{b} - Amathbf{x}$, guaranteeing full $10^{-12}$ analytical accuracy while halving VRAM bandwidth.
- Double-single `ds64` Knuth/Dekker emulation: emulates 64-bit floating point arithmetic inside standard WebGPU compute pipelines.
- Smoothed Aggregation Algebraic Multigrid (`sa_amg`): native C++ SA-AMG preconditioner and PCG solver in webcae_solve, achieving mesh-independent iteration counts ($le 35$ iterations) on massive 3D solid meshes.
- Matrix-Free P2 operators (`matrix_free_tet10`, `matrix_free_hex20`): evaluates element stiffness-vector products directly on quadrature points without assembling large sparse matrices, enabling multi-million DOF solves on consumer hardware.
3D Fracture mechanics (fracture evaluate)
`fracture evaluate crack_front="edge number N" [j_integral=on] [sif=on] [kink=on] [paris=on]`: - 3D Equivalent Domain Integral (EDI): evaluates the volume $J$-integral over a domain surrounding the crack front using $C^1$ smooth plateau weight functions. - Two-State Interaction Integral ($M$-integral): decouples mixed-mode stress intensity factors, computing signed $K_I, K_{II}, K_{III}$. - Erdogan–Sih Maximum Tangential Stress (MTS): calculates the branched crack kinking angle $ heta_0$ along maximum hoop stress. - Adaptive Paris–Erdogan fatigue life: numerically integrates cyclic crack advance $rac{da}{dN} = C (Delta K)^m$ to determine critical crack length $a_c$ and remaining cycles to failure $N_f$.
fracture evaluate crack_front="edge number 8" j_integral=on sif=on kink=on paris=on
probe j_integral
probe sif_k1
probe kink_angle_deg
probe paris_cyclesRotor dynamics (rotor) and parametric DOE (doe)
- Rotor dynamics:
-
rotor shaft length=1.2 radius=0.03 elements=8 axis=z: defines a Timoshenko beam shaft or 3D solid mesh. -rotor disk node=4 mass=5.0 ip=0.04 id=0.02: attaches lumped inertia disks. -rotor bearing target="surface number 1" kxx=1e7 kyy=1e7: assigns orthotropic bearing stiffness and damping. -rotor unbalance node=4 mass=0.02 eccentricity=0.002: applies mass unbalance. -solve campbell omega_min=0 omega_max=600 steps=31: computes the Campbell diagram, gyroscopic Coriolis matrix $G(Omega)$, forward/backward whirl splitting, and $1X/2X$ synchronous critical speeds $Omega_{ ext{cr}}$. - Parametric DOE and optimization:
-
doe study method=lhs|sobol|factorial samples=32: selects Latin Hypercube, Sobol low-discrepancy, or Full-Factorial sampling. -doe param name=E type=material min=180e9 max=220e9: defines study parameters. -doe response responses=max_disp,compliance,max_vm,f1: selects output responses. -solve doe: evaluates real FE meshes across sample points, fits quadratic Response Surface Methodology (RSM) metamodels, evaluates Sobol sensitivity indices, and extracts the Pareto optimal front.
Specialized multiphysics modules
- Phase-field fracture:
solve phase_field l0=0.002 gc=2700 steps=40 fixed="surface number 1" displaced="surface number 2" max_disp=0.001 - Biot poroelasticity:
solve biot alpha=1.0 permeability=1e-12 viscosity=1e-3 dt=10 steps=20 load_pressure=1e6 - Maxwell electromagnetics:
solve maxwell freq=50 sigma=5.8e7 mur=1.0 current_density=1e6 - Cavity radiation:
solve radiation_cavity surfaces=[(surface number 1, 800, 0.8), (surface number 2, 300, 0.2)] - Generative topology optimization:
solve generative vol_frac=0.3 filter_radius=0.005 steps=40 fixed="surface number 1" load="surface number 2" - Laminated composites:
layup plies=[(0, 0.25), (45, 0.25), (-45, 0.25), (90, 0.25)] material=cfrp criterion=puck
Postprocessing and inspection
- `probe <quantity> [target=surface number N] [at=x,y,z]` — extracts local field values or surface aggregations.
- `minmax <quantity>` — queries minimum and maximum field values across the active mesh.
- `reactions [bc=]` — extracts reaction forces and moments ($R_x, R_y, R_z, M_x, M_y, M_z$) at constraints.
- `hotspots [grading=] [refine=]` — identifies stress concentration peaks and notch effects.
- `assert <domain> <metric> expected= [tol=0.05]` — automated testing assertion verifying that simulation results match reference targets within tolerance.
- `export vtk [path=]` — exports mesh and field results to standard VTK format.
Quantities available to probe / minmax / assert
| Quantity | Physical meaning | SI Unit | ||||
|---|---|---|---|---|---|---|
displacement_magnitude | Total resultant displacement | m | ||||
displacement_x / y / z | Displacement components | m | ||||
vonMises | Equivalent von Mises stress | Pa | ||||
principalMax / principalMin | Maximum ($sigma_1$) and minimum ($sigma_3$) principal stress | Pa | ||||
stress_xx / yy / zz / xy / yz / zx | Components of Cauchy stress tensor | Pa | ||||
strain_xx / yy / zz / xy / yz / zx | Components of small strain tensor | — | ||||
plastic_strain / plastic_strain_max | Nodal / peak Gauss-point equivalent plastic strain $ar{arepsilon}^p$ | — | ||||
plastic_fraction | Fraction of Gauss points yielding under plasticity law | — | ||||
limit_load_factor | Last converged load proportionality factor $lambda$ at collapse | — | ||||
frequency | Modal natural frequency | Hz | ||||
load_factor | Buckling eigenvalue load multiplier $lambda_{ ext{cr}}$ | — | ||||
temperature | Continuum temperature field | K | ||||
reaction_x / y / z / reaction_magnitude | Support reaction force components and resultant | N | ||||
j_integral | 3D Equivalent Domain Integral (EDI) $J$-integral | J/m² | ||||
sif_k1 / k1, k2, k3 | Mode I, II, III stress intensity factors | Pa·m^0.5 | ||||
kink_angle_deg | Erdogan–Sih crack propagation kinking angle $ heta_0$ | deg | ||||
paris_cycles | Calculated fatigue life cycles to critical crack size | cycles | ||||
max_void_fraction | Peak void volume fraction $f$ in GTN porous plasticity | — | ||||
czm_damage | Cohesive zone delamination damage index $d in [0, 1]$ | — | ||||
cmy_conductance_hc | Cooper–Mikic–Yovanovich thermal contact conductance $h_c$ | W/(m²·K) | ||||
rom l2_magnitude_error | Relative $L_2$ error of Krylov-Padé fast frequency sweep | % | ||||
rom speedup_factor | Wall-clock execution speedup factor of ROM sweep over direct solve | — | ||||
psd_grms / psd_disp_1sigma / psd_disp_3sigma | Random vibration 1$sigma$ and 3$sigma$ RMS responses | m | ||||
psd_1sigma_vm / psd_3sigma_vm | Segalman–Fulcher random vibration equivalent stress RMS | Pa | ||||
stl_resonance_db | Sound Transmission Loss (STL) at acoustic cavity resonance | dB | ||||
fsi force_conservation_error | Relative error in CFD-to-solid force conservation | — | ||||
fsi heat_conservation_error | Relative error in CFD-to-solid conjugate heat-flux conservation | — | ||||
gpu relative_residual | Residual norm $ | Ax - b | / | b | $ of defect-corrected GPU solve | — |
gpu memory_reduction_factor | Memory reduction factor achieved by matrix-free P2 operator | — | ||||
bolt_working_force / bolt_stress / bolt_safety_factor | VDI 2230 bolt preload parameters | N / Pa / — | ||||
whirl_splitting | Frequency difference between forward and backward rotor whirl modes | Hz | ||||
rotor_crit_speed_1 | First synchronous critical speed $Omega_{ ext{cr}}$ of rotating shaft | rad/s | ||||
adaptive_gci_percent | Roache Grid Convergence Index (GCI) on finest mesh | % | ||||
adaptive_zz_error_percent | Zienkiewicz–Zhu superconvergent patch recovery relative stress error | % | ||||
adaptive_passes | Number of completed $h$-refinement iterations | — | ||||
submodel_peak_vm | Peak von Mises stress in extracted local submodel | Pa | ||||
phase_field_max_damage | Peak phase-field crack damage index $d in [0, 1]$ | — | ||||
phase_field_reaction_force | Peak structural load capacity before catastrophic crack propagation | N | ||||
phase_field_crack_volume | Mesh integral of crack volume $int d , dV$ | m³ | ||||
biot_max_pore_pressure | Peak fluid pore pressure in consolidation process | Pa | ||||
biot_max_settlement | Maximum foundation settlement displacement | m | ||||
biot_max_darcy_velocity | Peak Darcy interstitial seepage velocity | m/s | ||||
maxwell_max_b / maxwell_joule_power | Peak magnetic flux density and total induced Joule heating | T / W | ||||
maxwell_skin_depth | Electromagnetic alternating-current skin depth $delta$ | m | ||||
radiation_net_heat_flux | Peak net radiative heat transfer rate in enclosure | W | ||||
radiation_reciprocity_error | Residual of enclosure view factor reciprocity $A_i F_{ij} = A_j F_{ji}$ | — | ||||
generative_volume_fraction | Final retained solid volume fraction in topology optimization | — | ||||
generative_compliance | Final compliance (inverse structural stiffness) | J | ||||
composite_tsai_wu / composite_puck_fi | Peak Tsai–Wu and Puck failure indices across laminate plies | — | ||||
composite_min_sf | First-ply failure safety margin factor | — | ||||
tip_displacement / analytical_tip_displacement | Finite element and closed-form analytical tip displacement for FGM bars | m | ||||
relative_displacement_error | Relative error between FEM and exact analytical solution ($le 1%$) | — | ||||
neutral_axis_shift | Neutral axis shift of graded FGM beam $ar{z} = int z E(z) dz / int E(z) dz$ | m | ||||
min_youngs_modulus / max_youngs_modulus | Minimum and maximum local Young's modulus across continuum domain | Pa | ||||
resultant_force_mag / resultant_moment_mag | Resultant force and moment integrals from spatial pressure / traction fields | N / N·m | ||||
mpc_equation_count | Number of point-wise multipoint constraint (MPC) equations for curvilinear BCs | — | ||||
max_prescribed_disp | Maximum prescribed local boundary displacement magnitude | m | ||||
mid_temperature / analytical_mid_temperature | Numerical and analytical mid-domain temperature for FGM thermal conduction | K | ||||
thermal_relative_error | Relative temperature error for graded thermal conduction ($le 1%$) | — | ||||
total_heat_power | Domain integral of volumetric heat generation sources $int Q(mathbf{x}) dV$ | W | ||||
eval_E / eval_T / eval_pressure | Point evaluation of Young's modulus, temperature, and pressure at at= | Pa / K / Pa |
Units, tolerances, and operational scope
- Geometry: CAD primitives, sketches, and imported STEP files use scene units (millimetres by default).
- Procedural elements:
beam,shell,mass, andrefine zoneevaluate dimensions in the unit declared viaunits. - Solver boundary: Loads (
force=,pressure=), material constants ($E$, $ u$, $ ho$), and postprocessing outputs (reactions,probe) operate strictly in SI units (m, N, Pa, kg). - Verification accuracy: Every solver feature is tested against analytical and NAFEMS benchmark references within a strict 5% relative error tolerance.
- Mesher scope: Automatic hexahedral meshing (
mesh hex) is tailored for orthogonal and sweepable topologies; general arbitrary CAD solids use adaptive tetrahedral meshing (mesh tet). - Headless automation: In headless environments (
cae_run_scriptvia MCP or CLI), all numerical solvers, field evaluations, probes, and export commands operate with identical precision to interactive desktop sessions.