Nodal and member loads

Loads belong to a load case. The solver starts with one, solver.loadCases[0], and each create… method on it adds a load and returns it. For several cases and their combinations, see Load cases.

Values are in N, N/m and N·m and follow the axes: +z is down, a positive moment is counter-clockwise.

A beam with every kind

An 8 m beam on a pin and a roller, with a line load rising from 4 to 10 kN/m, a 20 kN point load, a 10 kNm couple and a horizontal force at the roller:

loads.ts
import { DofID, LinearStaticSolver } from '@edubeam/fem'

const solver = new LinearStaticSolver()
const { domain } = solver
domain.createMaterial(1, { e: 210e9, g: 81e9 })
domain.createCrossSection(1, { a: 28.5e-4, iy: 1943e-8, k: 1e32 })
domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // pin
domain.createNode('B', [8, 0, 0], [DofID.Dz]) // roller
domain.createBeam2D(1, ['A', 'B'], 1, 1)

const lc = solver.loadCases[0]
// 4 kN/m at A rising to 10 kN/m at B, down
lc.createBeamElementTrapezoidalEdgeLoad(1, [0, 4e3], [0, 10e3], false)
// [fx, fz, my, a]: 20 kN down, 2 m from A
lc.createBeamConcentratedLoad(1, [0, 20e3, 0, 2], false)
// a 10 kNm counter-clockwise couple, 6 m from A
lc.createBeamConcentratedLoad(1, [0, 0, 10e3, 6], false)
// 5 kN to the right at B
lc.createNodalLoad('B', { [DofID.Dx]: 5e3 })
solver.solve()

// getReactions gives a mathjs Matrix or an array: make it an array
const list = (v: unknown): number[] =>
  Array.isArray(v) ? v : (v as { toArray(): number[] }).toArray()

console.log(list(domain.getNode('A').getReactions(lc).values))
console.log(list(domain.getNode('B').getReactions(lc).values))
Output
[ -5000, -40250 ]
[ -35750 ]

By hand: the line load is 56 kN acting 4.571 m from A, so moments about A give , kN up, and kN up. The pin also holds back the 5 kN, which puts the whole beam in 5 kN of tension.

The same loads. The figure puts the couple on a node C at 6 m, which gives the same results.62.571.581.2210 kNm5 kN4 kN/m8.5 kN/m10 kN/m20 kN540.2535.75ACB
The same loads. The figure puts the couple on a node C at 6 m, which gives the same results.Open in EduBeam

Nodal loads

TypeScript
lc.createNodalLoad(node, { [DofID.Dx]: fx, [DofID.Dz]: fz, [DofID.Ry]: my }, lcs)

Give only the components you need. The values are in global axes, or, with lcs set to true, in the node's own axes, for a node turned with updateLcs. A force on a DOF the support holds goes straight into the reaction and bends nothing.

Member loads

MethodValuesLoad
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)N/muniform over the whole member
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)N/mlinear, from the first node to the second
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)N, N·m, ma force and a couple, a metres from the first node

Line loads always cover the whole member. For a load on part of a span, split the member with a node where the load starts: an extra node changes no result. A point load or a couple can sit anywhere along the member.

Global or local axes

The last argument, lcs, says which axes the components are in:

  • false: global x and z. fz acts vertically whatever the member's slope.
  • true: the member's local x (along it) and z (across it). fz acts perpendicular to the member.

On a horizontal member drawn left to right the two are the same; drawn right to left, local fz points up.

Change or remove a load

Each create… method returns the load. Change its values and solve again:

TypeScript
const q = lc.createBeamElementUniformEdgeLoad(1, [0, 10e3], true)
solver.solve()
q.values = [0, 20e3] // twice the load
solver.solve()

The loads live in plain arrays, lc.nodalLoadList and lc.elementLoadList (member and temperature loads), so lc.elementLoadList.splice(index, 1) removes one. The property names of each load are in the reference.

Temperature changes and support settlements are loads too: see Temperature and settlements.