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