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.

/
    • Grammar
    • Declarations
    • Procedures
    • Types, units and expressions
    • Files, modules and imports
    • Studies, analyses and state
    • Outputs, fields and observations
    • Operations and output queries
    • Operation reference
    • RunMat function integration
    • Diagnostics and tooling
    • Geometry features and AP242
    • Geometry, models and assignments
    • Constraints, loads and interfaces
    • Fluid materials
Docs>Physics>Language reference

Outputs, fields and observations

A study publishes what its output declarations ask for: whole fields, reduced quantities such as a peak stress over a region, values sampled at a point, and histories over time or frequency. Each output has a stable name, a type and a unit, and assessments turn outputs into pass or fail verdicts.

Name a field

output displacement = analysis.static.field.node.displacement
output von_mises = analysis.static.field.element.von_mises_stress

A field reference has four parts, analysis.<step>.field.<location>.<quantity>: the producing step, where the values live, and the physical quantity. The checker rejects a location or quantity the step's family and procedure do not produce, so a typo is an error at its line, not an empty result after the solve.

Locations:

LocationValues at
nodeMesh nodes; element values are averaged to nodes where the quantity is recovered (stress, flux).
elementOne value per element (the element average).
integration_pointQuadrature points, where stresses and fluxes are computed.
cellFinite-volume cells (fluid).
face, edgeMesh faces and edges, such as tractions on a boundary.
interfaceContact and coupled interfaces.
connector, constraint, reference_pointConnector forces, constraint reactions and reference-point results.
modeOne value per mode: frequencies, participation. As a study output Not yet releasedStatus.
globalOne value for the whole step: residuals, balances.

Quantities, by family:

FamilyQuantities
Structuraldisplacement, rotation, velocity, acceleration, strain, stress, von_mises_stress, reaction_force, reaction_moment, strain_energy
Beams and shellsbeam_axial_force, beam_shear_force, beam_bending_moment, beam_torsion_moment, beam_bending_stress, beam_torsion_stress, shell_membrane_force, shell_bending_moment, shell_transverse_shear, shell_von_mises
Contactcontact_gap, contact_pressure
Thermaltemperature, temperature_gradient, heat_flux, heat_rate, thermal_energy_storage_rate_density
Electricelectric_potential, electric_field, electric_displacement, electric_energy_density, electric_current, electric_current_density, electric_charge, joule_power_density, electric_edge_circulation
Magneticmagnetic_vector_potential, magnetic_flux_density, magnetic_field_intensity, magnetic_edge_circulation
Acousticacoustic_pressure, acoustic_particle_velocity, acoustic_intensity, acoustic_port_intensity (plane-wave power density through an incident or radiation port face), sound_pressure_level
Fluidfluid_pressure, fluid_velocity, vorticity, wall_shear_stress, mass_flow_rate, volume_flow_rate
Modalmodal_frequency, modal_participation, eigenvalue
Solver checksresidual, balance, constraint_violation

analysis.static.field.node.von_mises_stress is the nodal von Mises stress: at each node, the volume-weighted average of the surrounding elements' stress tensors, with von Mises taken from the averaged tensor. recover(…, to = node, using = volume_weighted_average) names the same recovery explicitly. The element field (field.element.von_mises_stress) is each element's own value.

Reduce a field

    output tip_deflection = max(magnitude(analysis.static.field.node.displacement), over = geometry.beam.region.loaded_end)

Output operations are typed: each one accepts certain field locations, quantities and shapes and returns a typed result. magnitude keeps the field's locations and turns a vector into a scalar; max over a region returns an attributed extremum, whose value stays linked to the entity, position, step and field it came from (.value gives the scalar alone).

OperationsPurpose
max, min, mean, rms, integral, resultant, moment, normReduce a field over a region.
magnitude, component, principal, von_misesTransform a field pointwise.
real, imag, phase, levelRead a complex (harmonic) result; level gives a decibel level.
flux(field, through = region)∫Γv⋅n dA\int_\Gamma \mathbf v\cdot\mathbf n\,dA∫Γ​v⋅ndA of a vector field over a face region.
sound_power(step, through = region)The flux of active acoustic intensity 12Re(p v∗)\tfrac12\mathrm{Re}(p\,\mathbf v^*)21​Re(pv∗): mean power leaving through the faces.
pressure_drop(step, from = region, to = region)Area-weighted mean fluid pressure on the from faces minus the mean on the to faces, in Pa, on a fluid step.
transmission_loss(step, incident = region, transmitted = region)10log⁡10(Winc/Wtr)10\log_{10}(W_\mathrm{inc}/W_\mathrm{tr})10log10​(Winc​/Wtr​) in dB per frequency on an acoustic harmonic step, from the incident and transmitted port powers.
interpolate(field, at = point), interpolate(field, at = [point, …])Sample a field at a point, or at an ordered list of points along a path.
sample, envelope, absmax, variance over time or frequencyHistories and spectra of a quantity.
recover(field, to = <location>, using = <method>)Move a field to another location.

Signatures and examples for every operation are in operations and output queries.

Sample a field at a point

output top_stress = interpolate(analysis.static.field.node.von_mises_stress, at = [100 mm, 50 mm, 100 mm])
output tip_deflection = interpolate(analysis.static.field.node.displacement, at = [200 mm, 0 mm, 50 mm])

interpolate(field, at = point) returns the value at one point in model coordinates. For a nodal field it evaluates the shape functions of the element that contains the point, so the value follows the gradient to the point; compare this with a surface stress from beam or plate theory. For an element field it returns the containing element's value. A point on a shared face or edge reads one of the elements that touch it. A point outside the meshed solid is an error; it is never moved to the nearest surface. On a beam or shell mesh, the point is located on the containing line or surface element (Not yet releasedStatus).

Histories and retention

Use an output block when an output also needs a sampling or retention policy:

output tip_history {
    value = sample(analysis.response.field.node.displacement, over = time, at = [0 s, 10 ms, 20 ms])
    retention = explicit_samples
    maximum_samples = 3
}

The checker verifies that the sampling domain belongs to the field (time for a transient step, frequency for a harmonic step), that sample locations have the right type and unit, and that the declared bound holds the requested samples.

Assess an output

    assessment deflection_limit {
        value = output.tip_deflection
        maximum = 0.5 mm
        evidence = authored_samples
    }

An assessment compares an output with a minimum, a maximum or both, in the output's unit, and publishes a pass or fail verdict with the run. runmat reassess evaluates revised assessments against a saved result without solving again. See operations and output queries.

Read results in .m code

Fields are published separately from rendering. After a run, .m code loads the result, selects a field and plots or post-processes it:

results = fea.results(run);
stress = fea.field(results, fea.StructuralField.vonMises());
plot(stress);

plot takes the field object, not a field name string.

Large results

Fields and histories are content-addressed, partitioned result objects. Each part records its study, step, field, sample and mesh identity, so reading one field or one sample loads only that data. Distributed reductions combine typed partitions in a fixed order, so a reduction gives the same value however the work was split, and the result records where each part ran.

Outputs across a sweep

Inside a sweep, case.output.<name> refers to one case's output of the study. collect, case min and max, and retain_each gather outputs across cases; see inputs, sweeps and cases.

On this page
  • Name a field
  • Reduce a field
  • Sample a field at a point
  • Histories and retention
  • Assess an output
  • Read results in .m code
  • Large results
  • Outputs across a sweep