Harmonic Response Submit
harmonic_response_submitSubmit a harmonic forced-response simulation of a cantilever beam to compute its first resonance frequency, static compliance, and damping quality factor via Elmer StressSolve, returning a job ID for asynchronous polling.
Instructions
Harmonic forced response (FRF) via Elmer StressSolve Harmonic Analysis
(SIMULATION_NEXT Tier B2), asynchronous — a plane-stress cantilever driven by
a harmonic tip traction, swept one quasi-static point + n_sweep points across
±span_pct% of its first resonance, with Rayleigh β tuned to damping_ratio
at f₁. Requires ElmerSolver; when absent this returns {ok:false, reason,
install} rather than raising.
Three gates from the in-phase (real) response: f1_ratio — Re(H) = 0 exactly
AT resonance, so the swept tip response's sign-flip locates f₁ vs the
Euler-Bernoulli beam_modal closed form (within ~2%, plane-stress vs beam
theory); static_ratio — the quasi-static point vs the exact tip compliance
F·L³/(3EI) (within ~5%); q_ratio — max|Re|/static vs Q/2 = 1/(4ζ), the
exact SDOF light-damping identity (within ~15%, sweep-sampled). Cross-links
harmonic_response (the SDOF oracle) and random_vibration (same Q). Also
accepts a prepared case_dir.
Returns the degradation dict or {job_id, status, cache_hit}; poll job_result for {ok, f1_solved_hz, f1_eb_hz, f1_ratio, static_solved_m, static_exact_m, static_ratio, peak_over_static, q_factor, q_ratio, frf:[[f_hz, tip_re_m]], case_dir}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nx | No | ||
| ny | No | ||
| sif | No | case.sif | |
| n_sweep | No | ||
| poisson | No | ||
| case_dir | No | ||
| height_m | No | ||
| length_m | No | ||
| span_pct | No | ||
| youngs_pa | No | ||
| traction_pa | No | ||
| damping_ratio | No | ||
| density_kg_m3 | No |