Units and signs

The solver has no unit system of its own: it computes with the numbers you give it. Give it SI and every result comes back in SI. The examples on these pages, and the EduBeam app, always do. The signs are the app's too; its theory manual explains them with figures in Coordinate system and sign conventions.

Units

QuantityUnitExample
Coordinates, lengths, positions along a memberm[6, 0, 0]
ForcesN20e3 for 20 kN
MomentsN·m10e3 for 10 kNm
Line loadsN/m12e3 for 12 kN/m
Young's and shear modulusPa210e9
Aream²28.5e-4 for 28.5 cm²
Second moment of aream⁴1943e-8 for 1943 cm⁴
Temperature changeK20
Thermal expansion coefficient1/K12e-6
Displacements, rotationsm, rad0.01 for 10 mm

Any consistent set works, such as kN, m and kPa, which gives results in kN and kNm. SI saves you from checking.

Axes

  • x points right, z points down, and the model lies in the x–z plane. Coordinates are [x, y, z], with y = 0.
  • y points toward you, out of the screen. Rotations and moments are about y, so a positive one is counter-clockwise on screen.
  • A member's local x runs from its first node to its second. Its local z is local x turned 90° clockwise on screen: on a member drawn left to right, it points down.

Because z points down, a gravity load is a positive fz, and the top of a 4 m column standing at is at .

Degrees of freedom

Every node of a Beam2D model has three degrees of freedom, named by the DofID enum:

DofIDValueMeaning
DofID.Dx0Displacement along x
DofID.Dz2Displacement along z, down
DofID.Ry4Rotation about y, counter-clockwise

Dy, Rx and Rz (1, 3, 5) exist in the enum but are not used by plane members.

Signs of the results

ResultPositive meansRead with
Normal force NtensioncomputeNormalForceAt
Bending moment Mtension on the local +z side: sagging, on a beam drawn left to rightcomputeBendingMomentAt
Shear force VM grows along local x, ; on a beam drawn left to right it turns a piece clockwise: at the left support of a simply supported beamcomputeShearForceAt
Deflection walong local +z: down, on a beam drawn left to rightcomputeLocalDefl
Nodal displacementalong +x, +z (down), counter-clockwisenode.getUnknowns
Reactionthe force the support puts on the structure, along +x, +z (down), counter-clockwisenode.getReactions
End forcesthe forces the nodes put on the member, in its local axescomputeEndForces

So the pin of a beam loaded downward reports a reaction of −36 000 N along z: 36 kN pushing up.

Positions along a member

Every …At(lc, x) method takes x in metres from the member's first node, not a fraction of its length. Point loads along a member are placed the same way.

Member direction

M and w are measured in the member's own axes, so the order of its two nodes matters. The 12 kN/m beam of Getting started, defined both ways with the load in global axes, [0, 12e3], false, so that it pushes down both times, and read with computeBendingMomentAt(lc, 3), computeLocalDefl(lc, 2).w[1] and computeShearForceAt:

MemberM at midspanw at midspanV at A
['A', 'B'], left to right+54 000 N·m+0.0499 m+36 000 N, at x = 0
['B', 'A'], right to left−54 000 N·m−0.0499 m+36 000 N, at x = 6

Defined right to left, the local z points up, so the same sagging beam reports a negative moment and an upward deflection. N and V keep their sign at every point of the beam; only x runs from the other end. A load given in local axes (true) turns with the member: on the right-to-left beam, [0, 12e3], true pushes up.