{
  "schema_version": 1,
  "id": "M02-single-material-spatial-and-modal-refinement",
  "prepared_utc": "2026-10-06T21:20:16Z",
  "status": "FROZEN_REVIEWED_MATRIX_BEFORE_EXECUTION",
  "execution_authorized": true,
  "new_eigensolutions_performed": 0,
  "new_forced_solves_performed": 0,
  "purpose": "Determine whether finer spatial discretization and more retained modes materially reduce M01 accuracy errors for one unchanged reference material. Obtain separate spatial, modal-truncation and sampled direct-reference evidence; do not optimize a material or manufacture passing counts.",
  "decision_before_execution": "Root and independent reviewer inspect this draft. If accepted, copy the reviewed exact matrix to a separately named frozen M02 plan, hash it before implementation/results, and record execution authorization separately. This draft is not an executed or completed study.",
  "parent_evidence": {
    "plan_path": "M01-PLAN.json",
    "plan_sha256": "03b107ecb99c194fa4d6768efdba2600dbfef99ecac95c49f58cae730e3ee218",
    "summary_path": "results-v2/M01_summary.json",
    "summary_sha256": "6ec9e98cbb235c4d2582839c929396cdbcd5cc2e4004d204792514335adeddc0",
    "material_input_path": "inputs/MATERIAL-INPUTS.json",
    "material_input_sha256": "40a7b0adcbe691326d4ed742018577e6fd43527a38dfd212630e45118a262e74",
    "frozen_engine_path": "fem3d.py",
    "frozen_engine_sha256": "df32d998f2d88256860978a951181f1a92e4773363cf725449a3648cbdfe4b6a",
    "parent_sources_results_figures_and_packages_read_only": true,
    "existing_M01_failed_screens_remain_failed": true,
    "parent_failure_context": "M01 steel n6-to-n8 first-six spectrum shifts about3.35%; its whole-band compliance and24-to48-mode screens failed. A selected-frequency direct match does not resolve those failures. The serialization-failed first attempt is retained as reporting provenance, not extra validation."
  },
  "primary_improvement": {
    "material_id": "structural_steel",
    "selection_reason": "One conventional isotropic reference, in the original material order, limits cost and separates numerical resolution from changing material properties. No claim that steel is the easiest, best, most fracture-prone or representative of all three materials.",
    "E_pa": 210000000000.0,
    "rho_kg_m3": 7850.0,
    "nu": 0.3,
    "other_materials": "No new aluminum or fused-silica solves in this bounded iteration. Their M01 evidence and unresolved status remain unchanged.",
    "primary_question": "At fixed144 retained modes, do n10-to-n12 spatial comparisons meet the original M01 spectrum and response criteria, and are those modal fields sufficiently close to direct solutions at the predeclared frequencies?",
    "no_guaranteed_pass": true
  },
  "unchanged_physics": {
    "geometry": "Homogeneous20mm cube; straight volume geometry is exact on every mesh",
    "side_m": 0.02,
    "method": "Small-strain isotropic linear-elastic TET4 FEM;6 Freudenthal tetrahedra per structured cell, same body diagonal and exact element gradients",
    "mass": "Consistent TET4 mass; no lumping",
    "boundary": "All three displacements fixed at z=0; other faces traction-free except loaded top",
    "load": "Uniform top-face downward traction,1N peak resultant,2500Pa; exp(+i*omega*t)",
    "rayleigh": {
      "C": "alpha*M+beta*K",
      "reference_damping_ratio": 0.01,
      "anchor_frequency_hz": [
        20000.0,
        200000.0
      ],
      "alpha_per_s": "2*zeta*omega_a*omega_b/(omega_a+omega_b)",
      "beta_s": "2*zeta/(omega_a+omega_b)",
      "same_coefficients_on_every_mesh_and_cutoff": true,
      "new_damping_fit_or_sensitivity": false,
      "interpretation": "Unmeasured illustrative loss, not material-specific calibrated damping. M01's separate0.005/0.02 sensitivity evidence is not rerun or changed."
    },
    "static_residual_correction": false,
    "strain_stress_conventions": "Preserve M01 engineering-shear strain and physical-shear stress Voigt ordering and energy factors",
    "stress_metric": "sqrt(sum(V_e*(VM_squared(real_sigma_e)+VM_squared(imag_sigma_e))/2)/sum(V_e)); RMS in time and volume",
    "peak_clamp_stress_convergence_claim": false,
    "no_fracture_hardness_cracks_or_hardware_model": true
  },
  "planned_matrix": {
    "mesh_order": [
      8,
      10,
      12
    ],
    "mesh_sizes": [
      {
        "n": 8,
        "nodes": 729,
        "tetrahedra": 3072,
        "free_dofs": 1944
      },
      {
        "n": 10,
        "nodes": 1331,
        "tetrahedra": 6000,
        "free_dofs": 3630
      },
      {
        "n": 12,
        "nodes": 2197,
        "tetrahedra": 10368,
        "free_dofs": 6084
      }
    ],
    "modal_eigensolves": "One144-mode sparse generalized eigenproblem per mesh, with the same deterministic initial vector and normalization convention. Nested cutoffs use columns from that one solution; do not solve or count them as independent eigensolutions.",
    "retained_mode_counts": [
      24,
      48,
      96,
      144
    ],
    "normalization": "phi.T*M*phi=1; compare sorted spectra and forced responses, not signs or individual vectors inside repeated clusters",
    "frequency_grid": {
      "min_hz": 20000.0,
      "max_hz": 200000.0,
      "count": 161,
      "spacing": "geometric",
      "exactly_same_as_M01": true
    },
    "direct_reference_frequencies_hz": [
      20000.0,
      25000.0,
      31500.0,
      40000.0,
      50000.0,
      66035.88395365438,
      80000.0,
      100000.0,
      125000.0,
      160000.0,
      180000.0,
      200000.0
    ],
    "direct_frequency_rationale": "Keep20/100/200kHz parent anchors and the frozen steel M01 n8 renderer peak, plus fixed intermediate probes. No new result-selected peak or adaptive frequency search.",
    "direct_reference_operator": "[(1+i*omega*beta)*K+(-omega^2+i*omega*alpha)*M]U=F on free DOFs; no modal reduction",
    "direct_references_on_every_mesh": true,
    "planned_main_eigensolutions": 3,
    "planned_baseline_frequency_grids": 3,
    "cutoff_curves_per_grid": 4,
    "planned_direct_reference_solves": 36,
    "new_ode_integrations": 0,
    "physical_trials": 0,
    "mesh_comparisons": [
      [
        8,
        10
      ],
      [
        10,
        12
      ]
    ],
    "no_additional_mesh_cutoff_frequency_or_material_added_after_results": true
  },
  "comparison_definitions": {
    "M01_n8_replay": "Before interpreting new resolution, compare the new n8 first6 frequencies and48-mode161-point complex compliance against frozen M01 steel n8. Same equations/inputs; allow relative error<=1e-6 using M01's1%-of-peak compliance denominator floor. Mode-vector signs/cluster rotations are not replay failures if the response/subspace agrees.",
    "spatial_spectrum": "For sorted first6frequencies, max(abs(f_coarser-f_finer)/abs(f_finer)); primary pair n10/n12; also report n8/n10 magnitudes and direction.",
    "spatial_compliance": "At the same fixed144-mode cutoff, compare complex compliance over the entire original161-point grid using M01's max pointwise error and denominator max(abs(H_finer(f)),.01*max_f abs(H_finer(f))). Also retain48/96-cutoff mesh errors as diagnostics.",
    "low_frequency": "At20kHz, compare direct-solve complex compliance and direct global time/volume RMS stress between meshes to isolate spatial error. Also retain the matching modal estimates. A20kHz result does not establish a contiguous low-frequency band.",
    "modal_truncation": "On each unchanged mesh compare24vs48,48vs96 and96vs144 complex compliance over the identical161-point grid, finer cutoff in denominator. Preserve the original24vs48 screen, while the added pairs are prospective applications of the same5% threshold.",
    "direct_vs_modal": "At each of the12fixed frequencies, for cutoffs48/96/144 report sqrt((U_modal-U_direct)^H*M*(U_modal-U_direct)/(U_direct^H*M*U_direct)), plus scalar complex compliance and global stress differences.",
    "direct_spatial_sampled": "Compare direct complex compliance and RMS stress between meshes at the12fixed frequencies. These samples separate omitted-mode error from spatial differences there; they do not certify the continuous or161-point full band.",
    "physical_amplitude": "Use unamplified displacement in metres, stress in Pa, mean energy/power and the original1N peak force. Any figures use the unchanged complex phase convention. No new decorative animation is required."
  },
  "criteria_reused_without_relaxation": {
    "eigen_residual_relative": 1e-07,
    "mass_orthogonality_absolute": 1e-08,
    "energy_identity_relative": 1e-08,
    "resultant_force_absolute_n": 1e-12,
    "first6_sorted_frequency_mesh_relative": 0.02,
    "low20kHz_complex_compliance_mesh_relative": 0.05,
    "low20kHz_volume_time_RMS_stress_mesh_relative": 0.05,
    "whole_band_complex_compliance_mesh_relative": 0.05,
    "whole_band_pointwise_denominator_floor_fraction_peak": 0.01,
    "modal_cutoff_pair_whole_band_relative": 0.05,
    "direct_vs_modal_displacement_mass_norm_relative": 0.05,
    "six_rigid_eigenvalue_relative_to_first_elastic": 1e-07,
    "added_equation_solver_check_direct_dynamic_residual_relative": 1e-08,
    "added_parent_replay_relative": 1e-06,
    "distinguish_additional_predeclared_checks_from_original_M01_gates": true,
    "invalid_rows_not_used_for_adequacy_claims": true,
    "passing_selected_frequencies_does_not_waive_whole_band_failure": true
  },
  "execution_and_stopping_budget": {
    "only_after_review_and_separate_authorization": true,
    "main_wall_time_limit_s": 600,
    "budget_clock_starts_before_tests_preflight_and_includes_serialization": true,
    "worker_wall_time_limit_s": 120,
    "main_deadline_overrides_worker_allowance": true,
    "max_process_tree_private_commit_bytes": 4294967296,
    "max_process_tree_working_set_bytes": 4294967296,
    "monitor_interval_s": 0.1,
    "resource_monitor_required_before_run": "Use Windows Job Object or an equivalently tested process-tree monitor. If limits cannot be enforced/observed, stop preflight rather than silently omit them. Capture peak observed values and monitoring limitations.",
    "max_parallel_workers": 1,
    "blas_threads": 2,
    "max_new_evidence_bytes": 33554432,
    "full_field_storage": "At most one unrounded current-mesh modal/context checkpoint at a time; archive finaln12 volume fields only if within cap. ScalarCSV/reports and failures take priority. No duplicate M01 arrays or large video.",
    "job_order": "Per mesh8,10,12: assemble/eigensolve and all modal curves, then the12direct frequencies in declared ascending order. Persist each direct row before the next. Parent replay failure stops refinement with explicit not_run_dependency rows.",
    "on_budget_or_timeout": "Stop active worker, preserve completed evidence, mark interrupted row stopped_budget/timeout with last checkpoint, mark every unstarted row not_run_budget. Do not substitute a smaller mesh or silently retry with changed settings.",
    "runtime_is_a_stop_not_a_performance_promise": true,
    "working_set_enforcement": "Sampled0.1s worker-tree plus coordinator monitoring; report observed peaks, not a hard instantaneous resident bound",
    "private_commit_enforcement": "Hard4GiB worker Job Object aggregate commit; sampled combined worker-plus-coordinator stop at4GiB"
  },
  "preflight_and_preservation": {
    "new_source_and_output_paths_only": "All new code/evidence under m02/; use exact copied inherited engine. Original M01 paths remain read-only.",
    "source_hashes": "Bind frozen M01engine/plan/input/summary/n8reports/CSV, new M02plan/runner/tests and dependency versions before and after. If any changes, retain output but mark provenance_invalid.",
    "tests": "Run existing15author checks plus focused new runner tests for nested cutoff semantics, replay comparison, same-mesh mass-norm direct metric, deadline termination, memory/size guards, exact planned IDs and JSON atomic-write failure bookkeeping. Reuse existing rigid/affine/analytic tests instead of inflating equivalent counts.",
    "durable_reporting": "Write each completed detail atomically before incrementing recorded count. Preallocate exact planned IDs. Separate computation status, evidence serialization status, numerical validity and adequacy. No doubled records after an exception.",
    "all_outcomes": [
      "completed_valid",
      "completed_numerically_invalid",
      "failed_solver",
      "failed_serialization",
      "stopped_timeout",
      "stopped_resource",
      "not_run_budget",
      "not_run_dependency",
      "provenance_invalid"
    ],
    "no_post_result_threshold_changes": true,
    "no_result_driven_tuning_or_favorable_row_omission": true,
    "independent_review": "Reviewer checks at least the n8parent replay, matrix identities, one new n10or12direct solution, every computed screen/counter and source/input hashes. Reviewer consistency does not waive failed adequacy."
  },
  "planned_outputs_and_interpretation": {
    "summary": "M02_summary.json with exact planned/completed/failed/unrun counts, resource receipts, numerical checks and distinct spatial/modal/direct findings",
    "data": "Per-mesh frequencyCSV containing all4cutoffs; each direct-reference record with displacement mass-norm errors and energy/stress diagnostics; compact source-hashed field data only within size budget",
    "figures": "One accuracy figure: frequency shifts versus mesh and complex-compliance/cutoff/direct errors with original thresholds. Prefer magnitude/error curves over pass-count headlines.",
    "useful_if_failed": "Quantify whether additional mesh resolution or modal enrichment reduces the dominant error and whether high-band response remains inadequate. A bounded negative result is an actionable outcome, not justification to retune.",
    "low_band_claim_limit": "May report20kHz and explicitly named direct-reference sample adequacy if valid; do not label the whole lower band validated without additional evidence.",
    "full_band_claim_limit": "All original161point mesh/cutoff screens and the direct checks must be disclosed together. Even if they pass, this establishes only resolution agreement for the declared linear model and sampled frequencies, not continuum proof, continuous-frequency maxima or measured specimen prediction.",
    "next_decision": "If modal enrichment helps but mesh error persists, propose a later separate spatial/element-order study. If mesh improves but modal/direct errors persist, propose a later residual-correction or larger-modal/direct-band study. No such extension is authorized by this draft.",
    "publication_status": "Internal execution authorized after source/resource review; publication remains root responsibility."
  },
  "frozen_utc": "2026-10-06T21:25:40.688954+00:00",
  "reviewed_draft_sha256": "2c3e5d50afc7113cd1b8a9cf36e0fdd57e6d9dfa0a8bb9a7f9582f1bf9332262",
  "freeze_clarifications": {
    "fixed_cutoff": "A144-mode spatial comparison still contains modal truncation; interpret jointly with96-to144 and sampled direct checks. Only direct-sample comparisons isolate spatial error at those frequencies.",
    "monitor_interval_s": 0.1,
    "memory": "Windows Job Object hard aggregate worker committed-memory cap4GiB, including descendants. Sampled working-set limit4GiB at0.1s; not an exact continuous resident-memory cap. Coordinator memory is separately reported and sampled combined commit/resident thresholds also stop work. No claim that sampled enforcement forbids all inter-sample excess.",
    "evidence": "Retain direct displacement vectors for all36probes, including independent preselected n10at100kHz. No extra solve."
  }
}
