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: benchmarks/remesh_infinity_riemann_spectral.py

remesh_infinity_riemann_spectral.py

R∞-1a-spectral — Spectral projection of REMESH-∞ fixed point onto Riemann basis.

Scope (honest)

Follow-up to benchmarks/remesh_infinity_riemann_baseline.py (R∞-1a). That benchmark established (Track B, N=512) that iterated REMESH on prime-ladder synthetic dynamics admits a non-trivial fixed point EPI* with structured FFT content (top-3 bins {16,19,20} of 21, fractions ~{10.6%, 9.7%, 9.3%}; dc_fraction post-demean ~ 3e-33).

Established (R∞-1a): - iterated REMESH is contractive (step_decay = 6.82e-6) - fixed point ≠ time-average (rel→avg = 0.2808) - spectral content concentrated in high-νf bins (necessary condition for B1 reframe satisfied)

NOT established (open after R∞-1a): - whether the spectral content of EPI* has ANY measurable correspondence with Riemann data (γ_n or residuals r_n)

Hypothesis under test (B1 spectral)

H2: There exists a non-trivial linear correlation between the magnitudes of the fixed-point spectrum (ordered by some canonical TNFR axis) and a Riemann-side quantity built from the first N zeros, where N is the spectral dimension.

Falsification criterion (pre-registered)

F3: If max(|r_α|, |r_β|, |r_γ|, |r_δ|) < 0.2 across all four correlation tests defined below, branch B1 is empirically refuted at the spectral level even though the fixed point is non-trivial. This would be strong evidence for branch B2 or B3 (§13octies of TNFR_RIEMANN_RESEARCH_NOTES.md).

text
If max(...) ∈ [0.2, 0.5]: indeterminate — fixed point has
weak/noisy Riemann signature; needs operator-level redesign.

If max(...) > 0.5: B1 spectrally supported (still does NOT
prove RH; only that REMESH-∞ on prime-ladder dynamics is
measurably correlated with Riemann data).

Tests (pre-registered, none decisive on its own)

Let s_i = EPI*[i] for i = 1..N nodes, sorted by νf = k·log(p) (canonical TNFR energy axis). Let P_k = |FFT(s - mean(s))|² for k = 0..N/2 = M. Let γ_n be the first N Riemann zeros (mpmath), γ̃_n the P28 smooth approximations, and r_n = γ_n - γ̃_n the oscillatory residuals.

text
r_α  = Pearson(P_1..P_M, |r_1..r_M|)            [index-aligned]
r_β  = Pearson(sort(P_1..P_M, desc),
               sort(|r_1..r_M|, desc))           [magnitude dist.]
r_γ  = Pearson(s_1..s_N, γ̃_1..γ̃_N)             [node-ordered vs smooth γ]
r_δ  = Spearman-rank(P_1..P_M, |r_1..r_M|)       [monotone alignment]

What R∞-1a-spectral does NOT do

  • Does NOT prove or disprove RH.
  • Does NOT close T-HP, G4, or any gap.
  • Does NOT build the admissible rescaling operator F.
  • Does NOT modify the canonical engine.

Status: EXPERIMENTAL — TNFR-Riemann R∞-1a-spectral (May 2026).

Source Code

python
"""R∞-1a-spectral — Spectral projection of REMESH-∞ fixed point onto Riemann basis.

Scope (honest)
--------------
Follow-up to ``benchmarks/remesh_infinity_riemann_baseline.py`` (R∞-1a).
That benchmark established (Track B, N=512) that iterated REMESH on
prime-ladder synthetic dynamics admits a non-trivial fixed point
EPI* with structured FFT content (top-3 bins {16,19,20} of 21,
fractions ~{10.6%, 9.7%, 9.3%}; dc_fraction post-demean ~ 3e-33).

Established (R∞-1a):
    - iterated REMESH is contractive (step_decay = 6.82e-6)
    - fixed point ≠ time-average (rel→avg = 0.2808)
    - spectral content concentrated in high-νf bins (necessary
      condition for B1 reframe satisfied)

NOT established (open after R∞-1a):
    - whether the spectral content of EPI* has ANY measurable
      correspondence with Riemann data (γ_n or residuals r_n)

Hypothesis under test (B1 spectral)
-----------------------------------
H2: There exists a non-trivial linear correlation between the
    magnitudes of the fixed-point spectrum (ordered by some
    canonical TNFR axis) and a Riemann-side quantity built from
    the first N zeros, where N is the spectral dimension.

Falsification criterion (pre-registered)
----------------------------------------
F3: If max(|r_α|, |r_β|, |r_γ|, |r_δ|) < 0.2 across all four
    correlation tests defined below, branch B1 is empirically
    refuted **at the spectral level** even though the fixed point
    is non-trivial.  This would be strong evidence for branch B2
    or B3 (§13octies of TNFR_RIEMANN_RESEARCH_NOTES.md).

    If max(...) ∈ [0.2, 0.5]: indeterminate — fixed point has
    weak/noisy Riemann signature; needs operator-level redesign.

    If max(...) > 0.5: B1 spectrally supported (still does NOT
    prove RH; only that REMESH-∞ on prime-ladder dynamics is
    measurably correlated with Riemann data).

Tests (pre-registered, none decisive on its own)
------------------------------------------------
Let s_i = EPI*[i] for i = 1..N nodes, sorted by νf = k·log(p)
(canonical TNFR energy axis).  Let P_k = |FFT(s - mean(s))|² for
k = 0..N/2 = M.  Let γ_n be the first N Riemann zeros (mpmath),
γ̃_n the P28 smooth approximations, and r_n = γ_n - γ̃_n the
oscillatory residuals.

    r_α  = Pearson(P_1..P_M, |r_1..r_M|)            [index-aligned]
    r_β  = Pearson(sort(P_1..P_M, desc),
                   sort(|r_1..r_M|, desc))           [magnitude dist.]
    r_γ  = Pearson(s_1..s_N, γ̃_1..γ̃_N)             [node-ordered vs smooth γ]
    r_δ  = Spearman-rank(P_1..P_M, |r_1..r_M|)       [monotone alignment]

What R∞-1a-spectral does NOT do
-------------------------------
* Does NOT prove or disprove RH.
* Does NOT close T-HP, G4, or any gap.
* Does NOT build the admissible rescaling operator F.
* Does NOT modify the canonical engine.

Status: EXPERIMENTAL — TNFR-Riemann R∞-1a-spectral (May 2026).
"""

from __future__ import annotations

import copy
import json
import math
from collections import deque
from pathlib import Path
from typing import Any

import mpmath as mp
import numpy as np

from tnfr.alias import get_attr, set_attr
from tnfr.constants.aliases import ALIAS_EPI
from tnfr.operators.remesh import apply_network_remesh
from tnfr.riemann.prime_ladder_hamiltonian import build_prime_ladder_graph
from tnfr.riemann.structural_zero_density import derive_smooth_zero_position

# ---------------------------------------------------------------------------
# Configuration (kept identical to R∞-1a for cross-comparison)
# ---------------------------------------------------------------------------

N_PRIMES: int = 10
MAX_POWER: int = 4
DT: float = 0.05
TAU_LOCAL: int = 4
ALPHA: float = 0.5
TAU_GLOBAL: int = 16
N_ITER: int = 512
MPMATH_DPS: int = 30


# ---------------------------------------------------------------------------
# Helpers (mirror R∞-1a)
# ---------------------------------------------------------------------------


def synthetic_epi_snapshot(G, t: float) -> dict:
    out: dict = {}
    for node in G.nodes():
        p, k = node
        log_p = math.log(p)
        nu_f = k * log_p
        out[node] = (log_p / k) * math.cos(nu_f * t)
    return out


def populate_history(G, n_steps: int) -> None:
    hist: deque = deque(maxlen=n_steps + 10)
    for step in range(n_steps):
        hist.append(synthetic_epi_snapshot(G, step * DT))
    G.graph["_epi_hist"] = hist
    last = hist[-1]
    for n, nd in G.nodes(data=True):
        set_attr(nd, ALIAS_EPI, last[n])


def snapshot_epi(G) -> dict:
    return {n: float(get_attr(nd, ALIAS_EPI, 0.0)) for n, nd in G.nodes(data=True)}


def restore_epi(G, snap: dict) -> None:
    for n, nd in G.nodes(data=True):
        set_attr(nd, ALIAS_EPI, snap[n])


def vec(d: dict, nodes: list) -> np.ndarray:
    return np.asarray([d[n] for n in nodes], dtype=float)


# ---------------------------------------------------------------------------
# Correlation utilities (pure NumPy / scipy-free)
# ---------------------------------------------------------------------------


def pearson(x: np.ndarray, y: np.ndarray) -> float:
    x = np.asarray(x, dtype=float)
    y = np.asarray(y, dtype=float)
    xm = x - x.mean()
    ym = y - y.mean()
    denom = math.sqrt(float((xm * xm).sum()) * float((ym * ym).sum()))
    if denom < 1e-30:
        return float("nan")
    return float((xm * ym).sum() / denom)


def spearman_rank(x: np.ndarray, y: np.ndarray) -> float:
    """Spearman rank correlation via Pearson on ranks (no ties handling)."""

    def _rank(a: np.ndarray) -> np.ndarray:
        order = np.argsort(a)
        ranks = np.empty_like(order, dtype=float)
        ranks[order] = np.arange(len(a), dtype=float)
        return ranks

    return pearson(_rank(x), _rank(y))


# ---------------------------------------------------------------------------
# Iterate REMESH^N to obtain the fixed point (replicates R∞-1a Track B)
# ---------------------------------------------------------------------------


def compute_fixed_point(G, baseline_epi: dict, n_iter: int) -> dict:
    G.graph["REMESH_TAU_LOCAL"] = TAU_LOCAL
    G.graph["REMESH_TAU_GLOBAL"] = TAU_GLOBAL
    G.graph["REMESH_ALPHA"] = ALPHA

    hist_backup = deque(
        copy.deepcopy(list(G.graph["_epi_hist"])),
        maxlen=G.graph["_epi_hist"].maxlen,
    )
    restore_epi(G, baseline_epi)
    for _ in range(n_iter):
        apply_network_remesh(G)
        G.graph["_epi_hist"].append(snapshot_epi(G))
    fixed_point = snapshot_epi(G)
    G.graph["_epi_hist"] = hist_backup
    restore_epi(G, baseline_epi)
    return fixed_point


# ---------------------------------------------------------------------------
# Riemann data
# ---------------------------------------------------------------------------


def fetch_riemann_zeros(n: int, dps: int = MPMATH_DPS) -> np.ndarray:
    mp.mp.dps = dps
    return np.asarray(
        [float(mp.im(mp.zetazero(k))) for k in range(1, n + 1)], dtype=float
    )


def fetch_smooth_targets(n: int) -> np.ndarray:
    """First n smooth Riemann-Siegel zero approximations via P28 API."""
    return np.asarray(
        [derive_smooth_zero_position(k) for k in range(1, n + 1)], dtype=float
    )


# ---------------------------------------------------------------------------
# Main protocol
# ---------------------------------------------------------------------------


def run() -> dict[str, Any]:
    G = build_prime_ladder_graph(n_primes=N_PRIMES, max_power=MAX_POWER)
    nodes = list(G.nodes())
    n_nodes = len(nodes)

    populate_history(G, n_steps=TAU_GLOBAL + 20)
    G.graph["REMESH_TAU_LOCAL"] = TAU_LOCAL
    G.graph["REMESH_ALPHA"] = ALPHA
    baseline_epi = snapshot_epi(G)

    # ---- Fixed point via iterated REMESH ----
    fixed_point = compute_fixed_point(G, baseline_epi, N_ITER)
    fp_vec_node_order = vec(fixed_point, nodes)

    # ---- νf-ordered fixed point ----
    nu_f = np.asarray([n[1] * math.log(n[0]) for n in nodes])
    order = np.argsort(nu_f)
    s_ordered = fp_vec_node_order[order]
    nu_f_ordered = nu_f[order]
    s_demean = s_ordered - s_ordered.mean()

    # ---- FFT power per bin ----
    spectrum = np.fft.rfft(s_demean)
    power = (np.abs(spectrum) ** 2).astype(float)
    # Drop DC bin (already removed by demean); keep bins 1..M
    P_full = power.copy()
    P = power[1:]
    M = len(P)  # = n_nodes // 2 = 20 for n_nodes=40

    # ---- Riemann zeros and smooth targets ----
    # Need enough zeros for all tests. M for spectral tests, n_nodes for
    # node-ordered test.
    n_need = max(n_nodes, M + 1)
    gamma = fetch_riemann_zeros(n_need)
    gamma_tilde = fetch_smooth_targets(n_need)
    r_residual = gamma - gamma_tilde
    abs_r = np.abs(r_residual)

    # ---- Pre-registered tests ----
    r_alpha = pearson(P, abs_r[:M])
    r_beta = pearson(np.sort(P)[::-1], np.sort(abs_r[:M])[::-1])
    r_gamma = pearson(s_ordered, gamma_tilde[:n_nodes])
    r_delta = spearman_rank(P, abs_r[:M])

    # Auxiliary controls (NOT in falsification criterion, only diagnostic)
    r_aux_smooth_pow = pearson(P, gamma_tilde[:M])
    r_aux_zero_pow = pearson(P, gamma[:M])
    r_aux_node_residual = pearson(s_ordered, r_residual[:n_nodes])

    max_pre_registered = max(abs(r_alpha), abs(r_beta), abs(r_gamma), abs(r_delta))
    F3_refuted = max_pre_registered < 0.2
    F3_supported = max_pre_registered > 0.5

    summary: dict[str, Any] = {
        "config": {
            "n_primes": N_PRIMES,
            "max_power": MAX_POWER,
            "n_nodes": n_nodes,
            "tau_global": TAU_GLOBAL,
            "tau_local": TAU_LOCAL,
            "alpha": ALPHA,
            "n_iter": N_ITER,
            "spectral_M": M,
            "mpmath_dps": MPMATH_DPS,
        },
        "riemann": {
            "gamma_first10": gamma[:10].tolist(),
            "gamma_tilde_first10": gamma_tilde[:10].tolist(),
            "residual_first10": r_residual[:10].tolist(),
            "residual_abs_mean": float(abs_r[:M].mean()),
            "residual_abs_max": float(abs_r[:M].max()),
        },
        "fixed_point": {
            "node_order_l2": float(np.linalg.norm(fp_vec_node_order)),
            "node_order_mean": float(fp_vec_node_order.mean()),
            "spectral_total_power": float(P_full.sum()),
            "spectral_top3_bins": np.argsort(P)[-3:][::-1].tolist(),
            "spectral_top3_power_fraction": [
                float(P[i] / (P.sum() + 1e-30))
                for i in np.argsort(P)[-3:][::-1].tolist()
            ],
        },
        "pre_registered_tests": {
            "r_alpha_pearson_power_vs_residual_index_aligned": r_alpha,
            "r_beta_pearson_sorted_power_vs_sorted_residual": r_beta,
            "r_gamma_pearson_nodefield_vs_smooth_targets": r_gamma,
            "r_delta_spearman_power_vs_residual": r_delta,
            "max_abs_pre_registered": max_pre_registered,
        },
        "auxiliary_controls_NOT_in_F3": {
            "r_power_vs_gamma_tilde": r_aux_smooth_pow,
            "r_power_vs_gamma": r_aux_zero_pow,
            "r_nodefield_vs_residual": r_aux_node_residual,
        },
        "falsification_F3": {
            "criterion": (
                "max(|r_alpha|,|r_beta|,|r_gamma|,|r_delta|) < 0.2 "
                "REFUTES B1 at spectral level; > 0.5 SUPPORTS B1 "
                "spectrally; in between indeterminate."
            ),
            "max_abs_pre_registered": max_pre_registered,
            "F3_refuted": F3_refuted,
            "F3_supported": F3_supported,
            "verdict": (
                "REFUTED"
                if F3_refuted
                else "SUPPORTED" if F3_supported else "INDETERMINATE"
            ),
        },
    }
    return summary


def print_report(summary: dict[str, Any]) -> None:
    print("=" * 78)
    print("R∞-1a-spectral — Spectral projection onto Riemann basis")
    print("=" * 78)
    cfg = summary["config"]
    print(
        f"Prime-ladder n_primes={cfg['n_primes']}, max_power={cfg['max_power']}, "
        f"n_nodes={cfg['n_nodes']}, M={cfg['spectral_M']}"
    )
    print(
        f"α={cfg['alpha']}, τ_l={cfg['tau_local']}, τ_g={cfg['tau_global']}, "
        f"N_iter={cfg['n_iter']}"
    )
    print()
    print("--- Riemann reference (mpmath, first 10) ---")
    rie = summary["riemann"]
    for i, (g, gt, r) in enumerate(
        zip(rie["gamma_first10"], rie["gamma_tilde_first10"], rie["residual_first10"])
    ):
        print(f"  n={i+1:>2}  γ={g:>10.6f}  γ̃={gt:>10.6f}  r={r:>+10.6f}")
    print(
        f"  Σ-stats:  |r|_mean={rie['residual_abs_mean']:.4f}  "
        f"|r|_max={rie['residual_abs_max']:.4f}"
    )
    print()
    print("--- Fixed point ---")
    fp = summary["fixed_point"]
    print(f"  ‖EPI*‖_L2 (node order) = {fp['node_order_l2']:.6f}")
    print(f"  mean(EPI*) = {fp['node_order_mean']:+.6e}")
    print(f"  spectral total power = {fp['spectral_total_power']:.4f}")
    print(
        f"  top-3 bins (1..M) = {fp['spectral_top3_bins']}  "
        f"fractions = {[f'{x:.3f}' for x in fp['spectral_top3_power_fraction']]}"
    )
    print()
    print("--- Pre-registered correlation tests ---")
    pr = summary["pre_registered_tests"]
    print(
        f"  r_α  (power[1..M] vs |r_n|[1..M], index-aligned)  = {pr['r_alpha_pearson_power_vs_residual_index_aligned']:+.4f}"
    )
    print(
        f"  r_β  (sort(power, desc) vs sort(|r_n|, desc))      = {pr['r_beta_pearson_sorted_power_vs_sorted_residual']:+.4f}"
    )
    print(
        f"  r_γ  (EPI*[νf-ordered] vs γ̃_n[1..N])              = {pr['r_gamma_pearson_nodefield_vs_smooth_targets']:+.4f}"
    )
    print(
        f"  r_δ  (Spearman power vs |r_n|)                     = {pr['r_delta_spearman_power_vs_residual']:+.4f}"
    )
    print(f"  max |·| = {pr['max_abs_pre_registered']:.4f}")
    print()
    print("--- Auxiliary controls (NOT in F3) ---")
    aux = summary["auxiliary_controls_NOT_in_F3"]
    for k, v in aux.items():
        print(f"  {k:>40s} = {v:+.4f}")
    print()
    print("--- F3 falsification verdict ---")
    f3 = summary["falsification_F3"]
    print(f"  Criterion: {f3['criterion']}")
    print(f"  max|·| = {f3['max_abs_pre_registered']:.4f}")
    print(f"  VERDICT: {f3['verdict']}")
    print("=" * 78)


def main() -> None:
    summary = run()
    print_report(summary)
    out_dir = Path("results/remesh_infinity")
    out_dir.mkdir(parents=True, exist_ok=True)
    out = out_dir / "remesh_infinity_riemann_spectral.json"
    out.write_text(json.dumps(summary, indent=2), encoding="utf-8")
    print(f"\nResults written to: {out}")


if __name__ == "__main__":
    main()