Harmonic Response
harmonic_responseComputes exact SDOF harmonic frequency response (FRF) from natural frequency and damping ratio, returning amplification, phase, peak frequency, and bandwidth for vibration checks.
Instructions
Exact SDOF harmonic frequency response (NO solver) — the FRF screen and the
oracle the Elmer harmonic_response_submit sweep is gated against. Bridges
beam_modal (f_n) and random_vibration (Q = 1/(2ζ)): with r = f/f_n,
|H| = 1/√((1−r²)²+(2ζr)²), phase = atan2(2ζr, 1−r²), peak amplification
Q = 1/(2ζ√(1−ζ²)) at f_peak = f_n·√(1−2ζ²), half-power bandwidth ≈ 2ζ·f_n.
With frequency_hz the response at that drive is returned;
static_deflection_mm scales it to an absolute amplitude_mm. fidelity='exact';
ζ ≥ 1/√2 has no peak (flagged). Escalate to harmonic_response_submit for a
real meshed FRF (multi-mode, geometry-true).
Returns {natural_frequency_hz, damping_ratio, q_factor, f_peak_hz, half_power_bandwidth_hz, frequency_ratio, amplification, phase_deg, amplitude_mm, fidelity, band_pct, valid_range_ok, warnings, escalate_to}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"natural_frequency_hz": "<natural_frequency_hz>",
"damping_ratio": "<damping_ratio>"
},
"name": "harmonic_response"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workspace | No | Run this call in this named workspace | |
| frequency_hz | No | ||
| damping_ratio | Yes | ||
| natural_frequency_hz | Yes | ||
| static_deflection_mm | No |