1% PLATE_RESULT_SCHEMA Fields of the structs the two methods return.
2%
3% A run has two stages. The modes stage (plate_rr_modes or
4% plate_fem_modes) depends on the plate, its material, the hole, the
5% thread, the sample rate (through the 0.47 fs cutoff), the mode cap and
6% the method's numerics; the host keeps its struct and reuses it while
7% only the hammer, the strike point, the probe, the microphone or the
8% render settings change. The strike stage (plate_rr_strike or
9% plate_fem_strike) returns the result.
10%
11% Coordinates are metres from the plate's centre, x to the right and y
12% towards the threaded top edge.
13%
14% modes.method 'rr' or 'fem'
15% modes.freqs 1 x nm, ascending; the finite-element method's three
16% rigid-body modes (below 20 Hz) come first
17% modes.shapes ny x nx x nm mass-normalized transverse shapes on the
18% grid (grid_x 1 x nx, grid_y 1 x ny; rows index y)
19% modes.kxx, kyy, kxy curvatures w_xx, w_yy, w_xy of each shape on the grid
20% modes.support_part 1 x nm, the shape at the hole
21% modes.volume_part 1 x nm, the integral of the shape over the plate
22% modes.vecs (rr only) the Ritz coefficients, n x nm
23% modes.ndof, size_note, wall_s, notes, and the mesh or basis sizes
24%
25% result.method 'rr' or 'fem'
26% result.grid x (1 x nx), y (1 x ny): the display grid [m]
27% result.t time axis of the series [s], one sample per 1/fs
28% result.probe x, y; w [m] the displacement (all modes); sxx, syy, txy,
29% vm, sp [Pa] the surface stresses there
30% result.frames t (1 x nf) over the first render.frame_span seconds;
31% w the flexural field (audible modes), w_total with the
32% rigid-body modes, vm and sp the surface stresses,
33% each ny x nx x nf
34% result.envelope vm, |sp|: peak over the frames, ny x nx [Pa]
35% result.spectrum f [Hz]; p the amplitude spectrum of the pressure, w of
36% the probe displacement (Hann window)
37% result.audio fs; p the pressure at the microphone [Pa], mean removed;
38% peak_pa; gain, the factor that puts the peak at
39% render.normalize_dbfs; model
40% result.modes n; freq, q, zeta, hit (the shape at the strike point),
41% support, radiation (volume participation),
42% radiation_factor, acoustic (Pa per m/s^2 of modal
43% acceleration), audible (1 or 0), q0 and v0 (the modal
44% state at separation), shapes (as in modes)
45% result.contact model; tc the contact time [s]; impulse [N s];
46% peak_force [N]; t (1 x 600), force, hammer_x, hammer_v,
47% plate_w, plate_v the histories (the hammer's are empty
48% for the prescribed pulse); hammer_exit_v, plate_exit_v,
49% relative_separation_v, effective_restitution; the
50% Hertz estimates hertz_duration, hertz_impulse,
51% hertz_peak_force, and contact_k
52% result.info method, ndof, nmodes, n_audible, n_rigid, fs, nsamples,
53% nframes, frame_span, plate_mass, thread_k,
54% critical_frequency, f_max, size_note, modes_wall_s,
55% wall_s, strike_wall_s, notes (cell array of strings)
56%
57% This file documents the convention and has no executable content.