M01_web.json schema contract, version1
====================================
geometry:
  nodes_m: full cube node coordinates, [node][x,y,z], metres
  tets: full volumetric four-node connectivity, zero-based full node indices
  surface_triangles: outward-oriented triangle connectivity, full node indices
  surface_adjacent_tet: the volume element touching each surface triangle
  surface_node_ids: list of full node indices used by surface-only mode arrays
  fixed_node_ids: all bottom nodes, whose all three displacements are constrained
  side_m, subdivisions_per_axis, volume_element_count

materials[]:
  id, name, E_pa, rho_kg_m3, nu, source_url
  damping: alpha_per_s, beta_s, reference_ratio, anchor_frequency_hz
  modes[]: mode_index(one-based),frequency_hz,
    surface_displacement_mass_normalized: [surface_node_ids entry][x,y,z]
    normalization: "phi.T*M*phi=1; units kg^-1/2"
    animation_gain_for_5pct_side_m: a visual coefficient in metres*sqrt(kg),
      giving max surface vector length0.05*side; not physical modal amplitude
  forced:
    frequency_hz (finite-grid peak |compliance| on finest baseline mesh)
    force_peak_n:1, load_direction:[0,0,-1], convention:"exp(+i*omega*t)"
    displacement_real_m, displacement_imag_m: [full node][x,y,z]
    surface_stress_real_pa, surface_stress_imag_pa: [surface triangle][6]
      constant adjacent-element stress, Voigt xx,yy,zz,xy,yz,xz; NOT nodal smoothing
    visual_gain_for_5pct_side: dimensionless, separate from physical displacement
    sampled_peak_node_displacement_amplitude_m: max-node harmonic vector norm peak
    observed_peak_element_von_mises_pa: exact harmonic phase peak per element,
      then maximum over elements; mesh-dependent and not a fracture limit
    volume_time_rms_von_mises_pa
    energy_checks and direct_reference_at_selected_frequency
  response_curves[]: reference_damping_ratio,frequency_hz,
    compliance_real_m_n,compliance_imag_m_n,compliance_magnitude_m_n

Physical phase replay:
  U(theta)=U_real*cos(theta)-U_imag*sin(theta).
  Stress(theta) has the same phase convention. Compute instantaneous von Mises
  from its six real components; do not take the magnitude of a complex VM scalar.
  Clamp fixed nodes exactly. Visual exaggeration does not change exported units.

summary/disclosures:
  model is3D FEM small-strain linear elasticity; no physical trial/fracture/hardness
  law. Repeated eigenvectors are a chosen basis, not uniquely tracked identities.
  JSON vectors are display-rounded9significant digits; use full float64 NPZ for audit.
