WebCAE
← Back to documentation

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

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_script tool 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=outer

Directional 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 vonMises

Execution 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 = expr declares or reassigns variables.
  • if / else, for x in <range or list>, while provide 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), and null.

Built-in functions

abs, sqrt, min, max, floor, ceil, round, len, str, num, basename.

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) on tet4, tet10, hex8, and hex20.
  • `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/CHT load 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_cycles

Rotor 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

QuantityPhysical meaningSI Unit
displacement_magnitudeTotal resultant displacementm
displacement_x / y / zDisplacement componentsm
vonMisesEquivalent von Mises stressPa
principalMax / principalMinMaximum ($sigma_1$) and minimum ($sigma_3$) principal stressPa
stress_xx / yy / zz / xy / yz / zxComponents of Cauchy stress tensorPa
strain_xx / yy / zz / xy / yz / zxComponents of small strain tensor—
plastic_strain / plastic_strain_maxNodal / peak Gauss-point equivalent plastic strain $ar{ arepsilon}^p$—
plastic_fractionFraction of Gauss points yielding under plasticity law—
limit_load_factorLast converged load proportionality factor $lambda$ at collapse—
frequencyModal natural frequencyHz
load_factorBuckling eigenvalue load multiplier $lambda_{ ext{cr}}$—
temperatureContinuum temperature fieldK
reaction_x / y / z / reaction_magnitudeSupport reaction force components and resultantN
j_integral3D Equivalent Domain Integral (EDI) $J$-integralJ/m²
sif_k1 / k1, k2, k3Mode I, II, III stress intensity factorsPa·m^0.5
kink_angle_degErdogan–Sih crack propagation kinking angle $ heta_0$deg
paris_cyclesCalculated fatigue life cycles to critical crack sizecycles
max_void_fractionPeak void volume fraction $f$ in GTN porous plasticity—
czm_damageCohesive zone delamination damage index $d in [0, 1]$—
cmy_conductance_hcCooper–Mikic–Yovanovich thermal contact conductance $h_c$W/(m²·K)
rom l2_magnitude_errorRelative $L_2$ error of Krylov-Padé fast frequency sweep%
rom speedup_factorWall-clock execution speedup factor of ROM sweep over direct solve—
psd_grms / psd_disp_1sigma / psd_disp_3sigmaRandom vibration 1$sigma$ and 3$sigma$ RMS responsesm
psd_1sigma_vm / psd_3sigma_vmSegalman–Fulcher random vibration equivalent stress RMSPa
stl_resonance_dbSound Transmission Loss (STL) at acoustic cavity resonancedB
fsi force_conservation_errorRelative error in CFD-to-solid force conservation—
fsi heat_conservation_errorRelative error in CFD-to-solid conjugate heat-flux conservation—
gpu relative_residualResidual norm $Ax - b/b$ of defect-corrected GPU solve—
gpu memory_reduction_factorMemory reduction factor achieved by matrix-free P2 operator—
bolt_working_force / bolt_stress / bolt_safety_factorVDI 2230 bolt preload parametersN / Pa / —
whirl_splittingFrequency difference between forward and backward rotor whirl modesHz
rotor_crit_speed_1First synchronous critical speed $Omega_{ ext{cr}}$ of rotating shaftrad/s
adaptive_gci_percentRoache Grid Convergence Index (GCI) on finest mesh%
adaptive_zz_error_percentZienkiewicz–Zhu superconvergent patch recovery relative stress error%
adaptive_passesNumber of completed $h$-refinement iterations—
submodel_peak_vmPeak von Mises stress in extracted local submodelPa
phase_field_max_damagePeak phase-field crack damage index $d in [0, 1]$—
phase_field_reaction_forcePeak structural load capacity before catastrophic crack propagationN
phase_field_crack_volumeMesh integral of crack volume $int d , dV$m³
biot_max_pore_pressurePeak fluid pore pressure in consolidation processPa
biot_max_settlementMaximum foundation settlement displacementm
biot_max_darcy_velocityPeak Darcy interstitial seepage velocitym/s
maxwell_max_b / maxwell_joule_powerPeak magnetic flux density and total induced Joule heatingT / W
maxwell_skin_depthElectromagnetic alternating-current skin depth $delta$m
radiation_net_heat_fluxPeak net radiative heat transfer rate in enclosureW
radiation_reciprocity_errorResidual of enclosure view factor reciprocity $A_i F_{ij} = A_j F_{ji}$—
generative_volume_fractionFinal retained solid volume fraction in topology optimization—
generative_complianceFinal compliance (inverse structural stiffness)J
composite_tsai_wu / composite_puck_fiPeak Tsai–Wu and Puck failure indices across laminate plies—
composite_min_sfFirst-ply failure safety margin factor—
tip_displacement / analytical_tip_displacementFinite element and closed-form analytical tip displacement for FGM barsm
relative_displacement_errorRelative error between FEM and exact analytical solution ($le 1%$)—
neutral_axis_shiftNeutral axis shift of graded FGM beam $ar{z} = int z E(z) dz / int E(z) dz$m
min_youngs_modulus / max_youngs_modulusMinimum and maximum local Young's modulus across continuum domainPa
resultant_force_mag / resultant_moment_magResultant force and moment integrals from spatial pressure / traction fieldsN / N·m
mpc_equation_countNumber of point-wise multipoint constraint (MPC) equations for curvilinear BCs—
max_prescribed_dispMaximum prescribed local boundary displacement magnitudem
mid_temperature / analytical_mid_temperatureNumerical and analytical mid-domain temperature for FGM thermal conductionK
thermal_relative_errorRelative temperature error for graded thermal conduction ($le 1%$)—
total_heat_powerDomain integral of volumetric heat generation sources $int Q(mathbf{x}) dV$W
eval_E / eval_T / eval_pressurePoint 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, and refine zone evaluate dimensions in the unit declared via units.
  • 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_script via MCP or CLI), all numerical solvers, field evaluations, probes, and export commands operate with identical precision to interactive desktop sessions.

We use essential cookies to run this site, plus analytics cookies if you agree. Privacy Policy