ECSS Structures — Rigid-Body Motion Checks (space-systems/ecss/rigid-body-motion-checks)
Use when the task is to verify a finite element model against the rigid-body
check requirements of ECSS-E-ST-32C clause 5.4 — confirming the mass matrix,
stress-free rigid-body strain energy, and residual force balance all meet their
acceptance thresholds before structural analysis proceeds.
Domain quick reference
- A correctly assembled finite element model must satisfy three independent
rigid-body checks before structural results are trusted. Each check targets
a different class of modelling error.
- Mass matrix check: the sum of all nodal masses produced by the assembled
mass matrix must match the reference (design) mass within a stated fraction.
A discrepancy flags missing mass items, duplicated masses, or mis-scaled
density properties.
- Strain energy check (stress-free rigid-body motion): when each of the six
rigid-body displacement fields (three translations TX, TY, TZ and three
rotations RX, RY, RZ) is applied to the unconstrained model, the resulting
internal strain energy must be essentially zero. Non-zero strain energy for a
rigid-body mode indicates spurious stiffness: grounded degrees of freedom,
incorrectly constrained multi-point constraint equations, or element
formulation errors that resist rigid translation or rotation.
- Residual force check: applying a rigid-body displacement to a free-floating
model should produce no net internal force vector. A non-zero residual force
indicates a force-balance error in the stiffness or constraint assembly —
distinct from a strain energy error and detectable only through this separate
check. Both the strain energy and residual force checks are run for all six
rigid-body modes; a failure in either is a separate finding.
- Acceptance thresholds for strain energy and residual force are relative to a
reference energy or force derived from the applied displacement amplitude and
the model's overall stiffness level; the analyst sets these thresholds before
the check and documents the basis.
Workflow
- Assemble the full finite element model including all mass items (structural
mass, non-structural mass, lumped point masses, fluid mass, etc.). Sum the
diagonal of the assembled mass matrix to obtain the computed total mass.
Compare against the reference mass: if the relative error exceeds the stated
tolerance, flag a mass matrix finding and do not proceed until resolved.
- For each of the six rigid-body modes (TX, TY, TZ, RX, RY, RZ), apply a
unit rigid-body displacement field to the free-free (unconstrained) model and
compute the resulting internal strain energy. Compare each mode's strain
energy against the strain energy threshold; flag any mode whose energy exceeds
the threshold as a strain energy finding.
- For each of the same six rigid-body modes, extract the residual force vector
produced by the rigid-body displacement and compute its magnitude. Compare
each magnitude against the residual force threshold; flag any mode whose
residual exceeds the threshold as a residual force finding.
- Collect all findings from steps 1–3. The model passes rigid-body checks only
when the mass finding list, the strain energy finding list, and the residual
force finding list are all empty. Record the numeric residuals for each check
in the model verification report regardless of pass or fail.
- If any finding is raised, investigate the root cause before re-running:
mass errors point to property or density table mismatches; strain energy
errors point to spurious grounding or constraint conflicts; residual force
errors point to force-balance assembly faults. Do not relax thresholds as a
remedy — correct the model.
Pitfalls
- Running the strain energy check on a constrained (boundary-condition applied)
model rather than the free-free model: boundary reactions absorb the rigid-body
displacement and the check always passes, masking real grounding errors.
- Treating a near-zero strain energy result as confirmation that residual forces
are also acceptable — the two quantities are independent; a model can have
negligible strain energy for a given mode yet exhibit a significant residual
force if the force-balance assembly is inconsistent with the stiffness assembly.
- Using an overly loose strain energy threshold (e.g. set relative to model
peak strain energy rather than a small absolute fraction) so that genuine
spurious stiffness passes undetected.
- Checking only the three translational modes and skipping the three rotational
modes — rotational spurious stiffness from shell normal-rotation coupling or
beam offset errors is only detectable through the RX, RY, RZ displacement
fields.
- Reporting a mass check pass without documenting which mass items were included
in the reference mass, making future mass growth assessments ambiguous.
Behavior contract (gate 3)
The mass matrix, strain energy, and residual force check logic is exercised by
the gate 3 contract test: scripts/test_rigid_body_motion_checks.py against
scripts/rigid_body_motion_checks_logic.py (stdlib unittest, offline). Run:
python3 scripts/test_rigid_body_motion_checks.py
Compliance
- ECSS standards are freely downloadable (ESA); cite the source and paraphrase
per standards-map.yaml.
- compliance: STANDARDS-REF, gated: false.
1---2name: rigid-body-motion-checks3description: "Use when verify that a finite element model passes rigid-body checks4 under ECSS-E-ST-32C clause 5.4: confirm the assembled mass matrix yields a total5 mass matching the reference value within tolerance, confirm that applying each of6 the six rigid-body displacement modes (three translations, three rotations) produces7 near-zero strain energy, and confirm that residual forces arising from rigid-body8 displacements are below the acceptance threshold. Each check produces a pass or9 fail result with a numeric residual; all three must pass for the model to be accepted.10 Trigger: ecss, e-st-32-structures-scope, rigid-body-checks, mass-matrix, strain-energy,11 residual-forces, fem-verification, finite-element."12license: Apache-2.013compliance: STANDARDS-REF14standards:15 - id: ecss16 reference-only: true17gated: false18domain: space-systems19pack: space-systems20compatibility: "agentskills.io SKILL.md; any SKILL.md host (Claude Code, Hermes, OpenClaw)"21metadata:22 source: https://skillmd.com/skills/ashfordeou/rigid-body-motion-checks23 domain: space-systems24 subdomain: ecss25 tags: [ecss, e-st-32-structures-scope, rigid-body-checks, mass-matrix, strain-energy, residual-forces, fem-verification, finite-element]26 version: 0.1.027 author: Aero Agent Skills28---2930# ECSS Structures — Rigid-Body Motion Checks (space-systems/ecss/rigid-body-motion-checks)3132Use when the task is to verify a finite element model against the rigid-body33check requirements of ECSS-E-ST-32C clause 5.4 — confirming the mass matrix,34stress-free rigid-body strain energy, and residual force balance all meet their35acceptance thresholds before structural analysis proceeds.3637## Domain quick reference3839- A correctly assembled finite element model must satisfy three independent40 rigid-body checks before structural results are trusted. Each check targets41 a different class of modelling error.42- **Mass matrix check**: the sum of all nodal masses produced by the assembled43 mass matrix must match the reference (design) mass within a stated fraction.44 A discrepancy flags missing mass items, duplicated masses, or mis-scaled45 density properties.46- **Strain energy check (stress-free rigid-body motion)**: when each of the six47 rigid-body displacement fields (three translations TX, TY, TZ and three48 rotations RX, RY, RZ) is applied to the unconstrained model, the resulting49 internal strain energy must be essentially zero. Non-zero strain energy for a50 rigid-body mode indicates spurious stiffness: grounded degrees of freedom,51 incorrectly constrained multi-point constraint equations, or element52 formulation errors that resist rigid translation or rotation.53- **Residual force check**: applying a rigid-body displacement to a free-floating54 model should produce no net internal force vector. A non-zero residual force55 indicates a force-balance error in the stiffness or constraint assembly —56 distinct from a strain energy error and detectable only through this separate57 check. Both the strain energy and residual force checks are run for all six58 rigid-body modes; a failure in either is a separate finding.59- Acceptance thresholds for strain energy and residual force are relative to a60 reference energy or force derived from the applied displacement amplitude and61 the model's overall stiffness level; the analyst sets these thresholds before62 the check and documents the basis.6364## Workflow65661. Assemble the full finite element model including all mass items (structural67 mass, non-structural mass, lumped point masses, fluid mass, etc.). Sum the68 diagonal of the assembled mass matrix to obtain the computed total mass.69 Compare against the reference mass: if the relative error exceeds the stated70 tolerance, flag a mass matrix finding and do not proceed until resolved.712. For each of the six rigid-body modes (TX, TY, TZ, RX, RY, RZ), apply a72 unit rigid-body displacement field to the free-free (unconstrained) model and73 compute the resulting internal strain energy. Compare each mode's strain74 energy against the strain energy threshold; flag any mode whose energy exceeds75 the threshold as a strain energy finding.763. For each of the same six rigid-body modes, extract the residual force vector77 produced by the rigid-body displacement and compute its magnitude. Compare78 each magnitude against the residual force threshold; flag any mode whose79 residual exceeds the threshold as a residual force finding.804. Collect all findings from steps 1–3. The model passes rigid-body checks only81 when the mass finding list, the strain energy finding list, and the residual82 force finding list are all empty. Record the numeric residuals for each check83 in the model verification report regardless of pass or fail.845. If any finding is raised, investigate the root cause before re-running:85 mass errors point to property or density table mismatches; strain energy86 errors point to spurious grounding or constraint conflicts; residual force87 errors point to force-balance assembly faults. Do not relax thresholds as a88 remedy — correct the model.8990## Pitfalls9192- Running the strain energy check on a constrained (boundary-condition applied)93 model rather than the free-free model: boundary reactions absorb the rigid-body94 displacement and the check always passes, masking real grounding errors.95- Treating a near-zero strain energy result as confirmation that residual forces96 are also acceptable — the two quantities are independent; a model can have97 negligible strain energy for a given mode yet exhibit a significant residual98 force if the force-balance assembly is inconsistent with the stiffness assembly.99- Using an overly loose strain energy threshold (e.g. set relative to model100 peak strain energy rather than a small absolute fraction) so that genuine101 spurious stiffness passes undetected.102- Checking only the three translational modes and skipping the three rotational103 modes — rotational spurious stiffness from shell normal-rotation coupling or104 beam offset errors is only detectable through the RX, RY, RZ displacement105 fields.106- Reporting a mass check pass without documenting which mass items were included107 in the reference mass, making future mass growth assessments ambiguous.108109## Behavior contract (gate 3)110111The mass matrix, strain energy, and residual force check logic is exercised by112the gate 3 contract test: scripts/test_rigid_body_motion_checks.py against113scripts/rigid_body_motion_checks_logic.py (stdlib unittest, offline). Run:114115```116python3 scripts/test_rigid_body_motion_checks.py117```118119## Compliance120121- ECSS standards are freely downloadable (ESA); cite the source and paraphrase122 per standards-map.yaml.123- compliance: STANDARDS-REF, gated: false.