TNFR Logo
TheoryLearnSoftwareResearch

On this page

TNFR

Resonant Fractal Nature Theory — a mathematical framework for coherent patterns on graph-coupled networks.

About
  • Project history
  • Editorial policy
  • Contact
Resources
  • GitHub
  • PyPI
  • DOI · Zenodo
Legal
  • MIT License
  • Citation
© 2026 TNFR project — MIT licensed.DOI 10.5281/zenodo.17602860
docs
grammar
PHYSICS_VERIFICATION.md
API_CONTRACTS.mdCANONICAL_OZ_SEQUENCES.mdEMPIRICAL_CONFRONTATION_EEG.mdREADME.mdSTRUCTURAL_FIELDS_TETRAD.mdSTRUCTURAL_INTERFACE_THEORY.md
theory
APPLIED_STRUCTURAL_ANALYSIS.mdCATALOG_TYPE_HYGIENE_PROGRAMME.mdDISSIPATIVE_AND_OPEN_SYSTEMS.mdEMERGENT_ONTOLOGY.mdEXTENDED_FIELDS_AND_DERIVED_QUANTITIES.mdFUNDAMENTAL_THEORY.mdGAUGE_SYMMETRY_AND_UNIFICATION.mdGLOSSARY.mdMATHEMATICAL_DYNAMICS_BASIS.mdMINIMAL_STRUCTURAL_DEGREES.mdNUCLEUS_A_PRIME_LADDER_ATLAS.mdNUCLEUS_B_EQUIVARIANCE_OBSTRUCTIONS.mdPHYSICAL_REGIME_CORRESPONDENCES.mdREADME.mdREMESH_INFINITY_DERIVATION.mdSTRUCTURAL_CONSERVATION_THEOREM.mdSTRUCTURAL_OPERATORS.mdSTRUCTURAL_STABILITY_AND_DYNAMICS.mdTNFR_BSD_RESEARCH_NOTES.mdTNFR_HODGE_RESEARCH_NOTES.mdTNFR_NAVIER_STOKES_RESEARCH_NOTES.mdTNFR_NUMBER_THEORY.mdTNFR_P_VS_NP_RESEARCH_NOTES.mdTNFR_RIEMANN_RESEARCH_NOTES.mdTNFR_VARIATIONAL_PRINCIPLE.mdTNFR_YANG_MILLS_RESEARCH_NOTES.mdTNFR.pdfUNIFIED_GRAMMAR_RULES.md
factorization-lab
analysis
analyze_patterns.pycertificate_manifest.py
benchmarks
benchmark_analysis.pybenchmark_expansion_suite.pyfull_spectrum_factorization.pypaley_gap_extended.pypaley_gap_smoke.pytest_benchmark_suite.py
demos
experiment_contexts
exp_0b1663cd19b7.jsonexp_0bf0054b7474.jsonexp_75a4c8ca616a.jsonexp_848ee0fd1857.jsonexp_f6fe00562193.jsonexp_fdf3da424e1e.json
failure_telemetry_batch.pyfeedback_integration_demo.pyintegration_demo_snapshots.dbseed_management_integration_demo.pysnapshot_integration_demo.pytrajectory_143.jsontrajectory_77.jsontrajectory_89.jsontrajectory_91.jsontrajectory_97.json
docs
FACTORING_PLAYBOOK.mdFALSE_POSITIVE_TEST_SUITE.mdOPERATOR_CERTIFICATES.mdROADMAP.mdSPECTRAL_ROUTE.md
experiment_contexts
exp_cebe1d9e7d8e.json
notebooks
spectral_history.ipynb
scripts
run_false_positive_tests.py
tests
run_false_positive_test_suite.pytest_cli.pytest_false_positive_methodology.pytest_false_positive_verifier.pytest_feedback_integration.pytest_partitioning.pytest_seed_management.pytest_self_opt_support.pytest_snapshot_system.pytest_spectral_paley.pytest_verification_robustness.py
tnfr_factorization
__init__.pyapi.pycli.pyfailure_telemetry.pyfeedback_adapter.pyfeedback_integration.pypartitioning.pyself_opt_support.pyspectral_paley.py
demo_snapshots.dbLICENSE_SNAPSHOT.mdPACKAGE_SUMMARY.mdREADME.mdseed_management.pysnapshot_system.pytest_certificate_hashing.pytest_installation.pyverification_trajectory_77.json
benchmarks
analyze_tetrad_universality.pyb0star_alpha_canonical_product_graphs.pybenchmark_optimization_tracks.pybenchmark_utils.pyboundary_vibration.pybridge_primes_riemann.pychiral_involution.pycli_utils.pycoherence_projector_sense_index.pycommutant_bridge.pycomposition_arithmetic.pyconfinement_zones_test.pyconservation_law_validation.pydirected_paley_bridge.pyemergent_arithmetic_pulse.pyemergent_atom_dynamics.pyemergent_atomic_shells.pyemergent_base_dimension.pyemergent_dimension_dynamics.pyemergent_fractal_pulse.pyemergent_fractal_simplex_dimension.pyemergent_integers_symmetry.pyemergent_musical_nfr.pyemergent_nfr_geometry.pyemergent_nfr_where.pyemergent_rationals.pyemergent_rhythm.pyemergent_screening.pyemergent_shell_cardinals.pyemergent_shell_ordering.pyemergent_simplex_dimension.pyemergent_substrate_symmetry.pyequivariance_wall.pyexternal_phase_gate_validation.pyfield_methods_battery.pygolden_residue_remesh_bridge.pyintegrated_force_regime_study.pyinverse_spectrum_to_symmetry.pyk_phi_safety_demo.pykuramoto_farey_bridge.pymissing_piece_bridge.pymultichannel_interface_benchmark.pynavier_stokes_recipe_bridge.pynodal_propagator_residue_bridge.pyns_moment_hierarchy_cascade.pyoperational_irreducibility.pypaley_bridge.pyphase_curvature_investigation.pyphase_wall.pyphi_s_confinement_investigation.pyprimes_as_consequence.pypulse_phase_coherence_budget.pyREADME.mdremesh_infinity_riemann_baseline.pyremesh_infinity_riemann_composed.pyremesh_infinity_riemann_modified_graph.pyremesh_infinity_riemann_operator.pyremesh_infinity_riemann_spectral_basis.pyremesh_infinity_riemann_spectral_robustness.pyremesh_infinity_riemann_spectral.pyresidue_phase_vs_riemann.pystructural_interface_benchmark.pytemporal_interface_benchmark.pytetrad_results_aggregate.pyu2_destabilization_irreversibility.pyuniversality_clusters.pyxi_c_fast_experiment.py
primality-test
benchmarks
comprehensive_benchmark.py
docs
ADVANCED_INTEGRATION.mdmathematical_foundation.mdperformance_analysis.md
examples
advanced_examples.pybasic_usage.py
tnfr_primality
__init__.py__main__.pyadvanced_cli.pyadvanced_core.pycli.pyconstants.pycore.pyoptimized.py
MANIFEST.inPACKAGE_SUMMARY.mdREADME.mdRELEASE_NOTES_v1.0.mdsetup.pytest_installation.py
tests
core_physics
__init__.pytest_conservation_laws.pytest_delta_nfr_computation_paths.pytest_delta_nfr.pytest_dispersion_coherence_sign_invariance.pytest_emergent_constants_guard.pytest_lyapunov_operators.pytest_nodal_equation.pytest_structural_triad.py
data
replay_manifests
sample_run
_manifest_summary.json_manifest.json_partition_files.txt.gz
self_opt_validation
seed_alpha
paley.json
seed_beta
integration.json
seed_gamma
unknown.json
self_optimization
test_run
partitioned
test_run
test_run_p0.jsontest_run_p1.json
_manifest_summary.json_manifest.json
engines
test_pattern_discovery_manifest.pytest_self_optimization_engine.py
mathematics
__init__.pytest_autodiff.pytest_backends.pytest_dissipative_dynamics.pytest_epi.pytest_factory_patterns.pytest_metrics.pytest_navier_stokes_refounded.pytest_number_theory_canonical.pytest_operators.pytest_residue_networks.pytest_riemann_nodal_pulse.pytest_riemann_pulse_coherence.pytest_spaces.pytest_transforms.pytest_validator.py
operators
test_canonical_operators_modern.pytest_grammar_canon.pytest_grammar_canonical_consistency.pytest_grammar_dynamics.pytest_operator_contracts.pytest_operator_strategies.py
parallel
test_fractal_partition_manifest.py
physics
test_conservation_gauge_unification.pytest_dissipative_conservation.pytest_emergent_chemistry.pytest_field_cache_invalidation.pytest_gauge.pytest_phase_transition.pytest_signatures.pytest_spectral_conservation.pytest_structural_diffusion.pytest_structural_integrity.pytest_symplectic_substrate.pytest_tetrad_bounds.pytest_variational.pytest_yang_mills_closure.pytest_yang_mills_derivability.pytest_yang_mills_scaling.pytest_yang_mills_structural_gap.pytest_yang_mills_u6_sweep.py
scripts
test_run_self_opt_validation.pytest_run_self_optimization.py
sdk
__init__.pytest_simple_advanced.py
__init__.pyconftest.pyREADME.mdtest_breast_cancer_phase_gate_demo.pytest_classical_mechanics.pytest_distributed_fft.pytest_external_phase_gate_validation.pytest_factorization_entrypoint.pytest_multichannel_interface.pytest_nodal_optimizer.pytest_phase_gate_api.pytest_replay_register_manifest.pytest_signal_confrontation.pytest_structural_interface_api.pytest_structural_interface_baselines.pytest_structural_interface_benchmark.pytest_temporal_interface.pytest_vectorized_coherence_length_regression.pytest_wine_quality_phase_gate_demo.pyutils.py
examples
01_foundations
01_hello_world.py02_musical_resonance.py03_network_formation.py04_operator_sequences.py05_coherence_evolution.py06_network_topologies.py07_phase_transitions.py08_emergent_phenomena.py09_visualization_suite.py10_simplified_sdk_showcase.py
02_physics_regimes
11_classical_limit_comparison.py115_operator_contract_audit.py12_classical_mechanics_demo.py13_quantum_mechanics_demo.py14_uncertainty_and_interference.py15_train_crossing_demo.py17_conservation_law_demo.py26_gauge_structure_demo.py27_variational_principle_demo.py28_dissipative_systems_demo.py29_lyapunov_stability_demo.py30_self_optimization_demo.py31_mathematical_constants_basis.py33_complex_field_unification.py34_conservation_protocol_suite.py35_tetrad_irreducibility.py36_grammar_violation_detector.py37_operator_tetrad_synergy.py38_grammar_energy_landscape.py39_nodal_equation_decomposition.py
03_riemann_zeta
157_nodal_pulse_phase_attack.py41_von_mangoldt_zeta_demo.py42_riemann_zeros_as_resonances.py43_prime_ladder_hamiltonian_demo.py44_weil_explicit_formula_demo.py45_li_keiper_demo.py46_weil_tnfr_positivity_demo.py47_alpha_sweep_demo.py48_admissible_family_sweep_demo.py49_nodeaware_gauge_sweep_demo.py50_uniform_coercivity_demo.py51_adaptive_coercivity_demo.py52_paley_gap_coercivity_demo.py53_lyapunov_spectral_positivity_demo.py54_hilbert_polya_demo.py55_structural_zero_density_demo.py56_spectral_emergence_demo.py57_admissible_rescaling_demo.py58_oscillatory_correction_demo.py
04_riemann_L_twisted
59_dirichlet_l_function_demo.py60_dirichlet_l_continuation_demo.py61_dirichlet_l_hamiltonian_demo.py62_dirichlet_weil_explicit_formula_demo.py63_dirichlet_li_keiper_demo.py64_twisted_weil_positivity_demo.py65_twisted_alpha_sweep_demo.py66_twisted_admissible_family_sweep_demo.py67_twisted_nodeaware_gauge_sweep_demo.py68_twisted_hermite_family_demo.py69_twisted_coercivity_uniform_demo.py70_twisted_paley_gap_coercivity_demo.py71_twisted_lyapunov_spectral_demo.py72_twisted_hilbert_polya_demo.py73_twisted_structural_zero_density_demo.py74_twisted_spectral_emergence_demo.py75_twisted_admissible_rescaling_demo.py76_twisted_oscillatory_correction_demo.py
05_type_hygiene
77_remesh_infinity_residue_split_demo.py78_nuf_type_signature_demo.py79_epi_type_signature_demo.py80_phi_type_signature_demo.py81_dnfr_type_signature_demo.py82_remesh_window_type_signature_demo.py83_delta_phi_max_type_signature_demo.py84_coupling_weights_type_signature_demo.py85_tetrad_closure_signature_demo.py86_currents_closure_signature_demo.py87_aggregates_closure_signature_demo.py88_urules_consistency_signature_demo.py89_operator_catalog_discipline_signature_demo.py
06_navier_stokes
158_navier_stokes_two_face_refounded.py
07_number_theory
100_prime_families_orbits.py101_numbers_as_coupled_network.py102_nodal_flow_primes_equilibria.py116_nuf_emergent_prime_visibility.py146_primality_grammatical_inertness.py147_numbers_as_free_monoid_words.py148_capacity_arm_carries_von_mangoldt.py149_p14_is_the_capacity_arm_operator.py153_structural_frequency_rank_cyclotomy.py40_arithmetic_number_theory.py94_generative_number_construction.py95_primes_from_spectral_waves.py96_spectral_vibration_of_coherence.py97_goldbach_additive_multiplicative.pyemergent_chemistry_particles_demo.py
08_emergent_geometry
103_emergent_substrate_meets_riemann.py106_per_node_polarization_geometry.py107_orthogonal_structure_emergent_geometry.py108_emergent_field_generating_structure.py112_structure_predicts_coherence_flow.py113_overdamped_projection_bridge.py114_substrate_conserved_quantities.py117_emergent_geometry_residue_graph.py118_emergent_vs_classical_operator.py119_phase_sector_directed_residue.py120_symmetry_wall_substrate_vs_spectrum.py121_canonical_symmetry_break_negative.py122_factorization_phase_sector.py123_symmetry_sector_decomposition.py124_emergent_metric_fractal_consistency.py125_node_is_the_emergent_substrate.py126_two_layers_base_fiber.py127_base_is_emergent_not_imposed.py128_base_substrate_coemergence.py129_spectral_gap_base_fiber_clock.py130_operators_break_substrate_charges.py131_coemergent_loop_convergence.py132_geometric_phase_holonomy.py133_psi_topological_defects.py134_spectral_dimension_heat_kernel.py135_arrow_of_time_h_theorem.py136_heat_kernel_coefficients.py137_synchronization_transition.py138_structure_frequency_synchronization.py139_grammar_formal_language.py140_grammar_automaton.py141_grammar_rule_decomposition.py142_grammar_operator_quotient.py143_glyphic_function_sublanguage.py144_branching_combinator.py145_syntactic_monoid_starfree.py150_emergent_grammatical_pattern_parry.py151_grammar_in_emergent_geometry.py152_operator_contract_tetrahedron.py154_conductor_annotated_qr_spectrum.py155_ontological_position_of_numbers.py156_emergence_directness_law.py98_emergent_symplectic_substrate.py99_structural_diffusion.pyunified_fields_showcase.py
09_millennium
109_p_vs_np_coherence_synthesis.py110_bsd_rank_structural_pressure.py111_hodge_discrete_and_honest_gap.py
10_applications
159_empirical_confrontation_pipeline.py90_phase_gate_monitor_demo.py91_breast_cancer_phase_gate_demo.py92_wine_quality_phase_gate_demo.py93_structural_interface_demo.pypytorch_cuda_demo.py
README.md
scripts
replay
__init__.pyregister_manifest.py
__init__.pyREADME.mdrebuild_failure_manifest.pyrun_reproducible_benchmarks.pyrun_self_opt_validation.pyrun_self_optimization.pytnfr_is_prime.pyvalidate_conservation_law.pyverify_internal_references.py
src
core
__init__.pyevaluation.py
tnfr
backends
__init__.pyjax_backend.pynumpy_backend.pyoptimized_numpy.pyREADME.mdtorch_backend.py
cli
__init__.py__init__.pyiarguments.pyarguments.pyiexecution.pyexecution.pyiinteractive_validator.pyREADME.mdutils.pyutils.pyi
compat
__init__.pydataclass.pyjsonschema_stub.pymatplotlib_stub.pynumpy_stub.pyREADME.md
config
__init__.py__init__.pyiconstants.pyconstants.pyidefaults_core.pydefaults_init.pydefaults_metric.pydefaults.pyfeature_flags.pyfeature_flags.pyiglyph_constants.pyoperator_names.pyoperator_names.pyiphysics_derivation.pyprecision_modes.pypresets.pypresets.pyiREADME.mdsecurity.pythresholds.pytnfr_config.py
constants
__init__.py__init__.pyialiases.pyaliases.pyicanonical.pymetric.pymetric.pyioperational.py
core
__init__.pycontainer.pydefault_implementations.pyexceptions.pyinterfaces.pyREADME.md
dynamics
__init__.py__init__.pyiadaptation.pyadaptation.pyiadaptive_sequences.pyadaptive_sequences.pyiadelic.pyadvanced_cache_optimizer.pyadvanced_fft_arithmetic.pyaliases.pyaliases.pyibifurcation.pycache_aware_fft_engine.pycanonical.pycanonical.pyicomputational_hub.pycoordination.pycoordination.pyidistributed_fft.pydnfr.pydnfr.pyidynamic_limits.pyemergent_centralization.pyemergent_integration_engine.pyfeedback.pyfeedback.pyifft_backend.pyfft_cache_coordinator.pyfft_dispatchers.pyfft_engine.pyfft_workers.pyfused_dnfr.pyhomeostasis.pyhomeostasis.pyiintegrators.pyintegrators.pyilearning.pylearning.pyimetabolism.pymulti_modal_cache.pynbody_tnfr.pynbody.pynodal_optimizer.pyoptimization_orchestrator.pypropagation.pyREADME.mdruntime.pyruntime.pyisampling.pysampling.pyiselectors.pyselectors.pyiself_optimizing_engine.pyspectral_structural_fusion.pystructural_cache.pystructural_clip.pysymplectic.pyunified_backend.pyunified_mathematical_cache_orchestrator.py
engines
computation
__init__.pyfft_engine.pyunified_fft_engine.pyunified_gpu_system.py
constants
__init__.pycanonical.pyoperational.py
integration
__init__.pyemergent_integration.py
pattern_discovery
__init__.pymathematical_patterns.pymulti_modal_cache.py
self_optimization
__init__.pyengine.py
__init__.pyREADME.md
errors
__init__.pycontextual.py
factorization
__init__.py
flatten
README.md
gamma
README.md
glyph_history
README.md
glyph_runtime
README.md
immutable
README.md
initialization
README.md
io
README.md
math
__init__.pyfields_symbolic.pygrammar_validators.pyoptimizer.pyREADME.mdsymbolic.py
mathematics
__init__.pybackend.pybackend.pyidynamics.pydynamics.pyiepi.pyepi.pyigenerators.pygenerators.pyiliouville.pymetrics.pymetrics.pyinumber_theory.pyoperators_factory.pyoperators_factory.pyioperators.pyoperators.pyioptimized_primality.pyprojection.pyprojection.pyiREADME.mdruntime.pyruntime.pyispaces.pyspaces.pyispectral.pytransforms.pytransforms.pyiunified_cache.pyunified_numerical.pyzeta.py
metrics
__init__.py__init__.pyibuffer_cache.pybuffer_cache.pyicache_utils.pycoherence.pycoherence.pyicommon.pycommon.pyicore.pycore.pyidiagnosis.pydiagnosis.pyiemergence.pyexport.pyexport.pyiglyph_timing.pyglyph_timing.pyilearning_metrics.pylearning_metrics.pyilocal_coherence.pyphase_coherence.pyphase_compatibility.pyREADME.mdreporting.pyreporting.pyisense_index.pysense_index.pyitelemetry.pytetrad.pytrig_cache.pytrig_cache.pyitrig.pytrig.pyi
multiscale
__init__.pyhierarchical.pyREADME.md
navier_stokes
__init__.pyconservative_face.pyoperator.py
node
README.md
observers
README.md
operators
network_analysis
__init__.pysource_detection.py
postconditions
__init__.pymutation.py
preconditions
__init__.pycoherence.pydissonance.pyemission.pymutation.pyreception.pyresonance.py
strategies
__init__.pydefaults.pygpu_strategies.pystrategy.py
__init__.py__init__.pyialgebra.pycanonical_patterns.pycascade.pycoherence.pycontraction.pycoupling.pycycle_detection.pydefinitions_base.pydefinitions.pydefinitions.pyidissonance.pyemission.pyexpansion.pygrammar_application.pygrammar_canon.pygrammar_context.pygrammar_core.pygrammar_dynamics.pygrammar_error_factory.pygrammar_memoization.pygrammar_patterns.pygrammar_telemetry.pygrammar_types.pygrammar_u6.pygrammar_validate.pygrammar.pygrammar.pyihamiltonian.pyhealth_analyzer.pyintrospection.pyjitter.pyjitter.pyilifecycle.pymetabolism.pymetrics_basic.pymetrics_core.pymetrics_network.pymetrics_structural.pymetrics_u6.pymetrics.pymutation.pynodal_equation.pyoperator_contracts.pypattern_detection.pypatterns.pyREADME.mdreception.pyrecursivity.pyregistry.pyregistry.pyiremesh.pyremesh.pyiresonance.pyself_organization.pysilence.pystructural_units.pytransition.py
parallel
__init__.pyauto_scaler.pydistributed.pyengine.pymonitoring.pypartitioner.pyREADME.md
performance
guardrails.py
physics
__init__.py_helpers.pycalibration.pycanonical.pycell.pyclassical_mechanics.pyconservation_gauge_unification.pyconservation.pydissipative_conservation.pyemergent_chemistry.pyemergent_particles.pyextended.pyfields.pygauge.pyintegrity.pyinteractions.pylife.pylyapunov.pypatterns.pyphase_transition.pyquantum_mechanics.pyREADME.mdsignatures.pyspectral_conservation.pyspectral_metrics.pystructural_diffusion.pysymplectic_substrate.pytelemetry.pyunified.pyvariational.pyvectorized_ops.py
primality
__init__.py
recipes
__init__.pycookbook.pyREADME.md
riemann
__init__.pyadmissible_family_sweep.pyadmissible_rescaling.pyaggregates_closure_signature.pyalpha_sweep.pyanalytic_continuation_dirichlet.pyanalytic_continuation.pycoercivity_uniform.pycoupling_weights_type_signature.pycurrents_closure_signature.pydelta_phi_max_type_signature.pydirichlet_l.pydnfr_type_signature.pyepi_type_signature.pyhilbert_polya.pyli_keiper.pylyapunov_spectral_positivity.pynodal_pulse.pynodeaware_gauge_sweep.pynuf_type_signature.pyoperator_catalog_discipline_signature.pyoperator.pyoscillatory_correction.pypaley_gap_coercivity.pyphi_type_signature.pyprime_ladder_hamiltonian.pypulse_coherence.pyremesh_infinity_residue_split.pyremesh_window_type_signature.pyspectral_emergence.pystructural_zero_density.pytelemetry.pytetrad_closure_signature.pytwisted_admissible_family_sweep.pytwisted_admissible_rescaling.pytwisted_alpha_sweep.pytwisted_coercivity_uniform.pytwisted_hermite_family.pytwisted_hilbert_polya.pytwisted_li_keiper.pytwisted_lyapunov_spectral_positivity.pytwisted_nodeaware_gauge_sweep.pytwisted_oscillatory_correction.pytwisted_paley_gap_coercivity.pytwisted_prime_ladder_hamiltonian.pytwisted_spectral_emergence.pytwisted_structural_zero_density.pytwisted_weil_explicit_formula.pytwisted_weil_positivity.pyurules_consistency_signature.pyvon_mangoldt.pyweil_explicit_formula.pyweil_positivity.py
schemas
__init__.pygrammar.jsonREADME.md
sdk
__init__.py__init__.pyiadaptive_system.pyadaptive_system.pyibuilders.pybuilders.pyifluent.pyfluent.pyiREADME.mdself_opt.pysimple.pytemplates.pytemplates.pyiutils.py
security
__init__.pycrypto.pydatabase.pyREADME.mdsubprocess.pyvalidation.py
sequencing
__init__.pypatterns.pyREADME.md
services
__init__.pyorchestrator.pyREADME.md
sparse
__init__.pyREADME.mdrepresentations.py
structural
README.md
telemetry
__init__.pycache_metrics.pycache_metrics.pyiconstants.pynu_f.pynu_f.pyiREADME.mdunified_telemetry_system.pyverbosity.pyverbosity.pyi
tools
__init__.pydomain_templates.pyREADME.mdsequence_generator.pytnfr_is_prime_cli_optimized.pytnfr_is_prime_cli.py
topology
__init__.pyasymmetry.pyREADME.md
utils
cache_layers.pycache.pycache.pyicallbacks.pycallbacks.pyichunks.pychunks.pyidata.pydata.pyifast_diameter.pygraph.pygraph.pyiinit.pyinit.pyiio.pyio.pyinumeric.pynumeric.pyiREADME.mdtopology.pyunified_cache.py
validation
__init__.py__init__.pyiaggregator.pybase.pycompatibility.pycompatibility.pyiconfig.pygraph.pygraph.pyihealth.pyinput_validation.pyinterface_baselines.pyinvariants.pymultichannel_interface.pyphase_gate.pyREADME.mdrules.pyrules.pyiruntime.pyruntime.pyisequence_validator.pysignal_confrontation.pysoft_filters.pysoft_filters.pyispectral.pyspectral.pyistructural_interface.pytemporal_interface.pyunified_validation_system.pyvalidator.pywindow.pywindow.pyi
visualization
__init__.pycascade_viz.pyhierarchy.pyREADME.mdsequence_plotter.py
yang_mills
__init__.pyclosure.pyderivability.pyscaling.pystructural_gap.pyu6_sweep.py
__init__.py__init__.pyi_compat.py_version.py_version.pyialias.pyalias.pyibackend_config.pycache.pycache.pyiexecution.pyexecution.pyiflatten.pyflatten.pyigamma.pygamma.pyiglyph_history.pyglyph_history.pyiglyph_runtime.pyglyph_runtime.pyiimmutable.pyimmutable.pyiinitialization.pyinitialization.pyiio.pyio.pyilocking.pylocking.pyinode.pynode.pyiobservers.pyobservers.pyiontosim.pyontosim.pyipy.typedrng.pyrng.pyisecure_config.pyselector.pyselector.pyisense.pysense.pyistructural.pystructural.pyitokens.pytokens.pyitrace.pytrace.pyitypes.pytypes.pyiunits.pyunits.pyi
tetrad_evaluator.py
.pre-commit-config.yaml.semgrep.yaml.zenodo.jsonARCHITECTURE.mdbandit.yamlCHANGELOG.mdCITATION.cffCONTRIBUTING.mdEMERGENT_CANON_AUDIT.mdEMERGENT_DERIVATION_PLAN.mdLICENSE.mdMakefileMANIFEST.inpyproject.tomlpyrightconfig.jsonPYTORCH_CUDA_INTEGRATION.mdREADME.mdSECURITY.mdTESTING.mdTNFR_Website_Content_Brief.md
FILE: examples/08_emergent_geometry/98_emergent_symplectic_substrate.py

98_emergent_symplectic_substrate.py

Example 98 — The Emergent Symplectic Substrate

Demonstrates the geometry that the TNFR nodal dynamics generates from itself: a symplectic phase space with canonical conjugate pairs, on which the nodal equation, conservation laws, and 13 operators all live. The substrate is not imposed (like the graph) — it EMERGES from the structure.

Physics

The Structural Conservation Theorem gives two canonical conjugate pairs per node:

text
Geometric sector:  (K_φ,  J_φ)       curvature ↔ phase current
Potential  sector: (Φ_s,  J_ΔNFR)    potential ↔ ΔNFR flux

so the emergent phase space is P = ℝ^{4N} with symplectic 2-form

text
ω = Σ_i [ dK_φ(i) ∧ dJ_φ(i) + dΦ_s(i) ∧ dJ_ΔNFR(i) ].

The substrate Hamiltonian H_sub = ½Σ(K_φ²+J_φ²+Φ_s²+J_ΔNFR²) plus the configuration background ½Σ|∇φ|² equals the canonical energy functional. The nodal equation ∂EPI/∂t = νf·ΔNFR is the overdamped projection of the Hamiltonian flow on this substrate.

Experiments

  1. The substrate emerges: extract P = ℝ^{4N} and verify it is a valid symplectic manifold (antisymmetric, non-degenerate, closed, canonical brackets, Jacobi, Liouville, harmonic flow)
  2. Energy consistency: H_sub + background = canonical energy functional
  3. Liouville is structural: div(X_H) = tr(J·Hess) = 0 for any Hamiltonian (the geometric reason operators preserve phase-space volume)

Honest scope

This makes EXPLICIT and verifies the emergent symplectic structure already implied by conservation.py and variational.py — a canonical consolidation, not a new postulate. Field coordinates are delegated to existing canonical functions. It does NOT, by itself, resolve any open program (Riemann, Navier–Stokes); it establishes the geometric substrate from which the canonical structures derive.

References

  • src/tnfr/physics/symplectic_substrate.py (this substrate)
  • src/tnfr/physics/variational.py (symplectic 2-form ω, Hamiltonian)
  • src/tnfr/physics/conservation.py (conjugate pairs, energy functional)
  • theory/TNFR_VARIATIONAL_PRINCIPLE.md (full derivation)
  • AGENTS.md §"Minimal Structural Degrees of Freedom"

Source Code

python
#!/usr/bin/env python3
"""
Example 98 — The Emergent Symplectic Substrate
===============================================

Demonstrates the geometry that the TNFR nodal dynamics generates from
itself: a symplectic phase space with canonical conjugate pairs, on which
the nodal equation, conservation laws, and 13 operators all live. The
substrate is not imposed (like the graph) — it EMERGES from the structure.

Physics
-------
The Structural Conservation Theorem gives two canonical conjugate pairs
per node:

    Geometric sector:  (K_φ,  J_φ)       curvature ↔ phase current
    Potential  sector: (Φ_s,  J_ΔNFR)    potential ↔ ΔNFR flux

so the emergent phase space is P = ℝ^{4N} with symplectic 2-form

    ω = Σ_i [ dK_φ(i) ∧ dJ_φ(i) + dΦ_s(i) ∧ dJ_ΔNFR(i) ].

The substrate Hamiltonian H_sub = ½Σ(K_φ²+J_φ²+Φ_s²+J_ΔNFR²) plus the
configuration background ½Σ|∇φ|² equals the canonical energy functional.
The nodal equation ∂EPI/∂t = νf·ΔNFR is the overdamped projection of the
Hamiltonian flow on this substrate.

Experiments
-----------
1. The substrate emerges: extract P = ℝ^{4N} and verify it is a valid
   symplectic manifold (antisymmetric, non-degenerate, closed, canonical
   brackets, Jacobi, Liouville, harmonic flow)
2. Energy consistency: H_sub + background = canonical energy functional
3. Liouville is structural: div(X_H) = tr(J·Hess) = 0 for any Hamiltonian
   (the geometric reason operators preserve phase-space volume)

Honest scope
------------
This makes EXPLICIT and verifies the emergent symplectic structure already
implied by conservation.py and variational.py — a canonical consolidation,
not a new postulate. Field coordinates are delegated to existing canonical
functions. It does NOT, by itself, resolve any open program (Riemann,
Navier–Stokes); it establishes the geometric substrate from which the
canonical structures derive.

References
----------
- src/tnfr/physics/symplectic_substrate.py (this substrate)
- src/tnfr/physics/variational.py (symplectic 2-form ω, Hamiltonian)
- src/tnfr/physics/conservation.py (conjugate pairs, energy functional)
- theory/TNFR_VARIATIONAL_PRINCIPLE.md (full derivation)
- AGENTS.md §"Minimal Structural Degrees of Freedom"
"""

import math
import os
import random
import sys

sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", "src"))

import networkx as nx
import numpy as np

from tnfr.dynamics.dnfr import default_compute_delta_nfr
from tnfr.physics.conservation import compute_energy_functional
from tnfr.physics.symplectic_substrate import (
    background_potential,
    canonical_bracket_table,
    extract_phase_space_point,
    liouville_divergence,
    noether_charges,
    substrate_hamiltonian,
    symplectic_form_matrix,
    verify_canonical_structure,
    verify_hermitian_structure,
    verify_integrability,
    verify_noether_conservation,
    verify_poincare_cartan,
    verify_polarization_symmetry,
    verify_substrate_geometry,
    verify_symplectic_reduction,
)


def _build_graph(n: int = 30, seed: int = 5) -> nx.Graph:
    rng = random.Random(seed)
    G = nx.watts_strogatz_graph(n, 4, 0.3, seed=seed)
    for node in G.nodes():
        G.nodes[node]["theta"] = rng.uniform(0.0, 2.0 * math.pi)
        G.nodes[node]["EPI"] = rng.uniform(0.2, 0.8)
        G.nodes[node]["nu_f"] = rng.uniform(0.5, 1.5)
    default_compute_delta_nfr(G)
    return G


# ============================================================================
# EXPERIMENT 1: The substrate emerges and is a valid symplectic manifold
# ============================================================================
def experiment_1_emergent_substrate():
    """Extract P = ℝ^{4N} and verify the canonical symplectic structure."""
    print("=" * 72)
    print("EXPERIMENT 1: The Emergent Symplectic Substrate")
    print("=" * 72)
    print()
    print("Two canonical conjugate pairs per node emerge from conservation:")
    print("  geometric (K_φ, J_φ)   and   potential (Φ_s, J_ΔNFR)")
    print("→ phase space P = ℝ^{4N} with form ω = Σ dK_φ∧dJ_φ + dΦ_s∧dJ_ΔNFR")
    print()

    G = _build_graph(30)
    cert = verify_canonical_structure(G)

    print(
        f"  Network: N = {cert.n_nodes} nodes  →  phase space dim = "
        f"{cert.dimension}"
    )
    print()
    print(f"  antisymmetric  ωᵀ = −ω        : {cert.is_antisymmetric}")
    print(
        f"  non-degenerate det ω = {cert.determinant:.1f}     : "
        f"{cert.is_nondegenerate}"
    )
    print(f"  closed         dω = 0         : {cert.is_closed}")
    print(f"  canonical Poisson brackets    : {cert.brackets_canonical}")
    print(f"  Jacobi identity               : {cert.jacobi_satisfied}")
    print(
        f"  Liouville div(X_H) = {cert.liouville_divergence:.1e}    : "
        f"{abs(cert.liouville_divergence) < 1e-9}"
    )
    print(f"  harmonic flow q̇=p, ṗ=−q       : {cert.flow_is_harmonic}")
    print()
    print(f"  VALID SYMPLECTIC MANIFOLD: {cert.is_valid_symplectic_manifold}")
    print()

    table = canonical_bracket_table()
    print("  Canonical brackets (one node):")
    print(f"    {{K_φ, J_φ}}   = {table['{qA,pA}']:.1f}   (geometric pair)")
    print(f"    {{Φ_s, J_ΔNFR}} = {table['{qB,pB}']:.1f}   (potential pair)")
    print(f"    cross-sector  = {table['{qA,pB}']:.1f}   (sectors decouple)")
    print()


# ============================================================================
# EXPERIMENT 2: The Hamiltonian is the canonical energy functional
# ============================================================================
def experiment_2_energy_consistency():
    """H_sub + background potential = canonical energy functional."""
    print("=" * 72)
    print("EXPERIMENT 2: The Hamiltonian IS the Energy Functional")
    print("=" * 72)
    print()
    print("H_sub = ½Σ(K_φ²+J_φ²+Φ_s²+J_ΔNFR²)  (symplectic core)")
    print("U     = ½Σ|∇φ|²                       (config. background)")
    print("H_sub + U should equal compute_energy_functional(G).")
    print()

    print(
        f"{'N':>5}  {'H_sub':>10}  {'U_bg':>10}  {'H_sub+U':>10}"
        f"  {'energy E':>10}  {'match':>6}"
    )
    print("-" * 60)
    for n in (10, 20, 30, 50):
        G = _build_graph(n, seed=n)
        pt = extract_phase_space_point(G)
        h_sub = substrate_hamiltonian(pt)
        u_bg = background_potential(pt)
        energy = compute_energy_functional(G)
        match = abs((h_sub + u_bg) - energy) < 1e-9
        print(
            f"{n:>5}  {h_sub:>10.4f}  {u_bg:>10.4f}  {h_sub + u_bg:>10.4f}"
            f"  {energy:>10.4f}  {'OK' if match else 'FAIL':>6}"
        )

    print()
    print("VALIDATED: the substrate Hamiltonian reconstructs the canonical")
    print("energy functional exactly. The substrate is consistent with the")
    print("existing conservation machinery — it is the same physics, seen")
    print("as the geometry the dynamics generates.")
    print()


# ============================================================================
# EXPERIMENT 3: Liouville is structural — the origin of symplectomorphism
# ============================================================================
def experiment_3_liouville_structural():
    """div(X_H) = tr(J·Hess) = 0 for ANY Hamiltonian — volume preserved."""
    print("=" * 72)
    print("EXPERIMENT 3: Liouville is Structural (Operator Volume)")
    print("=" * 72)
    print()
    print("The Hamiltonian flow X_H = J·∇H has divergence tr(J·Hess H).")
    print("Since J is antisymmetric and the Hessian is symmetric,")
    print("tr(J·Hess) = 0 for EVERY Hamiltonian. Phase-space volume is")
    print("preserved — this is why the 13 operators are symplectomorphisms.")
    print()

    G = _build_graph(20)
    pt = extract_phase_space_point(G)
    div = liouville_divergence(pt)
    print(f"  div(X_H) for the substrate Hamiltonian = {div:.3e}")
    print()

    # Demonstrate tr(J·S) = 0 for arbitrary symmetric Hessians.
    omega = symplectic_form_matrix(pt.n_nodes)
    rng = np.random.default_rng(20260613)
    print("  tr(J·Hess) for random symmetric Hessians (any Hamiltonian):")
    for trial in range(3):
        s = rng.standard_normal(omega.shape)
        s = 0.5 * (s + s.T)  # symmetric
        tr = float(np.trace(omega @ s))
        print(f"    trial {trial + 1}: tr(J·S) = {tr:.3e}")

    print()
    print("VALIDATED: volume preservation is a structural identity, not a")
    print("coincidence. The emergent geometry guarantees that grammar-")
    print("compliant evolution conserves the symplectic phase-space volume.")
    print()


# ============================================================================
# EXPERIMENT 4: Noether's theorem — symmetries generate conserved charges
# ============================================================================
def experiment_4_noether_charges():
    """Substrate symmetries → conserved charges; total splits into sectors."""
    print("=" * 72)
    print("EXPERIMENT 4: Noether's Theorem on the Substrate")
    print("=" * 72)
    print()
    print("Each continuous symmetry of H_sub generates a conserved charge:")
    print("  time translation → H_sub  (total energy)")
    print("  geometric U(1) (Ψ→e^{iα}Ψ, the gauge symmetry) → ½Σ|Ψ|²")
    print("  potential U(1) → ½Σ(Φ_s²+J_ΔNFR²)")
    print()

    G = _build_graph(30)
    cert = verify_noether_conservation(G)
    charges = noether_charges(extract_phase_space_point(G))

    print(f"  H_sub (time translation) = {charges['time_translation']:.4f}")
    print(f"  E_geo (geometric U(1))   = {charges['geometric_u1']:.4f}")
    print(f"  E_pot (potential U(1))   = {charges['potential_u1']:.4f}")
    print()
    print(f"  H_sub = E_geo + E_pot exactly : {cert.splits_exactly}")
    print("  max drift along the flow:")
    print(f"    H_sub  = {cert.max_hamiltonian_drift:.2e}")
    print(f"    E_geo  = {cert.max_geometric_drift:.2e}")
    print(f"    E_pot  = {cert.max_potential_drift:.2e}")
    print(f"  ALL CONSERVED: {cert.is_conserved}")
    print()
    print("VALIDATED: the U(1)×U(1) symmetry refines time-translation")
    print("conservation — the total energy splits into two separately-")
    print("conserved sector charges. E_geo = ½Σ|Ψ|² is exactly the gauge")
    print("invariant of physics/gauge.py. Noether's theorem on the")
    print("emergent substrate, derived to machine precision.")
    print()


# ============================================================================
# EXPERIMENT 5: Hermitian (flat Kähler) structure — Ψ is the complex coordinate
# ============================================================================
def experiment_5_hermitian_structure():
    """The substrate is Hermitian; Ψ = K_φ + i·J_φ is the complex coord."""
    print("=" * 72)
    print("EXPERIMENT 5: Hermitian (flat Kähler) Structure")
    print("=" * 72)
    print()
    print("The substrate carries a compatible triple (ω, J, g):")
    print("  ω = symplectic form,  J = −ω (complex structure, J² = −I),")
    print("  g = ω·J = identity (compatible metric).")
    print("The complex coordinate ζ = q + i·p makes each fiber ℝ⁴ ≅ ℂ².")
    print()

    G = _build_graph(30)
    cert = verify_hermitian_structure(G)

    print(f"  J² = −I                       : {cert.j_squared_is_minus_id}")
    print(f"  g = identity (pos. definite)  : {cert.metric_is_identity}")
    print(f"  J is g-orthogonal             : {cert.j_is_orthogonal}")
    print(f"  compatible ω(u,v) = g(Ju,v)    : {cert.compatible}")
    print(f"  Ψ = ζ^A (geometric coordinate) : " f"{cert.psi_is_geometric_coordinate}")
    print(f"  H_sub = Kähler potential       : " f"{cert.kahler_potential_matches}")
    print(f"  complex dimension dim_ℂ        : {cert.complex_dimension}")
    print()
    print(f"  VALID HERMITIAN STRUCTURE: " f"{cert.is_valid_hermitian_structure}")
    print()
    print("VALIDATED: Ψ = K_φ + i·J_φ of physics/gauge.py is NOT ad-hoc — it")
    print("is the complex coordinate ζ^A the substrate's complex structure J")
    print("induces on the geometric sector. The 'i' in Ψ IS the J = −ω of")
    print("the emergent geometry. H_sub = ½Σ|ζ|² is the Kähler potential, and")
    print("the substrate flow is the diagonal U(1) phase rotation")
    print("ζ → e^{−it}ζ.")
    print()


# ============================================================================
# EXPERIMENT 6: Complete integrability — action–angle variables (Liouville)
# ============================================================================
def experiment_6_integrability():
    """The substrate flow is completely integrable; actions are ½|ζ|²."""
    print("=" * 72)
    print("EXPERIMENT 6: Complete Integrability (Liouville–Arnold)")
    print("=" * 72)
    print()
    print("H_sub = ½Σ(K_φ² + J_φ² + Φ_s² + J_ΔNFR²) is a sum of decoupled")
    print("oscillators — one per conjugate pair. So each pair contributes an")
    print("action I = ½|ζ|², giving 2N integrals for a 2N-DOF system: the")
    print("flow is completely integrable, with action–angle coordinates")
    print("(I_i, θ_i) in which it is a rigid phase rotation θ → θ − t.")
    print()

    G = _build_graph(30)
    cert = verify_integrability(G)

    print(f"  degrees of freedom (2N)        : {cert.degrees_of_freedom}")
    print(f"  independent action variables   : {cert.n_action_variables}")
    print(
        f"  actions in involution {{I,J}}=0  : "
        f"{cert.actions_in_involution} "
        f"(max |bracket| {cert.max_involution_bracket:.1e})"
    )
    print(
        f"  actions conserved along flow   : {cert.actions_conserved} "
        f"(max drift {cert.max_action_drift:.1e})"
    )
    print(
        f"  angles advance θ(t) = θ(0) − t : "
        f"{cert.angles_advance_linearly} "
        f"(max err {cert.max_angle_error:.1e})"
    )
    print(
        f"  Σ I^A = E_geo,  Σ I^B = E_pot   : " f"{cert.sector_actions_match_charges}"
    )
    print()
    print(f"  COMPLETELY INTEGRABLE: {cert.is_completely_integrable}")
    print()
    print("VALIDATED: the per-node moduli ½|ζ|² are the action variables /")
    print("adiabatic invariants of the substrate harmonic backbone, and the")
    print("U(1) phases θ = arg ζ are their conjugate angles. The 13 operators")
    print("act as canonical transformations that redistribute these actions.")
    print("HONEST SCOPE: this is the integrability of the H_sub backbone, not")
    print("of the full nonlinear operator dynamics.")
    print()


# ============================================================================
# EXPERIMENT 7: Poincaré–Cartan integral invariants — the ω^k tower
# ============================================================================
def experiment_7_poincare_cartan():
    """The flow preserves the ω^k tower; ∮p·dq = 2π·I (Bohr–Sommerfeld)."""
    print("=" * 72)
    print("EXPERIMENT 7: Poincaré–Cartan Integral Invariants")
    print("=" * 72)
    print()
    print("The flow φ_t preserves the symplectic form ω (φ_t^* ω = ω), so it")
    print("preserves the whole tower of integral invariants ω^k (k = 1 … N):")
    print("  k=1   relative invariant ∮ p dq  (M symplectic, MᵀΩM = Ω),")
    print("  1<k<N intermediate ∫ω^k  (palindromic char. poly of M),")
    print("  k=N   Liouville volume ω^N  (det M = 1).")
    print()

    G = _build_graph(30)
    cert = verify_poincare_cartan(G)

    print(
        f"  ω preserved (MᵀΩM = Ω)         : "
        f"{cert.preserves_symplectic_form} "
        f"(drift {cert.max_omega_drift:.1e})"
    )
    print(f"  palindromic char. polynomial   : " f"{cert.char_poly_palindromic}")
    print(f"  Liouville volume (det M = 1)   : {cert.volume_preserved}")
    print(
        f"  ∮ p dq constant under flow     : "
        f"{cert.relative_invariant_preserved} "
        f"(drift {cert.max_relative_drift:.1e})"
    )
    print(
        f"  Bohr–Sommerfeld |∮p dq| = 2πI  : "
        f"{cert.bohr_sommerfeld_holds} "
        f"(err {cert.max_bohr_error:.1e})"
    )
    print()
    print(f"  ALL INVARIANTS HOLD: {cert.all_invariants_hold}")
    print()
    print("VALIDATED: ω-preservation (Poincaré's relative invariant) is the")
    print("integral form of Liouville's theorem and is STRONGER than div=0:")
    print("it preserves areas ∮ p dq, not just the top volume. On an action")
    print("torus ∮ p dq = 2π·I recovers the Bohr–Sommerfeld quantum, tying")
    print("the integral invariant to the action variables of Experiment 6.")
    print()


# ============================================================================
# EXPERIMENT 8: Marsden–Weinstein symplectic reduction by the U(1) flow
# ============================================================================
def experiment_8_symplectic_reduction():
    """The diagonal U(1) flow symmetry reduces P to a P//U(1) of dim 4N−2."""
    print("=" * 72)
    print("EXPERIMENT 8: Marsden–Weinstein Symplectic Reduction")
    print("=" * 72)
    print()
    print("The flow ζ → e^{−it}ζ is the diagonal U(1) action rotating every")
    print("conjugate pair together. Its moment map is J = Σ I_k = H_sub (the")
    print("time-translation Noether charge). Reducing P by this symmetry —")
    print("P//U(1) = J⁻¹(μ)/U(1) — quotients the collective phase, leaving")
    print("the relative phases φ_k = θ_k − θ_0 as the reduced coordinates.")
    print()

    G = _build_graph(30)
    cert = verify_symplectic_reduction(G)

    print(
        f"  moment map J = Σ I_k = H_sub   : "
        f"{cert.moment_map_is_hamiltonian} "
        f"(J = {cert.moment_map_value:.4f})"
    )
    print(
        f"  J conserved (U(1) symmetry)    : "
        f"{cert.moment_map_conserved} "
        f"(drift {cert.max_moment_drift:.1e})"
    )
    print(
        f"  dim P → dim P//U(1)            : "
        f"{cert.phase_space_dimension} → {cert.reduced_dimension}  "
        f"(4N−2)"
    )
    print(
        f"  reduced ω non-degenerate       : "
        f"{cert.reduced_form_nondegenerate} "
        f"(det {cert.reduced_form_determinant:.3g})"
    )
    print(f"  relative phases φ_k invariant  : " f"{cert.relative_phases_invariant}")
    print()
    print(f"  VALID REDUCTION: {cert.is_valid_reduction}")
    print()
    print("VALIDATED: the reduced 2-form Σ dI_k ∧ dφ_k is canonical and")
    print("non-degenerate, so P//U(1) is a genuine symplectic manifold of")
    print("dimension 4N−2. The symmetry that GENERATES the flow (time")
    print("translation) is the symmetry one reduces by — moment map = H_sub.")
    print("HONEST SCOPE: reduction of the FLAT substrate by its diagonal")
    print("U(1); the reduced space is a flat linear symplectic space.")
    print()


# ============================================================================
# EXPERIMENT 9: Polarization symmetry (U(2)) — new Stokes charges
# ============================================================================
def experiment_9_polarization():
    """H_sub is a ℂ² doublet norm → U(2) polarization symmetry → Stokes vector."""
    print("=" * 72)
    print("EXPERIMENT 9: Polarization Symmetry U(2) (new conserved charges)")
    print("=" * 72)
    print()
    print("H_sub = ½Σ‖(ζ^A, ζ^B)‖² is the squared norm of a complex doublet")
    print("(ζ^A geometric, ζ^B potential), so it is invariant under the FULL")
    print("U(2) on the doublet — the POLARIZATION symmetry of a two-component")
    print("complex field (the same math as classical wave polarization,")
    print("Stokes 1852 / Poincaré 1892). U(1)×U(1) (Noether) is its Cartan")
    print("torus; the SU(2) part gives the three Stokes parameters.")
    print()

    G = _build_graph(30)
    cert = verify_polarization_symmetry(G)

    print(f"  P_1 = Σ(K_φ·Φ_s + J_φ·J_ΔNFR)  : {cert.p_1:.4f}  (NEW)")
    print(f"  P_2 = Σ(K_φ·J_ΔNFR − J_φ·Φ_s)  : {cert.p_2:.4f}  (NEW)")
    print(f"  P_3 = E_geo − E_pot            : {cert.p_3:.4f}")
    print(f"  squared magnitude |P|²         : {cert.magnitude_sq:.4f}")
    print(f"  P_3 = E_geo − E_pot            : " f"{cert.p3_equals_energy_difference}")
    print(
        f"  su(2) closes {{P_a,P_b}}=2εP_c   : "
        f"{cert.su2_algebra_closes} (res {cert.max_algebra_residual:.1e})"
    )
    print(f"  SU(2) rotation symplectic      : {cert.rotation_is_symplectic}")
    print(
        f"  charges conserved along flow   : "
        f"{cert.charges_conserved} (drift {cert.max_charge_drift:.1e})"
    )
    print(
        f"  fully polarized |P_node|=e_node: "
        f"{cert.full_polarization_holds} "
        f"(res {cert.max_polarization_residual:.1e})"
    )
    print()
    print(f"  VALID POLARIZATION SYMMETRY: {cert.is_valid_polarization_symmetry}")
    print()
    print("VALIDATED: P_1 and P_2 are GENUINELY NEW conserved charges — the")
    print("cross-sector correlations between the geometric and potential")
    print("sectors — beyond the known P_3 = E_geo − E_pot. They close the")
    print("su(2) algebra and are conserved along the flow. Per node the")
    print("Stokes 3-vector has length = energy: each node is fully polarized,")
    print("a unit point on the Poincaré sphere of radius = its energy.")
    print("HONEST SCOPE: a dynamical symmetry of the flat isotropic H_sub")
    print("backbone (the SU(2) mixes physically distinct sectors and is not")
    print("one of the 13 operators); the charges are exact along the substrate")
    print("flow and diagnostics at the full nonlinear level. The substrate is")
    print("a CLASSICAL phase field: this is the polarization (Stokes/Poincaré)")
    print("of a wave, NOT a quantum two-level system (no entanglement).")
    print()


# ============================================================================
# EXPERIMENT 10: Consolidated tower — the whole geometry in one call
# ============================================================================
def experiment_10_consolidated_tower():
    """verify_substrate_geometry runs the whole tower in a single call."""
    print("=" * 72)
    print("EXPERIMENT 10: Consolidated Geometric Tower (single entry point)")
    print("=" * 72)
    print()
    print("verify_substrate_geometry(G) runs all seven structural")
    print("verifications and bundles their certificates into one report —")
    print("the consolidated entry point to the whole emergent geometry.")
    print()

    G = _build_graph(30)
    report = verify_substrate_geometry(G)
    print(report.summary())
    print()
    print(f"  ALL STRUCTURES VALID: {report.all_structures_valid}")
    print()


def main():
    print()
    print("  TNFR Example 98: The Emergent Symplectic Substrate")
    print("  The geometry the nodal dynamics generates from itself")
    print("  ====================================================")
    print()

    experiment_1_emergent_substrate()
    experiment_2_energy_consistency()
    experiment_3_liouville_structural()
    experiment_4_noether_charges()
    experiment_5_hermitian_structure()
    experiment_6_integrability()
    experiment_7_poincare_cartan()
    experiment_8_symplectic_reduction()
    experiment_9_polarization()
    experiment_10_consolidated_tower()

    print("=" * 72)
    print("WHAT THIS ESTABLISHES")
    print("=" * 72)
    print()
    print("The TNFR nodal dynamics generates its OWN geometry — a symplectic")
    print("phase space P = ℝ^{4N} with canonical conjugate pairs, on which:")
    print("  • the energy functional is the Hamiltonian (Experiment 2),")
    print("  • the 13 operators are symplectomorphisms (Liouville, Exp. 3),")
    print("  • symmetries generate conserved charges (Noether, Exp. 4),")
    print("  • Ψ is the complex coordinate of a Hermitian structure (Exp. 5),")
    print("  • the flow is completely integrable (action–angle, Exp. 6),")
    print("  • it preserves the Poincaré–Cartan invariants (Exp. 7),")
    print("  • it reduces by its U(1) symmetry (Marsden–Weinstein, Exp. 8),")
    print("  • it carries a U(2) polarization symmetry with new Stokes")
    print("    charges (Exp. 9),")
    print("  • the whole tower verifies in one call (Exp. 10),")
    print("  • the nodal equation is the overdamped Hamiltonian flow.")
    print()
    print("This substrate is EMERGENT (derived from the conservation laws),")
    print("not imposed like the graph. It makes explicit the geometry the")
    print("dynamics already inhabits — a canonical consolidation. It does")
    print("not, by itself, resolve any open program; it is the geometric")
    print("foundation from which the canonical structures derive.")
    print()


if __name__ == "__main__":
    main()