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: theory/GAUGE_SYMMETRY_AND_UNIFICATION.md

GAUGE_SYMMETRY_AND_UNIFICATION.md

Gauge Symmetry and Conservation-Gauge Unification

The complex geometric field Ψ=Kϕ+i⋅Jϕ\Psi = K_\phi + i \cdot J_\phiΨ=Kϕ​+i⋅Jϕ​ admits a local U(1) gauge symmetry with structural consequences within the TNFR formalism. This document derives the gauge structure, identifies gauge-invariant observables, establishes the conservation-gauge unification, and extends conservation laws to the spectral domain.

Status: CANONICAL — Derived from the nodal equation and U(1) representation theory.


1. Local U(1) Gauge Symmetry

1.1 Gauge Transformation

The gauge transformation acts on the geometric-transport sector (Kϕ,Jϕ)(K_\phi, J_\phi)(Kϕ​,Jϕ​) while leaving the remaining fields as gauge singlets:

Ψ(i)  →  eiα(i) Ψ(i)\Psi(i) \;\to\; e^{i\alpha(i)}\,\Psi(i)Ψ(i)→eiα(i)Ψ(i)

In component form:

Kϕ′(i)=Kϕ(i)cos⁡α(i)−Jϕ(i)sin⁡α(i)K_\phi'(i) = K_\phi(i)\cos\alpha(i) - J_\phi(i)\sin\alpha(i)Kϕ′​(i)=Kϕ​(i)cosα(i)−Jϕ​(i)sinα(i) Jϕ′(i)=Kϕ(i)sin⁡α(i)+Jϕ(i)cos⁡α(i)J_\phi'(i) = K_\phi(i)\sin\alpha(i) + J_\phi(i)\cos\alpha(i)Jϕ′​(i)=Kϕ​(i)sinα(i)+Jϕ​(i)cosα(i)

The fields Φs\Phi_sΦs​, ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣, JΔNFRJ_{\Delta\mathrm{NFR}}JΔNFR​, and ξC\xi_CξC​ are gauge singlets (invariant under the transformation).

1.2 Gauge-Invariant Observables

Five quantities are exactly gauge-invariant:

QuantityDefinitionPhysical meaning
Energy density E(i)\mathcal{E}(i)E(i)$\Phi_s^2 +\nabla\phi
Field magnitude $\Psi(i)^2$
Coherence C(t)C(t)C(t)Depends on ΔNFR\Delta\mathrm{NFR}ΔNFR/phase, not arg⁡(Ψ)\arg(\Psi)arg(Ψ)Network stability
Topological norm $\mathcal{T}^2$
Chirality norm $\mathcal{X}^2$

where:

  • Q~=Kϕ⋅∣∇ϕ∣+Jϕ⋅JΔNFR\tilde{\mathcal{Q}} = K_\phi \cdot |\nabla\phi| + J_\phi \cdot J_{\Delta\mathrm{NFR}}Q~​=Kϕ​⋅∣∇ϕ∣+Jϕ​⋅JΔNFR​ (dual topological charge)
  • χ~=∣∇ϕ∣⋅Jϕ+Kϕ⋅JΔNFR\tilde{\chi} = |\nabla\phi| \cdot J_\phi + K_\phi \cdot J_{\Delta\mathrm{NFR}}χ~​=∣∇ϕ∣⋅Jϕ​+ (dual chirality)

1.3 U(1) Multiplets (NOT Invariant)

The following transform as 2D rotation doublets under α\alphaα:

  • (Q,  Q~)(\mathcal{Q},\;\tilde{\mathcal{Q}})(Q,Q~​) — topological charge doublet
  • (χ,  χ~)(\chi,\;\tilde{\chi})(χ,χ~​) — chirality doublet
  • Noether charge Q=∑(Φs+Kϕ)Q = \sum(\Phi_s + K_\phi)Q=∑(Φs​+Kϕ​) — NOT invariant
  • Symmetry breaking S=(∣∇ϕ∣2−Kϕ2)+(Jϕ2−JΔNFR2)\mathcal{S} = (|\nabla\phi|^2 - K_\phi^2) + (J_\phi^2 - J_{\Delta\mathrm{NFR}}^2)S=(∣∇ϕ∣2−Kϕ — NOT invariant

Their norms ∣T∣2|\mathcal{T}|^2∣T∣2 and ∣X∣2|\mathcal{X}|^2∣X∣2 are invariant because quadratic sums are preserved under rotation.

1.4 Derivation Outline

The proof follows from representation theory of U(1) on the 6D field space (Φs,∣∇ϕ∣,Kϕ,Jϕ,JΔNFR,ξC)(\Phi_s, |\nabla\phi|, K_\phi, J_\phi, J_{\Delta\mathrm{NFR}}, \xi_C)(Φs​,∣∇ϕ∣,Kϕ​,Jϕ​,JΔNFR​,ξC​):

  1. Step 1: Gauge transformation acts only on the geometric-transport sector (Kϕ,Jϕ)(K_\phi, J_\phi)(Kϕ​,Jϕ​), leaving 4 fields as singlets.
  2. Step 2: Component rotation formulas (§1.1).
  3. Step 3: Bilinear forms involving one Ψ\PsiΨ-component and one singlet transform as 2D doublets; their quadratic norms are invariant.

Implementation: src/tnfr/physics/gauge.py — verify_gauge_invariance(), GaugeInvarianceResult dataclass.


2. Gauge Connection and Curvature

2.1 Gauge Connection

The natural gauge connection on edges emerges from the Ψ\PsiΨ phase gradient:

Aij=arg⁡(Ψj)−arg⁡(Ψi)(wrapped to [−π,π])A_{ij} = \arg(\Psi_j) - \arg(\Psi_i) \quad\text{(wrapped to } [-\pi,\pi]\text{)}Aij​=arg(Ψj​)−arg(Ψi​)(wrapped to [−π,π])

2.2 Covariant Derivative

The discrete covariant derivative along edge (i,j)(i,j)(i,j):

DijΨ=Ψ(j)−eiAij Ψ(i)D_{ij}\Psi = \Psi(j) - e^{iA_{ij}}\,\Psi(i)Dij​Ψ=Ψ(j)−eiAij​Ψ(i)

Under gauge transformation Ψ→eiαΨ\Psi \to e^{i\alpha}\PsiΨ→eiαΨ:

DijΨ  →  eiα(j) DijΨ(covariant)D_{ij}\Psi \;\to\; e^{i\alpha(j)}\,D_{ij}\Psi \quad\text{(covariant)}Dij​Ψ→eiα(j)Dij​Ψ(covariant)

Therefore ∣DijΨ∣|D_{ij}\Psi|∣Dij​Ψ∣ is gauge-invariant.

2.3 Gauge Curvature (Field Strength)

The gauge curvature on a cycle CCC is the discrete holonomy:

FC=∑(i,j)∈CAij(wrapped to [−π,π])F_C = \sum_{(i,j) \in C} A_{ij} \quad\text{(wrapped to } [-\pi,\pi]\text{)}FC​=(i,j)∈C∑​Aij​(wrapped to [−π,π])

Non-zero FCF_CFC​ indicates gauge vortices — topological defects analogous to magnetic flux tubes.

2.4 Yang-Mills Action

The Yang-Mills action functional:

SYM=12∑CFC2S_{\mathrm{YM}} = \frac{1}{2}\sum_C F_C^2SYM​=21​C∑​FC2​

The Yang-Mills field equations with matter current follow from δSYM/δAij=0\delta S_{\mathrm{YM}} / \delta A_{ij} = 0δSYM​/δAij​=0.

Implementation: src/tnfr/physics/gauge.py — compute_gauge_curvature(), compute_covariant_derivative_magnitude(), compute_yang_mills_action().


3. Interaction Regimes

Four interaction regimes emerge from the gauge structure, classified by which sector dominates:

RegimeConditionPhysical analogy
em_likearg⁡(Ψ)≈0\arg(\Psi) \approx 0arg(Ψ)≈0Geometric-dominant, weak coupling
weak_likearg⁡(Ψ)≈π/2\arg(\Psi) \approx \pi/2arg(Ψ)≈π/2Transport-dominant, chiral asymmetry
strong_like$F_C
gravity_like$\Phi_s \gg\Psi

Activity criterion (audit 2026 redesign): the four sectors share a unit score budget; a sector is active when its normalised score exceeds the equipartition share 1/Nregimes=1/41/N_\text{regimes} = 1/41/Nregimes​=1/4 (the maximum-entropy reference). This is parameter-free — it derives from the number of gauge sectors (the four structural channels), with no (φ,γ,π,e)(\varphi,\gamma,\pi,e)(φ,γ,π,e) overlay constant. The dominant regime is always the sector with the highest score.

Implementation: src/tnfr/physics/gauge.py — classify_interaction_regime(), classify_interaction_regime_formal(), GaugeSnapshot dataclass.


4. Operator-Gauge Correspondence

Each canonical operator has a specific gauge interpretation:

OperatorGauge role
UM (Coupling)Creates gauge links — establishes the connection field AijA_{ij}Aij​
IL (Coherence)Acts as covariant derivative operator — reduces gauge-variant fluctuations
OZ (Dissonance)Sources gauge curvature FCF_CFC​ — creates topological defects
RA (Resonance)Propagates gauge-invariant quantities along links

Grammar rule U3 constrains the external phase ϕ\phiϕ via ∣ϕi−ϕj∣≤Δϕmax⁡|\phi_i - \phi_j| \le \Delta\phi_{\max}∣ϕi​−ϕj​∣≤Δϕmax​, while the internal gauge phase arg⁡(Ψ)\arg(\Psi)arg(Ψ) provides an independent degree of freedom.


5. Conservation-Gauge Unification

5.1 The TNFR Action Functional

The central theoretical result: grammar rules, symmetries, conservation laws, and gauge structure are four projections of a single mathematical structure — the stationarity of the TNFR action functional:

STNFR=∑nΔt⋅∑i[12(Jϕ2+JΔNFR2)−12(Φs2+∣∇ϕ∣2+Kϕ2)]S_{\mathrm{TNFR}} = \sum_n \Delta t \cdot \sum_i \left[\frac{1}{2}(J_\phi^2 + J_{\Delta\mathrm{NFR}}^2) - \frac{1}{2}(\Phi_s^2 + |\nabla\phi|^2 + K_\phi^2)\right]STNFR​=n∑​Δt⋅i∑​[21​(Jϕ2​+J

This encodes the nodal equation ∂EPI/∂t=νf⋅ΔNFR(t)\partial\mathrm{EPI}/\partial t = \nu_f \cdot \Delta\mathrm{NFR}(t)∂EPI/∂t=νf​⋅ΔNFR(t) as its Euler-Lagrange equation.

5.2 Four Symmetries

Under grammar-compliant evolution (U1–U6), STNFRS_{\mathrm{TNFR}}STNFR​ possesses:

SymmetryConservation lawVia
Time-translationEnergy conservation H=T+V=constH = T + V = \text{const}H=T+V=constNoether's theorem
Internal U(1)Gauge structure on Ψ\PsiΨS[eiαΨ]=S[Ψ]S[e^{i\alpha}\Psi] = S[\Psi]S[eiαΨ]=S[Ψ]
Grammar symmetryStructural continuity ∂ρ/∂t+∇⋅J=Sgrammar\partial\rho/\partial t + \nabla\cdot\mathbf{J} = S_{\text{grammar}}∂ρ/∂t+∇⋅J=Sgrammar​Ward identities
Symplectic structurePhase space geometryCanonical form ω\omegaω

5.3 Unification Structure

STNFR{δS/δΦ=0→Euler-Lagrange=Nodal equation∂S/∂t=0→Noether→Energy conservationS[eiαΨ]=S[Ψ]→U(1) gauge structureU1–U6⊂Aut(S)→Structural continuity (ρ,J)S_{\mathrm{TNFR}} \begin{cases} \delta S/\delta\Phi = 0 &\to \text{Euler-Lagrange} = \text{Nodal equation} \\ \partial S/\partial t = 0 &\to \text{Noether} \to \text{Energy conservation} \\ S[e^{i\alpha}\Psi] = S[\Psi] &\to \text{U(1) gauge structure} \\ \text{U1–U6} \subset \mathrm{Aut}(S) &\to \text{Structural continuity } (\rho, \mathbf{J}) \end{cases}STNFR​⎩⎨⎧​δS/δΦ

5.4 Grammar → Conservation Mapping

Each grammar rule protects a specific conservation law:

Grammar ruleSymmetry protectedConservation consequence
U1 (Initiation/Closure)Boundary conditionsEnergy finiteness (action endpoints)
U2 (Convergence)Lyapunov stabilitydH/dt≤0dH/dt \le 0dH/dt≤0 (stability)
U3 (Resonant Coupling)Gauge connectionAijA_{ij}Aij​ regularity (smooth connection)
U4 (Bifurcation)Topological chargeQuantisation of Q\mathcal{Q}Q
U5 (Multi-Scale)Hierarchical actionAction factorisation across scales
U6 (Confinement)Potential energyV<12(π/2)2⋅NV < \frac{1}{2}(\pi/2)^2 \cdot NV<21​(π/2)2⋅N (boundedness)

5.5 Symplectic Structure

The symplectic 2-form on the structural phase space:

ω=∑i[dKϕ(i)∧dJϕ(i)+dΦs(i)∧dJΔNFR(i)]\omega = \sum_i \left[dK_\phi(i) \wedge dJ_\phi(i) + d\Phi_s(i) \wedge dJ_{\Delta\mathrm{NFR}}(i)\right]ω=i∑​[dKϕ​(i)∧dJϕ​(i)+dΦs​(i)∧dJΔNFR​(i)]

Two conjugate pairs:

  • Geometric sector: (Kϕ,Jϕ)(K_\phi, J_\phi)(Kϕ​,Jϕ​) — curvature and current
  • Potential sector: (Φs,JΔNFR)(\Phi_s, J_{\Delta\mathrm{NFR}})(Φs​,JΔNFR​) — potential and flux

Canonical operators preserve ω\omegaω (Liouville theorem analogue).

Implementation: src/tnfr/physics/conservation_gauge_unification.py — ConservationGaugeUnification, GrammarSymmetryMapping, SymplecticGaugeCompatibility dataclasses.


6. Spectral Conservation

6.1 Graph Fourier Transform

The structural conservation equations are lifted to the spectral domain using the Graph Fourier Transform (GFT) in the Laplacian eigenbasis {ψk}\{\psi_k\}{ψk​}.

Given the discrete structural continuity equation:

Δρ(i)Δt+div⁡J(i)=Sgrammar(i)\frac{\Delta\rho(i)}{\Delta t} + \operatorname{div}\mathbf{J}(i) = S_{\text{grammar}}(i)ΔtΔρ(i)​+divJ(i)=Sgrammar​(i)

Projecting onto eigenvectors ψk\psi_kψk​:

dρ^kdt+λk⋅J^k=S^k\frac{d\hat{\rho}_k}{dt} + \lambda_k \cdot \hat{J}_k = \hat{S}_kdtdρ^​k​​+λk​⋅J^k​=S^k​

where:

  • ρ^k=⟨ψk∣ρ⟩\hat{\rho}_k = \langle\psi_k | \rho\rangleρ^​k​=⟨ψk​∣ρ⟩ — charge density in mode kkk
  • J^k=⟨ψk∣div⁡J⟩\hat{J}_k = \langle\psi_k | \operatorname{div}\mathbf{J}\rangleJ^k​=⟨ψk​∣div — current divergence in mode
  • S^k=⟨ψk∣S⟩\hat{S}_k = \langle\psi_k | S\rangleS^k​=⟨ψk​∣S⟩ — source term in mode
  • λk\lambda_kλk​ — Laplacian eigenvalue (mode frequency)

6.2 Physical Interpretation

Mode regimeConditionBehaviour
Low-frequency (small λk\lambda_kλk​)Global coherence modesNear-exact conservation (S^k≈0\hat{S}_k \approx 0S^k​≈0); corresponds to U5 multi-scale structure
High-frequency (large λk\lambda_kλk​)Local fluctuation modesRapid equilibration via λk⋅J^k\lambda_k \cdot \hat{J}_kλk​⋅J dissipation; grammar violations manifest here

6.3 Parseval Conservation

Energy in the spatial domain equals energy in the spectral domain:

∥ρ∥2=∑k∣ρ^k∣2\|\rho\|^2 = \sum_k |\hat{\rho}_k|^2∥ρ∥2=k∑​∣ρ^​k​∣2

Drift in this identity signals numerical or structural inconsistency.

6.4 Spectral Energy Decomposition

The Lyapunov energy decomposes mode-by-mode:

Ek=12(∣Φ^s,k∣2+∣∇ϕ^k∣2+∣K^ϕ,k∣2+∣J^ϕ,k∣2+∣J^ΔNFR,k∣2)E_k = \frac{1}{2}\left(|\hat{\Phi}_{s,k}|^2 + |\widehat{\nabla\phi}_k|^2 + |\hat{K}_{\phi,k}|^2 + |\hat{J}_{\phi,k}|^2 + |\hat{J}_{\Delta\mathrm{NFR},k}|^2\right)Ek​=21​(∣Φ^s,k​∣2+∣

Under grammar compliance (U2): dEk/dt≤0dE_k/dt \le 0dEk​/dt≤0 for stabiliser-dominated modes.

Implementation: src/tnfr/physics/spectral_conservation.py — SpectralConservationBalance, SpectralWardIdentity, SpectralLyapunovResult dataclasses.


7. Spectral-Gauge Consequence

The gauge-conservation unification implies that the TNFR-Riemann operator H(k)(σ)=Lk+VσH^{(k)}(\sigma) = L_k + V_\sigmaH(k)(σ)=Lk​+Vσ​ has spectral properties constrained by both:

  • Conservation: Eigenvalues satisfy sum rules from E=constE = \text{const}E=const
  • Gauge: U(1)-symmetric spectrum at σ=1/2\sigma = 1/2σ=1/2 (self-dual point)
  • Together: Critical parameter σc(k)→1/2\sigma_c^{(k)} \to 1/2σc(k)​→1/2 as k→∞k \to \inftyk→∞

This provides the structural basis for the coherence axis Re(s)=1/2\mathrm{Re}(s) = 1/2Re(s)=1/2 read from the emergent prime-NFR nodal pulse (src/tnfr/riemann/nodal_pulse.py).


Implementation Reference

ModuleContent
src/tnfr/physics/gauge.pyU(1) gauge symmetry, connection, curvature, Yang-Mills, interaction regimes
src/tnfr/physics/conservation_gauge_unification.pyAction functional, four symmetries, grammar mapping, symplectic structure
src/tnfr/physics/spectral_conservation.pySpectral continuity, Parseval identity, per-mode Lyapunov

Tests: tests/test_gauge.py, tests/test_conservation_gauge_unification.py, tests/test_spectral_conservation.py

Example: examples/02_physics_regimes/26_gauge_structure_demo.py


Implementation & Examples

Executable Demonstrations

ExampleConcept from this document
26_gauge_structure_demo.pyU(1) gauge symmetry of Ψ, connections, curvature, Wilson loops

Key Source Modules

  • src/tnfr/physics/gauge.py — Gauge field structure and symmetries
  • src/tnfr/physics/fields.py — Complex geometric field Ψ = K_φ + i·J_φ

Cross-References

  • Nodal equation: FUNDAMENTAL_THEORY.md §1
  • Conservation laws: STRUCTURAL_CONSERVATION_THEOREM.md
  • Variational principle: TNFR_VARIATIONAL_PRINCIPLE.md
  • Grammar rules: UNIFIED_GRAMMAR_RULES.md
  • Extended fields (JϕJ_\phiJϕ​, JΔNFRJ_{\Delta\mathrm{NFR}}JΔNFR​): EXTENDED_FIELDS_AND_DERIVED_QUANTITIES.md
Kϕ​⋅
JΔNFR​
2
​
)
+
(Jϕ2​−
JΔNFR2​)
ΔNFR2
​
)
−
21​
(
Φs2​
+
∣∇
ϕ
∣2
+
Kϕ2​
)
]
=
0
∂S/∂t=0
S[eiαΨ]=S[Ψ]
U1–U6⊂Aut(S)
​
→Euler-Lagrange=Nodal equation→Noether→Energy conservation→U(1) gauge structure→Structural continuity (ρ,J)​
J
⟩
kkk
kk
k
^
k​
∇ϕ​
k​
∣2
+
∣
K^ϕ,k​
∣2
+
∣
J^ϕ,k​
∣2
+
∣
J^ΔNFR,k​
∣2
)