RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
    • Study language
    • Geometry
    • Meshing
    • Materials
    • Models
    • Initial conditions
    • Loads
    • Structural loads
    • Thermal loads
    • Electromagnetic loads
    • Acoustic loads
    • Fluid loads
    • Constraints
    • Structural constraints
    • Thermal constraints
    • Electromagnetic constraints
    • Acoustic constraints
    • Fluid constraints
    • Connectors
    • Contact and interfaces
    • Inputs, sweeps and cases
    • Study contracts
Docs>Physics>Set up

Constraints

Constraints state what motion or field values are restricted. They are model objects, not meshing options and not solver guesses. Every target is a typed geometry region, so RunMat can reject a solid used where a face is required, a stale persistent id, or an ambiguous selector before solve.

DomainGuide
Supports, prescribed motion, coupling, ties, equations, periodicityStructural constraints
Temperature, thermal ties, jumps, and periodicityThermal constraints
Electric references, conductors, current constraints, gauges, and periodicityElectromagnetic constraints
Pressure and periodic acoustic conditionsAcoustic constraints
Velocity, walls, pressure reference, and periodic flowFluid constraints
Springs, dashpots, and foundationsConnectors
Contact and multiphysics transferInterfaces
Displacement, velocity, temperature, pressure, and field state at the initial instantInitial conditions

Find a constraint by modeling task

I need to model…Start here
Fixed, pinned, roller, sliding, simple, symmetry, or prescribed-motion supportStructural constraints
Bolt/weld idealization, rigid/distributing coupling, nonmatching tie, or equationStructural couplings and ties
Spring, dashpot, elastic support, or compliant mountConnectors
Opening, sliding, friction, bonded contact, or finite interface stiffnessInterfaces
Controlled temperature, adiabatic wall, thermal contact, or periodic temperatureThermal constraints
Ground, floating/equipotential conductor, current terminal, magnetic gauge, or sectorElectromagnetic constraints
Pressure-release surface, datum, acoustic periodic cell, or Bloch phaseAcoustic constraints
Inlet velocity, stationary/moving/slip wall, pressure datum, or periodic passageFluid constraints
Initial displacement, velocity, temperature, pressure, or restart stateInitial conditions

These are physical modeling choices, not alternative solver stabilization knobs. Each linked guide states the equation being imposed, exact .fea form, target topology, common conflicts, and evidence to inspect.

The guides distinguish essential constraints from natural boundaries. Pressure, heat flux, convection, impedance, radiation, magnetic insulation, and outlet pressure are documented with loads and boundary conditions, because they contribute flux or traction rather than directly prescribing the primary unknown.

Complete essential-constraint catalog

The .fea language accepts the following closed set. Family pages provide complete field syntax, equations, examples, conflicts, and verification evidence. If a kind is absent from this table, runmat check rejects it; RunMat does not reinterpret an unknown constraint as a generic penalty.

FamilyConstraint kindsPhysical role
Structural supportsstructural.fixed, structural.symmetry, structural.antisymmetryRemove the support/symmetry DOFs defined by the formulation
Structural prescribed statestructural.prescribed, structural.prescribed_motion, structural.normal_displacementPrescribe selected translations, rotations, motion, or normal displacement
Structural relationsstructural.rigid_coupling, structural.distributing_coupling, structural.tie, structural.periodic, structural.equationRelate DOFs across points or paired regions
Thermalthermal.temperature, thermal.periodic, thermal.tie, thermal.affine_jumpPrescribe temperature or relate temperature across boundaries
Electricalelectrical.potential, electrical.equipotential, electrical.floating_conductor, electrical.integral_current, electrical.potential_reference, electrical.periodicPrescribe or reference electric potential and terminal current
Magneticmagnetic.vector_potential, magnetic.vector_potential_ground, magnetic.coulomb_gauge, magnetic.periodic, magnetic.phase_shifted_periodicPrescribe potential, fix gauge freedom, or relate periodic fields
Acousticacoustic.pressure, acoustic.periodic, acoustic.phase_shifted_periodicPrescribe pressure or relate periodic acoustic fields
Fluidfluid.velocity, fluid.moving_wall, fluid.no_slip_wall, fluid.slip_wall, fluid.symmetry, fluid.pressure_reference, fluid.periodicPrescribe velocity/wall kinematics, gauge pressure, or periodic flow

The target must be a named geometry region. Boundary constraints reject solid and cell targets, except magnetic.coulomb_gauge, which may act on the admitted gauge domain. Paired constraints require distinct primary and secondary regions plus their mapping/tolerance contract. Scalar values retain their physical quantity: temperature cannot be used as a generic scalar, and pressure cannot stand in for an acoustic or fluid velocity condition.

Which constraint families can I execute today?

All cataloged constraints are part of the typed source contract and are available to runmat check. Native whole-study execution currently admits structural procedure graphs; thermal, electromagnetic, acoustic, fluid, and coupled procedure graphs remain checkable definitions rather than admitted end-to-end solves. A parser or semantic-check success proves that names, quantities, targets, and relations are coherent. It does not prove that the requested formulation has an execution, recovery, and publication path.

Each family guide states the relevant limitation next to its examples. The authoritative summary is FEA capability status. Validation claims require the evidence described in verification and validation, including formulation-specific references and fail-closed negative cases.

Complete connector and interface catalog

These declarations are related to constraints but assemble different mathematical objects:

CategoryClosed kinds
Connectoraxial_spring, axial_dashpot, isotropic_ground_spring, surface_normal_foundation
Structural contactcontact.frictionless, contact.coulomb
Fluid–structure transferfluid_structure.no_slip
Conjugate heat transferconjugate_heat_transfer.perfect, conjugate_heat_transfer.conductance, conjugate_heat_transfer.resistance

See connectors and interfaces. A directional point spring, six-DOF bushing, cohesive law, nonlinear gap spring, radiation interface, or porous jump is not implied by these names and must not be approximated by supplying dimensionally incompatible coefficients.

How do I prescribe a value that varies with time or frequency?

Where a constraint field admits PrescribedValue, bind a typed signal rather than writing an expression inside the constraint. The signal owns domain, interpolation, extrapolation, and function provenance; the constraint owns target and physical meaning.

signal platen_motion : displacement over time {
    samples = [
        { at = 0 s, value = 0 mm },
        { at = 1 s, value = 2 mm },
        { at = 2 s, value = 2 mm },
    ]
    interpolation = linear
    extrapolation = reject
}

model compression_fixture {
    constraint moving_platen {
        structural.prescribed {
            target = geometry.specimen.region.top_platen
            frame = global
            uz = signal.platen_motion
        }
    }
}

The analysis domain must be covered by the signal domain. A frequency-domain constraint also needs the admitted complex amplitude/phase representation; a real magnitude is not silently promoted to a zero-phase complex boundary.

How do I constrain an assembly without hiding its load path?

Give every physical support, tie, connector, and interface its own stable name and the smallest region that represents its footprint. Do not place one fixed constraint on all mounting faces merely because it removes rigid modes. For an assembly, inspect reactions by support, connector endpoint forces, interface transfer, and the moment balance about a stated origin. This preserves the load path and makes a support-assumption comparison possible.

How do I model a boundary condition that RunMat does not list?

Do not reuse the nearest-looking declaration. Write down the field, conjugate flux, equation, units, target topology, time/frequency dependence, and whether the relation is essential, natural, constitutive, unilateral, or coupled. If no catalog entry has that contract, the condition is not currently first class. The family guides identify common unsupported cases and the evidence a future typed implementation would require.

Common form

model supported_part {
    constraint support {
        structural.fixed { target = geometry.part.region.mounting_faces }
    }
}

The declaration name (support) is stable model identity. The kind (structural.fixed) selects a closed typed contract. target resolves a named region from the bound geometry. An analysis may activate, continue, or modify model objects explicitly; omission never means “let the solver choose.”

Which boundary condition should I use?

Start with the field being solved and the physical statement at the boundary:

Physical statementUseDo not substitute
A displacement or rotation component is knownstructural.prescribedAn arbitrary stiff spring
A surface cannot movestructural.fixedZero force
A temperature is controlledthermal.temperatureVery large convection coefficient
Heat transfer to an ambient is knownthermal.convection loadFixed temperature
Fluid sticks to a stationary wallfluid.no_slip_wallZero pressure
Fluid pressure needs a gauge datumfluid.pressure_referenceOutlet pressure on every outlet
Two surfaces are permanently kinematically bondedstructural/thermal tieContact
Two surfaces may open or slidecontact interfaceTie
Repeating boundaries are geometrically mappedfamily-specific periodicCoincident-node assumptions
Motion or fields transfer between physicstyped multiphysics interfaceDuplicated manual histories

Essential constraints prescribe the primary unknown. Natural boundaries prescribe its conjugate flux or traction and are documented under loads. Connectors add constitutive relations; interfaces transfer state between two regions. Keeping these categories separate makes assembly, validation, and preview behavior predictable.

How do region targets connect constraints to CAD?

Define a named, typed geometry region from persistent CAD identity or an explicit geometric selection, then reference it as geometry.<geometry-name>.region.<region-name>. The compiler checks the region's entity dimension and cardinality before meshing; the admission path records how it maps to solver entities after meshing.

geometry bracket {
    file = "bracket.step"
    units = mm

    region mounting_faces : face {
        select tag "mount"
        expect one_or_more
    }
}

model supported_bracket {
    constraint mounting_support {
        structural.fixed {
            target = geometry.bracket.region.mounting_faces
        }
    }
}

If a CAD revision removes or splits the tagged region contrary to its cardinality contract, checking fails. RunMat does not silently choose a similarly located face.

How do I constrain only one direction?

Use a component-wise structural prescribed constraint in an explicit frame. A fixed support removes all admitted structural degrees of freedom and is too strong when a roller, slider, or bearing only blocks selected motion. See structural constraints for component masks, local frames, normal displacement, symmetry, and couplings.

How do I connect nonmatching meshes?

Use a typed tie or interface and name both sides. Pairing tolerance controls geometric matching; it does not create compliance. Choose structural tie for kinematic continuity, thermal tie for equal temperature, finite thermal conductance/resistance for a temperature jump, and contact when opening or sliding is possible.

How do I model cyclic symmetry or a repeating cell?

Use the periodic constraint for the solved field family and state the complete translation or rotation that maps primary to secondary. Thermal affine jump adds a macroscopic temperature difference. Acoustic and magnetic phase-shifted periodicity add complex Bloch phase. Periodicity is not inferred from matching face shapes.

How do I detect an underconstrained model?

RunMat checks field nullspaces before solve where the formulation exposes them: rigid-body modes in structural statics, the constant-temperature mode in pure-Neumann steady conduction, pressure gauge freedom in incompressible flow, electric-potential reference freedom, and magnetic gauge freedom. Add the physical reference the model is missing; do not add an arbitrary numerical anchor merely to make the matrix nonsingular.

How do I avoid conflicting or redundant constraints?

Review overlaps by resolved solver DOF, not declaration name. Two region names can map to the same face or node set. RunMat diagnoses incompatible values and records redundant relations; the family guides explain valid combinations. In particular, do not combine fixed and nonzero prescribed motion on the same DOF, tie and contact on the same pair, or several independent gauge references without a physical reason.

What should I inspect before trusting a constrained solve?

Check resolved target coverage, removed/free DOF counts, pair projection coverage, reference/gauge status, reaction resultants, and any constraint residual. For contact, also inspect active/open/slip state and penetration. These facts belong in result evidence so a later run can show exactly which constraint realization was solved.

How do constraints interact with load cases and analysis steps?

Constraints are stable named model objects. The study sequence determines when admitted constraints are active or continued; load cases determine external actions. A preload or retained-state procedure must state which constraints remain active downstream. Omission does not mean the solver may choose a convenient support.

How do I parameterize a prescribed value?

Bind the value to a compatible typed input or signal where that constraint kind admits one. Keep length, angle, temperature, pressure, velocity, or electromagnetic quantity types intact. A sweep varies the typed input and produces distinct result cases; it does not perform textual replacement in the constraint block.

How do I choose primary and secondary sides?

Choose the direction that matches the declared geometric transform, projection policy, and physical reporting convention. Primary/secondary is retained in evidence and can affect normal sign, projection, phase, and contact reporting. Reversing the pair is not merely cosmetic when the law is directional.

What happens to constraints when the mesh changes?

Constraints resolve from persistent CAD regions on each admitted mesh. Ties, periodic pairs, and interfaces repeat their pairing/projection and report coverage/error. RunMat does not preserve stale node numbers from a prior mesh. Compare target measure, projected entity count, rank, and residual between mesh revisions.

What is the difference between a constraint, connector, interface, and load?

These declarations assemble different mathematical objects:

DeclarationMathematical roleTypical question
ConstraintPrescribes a field value or exact relation, Bx=g\mathsf B\mathbf x=\mathbf gBx=g“Which motion or field value is forbidden or known?”
ConnectorAdds a constitutive relation such as f=kΔu\mathbf f=k\Delta\mathbf uf=kΔu“What compliant or dissipative attachment connects these regions?”
InterfaceTransfers fields or enforces unilateral/coupled behavior between two domains“How do these bodies or physics communicate?”
Natural-boundary loadAdds traction, flux, impedance, or an outlet operator“What conjugate action acts on this boundary?”

This distinction controls result interpretation. A fixed constraint produces a reaction; a spring stores energy; contact changes active status; pressure contributes external work. Choosing one only because it makes the matrix solvable changes the model.

How do I write a complete constrained model fragment?

Declare geometry regions by their physical role, then place constraints inside the model that owns them. Loads remain separately named so activation is reviewable:

geometry bracket {
    file = "bracket.step"
    units = mm
    region body : solid { select tag "body"; expect exactly_one }
    region mount : face { select tag "mount"; expect one_or_more }
    region pad : face { select tag "load_pad"; expect exactly_one }
}

model supported_bracket {
    assign material.steel to geometry.bracket.region.body

    constraint mounting_fixture {
        structural.fixed { target = geometry.bracket.region.mount }
    }

    load service_force {
        force on geometry.bracket.region.pad = [0, -4, 0] kN
    }
    load_case service { include load.service_force }
}

mounting_fixture removes admitted structural degrees of freedom only on mount. The load case does not activate or infer the support. In a multi-step study, the analysis sequence states whether that named constraint continues into each downstream procedure.

How do I review constraint rank and reactions?

For linear equality constraints, inspect the resolved relation matrix rank, removed degrees of freedom, redundant rows, and residual ∥Bx−g∥\|\mathsf B\mathbf x-\mathbf g\|∥Bx−g∥. For supports, integrate reaction force and moment by named constraint. For ties and periodic pairs, inspect matched measure, unmatched entities, projection distance, and pair residual. For contact, rank alone is insufficient: inspect active/open/stick/slip state, penetration, and contact work.

What should fail during runmat check?

Checking should reject an incompatible topology role, missing or ambiguous region, duplicate identity, invalid quantity or frame, incomplete pair transform, self-pair, nonphysical coefficient, conflicting ownership, and a procedure that cannot consume the constraint kind. Geometry-dependent pair coverage and operator nullspaces are resolved later, but they still fail closed before a result is admitted. Solver regularization is not a substitute for a missing physical reference.

On this page
  • Find a constraint by modeling task
  • Complete essential-constraint catalog
  • Which constraint families can I execute today?
  • Complete connector and interface catalog
  • How do I prescribe a value that varies with time or frequency?
  • How do I constrain an assembly without hiding its load path?
  • How do I model a boundary condition that RunMat does not list?
  • Common form
  • Which boundary condition should I use?
  • How do region targets connect constraints to CAD?
  • How do I constrain only one direction?
  • How do I connect nonmatching meshes?
  • How do I model cyclic symmetry or a repeating cell?
  • How do I detect an underconstrained model?
  • How do I avoid conflicting or redundant constraints?
  • What should I inspect before trusting a constrained solve?
  • How do constraints interact with load cases and analysis steps?
  • How do I parameterize a prescribed value?
  • How do I choose primary and secondary sides?
  • What happens to constraints when the mesh changes?
  • What is the difference between a constraint, connector, interface, and load?
  • How do I write a complete constrained model fragment?
  • How do I review constraint rank and reactions?
  • What should fail during runmat check?