Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- VR Stiffness
-
Unit N/m Default 1283 Range At least 0
About this input
Positive effective linear restoring stiffness on the modeled displacement coordinate.
- VR Mass
-
Unit kg Default 7.3 Range At least 0
About this input
Positive effective modal or physical mass represented by the single degree of freedom.
- VR Viscous Damping Coefficient
-
Unit N*s/m Default 18.7 Range At least 0
About this input
Nonnegative linear viscous coefficient c; zero is explicitly supported away from resonance.
- VR Unit System
-
Default SI metric Allowed SI metric, US customary
About this input
Select SI metric or US customary entry/display units; both paths use the same SI base equations.
- VR Excitation Frequency
-
Unit Hz Default 2.37 Range At least 0
About this input
Nonnegative cyclic frequency of the active sinusoidal force or base motion.
- VR Base Displacement Amplitude Conditional
-
Unit mm Default 4.63 Range At least 0
About this input
Nonnegative peak prescribed base displacement; active only in base-displacement mode.
- VR Force Amplitude Conditional
-
Unit N Default 43.7 Range At least 0
About this input
Nonnegative peak force applied directly to the mass; active only in harmonic-force mode.
- VR Excitation Mode
-
Default Harmonic force Allowed Harmonic force, Base displacement
About this input
Choose direct sinusoidal force on the mass or prescribed sinusoidal support/base displacement.
Outputs
- Static force deflection amplitude
-
Unit mm
About this output
Force mode: F0/k static displacement reference. Base mode: entered base displacement amplitude.
- VR Peak Velocity Amplitude
-
Unit m/s
About this output
Excitation angular frequency multiplied by response displacement amplitude.
- VR Peak Acceleration Amplitude
-
Unit m/s^2
About this output
Excitation angular frequency squared multiplied by response displacement amplitude.
- VR Response Regime
-
No unit declared
About this output
Classifies the excitation frequency as below, at, or above the undamped natural frequency using a 1e-9 display classification tolerance.
- VR Response Phase Lag
-
Unit deg
About this output
Force mode: displacement lag relative to applied force. Base mode: absolute mass-displacement lag relative to base displacement.
- VR Response Displacement Amplitude
-
Unit mm
About this output
Peak steady-state absolute displacement amplitude of the mass.
- VR Critical Damping Coefficient
-
Unit N*s/m
About this output
Critical viscous coefficient 2*sqrt(k*m) on the entered displacement coordinate.
- Dynamic magnification factor
-
Unit ratio
About this output
Force mode: displacement magnification relative to F0/k. Base mode: absolute mass-displacement transmissibility relative to base amplitude.
- Model Status
-
No unit declared
About this output
Returns actionable NOT VALID or CHECK text. OK means the stated linear steady-state equations evaluated; it is not a vibration qualification, allowable, or safety approval.
- VR Natural Frequency
-
Unit Hz
About this output
Undamped cyclic natural frequency sqrt(k/m)/(2*pi).
- VR Frequency Ratio
-
Unit ratio
About this output
Excitation angular frequency divided by undamped natural angular frequency.
- VR Damping Ratio
-
Unit ratio
About this output
Entered viscous damping coefficient divided by the critical damping coefficient.
What it is
The Single Degree of Freedom Forced Vibration Response Calculator works out the steady-state response of one lumped mass on one linear spring and one linear viscous damper to a steady sinusoidal excitation. It runs in two modes: a harmonic force applied directly to the mass, and a harmonic displacement prescribed at the base.
It reports the undamped natural frequency, the critical damping coefficient, the damping ratio, the ratio of excitation frequency to natural frequency, the dynamic magnification factor or the absolute displacement transmissibility, the steady response amplitude, the phase lag, and the peak velocity and acceleration. It also states whether the excitation sits below, at, or above the natural frequency.
Entry is in SI metric or US customary, and both paths run the same SI base equations, so the same physical system entered either way returns the same natural frequency and damping ratio. Changing the selector reinterprets whatever is already in the fields rather than converting it. Displacement amplitudes are in millimetres or inches, frequency in hertz, phase in degrees, and velocity and acceleration in metres or inches per second and per second squared.
The single degree of freedom is the limitation to keep in front of you. One mode, one concentrated mass, one linear viscous damper, and the steady state only. A real structure has distributed mass and many modes, and the mode this model describes may not be the one that governs. It is a response screen, not a vibration acceptability determination.
Methodology
Purpose and model boundary
This model calculates the linear steady-state sinusoidal response of one mass-spring-viscous-damper degree of freedom. It supports direct harmonic force and prescribed base-displacement excitation and reports absolute mass-displacement response. It is a deterministic single-frequency response model, not a transient, modal, fatigue or vibration-acceptability analysis.
The spreadsheet remains the calculation authority. The page submits the named inputs through the calculation service and displays the workbook's results, comparison chart and status; the response equations are not reimplemented in browser code.
Inputs and units
| Input group | Values used by the model |
|---|---|
| Unit basis | SI metric or US customary; the workbook converts to SI internally and converts displayed results back. |
| System | Effective mass m, stiffness k, and viscous damping coefficient c. |
| Excitation | Harmonic force or base displacement, excitation frequency f, and the active force amplitude F0 or base amplitude Y. |
Mass and stiffness must be positive. Damping, frequency and the active excitation amplitude may be zero. The inactive amplitude is hidden and not used.
Governing relationships
The natural circular frequency, natural frequency, critical damping, damping ratio and frequency ratio are
ωn = √(k/m)andfn = ωn/(2π);cc = 2√(km)andζ = c/cc;ω = 2πfandr = ω/ωn.
The common response denominator is
D = √((1 − r²)² + (2ζr)²).
For harmonic force, reference displacement is F0/k, amplitude ratio is 1/D, and phase lag follows the complex force-response denominator. For base displacement, reference displacement is Y, absolute displacement transmissibility is √(1 + (2ζr)²)/D, and phase follows the corresponding absolute-motion transfer function. Response amplitude is reference amplitude times the active ratio. Peak velocity and acceleration are ωX and ω²X.
Calculation sequence
- Validate units and excitation mode, positive mass and stiffness, nonnegative damping and frequency, and nonnegative active excitation amplitude.
- Convert the selected units to the SI calculation basis.
- Calculate natural frequency, critical damping, damping ratio and frequency ratio.
- Evaluate the mode-specific numerator, common denominator, amplitude ratio and reference displacement.
- Calculate absolute displacement, phase lag, peak velocity and peak acceleration.
- Reject the exact undamped-resonance singularity, verify all public and chart values are finite and consistent, and return the ordered status.
Outputs and interpretation
Primary outputs are response displacement amplitude, amplitude ratio, natural frequency, frequency ratio and damping ratio. Details expose reference displacement, critical damping, phase lag, peak velocity, peak acceleration and the below/at/above-natural-frequency regime. The chart compares the active excitation reference amplitude with absolute steady response.
In base-excitation mode, the response is absolute mass motion, not relative suspension deflection or transmitted force. Those quantities require different equations.
Validation and status logic
The workbook applies these conditions in order:
| Condition | Returned status |
|---|---|
| A listed mode is not selected, or active mass, stiffness, damping, frequency, force or base-displacement input is outside its domain | NOT VALID: choose listed modes and correct active mass, stiffness, damping, frequency, force, or base-displacement inputs |
Damping is zero and |r − 1| ≤ 10⁻¹² |
NOT VALID: undamped resonance has unbounded steady-state response |
| A required converted, response or chart value is not finite or fails the protected numeric relationships | NOT VALID: derived result exceeds the supported calculation range |
| Damping is zero away from the singular point | CHECK: undamped model; steady-state response is singular at resonance |
| The active reference excitation amplitude is zero | CHECK: zero excitation amplitude gives zero steady response |
| None of the preceding conditions applies | OK |
The undamped warning takes precedence over the zero-excitation warning away from resonance. At natural frequency the regime label uses |r − 1| ≤ 10⁻⁹, while the non-computing undamped singularity uses the tighter 10⁻¹² tolerance.
Assumptions and limitations
- The system is linear, time-invariant and represented by one concentrated mass, one linear spring and one linear viscous damper.
- Only steady-state sinusoidal response is reported; free transients and initial conditions have decayed.
- System properties are effective user inputs and are not inferred from geometry or a material/component database.
- Shock, random vibration, response spectra, fatigue, modal superposition and multiple degrees of freedom are outside scope.
- Nonlinear stiffness, friction, hysteretic or frequency-dependent damping, backlash, clearance, impact and amplitude-dependent properties are not modeled.
- Near resonance, small uncertainty in
m,k,corfcan dominate response. No proprietary severity zone, machine class, isolation criterion or allowable is embedded.
Restrictions and non-computing states
The exact undamped-resonance state has an unbounded steady response and is deliberately non-computing. Zero damping away from resonance and zero excitation amplitude are computing boundary states with CHECK messages. Any NOT VALID state supersedes displayed residue. A finite response is not a qualification or safety approval.
Errors and warnings
A rejected entry means the submitted values did not satisfy the published input rules. NOT VALID means the workbook refused a singular, unsupported or malformed state. CHECK identifies a mathematically defined boundary needing interpretation. Calculation-service failures are availability errors and must not be confused with zero response.
References
No isolator catalogue, licensed damping dataset, vibration severity table or machine class is embedded. Mass, stiffness and the viscous damping coefficient are entered by you, and the shipped values are synthetic demonstration numbers describing no real machine, mount or structure. The workbook implements the ordinary textbook form of the linear single-degree-of-freedom force and base excitation relations, independently coded, rather than any one publication's derivation. The sources cited for those relations and the unit identities are below.
- NASA. Frequency Response of Single Degree-of-Freedom Systems, for the force-excited equation of motion, critical damping, damping ratio, natural frequency and dynamic magnification. https://ntrs.nasa.gov/api/citations/20190033330/downloads/20190033330.pdf
- NASA. Vibration and Shock Isolation, for the distinction between applied force and prescribed base motion, transmissibility, phase and the undamped resonance singularity. https://ntrs.nasa.gov/api/citations/19810017924/downloads/19810017924.pdf
- NIST. Guide to the SI, Appendix B: Conversion Factors, for the exact inch, standard gravity and pound-force identities on the US path. https://www.nist.gov/pml/special-publication-811/nist-guide-si-appendix-b-conversion-factors
- NIST. Handbook 133 (2014), Appendix E, for the exact avoirdupois pound identity used by the mass conversion. https://www.nist.gov/document/14-app-e-14-hb133-finalpdf
Citing these sources implies no endorsement by the agencies named. Allowable vibration levels, machine severity classes, isolator selection data, modal survey results and fatigue assessment are not supplied here. Take them from the governing standard, the equipment manufacturer, and measurement on the actual installation.
Additional source notes migrated from Methodology
Project-specific vibration criteria, validated system properties and qualified dynamics review govern real equipment or structural decisions.
Frequently asked questions
My excitation is above the natural frequency, so why is the motion getting worse?
Does adding damping always reduce the motion?
What happens if I enter zero damping?
How much can I trust the amplitude near resonance?
Is the reported amplitude the absolute motion or the motion across the mount?
Why did every output come back as zero?
Can I use this for rotating unbalance?
When is one degree of freedom not enough?
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.
LogicCommons is in beta. If a result, label, or reference looks wrong, tell us here; we read every message.