Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- Mass 2 (required)
-
Unit kg Default 1 Range 0.1 to 10
About this input
Mass 2 in kilograms, from 0.1 to 10. Used only when the chain has at least 2 masses; the value must still be in range.
- Mass 3 (required)
-
Unit kg Default 1 Range 0.1 to 10
About this input
Mass 3 in kilograms, from 0.1 to 10. Used only when the chain has at least 3 masses; the value must still be in range.
- Mass 4 (required)
-
Unit kg Default 1 Range 0.1 to 10
About this input
Mass 4 in kilograms, from 0.1 to 10. Used only when the chain has at least 4 masses; the value must still be in range.
- Mass 1 (required)
-
Unit kg Default 1 Range 0.1 to 10
About this input
Mass 1 in kilograms, from 0.1 to 10. Used only when the chain has at least 1 masses; the value must still be in range.
- Starting velocity of mass 2 (required)
-
Unit m/s Default 0 Range -5 to 5
About this input
The speed mass 2 starts with, in metres per second, from -5 to 5; positive is to the right.
- Starting velocity of mass 3 (required)
-
Unit m/s Default 0 Range -5 to 5
About this input
The speed mass 3 starts with, in metres per second, from -5 to 5; positive is to the right.
- Starting velocity of mass 4 (required)
-
Unit m/s Default 0 Range -5 to 5
About this input
The speed mass 4 starts with, in metres per second, from -5 to 5; positive is to the right.
- Number of masses (required)
-
Default 3 Range 2 to 4
About this input
How many masses sit in the chain, from 2 to 4. The left end is always fixed to a wall; spring 1 joins it to mass 1.
- Spring 3 stiffness (required)
-
Unit N/m Default 10 Range 1 to 500
About this input
Stiffness of spring 3 in newtons per metre, from 1 to 500. It joins mass 2 to mass 3, or mass 2 to the right wall when mass 2 is the last and the end is fixed; otherwise it is not used.
- Spring 4 stiffness (required)
-
Unit N/m Default 10 Range 1 to 500
About this input
Stiffness of spring 4 in newtons per metre, from 1 to 500. It joins mass 3 to mass 4, or mass 3 to the right wall when mass 3 is the last and the end is fixed; otherwise it is not used.
- Spring 5 stiffness (required)
-
Unit N/m Default 10 Range 1 to 500
About this input
Stiffness of spring 5 in newtons per metre, from 1 to 500. It joins mass 4 to mass 5, or mass 4 to the right wall when mass 4 is the last and the end is fixed; otherwise it is not used.
- Spring 2 stiffness (required)
-
Unit N/m Default 10 Range 1 to 500
About this input
Stiffness of spring 2 in newtons per metre, from 1 to 500. It joins mass 1 to mass 2, or mass 1 to the right wall when mass 1 is the last and the end is fixed; otherwise it is not used.
- Your prediction (required)
-
Default 0 Range 0 to 5
About this input
Your answer in challenges 1 and 4: 1 or 2 for the mode shape in challenge 1, a spring number in challenge 4. 0 means no answer yet.
- Right end (required)
-
Default Fixed wall Allowed Fixed wall, Free end
About this input
Fixed wall joins the last mass to a second wall through one more spring; Free end leaves the last mass free to move.
- Spring 1 stiffness (required)
-
Unit N/m Default 10 Range 1 to 500
About this input
Stiffness of spring 1 in newtons per metre, from 1 to 500: the force per metre of stretch between the left wall and mass 1.
- Starting velocity of mass 1 (required)
-
Unit m/s Default 0 Range -5 to 5
About this input
The speed mass 1 starts with, in metres per second, from -5 to 5; positive is to the right.
- Damper 3 (required)
-
Unit N s/m Default 0 Range 0 to 20
About this input
Damper 3 in newton-seconds per metre, from 0 to 20, acting alongside spring 3: a force proportional to how fast that spring stretches. 0 means no damper.
- Damper 4 (required)
-
Unit N s/m Default 0 Range 0 to 20
About this input
Damper 4 in newton-seconds per metre, from 0 to 20, acting alongside spring 4: a force proportional to how fast that spring stretches. 0 means no damper.
- Damper 5 (required)
-
Unit N s/m Default 0 Range 0 to 20
About this input
Damper 5 in newton-seconds per metre, from 0 to 20, acting alongside spring 5: a force proportional to how fast that spring stretches. 0 means no damper.
- Damper 2 (required)
-
Unit N s/m Default 0 Range 0 to 20
About this input
Damper 2 in newton-seconds per metre, from 0 to 20, acting alongside spring 2: a force proportional to how fast that spring stretches. 0 means no damper.
- Mode to animate (required)
-
Default 1 Range 1 to 4
About this input
Which mode shape the page animates, from 1 (the slowest) to 4. A number above the chain's mass count animates its highest mode.
- Challenge number (required)
-
Default 0 Range 0 to 5
About this input
0 for free exploration, or 1 to 5 to load a challenge. A challenge replaces the system with its own and leaves you only the inputs it names.
- Damper 1 (required)
-
Unit N s/m Default 0 Range 0 to 20
About this input
Damper 1 in newton-seconds per metre, from 0 to 20, acting alongside spring 1: a force proportional to how fast that spring stretches. 0 means no damper.
- Simulated time (required)
-
Unit s Default 10 Range 1 to 300
About this input
How many seconds of motion to simulate, from 1 to 300. The model always takes 200 equal steps, so a longer run means a coarser step.
- Starting displacement of mass 2 (required)
-
Unit m Default 0 Range -0.5 to 0.5
About this input
How far mass 2 starts from its rest position, in metres, from -0.5 to 0.5; positive is to the right.
- Starting displacement of mass 3 (required)
-
Unit m Default 0 Range -0.5 to 0.5
About this input
How far mass 3 starts from its rest position, in metres, from -0.5 to 0.5; positive is to the right.
- Starting displacement of mass 4 (required)
-
Unit m Default 0 Range -0.5 to 0.5
About this input
How far mass 4 starts from its rest position, in metres, from -0.5 to 0.5; positive is to the right.
- Starting displacement of mass 1 (required)
-
Unit m Default 0.05 Range -0.5 to 0.5
About this input
How far mass 1 starts from its rest position, in metres, from -0.5 to 0.5; positive is to the right.
- Force amplitude (required)
-
Unit N Default 0 Range 0 to 100
About this input
The peak of a steady shaking force, in newtons, from 0 to 100. The force is the amplitude times sin(2 pi f t); 0 gives a free response.
- Mass the force acts on (required)
-
Default 1 Range 1 to 4
About this input
Which mass the shaking force pushes, from 1 to 4; it must be one of the masses in the chain.
- Force frequency (required)
-
Unit Hz Default 1 Range 0.01 to 20
About this input
How many times a second the shaking force repeats, in hertz, from 0.01 to 20. Shaking near a natural frequency makes the chain resonate.
Outputs
- Model Status
-
No unit declared
About this output
OK when every result is computed with nothing to flag; CHECK when the results are computed but need attention, for example a force near resonance; NOT VALID, with the reason, when an input is out of range or the run would be unstable.
- One period of the animated mode in 48 frames
-
No unit declared
About this output
One period of the animated mode in 48 frames: the time of each frame and how far each mass sits from rest, scaled so the largest movement is 1. The page plays these frames to show the masses oscillating in that mode.
- Natural frequencies and mode shapes
-
No unit declared
About this output
One row per mode: the angular frequency, the frequency in hertz, the period, an estimate of the modal damping ratio, the share of the starting energy in that mode, and the shape (largest movement 1, mass 1 positive).
- Model version
-
No unit declared
About this output
The model version.
- Masses in the chain solved
-
No unit declared
About this output
The number of masses in the chain that was solved; in a challenge, the challenge's own chain.
- Lowest natural frequency
-
Unit Hz
About this output
The first (lowest) natural frequency in hertz: how often the chain swings per second in its slowest pattern, where every mass moves the same way.
- Longest stable simulated time
-
Unit s
About this output
The longest simulated time, in seconds, whose step keeps the step ratio at 2.5 or below for this system.
- Displacement results by mass
-
No unit declared
About this output
For each mass: the largest displacement during the run, and the steady-state amplitude under the shaking force (blank with no force).
- Spring sensitivity of mode 1
-
No unit declared
About this output
For each spring in the chain: its share of mode 1's strain energy, and how much the first natural angular frequency rises per newton per metre of extra stiffness.
- Right end solved
-
No unit declared
About this output
Whether the solved chain ends at a fixed wall or a free mass.
- Time step
-
Unit s
About this output
The length of one step of the motion calculation, in seconds: the simulated time divided by 200.
- Step ratio (step x fastest rate)
-
No unit declared
About this output
The time step times the fastest rate of the system. Above 0.5 the fastest mode loses accuracy; above 2.5 the step-by-step method would be unstable and the run is refused.
- Most sensitive spring for mode 1
-
No unit declared
About this output
The spring that, made a few percent stiffer, raises the first natural frequency the most: the one storing the largest share of mode 1's strain energy.
- Formula module versions
-
No unit declared
About this output
The formula modules the model is built from, with their versions: the eigenvalue method, the time-stepping method and the frequency-response solver.
- Time response: 201 rows computed by RK4
-
No unit declared
About this output
The motion, one row per step from time 0: each mass's displacement, the force, and the kinetic, potential and total energy. These are the frames the page animates.
- Mode near resonance (0 = none)
-
No unit declared
About this output
The mode whose natural frequency is within 5% of the forcing frequency, or 0 when none is (or there is no force).
- Challenge result
-
No unit declared
About this output
MET when the selected challenge's goal is reached, NOT MET when it is not, or No challenge selected.
- Challenge score
-
No unit declared
About this output
100 when the selected challenge is met, otherwise 0.
- Energy drift of an undamped free run
-
Unit %
About this output
For a run with no dampers and no force, the percentage change of the total energy from start to end. It should be 0; what remains is the error of the step-by-step method. Blank when dampers or a force change the energy for real.
- Simulated time solved
-
Unit s
About this output
The simulated time of the solved run, in seconds.
- The chain solved
-
No unit declared
About this output
The chain as solved, one row per element: mass (row 5 has none), spring and damper stiffness of the elements in the chain, and each mass's starting displacement and velocity. Unused slots are blank.
- Mode animated
-
No unit declared
About this output
The mode the page animates: the one you chose, or the highest mode of the chain when you chose a higher number.
- Challenge goal
-
No unit declared
About this output
What the selected challenge asks you to do.
- Challenge feedback
-
No unit declared
About this output
A short explanation when the challenge is met, or a hint when it is not.
- Highest natural frequency
-
Unit Hz
About this output
The highest natural frequency in hertz, in the pattern with the most reversals between neighbouring masses.
- Frequency response: amplitude per newton of force
-
No unit declared
About this output
How far each mass moves per newton of steady shaking at 40 frequencies up to 1.25 times the highest natural frequency. Peaks mark the natural frequencies.
- Jacobi rotations: how the off-diagonal part shrinks
-
No unit declared
About this output
The 36 Jacobi rotations: which pair each rotation works on and how large the off-diagonal part of the matrix is afterwards, relative to the diagonal. It falls to about 1E-16 as the method converges.
- Starting energy
-
Unit J
About this output
The energy at the start, in joules: kinetic energy of the moving masses plus potential energy of the stretched springs.
- Force amplitude solved
-
Unit N
About this output
The force amplitude of the solved run, in newtons; 0 means a free response.
- Energy at the end
-
Unit J
About this output
The energy at the end of the run, in joules.
- Force frequency solved
-
Unit Hz
About this output
The force frequency of the solved run, in hertz.
- Mass the force acts on, solved
-
No unit declared
About this output
The mass the shaking force acted on in the solved run.
LogicCommons is in beta. If a result, label, or reference looks wrong, tell us here; we read every message.
Methodology
Purpose and model boundary
This lab models a straight chain of 2 to 4 point masses joined by springs, each with an optional damper beside it. The left end is always fixed to a wall; the right end is either a second fixed wall or a free last mass. For the chain as set, the model finds the natural frequencies and mode shapes, steps the free or forced motion through 200 equal time steps with its kinetic, potential and total energy, and computes the steady response to a shaking force at 40 frequencies. Five scored challenges turn these results into small design and prediction tasks.
It is a linear model for learning vibrations and numerical methods. It does not assess any real structure, machine, floor or vehicle: there is no friction, contact, nonlinear spring, large motion or continuous (distributed) mass, and no more than one harmonic force.
The model is the calculation authority. The page sends the values you set to the model and draws only what the model returns; it computes no frequency, shape, motion or energy value itself. The animation plays the model's own rows.
Inputs and units
| Input | Meaning and unit |
|---|---|
| Number of masses | How many masses are in the chain, a whole number from 2 to 4. |
| Right end | Fixed wall (the last mass is joined to a second wall through one more spring and damper) or Free end (the last mass is free to move). |
| Mass 1 to 4 | Each mass in kg, from 0.1 to 10. Only the first N are used, but every value must still be in range. |
| Spring 1 to 5 stiffness | Each spring in N/m, from 1 to 500. Spring 1 joins the left wall to mass 1, and spring e joins mass e-1 to mass e. Spring N+1 joins the last mass to the right wall, and is used only when the right end is a fixed wall; springs beyond the chain are ignored but must still be in range. |
| Damper 1 to 5 | Each damper in N s/m, from 0 to 20, acting beside the spring with the same number: a force proportional to how fast that spring stretches. 0 means no damper. |
| Starting displacement of mass 1 to 4 | How far each mass starts from its rest position, in m, from -0.5 to 0.5. |
| Starting velocity of mass 1 to 4 | The speed each mass starts with, in m/s, from -5 to 5. |
| Force amplitude | The peak of a steady shaking force F0, in N, from 0 to 100. The force is F0 sin(2π f t); 0 gives a free response. |
| Force frequency | How many times a second the force repeats, f in Hz, from 0.01 to 20. |
| Mass the force acts on | Which mass the force pushes, a whole number from 1 to 4; it must be one of the masses in the chain. |
| Simulated time | How many seconds of motion to simulate, from 1 to 300 s. The model always takes 200 equal steps, so a longer run means a coarser step. |
| Mode to animate | Which mode shape the page animates, from 1 (the slowest) to 4. A number above the chain's mass count animates its highest mode. |
| Challenge number | 0 for free exploration, or 1 to 5 to load a challenge. |
| Your prediction | Your answer in challenges 1 and 4, a whole number from 0 to 5; 0 means no answer yet. |
Sign conventions: displacements and velocities are measured from the unstretched rest position, positive to the right. The force is positive to the right when sin(2π f t) is positive.
Where each input is set:
- On the canvas only: the number of masses and the right end, chosen with the chips above the chain.
- In the input panel: every other input. For N masses, the panel shows masses and starting values 1 to N and springs and dampers 1 to N+1.
- Also on the canvas:
- Drag a mass sideways, or a start dot on the displacement chart at t = 0, to set its starting displacement.
- Tap a mass to set its mass, starting displacement and starting velocity.
- Tap a spring or damper to set its value, or drag it up or down to scale it.
- Tap F to set the force amplitude, its frequency and the mass it acts on.
- Drag the forcing marker on the frequency-response chart to set the force frequency.
- The mode buttons set the mode to animate, and in challenges 1 and 4 the prediction buttons set your prediction.
Governing relationships
The chain. Element e (e = 1 to 5) is spring k_e with damper c_e beside it, joining mass e-1 to mass e, where "mass 0" is the left wall. With a fixed right end, element N+1 joins mass N to the right wall; with a free end there is no element N+1. Elements outside the chain count as zero. The mass matrix M is diagonal (m_1 … m_N); the stiffness matrix K is tridiagonal, with K_ii = k_i + k_(i+1) and K_i,(i+1) = −k_(i+1). The damping matrix C is built the same way from the dampers. Because spring 1 always ties the chain to a wall and every spring is at least 1 N/m, K is positive definite: every natural frequency is real and above 0.
Natural frequencies and mode shapes: cyclic Jacobi. The model solves the undamped problem K φ = λ M φ. It turns it into a symmetric one, A v = λ v, with A = M^(−1/2) K M^(−1/2) and φ = M^(−1/2) v. It then applies 36 Jacobi rotations: six sweeps over the pairs (1,2), (1,3), (1,4), (2,3), (2,4), (3,4). Each rotation zeroes one off-diagonal entry a_pq:
- θ = (a_qq − a_pp) / (2 a_pq), t = sign(θ) / (|θ| + √(θ² + 1)), c = 1 / √(t² + 1), s = t c.
- The rotation updates the matrix and accumulates the eigenvector matrix V.
- A pair is skipped when |a_pq| ≤ 1×10⁻¹⁵ × √|a_pp a_qq|, which includes an entry that is already zero.
After the last rotation, the diagonal holds the eigenvalues λ_r, sorted from smallest to largest. From them, ω_r = √λ_r (rad/s), f_r = ω_r / 2π (Hz) and T_r = 2π / ω_r (s).
Mode shapes. Each mass-normalised shape φ_r = M^(−1/2) v_r is signed so that mass 1 moves in the positive direction. For display, it is scaled so that its largest movement is 1.
Per-mode values:
- The damping ratio estimate is ζ_r = Σ_e c_e (Δ_e φ_r)² / (2 ω_r), where Δ_e is the stretch of element e. This is the diagonal of the modal damping matrix: exact only when damping is proportional, an estimate otherwise.
- The share of the starting energy is found from the modal coordinates of the start, q_r = Σ m_i φ_i,r x0_i and p_r = Σ m_i φ_i,r v0_i. Each mode holds E_r = ½ (p_r² + λ_r q_r²), and its share is E_r / Σ E_r.
Mode 1 spring sensitivity:
- Spring e stores S_e = k_e (Δ_e φ_1)² of mode 1's strain energy, and its share is S_e / Σ S_e.
- The rise of the first angular frequency per unit of extra stiffness is dω_1/dk_e = (Δ_e φ_1)² / (2 ω_1).
- The most sensitive spring is the one with the largest share. Shares within 1×10⁻⁹ (relative) count as a tie, which goes to the lower spring number.
Time response: classic fourth-order Runge-Kutta (RK4), fixed step. The step is h = duration / 200, and row n is at time t_n = n h (n = 0 to 200). Row 0 holds the starting displacements and velocities. The acceleration of mass i is
a_i = [F_i(t) − k_i (x_i − x_(i−1)) + k_(i+1) (x_(i+1) − x_i) − c_i (v_i − v_(i−1)) + c_(i+1) (v_(i+1) − v_i)] / m_i
Walls and masses outside the chain stay at zero, and F_i(t) = F0 sin(2π f t) on the forced mass only. Each step evaluates four stages: one at the start, two at the midpoint and one at the end. It then combines them with weights 1, 2, 2, 1, divided by 6.
Energy at each row: KE = ½ Σ m_i v_i², PE = ½ Σ_e k_e (Δ_e x)², and E = KE + PE, in joules.
- For a run with no damper and no force, the energy drift is 100 × (E_200 − E_0) / E_0, in percent. Exact motion would keep E constant, so what remains is the error of the step-by-step method.
Step ratio and stability:
- The fastest rate of the system is the larger of the highest natural angular frequency ω_N and a bound γ on the damping rates. γ is a row-sum (Gershgorin) bound built from the dampers on each mass.
- The step ratio is h × rate.
- The longest stable simulated time is 200 × 2.5 / rate.
Frequency response: a complex tridiagonal solve (Thomas algorithm). For a forcing angular frequency ω and a unit force on the forced mass j, the model solves (K − ω² M + iω C) X = e_j in complex arithmetic. It eliminates forward down the tridiagonal, then substitutes back. The receptance of mass i is |X_i|, in metres per newton.
- The sweep has 40 points, f_k = k × 1.25 × f_N / 40 for k = 1 to 40.
- The steady-state amplitude of each mass at the force frequency is F0 × |X_i|.
- A point whose solve would divide by exactly zero (an undamped resonance) is left blank.
Resonance. For a forced run, the mode near resonance is the lowest mode r with |f − f_r| / f_r ≤ 5%.
Calculation sequence
The model works through the relationships above in this order:
- It checks the values you entered (items 1 to 9 of the status list under Errors and warnings).
- It fixes the values solved: your inputs, or in a challenge the challenge's own system. It checks that the forced mass is in the chain (item 10).
- It builds M, K and C for the chain, and finds the natural frequencies and mode shapes with the 36 Jacobi rotations.
- It computes the per-mode damping ratio estimates and energy shares, and the mode 1 spring sensitivities.
- It finds the step, the step ratio and the longest stable simulated time, and refuses a step ratio above 2.5 (item 11).
- It steps the motion through the 200 RK4 steps, with the energy at each row and the energy drift.
- It solves the frequency response at the 40 sweep points and the steady-state amplitude at the force frequency, and finds the mode near resonance.
- It sets the status and, in a challenge, scores the challenge.
Outputs and interpretation
Summary values:
- Status: OK, CHECK with a reason, or NOT VALID with the first problem to fix (see Validation and status logic and Errors and warnings).
- Lowest and highest natural frequency (Hz, 0.0000): the slowest pattern, where every mass moves the same way, and the fastest, with the most reversals between neighbouring masses.
- Time step (s, 0.00000) and step ratio (0.000): the step is duration / 200. Above 0.5 the fastest mode loses accuracy; above 2.5 the run is refused.
- Longest stable simulated time (s, 0.00): the duration at which the step ratio reaches 2.5.
- Starting energy and energy at the end (J, 0.000000).
- Energy drift of an undamped free run (%, 0.0000): close to 0. It is blank when a damper in the chain or a force changes the energy for real, or when the starting energy is 0.
- Mode near resonance: the mode within 5% of the force frequency, or 0 when there is none or no force.
- Most sensitive spring for mode 1: the spring that, made a few percent stiffer, raises the first natural frequency the most.
- The values solved: the number of masses, right end, force amplitude and frequency, forced mass, simulated time and mode animated. In a challenge they show the challenge's own system.
- Model version and formula module versions: the eigenvalue method (cyclic Jacobi, 6 sweeps), the time stepping (classic Runge-Kutta, fixed step) and the frequency-response solver (Thomas algorithm).
Tables:
The chain solved: one row per slot. Each row gives the mass, the spring and damper of each element in the chain, and each mass's starting displacement and velocity. Slots outside the chain are blank.
Natural frequencies and mode shapes: one row per mode. Each row gives:
- the angular frequency (rad/s), frequency (Hz) and period (s);
- the damping ratio estimate;
- the share of the starting energy;
- the shape, with the largest movement 1 and mass 1 positive.
To compare shapes, compare the ratios between masses, not the raw entries.
Jacobi rotations: the 36 rotations, each with its pair (row p, column q) and the relative off-diagonal size afterwards. The relative size is the root-sum-square of the off-diagonal entries over that of the diagonal entries. It falls towards about 1×10⁻¹⁶ as the method converges, and skipped pairs are still listed.
Time response: 201 rows, from time 0 through the 200 steps. Each row gives each mass's displacement (m), the force (N), and the kinetic, potential and total energy (J). These are the frames the page animates.
Frequency response: the 40 sweep frequencies and each mass's receptance in m/N. Peaks mark the natural frequencies; multiply by the force amplitude to get metres.
Displacement results by mass: each mass's peak displacement during the run, and its steady-state amplitude under the force (blank with no force).
Spring sensitivity of mode 1: each spring's share of mode 1's strain energy and the sensitivity dω_1/dk_e, in (rad/s) per (N/m).
Mode animation: one period of the animated mode in 48 frames. Each frame holds its time k T / 48 and the display shape times sin(2π k / 48).
Reading the results:
- Rows past the number of masses, and elements outside the chain, are blank.
- In the time response and the mode shapes, unused mass slots read 0.
- The natural frequencies are those of the undamped chain: dampers change the motion and the frequency response, not the frequencies in the mode table.
Challenges
Each challenge replaces the system with its own: the number of masses, right end, masses, springs, starting state, force and a 10 s run, all with no dampers and no starting velocity. Only the inputs a challenge leaves open stay yours, and the page marks the rest as fixed by the challenge. The mode to animate always stays yours. A met challenge scores 100, an unmet one 0, and feedback gives a hint when it is not met.
- Which mode is higher? For a two-mass chain, predict which mode shape has the higher natural frequency: 1 if the masses move together, 2 if they move against each other. You set the prediction.
- Tune a natural frequency. Choose the middle spring of a two-mass chain so the second natural frequency is 1 Hz, within 2%.
- Reduce the amplitude (vibration absorber). A 1 N force at 1 Hz shakes mass 1 of a heavy mass with a small mass hung on it. Choose the small mass's spring so mass 1's steady-state amplitude is at most 2 mm.
- The most sensitive spring. For a three-mass chain, predict which spring, made a few percent stiffer, raises the first natural frequency the most. You set the prediction.
- Match two modes. Choose both springs of a free-ended two-mass chain so the natural frequencies are 0.5 Hz and 1 Hz, each within 3%.
Validation and status logic
Every input is checked, including inputs for slots the chain does not use. The status shows the first message in the list under Errors and warnings that applies. Items 1 to 9 check the values you entered. Items 10 to 15 check the values solved, which are a challenge's own when one is selected. Under CHECK every result is computed.
Assumptions and limitations
Idealisations:
- Point masses in a line, with linear springs and linear (viscous) dampers.
- Small motions, with no friction, contact or large-deflection effects.
- At most one harmonic force, on one mass.
Numerical limits:
- 2 to 4 masses and up to 5 springs and dampers.
- Exactly 200 RK4 steps, so the step is always duration / 200. RK4 slowly loses the energy of modes whose step ratio is large.
- 36 Jacobi rotations (6 sweeps), with a skip tolerance of 1×10⁻¹⁵.
- 40 frequency-response points, up to 1.25 times the highest natural frequency. They cannot resolve a lightly damped peak narrower than the point spacing; the natural frequencies themselves come from the eigenvalue solution, not from the sweep.
- 48 frames for the mode animation.
- The damping ratios are estimates whenever damping is not proportional.
- A value within about 1×10⁻⁹ (relative) of a threshold may fall either side of it. This applies to the Jacobi skip test, the 5% resonance band, the step-ratio limits and the spring-share tie.
Restrictions and non-computing states
What happens under NOT VALID:
- Every table and every numeric result is blank, apart from three values: the mode near resonance, the most sensitive spring and the challenge score all read 0.
- A selected challenge reads NOT MET; its goal and hint still show. If the challenge number itself is not a whole number from 0 to 5, the result reads No challenge selected.
- Under item 11 only, the time step, step ratio and longest stable simulated time still show, so you can see how far to shorten the run.
Errors and warnings
The status messages, in the order they are checked:
- "NOT VALID: the number of masses must be a whole number from 2 to 4"
- "NOT VALID: choose the right end from the list"
- "NOT VALID: each mass must be from 0.1 to 10 kg"
- "NOT VALID: each spring must be from 1 to 500 N/m"
- "NOT VALID: each damper must be from 0 to 20 N s/m"
- "NOT VALID: each starting displacement must be from -0.5 to 0.5 m and each starting velocity from -5 to 5 m/s"
- "NOT VALID: the force must be from 0 to 100 N at 0.01 to 20 Hz, on a mass numbered 1 to 4"
- "NOT VALID: the duration must be from 1 to 300 s"
- "NOT VALID: the challenge number must be a whole number from 0 to 5, the prediction from 0 to 5, and the animated mode from 1 to 4"
- "NOT VALID: the force must act on one of the masses in the chain": the forced mass number is larger than the number of masses solved.
- "NOT VALID: the time step (duration / 200) is too long for this system, so the step-by-step solution would be unstable; shorten the duration to the maximum stable duration or less": the step ratio is above 2.5.
- "CHECK: nothing moves; give a mass a starting displacement or velocity, or apply a force": every starting displacement and velocity of the masses in the chain is 0 and the force amplitude is 0.
- "CHECK: the forcing frequency is within 5% of the natural frequency of mode r, so the motion builds up near resonance": r is the mode near resonance.
- "CHECK: the time step is coarse for the fastest mode (step ratio above 0.5), so the response loses accuracy; shorten the duration"
- "CHECK: the run is shorter than one period of the slowest mode; lengthen the duration to see a full cycle": the simulated time is shorter than the period of mode 1.
- "OK"
References
This laboratory is an educational model of a chain of two to four masses joined by springs and dampers. Its natural frequencies and mode shapes come from the generalized eigenproblem K phi = lambda M phi, turned into a symmetric problem and solved by the cyclic Jacobi method of plane rotations. Its motion in time is integrated by the classical fourth-order Runge-Kutta method with a fixed step, with the kinetic, potential and total energy at every step. Its steady response to a harmonic force comes from a complex tridiagonal system solved by the Thomas algorithm.
Sources and further reading
- Two- and multi-degree-of-freedom vibration, natural frequencies, mode shapes and modal analysis: S. S. Rao, Mechanical Vibrations, 6th edition, Pearson, 2017, chapter 5, Two-Degree-of-Freedom Systems, and chapter 6, Multidegree-of-Freedom Systems. Publisher page
- The rotation method for symmetric matrices, as first published: C. G. J. Jacobi, "Über ein leichtes Verfahren die in der Theorie der Säcularstörungen vorkommenden Gleichungen numerisch aufzulösen", Journal für die reine und angewandte Mathematik 30, 1846, pages 51-94. doi:10.1515/crll.1846.30.51
- The cyclic Jacobi method, and the solution of banded (including tridiagonal) systems: G. H. Golub and C. F. Van Loan, Matrix Computations, 4th edition, Johns Hopkins University Press, 2013, section 8.5, Jacobi Methods, and section 4.3, Banded Systems.
- Runge-Kutta methods: E. Hairer, S. P. Nørsett and G. Wanner, Solving Ordinary Differential Equations I: Nonstiff Problems, 2nd revised edition, Springer Series in Computational Mathematics 8, Springer, 1993, chapter II, Runge-Kutta and Extrapolation Methods. doi:10.1007/978-3-540-78862-1
- A short description of the Jacobi transformation for symmetric matrices: E. W. Weisstein, "Jacobi Transformation", MathWorld, Wolfram Research. MathWorld
No table or text from any of these publications is reproduced, and none of their authors or publishers has reviewed or endorses this laboratory.
This laboratory is for learning. Its results hold only within its stated ranges; it is not a tool for designing machines, structures or vibration isolators.
Found a problem, or have an idea?
Tell us if a result looks wrong, a label is unclear, or something is missing. We read every message.