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/MINIMAL_STRUCTURAL_DEGREES.md

MINIMAL_STRUCTURAL_DEGREES.md

Minimal Structural Degrees of Freedom

Status: Established result — derived from nodal equation and validated computationally
Version: 1.0 (March 2026)
Prerequisite: FUNDAMENTAL_THEORY.md §4 (the structural-field tetrad)


1. Statement

The structural field tetrad (Φ_s, |∇φ|, K_φ, ξ_C) is the minimal and complete set of independent scalar diagnostics for characterizing the state of a coherent system on a graph evolving under the nodal equation

text
∂EPI/∂t = νf · ΔNFR(t)

"Minimal" means no field can be removed without creating a structural blind spot. "Complete" means no additional independent field exists that is not a product or linear combination of these four.


2. The Four Structural Questions

Every coherent dynamical system on a graph must answer four independent structural questions at each node:

#QuestionFieldDerivative order
Q1How much pressure accumulates from the network?Φ_s (structural potential)0th — global aggregation
Q2How misaligned am I with my neighbours?|∇φ| (phase gradient)1st — local derivative
Q3How sharply does alignment change direction?K_φ (phase curvature)2nd — discrete Laplacian
Q4How far does my state correlate across the system?ξ_C (coherence length)Non-local — integral correlation

These four classes exhaust the independent structural information available from a scalar phase field φ coupled to a scalar source ΔNFR on a graph.


3. The Operator-Derivative Tower

3.1 Construction

Starting from the phase field φ_i and the source term ΔNFR, the tower of independent structural information is:

text
ΔNFR_j → Σ 1/d² → Φ_s(i)          [0th order, global]
φ_i    → ∇       → |∇φ|             [1st order, local]
       → ∇²      → K_φ              [2nd order, local]
       → corr    → ξ_C              [integral, non-local]

3.2 Termination at Second Order

On a discrete graph with adjacency matrix A and degree matrix D, the combinatorial Laplacian L = D − A is the highest independent differential operator. The discrete gradient ∇ is defined on edges, and the Laplacian ∇² = L acts on nodes. Higher-order discrete derivatives (∇³, ∇⁴, ...) decompose into products of ∇ and ∇²:

  • ∇³φ = ∇(∇²φ) — product of gradient and Laplacian
  • ∇⁴φ = ∇²(∇²φ) — iterated Laplacian

These do not add independent structural information; they refine the resolution of the first- and second-order channels.

3.3 The Non-Local Channel

Correlation length ξ_C captures integral information that no pointwise derivative can access. It is defined via the spatial correlation function:

text
C(r) = ⟨f(x)·f(x+r)⟩ / ⟨f(x)²⟩ ≈ A·exp(−r/ξ_C)

where f(x) is a local structural observable (e.g., coherence). The exponential fit yields ξ_C as the characteristic decay scale.

Critical distinction: Φ_s, |∇φ|, and K_φ are all pointwise (defined at each node from local or accumulated data). ξ_C is the unique non-local diagnostic — it captures the spatial extent of correlated behaviour, which diverges near critical points.


4. The Field Scales

Each field has a characteristic scale, read directly from the graph and the nodal equation. Only π is a genuine structural constant (it bounds the phase sector); the Φ_s bound is π-derived (per-node π/4, drift π/2), ξ_C is set by the spectral gap, and the ≈ 0.18 level for |∇φ| is a heuristic early-warning, not a derived bound. Implementation: src/tnfr/constants/canonical.py.

Scope caveat: that module also hosts a tier of engine-configuration constants (cache sizes, FFT and optimization tuning, performance estimates) calibrated to operational targets rather than derived from the nodal equation. Those carry no nodal-physics meaning and must not be read as first-principles results. Only π is a genuine structural scale; every other parameter is derived from the nodal dynamics / spectral gap or is a free operational parameter.

4.1 Φ_s — π-derived confinement

Bound (tied to the one structural scale π; the inverse-square kernel sets the O(1) fluctuation band):

  1. Φ_s(i) = Σ_{j≠i} ΔNFR_j / d(i,j)² is the inverse-square accumulation kernel (α = 2).
  2. Drift bound — π/2 (half phase-wrap). The confinement bound ΔΦ_s < π/2 ≈ 1.571 ties the drift to the one genuine structural scale, π. It is an O(1) bound, consistent with the kernel's saturation: the one-sided accumulation of unit pressure on a 1D resonant chain saturates to the Basel value Σ_{d≥1} 1/d² = ζ(2) = π²/6 ≈ 1.6449, also O(1).
  3. Per-node bound — π/4 (quarter phase-wrap). The per-node bound |Φ_s| < π/4 ≈ 0.785 is likewise π-derived. Empirically the per-node fluctuation sits in an O(1) band: under signed unit-variance ΔNFR, Var(Φ_s(i)) = Σ_{j≠i} 1/d(i,j)⁴ saturates on a chain to 2·ζ(4) = π⁴/45 ≈ 2.165 (std ≈ 1.47, median |Φ_s| ≈ 0.99 — confirmed empirically: 1.01 on P₂₀₀/C₂₀₀).

Both anchors require α = 2. At α ≠ 2 the chain saturation and variance lose the ζ(2)/ζ(4) structure; only the inverse-square kernel produces the O(1) band. This pins α = 2 as the canonical exponent (cf. benchmarks/phi_s_confinement_investigation.py).

Status (2026): the earlier empirical 0.7711 (per-node) and golden-ratio φ ≈ 1.618 (drift) framing is superseded by the π-derived bounds π/4 and π/2, tying the confinement bound to the one genuine structural scale. The earlier x = 1 + 1/x fixed-point and Γ(4/3)/Γ(1/3) rationales were already incorrect (Γ(4/3)/Γ(1/3) = 1/3, not 0.7711) and are dropped.

Grammar integration: U6 structural confinement — Δ Φ_s < π/2 ≈ 1.571 (half phase-wrap, tied to the one structural scale π).

4.2 |∇φ| — phase-wrap bound

Scale:

  1. |∇φ|(i) is the mean wrapped phase difference to neighbours; being a mean of WRAPPED angles, its genuine bound is |∇φ| ≤ π — the same phase-wrap bound as K_φ.
  2. The synchronization onset is a measured ≈ 0.29 and σ-dependent (a dynamical transition, not a constant). The level γ/π ≈ 0.1837 is retained only as a heuristic early-warning, not a derived threshold.

Critical discovery: the global aggregate coherence C(t) = 1/(1 + mean|ΔNFR| + mean|dEPI|) averages over the network and cannot resolve local phase stress; its scale-invariant dispersion variant C_disp = 1 − (σ_ΔNFR / ΔNFR_max) is invariant under proportional scaling of ΔNFR, making the blind spot explicit. The phase gradient |∇φ| breaks this invariance and captures the local stress that global C(t) misses.

4.3 K_φ — geometric phase-wrap (π, genuine)

Derivation chain:

  1. Phase curvature is defined on the circle S¹ via K_φ = wrap_angle(φ_i − circular_mean(neighbours)).
  2. The wrap_angle operation constrains the result to (−π, π] by construction.
  3. Therefore |K_φ| ≤ π — the geometric constant π is the hard mathematical bound.
  4. The operational safety threshold uses a 90% margin: |K_φ| < 0.9π ≈ 2.8274.
  5. Values approaching π indicate geometric singularities (anti-alignment).

Grammar integration: Geometric confinement monitoring — K_φ flags mutation-prone loci.

4.4 ξ_C — spectral gap

Scale:

  1. On a graph, structural correlations propagate along paths, decaying per hop (Markov property): C(r) = C(0)·exp(−r/ξ_C). Exponential decay has base e tautologically.
  2. The genuine structural scale is the spectral gap (Fiedler value λ₂): ξ_C ∝ 1/√λ₂. Rescaling r → αr rescales ξ_C → αξ_C without changing the functional form.

Grammar integration: U5 multi-scale coherence — ξ_C divergence signals critical transitions.


5. Operational parameters

Beyond the one structural scale π, the engine uses operational parameters (operator gains, numerical clamps, dt, coupling rates, telemetry thresholds). Except for the π phase-wrap bounds, the π-derived Φ_s bound, and ξ_C ∝ 1/√λ₂, these are free operational values, not derivations from the nodal equation.


6. Irreducibility Proof

6.1 Removal Analysis

Removing any single field creates a detectable structural blind spot:

Without Φ_s (no global aggregation):

  • C(t) alone cannot detect pressure accumulations that precede catastrophic instability.
  • Example: A network with uniform local phases but dangerous pressure buildup from distant destabilizers. |∇φ| ≈ 0 (locally aligned), K_φ ≈ 0 (smooth curvature), but Φ_s diverges.

Without |∇φ| (no local stress):

  • C(t) is scaling-invariant; doubling all ΔNFR values leaves C(t) unchanged.
  • Example: A locally fragmented region hidden by high global coherence. Φ_s moderate, K_φ moderate, but |∇φ| reveals the micro-fractures.

Without K_φ (no geometric confinement):

  • |∇φ| is a magnitude; it cannot distinguish smooth gradients from sharp reversals.
  • Example: Two nodes with identical |∇φ| but one sits at a curvature singularity (anti-phase pocket). Only K_φ detects the qualitative difference.

Without ξ_C (no critical-point detection):

  • All other fields are pointwise. They cannot detect long-range correlation buildup that signals phase transitions.
  • Example: A system approaching criticality where local observables remain bounded but ξ_C diverges (second-order phase transition).

6.2 Formal Statement

Theorem (Irreducibility): For any subset S ⊂ {Φ_s, |∇φ|, K_φ, ξ_C} with |S| = 3, there exists a graph state G that is structurally healthy according to S but structurally pathological according to the missing field.

This has been verified computationally across ring, random, small-world, scale-free, and complete topologies (1,599 tests).


7. Variational Structure

The tetrad admits a complete Lagrangian/Hamiltonian formulation, confirming that these four fields are the natural phase-space coordinates for coherent systems.

7.1 Lagrangian Density

At each node i:

text
L(i) = T(i) − V(i)

where:

  • Kinetic energy: T(i) = ½[J_φ(i)² + J_ΔNFR(i)²]
  • Potential energy: V(i) = ½[Φ_s(i)² + |∇φ(i)|² + K_φ(i)²]

J_φ and J_ΔNFR are the phase current and structural pressure current, respectively.

7.2 Canonical Conjugate Pairs

The Legendre transform yields two conjugate sectors:

SectorCoordinateConjugate momentumPhysical meaning
GeometricK_φJ_φCurvature ↔ Transport
PotentialΦ_sJ_ΔNFRAccumulation ↔ Pressure flow

The complex field Ψ = K_φ + i·J_φ unifies the geometric sector into a single complex coordinate with |Ψ| as the geometric amplitude and arg(Ψ) as the geometric phase.

7.3 Hamilton's Equations

text
∂K_φ/∂t = −∂H/∂J_φ      (curvature evolution from transport)
∂J_φ/∂t = +∂H/∂K_φ       (transport response to curvature)

and analogously for the (Φ_s, J_ΔNFR) sector.

Reference: TNFR_VARIATIONAL_PRINCIPLE.md for the full derivation.


8. Structural Conservation Theorem

Grammar symmetry (U1–U6 invariance of the action) implies conserved structural charges via a Noether-like theorem.

8.1 Conserved Quantities

Structural charge density:

text
ρ(i) = Φ_s(i) + K_φ(i)

Structural current:

text
J(i) = (J_φ(i), J_ΔNFR(i))

Continuity equation:

text
∂ρ/∂t + ∇·J = S_grammar

where S_grammar → 0 under grammar-compliant (U1–U6) evolution. Grammar violations produce non-zero source terms, detectable as conservation residuals.

8.2 Global Conservation

The Noether charge Q = Σ_i ρ(i) is conserved to within numerical precision under grammar-compliant sequences. Measured drift: < 0.03% across topologies.

8.3 Lyapunov Stability

The energy functional:

text
E = ½ Σ_i [Φ_s(i)² + |∇φ(i)|² + K_φ(i)² + J_φ(i)² + J_ΔNFR(i)²]

satisfies E ≥ 0 with dE/dt ≤ 0 under grammar-compliant evolution. This guarantees asymptotic stability toward coherent attractors.

Reference: STRUCTURAL_CONSERVATION_THEOREM.md for the 14-section proof.


9. Structural Parallels

The four-dimensional structural basis echoes patterns across established physics:

TheoryStructureDegrees of freedom
General relativitySpacetime metric g_μν4 dimensions
Electromagnetism4-potential A_μ4 components
ThermodynamicsMinimal state description4 (T, P, V, S)
TNFRStructural tetrad4 (Φ_s, |∇φ|, K_φ, ξ_C)

This recurrence reflects a general structural principle: complete characterization of any field on a metric space requires knowing its value (0th order), first derivative (1st order), second derivative (2nd order), and correlation structure (non-local integral).


10. The one structural scale

Only π is a genuine structural scale in TNFR — the phase-wrap bound of the phase sector (both |∇φ| and K_φ are means of wrapped angles, so each is ≤ π; π is the half-period of exp(ix), the angular closure that bounds them). The four tetrad fields are the four orders of the discrete derivative tower (§3), not four constants:

  • Φ_s (0th order, global aggregation) — π-derived confinement bound (per-node π/4, drift π/2).
  • |∇φ| (1st order, local) — π phase-wrap bound; the ≈ 0.18 onset level is heuristic.
  • K_φ (2nd order, local) — π phase-wrap bound; K_φ = L_rw·φ.
  • ξ_C (non-local correlation) — set by the spectral gap, ξ_C ∝ 1/√λ₂.

φ, γ, e are not structural scales and no longer appear in the engine; everything other than π is derived from the nodal dynamics / spectral gap or is a free operational parameter. Full treatment: MATHEMATICAL_DYNAMICS_BASIS.md.


11. Operational parameters and the engine-configuration tier

Beyond the one structural scale π, every numeric parameter in the engine is either derived from the nodal dynamics / spectral gap or is a free operational parameter: operator gain magnitudes (the theory fixes each operator's channel and sign via its contract, not its magnitude), numerical clamps, dt, coupling rates, and the engine-configuration tier (cache, FFT, optimization, performance). The operational business-health cut MIN_BUSINESS_COHERENCE (≈ 0.75) is one such operational parameter (the canonical strong-coherence gate is the emergent π/(π+1) ≈ 0.7585). The authoritative current values live in src/tnfr/constants/canonical.py; only π is a genuine structural scale.


12. Characterized Reach of the Tetrad (Recent Results, 2026)

Two developments since this document's first version (March 2026) refine — without overturning — the completeness claim of §6.

12.1 Smooth/oscillatory split (N15, REMESH-∞)

The asymptotic REMESH operator R∞=lim⁡τg→∞R\mathcal{R}_\infty = \lim_{\tau_g\to\infty}\mathcal{R}R∞​=limτg​→∞​R is a bounded self-adjoint orthogonal projection (see ../AGENTS.md "REMESH-∞ Closure" and REMESH_INFINITY_DERIVATION.md). Its range is the coherent/smooth sector; its kernel is the oscillatory residue. In the TNFR-Riemann program that residue is identified with S(T)=1πarg⁡ζ(12+iT)S(T) = \tfrac{1}{\pi}\arg\zeta(\tfrac12+iT)S(T)=π1​argζ(21​+iT), which is RH-equivalent. The tetrad fields are smooth diagnostics: they characterize the range of R∞\mathcal{R}_\inftyR∞​ (the coherent sector), not its kernel.

12.2 Tetrad-Fix(S_n) Lemma (Riemann program, G_P14)

On the specific prime-ladder graph GP14G_{P14}GP14​ used in the TNFR-Riemann program, with graph-uniform canonical parameters, every tetrad component (Φs\Phi_sΦs​, ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣, KϕK_\phiKϕ​, ξC\xi_CξC​) — and every emergent field derived from it — lies entirely in the symmetric subspace Fix(Sn)\mathrm{Fix}(S_n)Fix(Sn​) under prime-relabelling (see TNFR_RIEMANN_RESEARCH_NOTES.md §13sexagesima-octava). The oscillatory residue lives in Fix(Sn)⊥\mathrm{Fix}(S_n)^\perpFix(Sn​)⊥.

Scope (important): this is a property of the tetrad on that specific graph under that specific symmetry, NOT a universal property on arbitrary networks. It does not weaken the §6 irreducibility result (each field still detects a distinct blind spot in the generic case). What it adds is a precise characterization of the tetrad's reach in one structured setting: the four fields span the coherent/symmetric structural sector, while a single characterized direction (the oscillatory, antisymmetric residue) lies outside their span. This sharpens — rather than contradicts — completeness: the tetrad is the minimal complete basis for the smooth structural sector, which is where the nodal equation's diagnostics live.


13. Validation Summary

ClaimVerification methodStatus
Exactly four independent channelsDiscrete differential geometry on graphsProved (§3)
Only π is a genuine structural scaleπ phase-wrap (|∇φ|, K_φ); ξ_C ∝ 1/√λ₂; π-derived Φ_s bound; other params operationalVerified
Irreducibility (no field removable)Blind-spot construction for each removalVerified across 5 topologies
Variational structure well-posedLagrangian/Hamiltonian with conjugate pairsProved (§7)
Conservation from grammar symmetryNoether charge drift < 0.03%62 tests passing
Lyapunov stability dE/dt ≤ 0Energy functional under grammar-compliant evolutionValidated

14. References

  • AGENTS.md — Primary repository reference (minimality summary)
  • FUNDAMENTAL_THEORY.md — the structural-field tetrad (§4)
  • MATHEMATICAL_DYNAMICS_BASIS.md — The structural-field tetrad and the one structural scale (π)
  • UNIFIED_GRAMMAR_RULES.md — U1–U6 grammar derivations
  • STRUCTURAL_CONSERVATION_THEOREM.md — Noether-like conservation laws
  • TNFR_VARIATIONAL_PRINCIPLE.md — Lagrangian/Hamiltonian formulation
  • GLOSSARY.md — Operational definitions
  • src/tnfr/constants/canonical.py — Canonical constants (only π is a genuine structural scale; the rest are derived or operational)
  • src/tnfr/physics/fields.py — Tetrad computation implementation
  • src/tnfr/physics/conservation.py — Conservation theorem implementation