Physical and metamorphic checks

This chapter belongs to the detailed evidence of the Solver verification. It describes the checks that need no reference solution and therefore apply to all 18 cases.

Principle

A reference comparison needs a known correct value. For cases V07 to V15, the validation catalog stores no analytical reference; there, the reference values come only from the two external programs. Mechanics, however, prescribes relations that every correct solution must satisfy, within one run and between several runs. This gives two kinds of checks:

  • Physical checks evaluate a single calculation run.
  • Metamorphic checks link several runs. A metamorphic relation is a necessary property of a method across several inputs and their outputs. It does not require known expected values.1

A relation that is satisfied does not prove the solution, because it is only a necessary condition.1 These checks therefore complement the reference comparisons and do not replace them. Both kinds of checks evaluate only the results of the solver and use neither its matrices nor its internal derivatives. Except for the equilibrium check of the reference solutions, which adopts their comparison tolerances, their tolerances are stricter than those of the reference comparisons:

QuantityabsTolrelTol
Forces, moments10−7 N10^{-7}\,\mathrm{N} or Nm10−910^{-9}
uu, ww, θ\theta10−12 m10^{-12}\,\mathrm{m} or rad10−910^{-9}
dV/dx\mathrm{d}V/\mathrm{d}x10−7 N/m10^{-7}\,\mathrm{N/m}10−910^{-9}

Equilibrium

Global equilibrium is evaluated directly from the inputs and the support reactions calculated by SpanDraft. The resultant of a distributed load qq from aa to bb is q(b−a)q(b-a), its lever arm (a+b)/2(a+b)/2.

∑Rx=0\sum R_x=0
(1)
∑Ry+∑F+∑q(b−a)=0\sum R_y+\sum F+\sum q(b-a)=0
(2)
∑(Ryx+RM)+∑FxF+∑C+∑q(b−a)a+b2=0\sum\left(R_y x+R_M\right)+\sum F x_F+\sum C+\sum q(b-a)\frac{a+b}{2}=0
(3)

This gives three comparisons per case. The same equations are applied to the 45 stored references: the check thus also covers the references themselves, except for horizontal equilibrium for PyCBA, which does not supply RxR_x.

Jump and continuity conditions

At an interior location with a point force, point moment or support, the fields must jump by the external load. This is the local equilibrium relation derived in the chapter Loads, supports and internal forces and moments.

V(x+)−V(x−)=∑F+RyV(x^+)-V(x^-)=\sum F+R_y
(4)
M(x+)−M(x−)=−(∑C+RM)M(x^+)-M(x^-)=-\left(\sum C+R_M\right)
(5)

A downward force and a counterclockwise moment thus lower the respective field.

On the left, a point force F and the shear force curve, which jumps at the location from V minus to V plus. On the right, a point moment C and the moment curve, which jumps from M minus to M plus.
Figure 1: Jump of the shear force at a point force F (left) and of the bending moment at a point moment C (right).

Deflection and rotation, in contrast, must not jump. At every interior location, w(x+)=w(x−)w(x^+)=w(x^-) and θ(x+)=θ(x−)\theta(x^+)=\theta(x^-) hold.

Differential relations

Between the jump locations, the fields are linked through dM/dx=V\mathrm{d}M/\mathrm{d}x=V and dV/dx=q\mathrm{d}V/\mathrm{d}x=q, here in the SpanDraft sign convention.2 The check computes the derivatives independently using central differences on the output values. It thus remains independent of the internal polynomials of the solver.

M(x+h)−M(x−h)2h=V(x)\frac{M(x+h)-M(x-h)}{2h}=V(x)
(6)
V(x+h)−V(x−h)2h=q(x)\frac{V(x+h)-V(x-h)}{2h}=q(x)
(7)

Check locations lie at 37 % and 63 % of each subinterval, the step sizes are h=0.01 Lih=0.01\,L_i and h/2h/2 with the interval length LiL_i. No stencil point crosses a jump location. For a constant distributed load, MM is quadratic and VV linear. For these polynomials, the central difference has no truncation error, so the strict tolerance can apply. The second step size checks the numerical stability.

A subinterval from a to b with two check locations at 0.37 and 0.63. At each check location lie two stencil points on each side at the distance h and h half.
Figure 2: Stencil points of the central difference in the subinterval from a to b: filled at distance h, open at distance h/2. Distances drawn enlarged.

Zero curves in the longitudinal direction

SpanDraft has no axial loads, and all cases therefore contain u=0u=0 and N=0N=0. Both are checked as a zero curve at all evaluation points. A loaded axial calculation path is thus not accepted independently.

CheckIndividual comparisons
Equilibrium of SpanDraft54
Equilibrium of the references117
Jumps of VV and MM56
Continuity of ww and θ\theta56
Differential relations368
Zero curves of uu and NN512
Total1163

Scaling and sign reversal

The beam model is linear. For constant EIEI and rigid supports, the internal forces and moments are independent of the stiffness, and the deformation is proportional to load and compliance.3 Relations between two calculation runs follow from this. For this purpose, SpanDraft recalculates the transformed input completely.

TransformationReactions, NN, VV, MMww, θ\theta
all loads · 2doubleddoubled
all loads · (−1)reversedreversed
EE · 2unchangedhalved
II · 2unchangedhalved
force of zero at 41 % of the longest subintervalunchangedunchanged

The fields are compared at all evaluation points, not only at the extreme values marked in Figure 3.

Deflection curve w of case V06 with the curves 2w, w half and minus w, each of which has the same ratio to the initial curve.
Figure 3: Deflection curves of case V06 under the transformations: 2w for doubled loads, −w for reversed loads, w/2 for doubled E or I.

The last row checks that additional event stations do not change the solution. A force of magnitude zero changes nothing about the loading but creates an additional event station with its own nodal result. The check ensures that this station is created and all results remain the same. This follows from the transfer with load integrals: load positions create no unknowns.

Superposition

In the linear model, the solution for a sum of loads is the sum of the individual solutions. Six tests check this in two forms: they split existing load combinations or add a further load.

CaseLoad group 1Load group 2
V04distributed load of the caseadditionally −150 N at 0.41 LL
V08point forcedistributed load
V09point force of the caseadditionally −100 N/m from 0 to 3 m
V11point forcesdistributed load
V13first distributed loadsecond distributed load
V15point force and point momentdistributed load

Figure 4 shows this for V13: the moment curve of the combination is at every location the sum of the moment curves M1M_1 and M2M_2 of the two distributed loads.

Beam with two overlapping distributed loads, below the moment curves of the two individual loads in gray and the moment curve of the combination in black.
Figure 4: Case V13 with L = 4 m: moment curves M₁ and M₂ of the two distributed loads (gray) and of their combination (black).

The support reactions and all six fields at the evaluation points of the case are compared.

CheckTestsIndividual comparisons
Loads · 2181599
Loads · (−1)181599
EE · 2181599
II · 2181599
Additional event station181599
Superposition6838
Total968833

Comparison counts per case

The numbers come from the acceptance runs of October 3, 2026 and November 11, 2026, which agree. Cases with a stored analytical reference have three more comparisons in the reference equilibrium, because this reference is added there as an additional reference provider.

CaseEquilibriumField checksReference equilibriumMetamorphic testsMetamorphic comparisons
V0134485375
V0232485255
V0332485255
V0432486306
V0534485375
V0634485375
V0734455375
V08310456882
V0936456600
V1034455380
V113124561038
V1232455270
V13310456882
V1434455380
V153164561320
V04-S0132485255
V04-S0232485255
V04-S0332485255
Total54992117968833

Sources

  1. Tsong Yueh Chen; Fei-Ching Kuo; Huai Liu; Pak-Lok Poon; Dave Towey; T. H. Tse; Zhi Quan Zhou. Metamorphic Testing: A Review of Challenges and Opportunities. ACM Computing Surveys 51 (1), Article 4. 2018. DOI 10.1145/3143561. Accessed .
  2. René Alderliesten. Relation Among Distributed Load, Shearing Force, and Bending Moment. Introduction to Aerospace Structures and Materials, Delft University of Technology / TU Delft Open via Engineering LibreTexts. Accessed .
  3. Jesse Bonanno. IndeterminateBeam: A Python package for solving 1D indeterminate beams. Journal of Open Source Education 4 (40), 111. 2021. DOI 10.21105/jose.00111. Accessed .