Omniadisce

What the labs are

A lab is a working engineering tool you can play with: a beam you load and watch bend, a truss bridge a lorry drives over, a footing on soil, a road junction. Each one runs the same kind of calculation engineers use, on the server, and shows the result straight away: forces, deflections, whether every check passes, and what it costs.

Unlike a simulation, a lab doesn't play out over time. You change the design and the answer updates. That makes labs good for "what if" questions: what if the load moves? what if the beam is deeper? what if the soil is wet?

The twelve labs

LabWhat you can do in it
BeamSupports, point and spread loads, steel or timber sections; reactions, bending, shear, deflection, cost.
BridgeA truss bridge: which members pull and push, buckling, and a vehicle driving across.
SoilFootings, settlement, and slopes that slide after rain.
DrainageRain, runoff and pipes: does the network cope with the storm?
RoadsCurves, sight lines, capacity and traffic lights.
TestingTensile tests on steel, concrete cubes, and drilling a site before you build.
ConcreteReinforced concrete beams, and how a building's weight reaches the ground.
Wind and earthquakesWind on tall buildings, natural periods, soft storeys, the shake table.
ConstructionMoving earth, the critical path of a building programme, embodied carbon.
Water supplyPressure and friction in water mains, open channels, the hydraulic jump.
Retaining wallsEarth and water pressure; sliding, toppling and bearing; sheet piles.
PavementLayers, wheel loads and how long a road lasts.

The failure case files re-run real disasters in these labs: read the story, find the cause, check it by hand, then fix it.

Learning with a lab

  • Follow the path. The learning path takes you through the labs one idea at a time. Each lesson explains, asks you to guess, asks you to calculate by hand, then lets you try it in the lab. Your progress is kept with your account when you're logged in.
  • Sandbox. Most labs open in Sandbox mode: change anything and watch the results. Start from a preset (in the beam lab: simply supported, cantilever, two spansโ€ฆ).
  • Challenges. Switch to Challenges for a goal, such as "the lightest beam that passes", and press Check my design.
  • Read the colours. Most labs colour a part by how hard it's working: green is comfortable, red is over the limit. 100% means exactly at the limit.

What a lab lesson is

A lab lesson is a lesson post that runs inside one of the labs. The reader sees the lesson in a panel beside the lab, one step at a time, and the lab follows along: it loads your set-up, points at what matters, and checks what the reader builds.

Its answers come from the lab itself. If you ask "what is the right-hand reaction?", you don't type 6.67: you write R_B, and the lab works it out from your set-up. Change the set-up later and the answer follows.

An ordinary lesson can also embed a simulation, circuit or model lab in a Try it step. Write a lab lesson when the whole lesson is about one lab, so the reader keeps it open from start to finish.

Your first lab lesson

  1. Open the editor for a lab. Go to /lesson/new?lab= followed by the lab's name, e.g. /lesson/new?lab=beam or ?lab=bridge. The other names are soil, drainage, roads, testing, concrete, lateral, construction, water, retaining and pavement.
  2. Basics. A title that says the idea ("Supports push back"), a topic, a level and roughly how many minutes it takes.
  3. The lab and its set-up. The editor starts with the set-up of that lab's first built-in lesson. Change its numbers to the situation you want (see below).
  4. Introduction. A one-sentence summary for the feed card, a hook (why it matters), the idea in a few short paragraphs, and a recap of what the reader can now do.
  5. Key words (optional). Words the reader may not know. Link them in any text with [[key]]; the reader can tap one to see what it means and where it is in the lab.
  6. Steps. Add them in order: read, guess, work it out, try it in the lab. See the four step types.
  7. Preview in the lab. The button at the top opens your draft in the real lab, exactly as readers will see it. Do every step yourself.
  8. Publish. The server works out every answer and runs every check on your set-up first. A lesson with a formula it can't work out won't publish.

The set-up

The set-up is what the lab loads when the lesson starts, written in the lab's own format (JSON). You rarely write it from nothing: change the numbers in the one the editor gives you. For the beam lab it looks like this:

{"length": 6.0, "material": "S235", "section": "IPE240", "self_weight": false,
 "supports": [{"x": 0, "type": "pin"}, {"x": 6.0, "type": "roller"}],
 "point_loads": [{"x": 2, "P": 20, "kind": "Q"}],
 "udls": [], "combination": "characteristic"}

That is a 6 m steel beam on two supports with a 20 kN load 2 m from the left. Lengths are in metres and forces in kN.

  • Keep the numbers simple. A 6 m beam with the load at 2 m gives reactions of 13.33 and 6.67 kN, easy to check by hand. Readers should be able to calculate what the lab shows.
  • Start from something that needs fixing if a step asks the reader to change the design. If the set-up already passes, the step is done before it starts.
  • Copy a built-in lesson's set-up when you want a different starting point: the learning path's lessons cover every lab.

The lab's results

Open The lab's results under the set-up. It lists every number the lab works out for your set-up, with its name, what it means and its value now. Click a name to put it in the field you were last typing in.

Name (beam lab)MeansValue for the set-up above
R_A, R_Bthe left and right reactions (kN)13.33, 6.67
max_Mthe largest bending moment (kNm)26.67
max_defl_mmthe largest deflection (mm)9.47
max_utilthe highest utilisation (1 = at the limit)0.395
passeswhether every check passestrue
cost_eurthe cost (โ‚ฌ)405

Use them in three places:

  • As an answer: R_B, or a formula such as max_M / 1.5.
  • As a condition in a Try it step: max_defl_mm < 5, passes and cost_eur < 500.
  • In any text: {=R_B} shows the value; {=R_B|1} rounds it to 1 decimal; {=max_util|%} shows it as a percentage.

Formulas use + - * / ** ( ), comparisons (< <= > >= == !=), and, or, not, โ€ฆ if โ€ฆ else โ€ฆ, and the functions min max abs round sqrt log log10 exp sin cos tan floor ceil.

The four step types

StepThe readerโ€ฆYou write
Readreads one idea, with the lab beside ita title, a short explanation, and what to look at
Your guesspicks an answer before the lab shows itthe question, the choices, the right one, and why. The right choice can be a formula, e.g. 1 if R_A > R_B else 2, so it follows the set-up.
Work it outcalculates a number by hand and types itthe answer (a number or a formula like R_B), the unit, a tolerance in % (2% by default), optionally the equation with the numbers filled in, and a worked solution
Try it in the labchanges the design until it passesthe task, and when it's done: conditions on the lab's results (all must hold), or a ready-made check from the built-in lessons. Optionally, what to say while a condition fails, and a line showing their numbers, like deflection {=max_defl_mm|1} mm.

Every step except Read can have hints, shown one at a time, and Afterwards: a sentence the reader sees once the step is done, saying what it means.

Why this order works: a guess makes the reader commit, so the lab's answer surprises or confirms; the hand calculation makes them understand it; trying it in the lab makes them use it.

A worked example

Supports push back, in the beam lab, with the set-up above.

  1. Read: "A beam pushes down on its supports, and they push back up. Together they carry the whole load."
  2. Your guess: "Which support pushes harder?" Choices: the left one, the right one, both the same. Right choice: 1 if R_A > R_B else 2 if R_B > R_A else 3. Why: "The load is closer to the left support, so the left one carries more of it."
  3. Work it out: "Take moments about the left support. What is $R_B$?" Answer R_B, unit kN, tolerance 2%. Equation: R_B ร— 6 = 20 ร— 2. Solution: "$R_B = 40 / 6$ = {=R_B|2} kN."
  4. Try it in the lab: "Move the load until both supports push equally." Condition: abs(R_A - R_B) < 0.5, saying "Not yet: left {=R_A|1} kN, right {=R_B|1} kN" while it fails. Afterwards: "In the middle, each support carries half."

Now change the set-up's load to 30 kN: the guess, the answer, the solution text and the check all follow, with nothing to retype.

What the lab shows (advanced)

Each step has a fold, What the lab shows during this step, for steering the lab itself. The Beam and Bridge labs have their own guide, which draws and coaches by itself, so you can usually leave the fold empty there.

In every other lab, name the controls. During a lesson, those labs show only the controls a step names under Controls used. A Try it step there with no controls named leaves the reader nothing to change. Find a control's id by right-clicking it in the lab and choosing Inspect, and look for its id: in the soil lab, for example, B and D are the footing's controls.

FieldWhat it does
ShowBeam and Bridge: which overlays to draw during the step, e.g. names, dims, arrows.
Reveal once doneOverlays that appear only after the step is done, so they don't give the answer away.
Controls usedThe ids of the lab's controls this step works with. They're highlighted, and in labs other than Beam and Bridge they're the only ones shown.
Live coachA coach that says which way to go while the reader works. Beam: balance, peak, lightest, stiff. Bridge: stable, budget, pass. The other labs re-check a Try it step by themselves as the reader changes things.
ResultsShow or hide the lab's results panel, e.g. hide it during a guess.
Switch to this set-up once doneA set-up to load after the step: the answer, shown.
Set-ups to compareTwo or more set-ups side by side, e.g. a shallow and a deep beam.
Fixed inputs (in a Try it step)Values the check uses whatever the reader changes, e.g. a deadline that stays at 40 days.

The checklist

  • The lesson teaches one idea, and the title says which.
  • The set-up's numbers can be checked by hand.
  • Every answer that comes from the lab is a formula, not a typed number.
  • There's a guess before the lab reveals something, and a calculation before the reader tries it.
  • Every Try it step fails at the start and says exactly what to change.
  • You've done the whole lesson in Preview, including a wrong answer on each step.

When something's wrong

What you seeWhat it meansFix
This is not valid JSON yetThe set-up has a missing comma, bracket or quote.Undo the last edit, or compare with the example above.
'โ€ฆ' is not one of this lab's resultsA formula uses a result that isn't in the list, often a typo.Click the name in The lab's results instead of typing it.
'โ€ฆ' uses something a formula cannotThe formula uses something outside the language above.Use only the signs and functions listed.
The lab rejects the set-upA value is impossible: a load past the end of the beam, a negative length.Read the message; it names the value.
A Try it step is done as soon as it opensThe set-up already meets its conditions.Start from a set-up that fails, or tighten a condition.
The reader can't change anything in a Try it stepThe lab shows only named controls, and none are named.Fill in Controls used (see above).

Log in to write a lab lesson

× Enlarged view