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

PHYSICAL_REGIME_CORRESPONDENCES.md

Physical Regime Correspondences

Status: Technical reference Version: 0.0.3.3 Date: March 2026


1. Scope

This document derives five physical regimes as limiting cases of the nodal equation ∂EPI/∂t=νf ΔNFR(t)\partial\mathrm{EPI}/\partial t = \nu_f \, \Delta\mathrm{NFR}(t)∂EPI/∂t=νf​ΔNFR(t). Each regime is specified by measurable conditions on the structural field tetrad (Φs\Phi_sΦs​, ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣, KϕK_\phiKϕ​, ξC\xi_CξC​), the observable mappings between TNFR quantities and classical/quantum variables, and the validation artifacts linking theory to reproducible simulations.

Verification Status

RegimeImplementationExternal referenceTest coverageStatus
Classical mechanicsclassical_mechanics.pyKepler orbit (analytical)test_classical_mechanics.pyVerified
Inertialclassical_mechanics.pyTwo-train analyticalEmbedded in exampleVerified
Quantumquantum_mechanics.pyParticle-in-box (En=(πn/L)2E_n = (\pi n/L)^2En​=(πn/L)2)NonePartial
Uncertainty/interferenceExample onlyFourier boundNonePartial
ThermodynamicsExample onlyNewton cooling lawNoneDemonstration

2. Classical Mechanics (Low-Dissonance Limit)

2.1 Regime Conditions

∣∇ϕ∣→0,νf=const,C(t)≈1|\nabla\phi| \to 0, \qquad \nu_f = \mathrm{const}, \qquad C(t) \approx 1∣∇ϕ∣→0,νf​=const,C(t)≈1

Under these constraints the nodal equation reduces to a form algebraically identical to Newton's second law.

2.2 Observable Mapping

Classical quantitySymbolTNFR quantityAccess
PositionqqqSpatial component of EPIClassicalMechanicsMapper.position
Velocityq˙\dot{q}q˙​Flow componentSame accessor
Massmmm1/νf1/\nu_f1/νf​Telemetry
ForceFFFΔNFR\Delta\mathrm{NFR}ΔNFRStructural units
PotentialVVVΦs\Phi_sΦs​compute_structural_potential()
ActionSSSPhase accumulationDiagnostics

2.3 Derivation

Starting from the nodal equation:

∂EPI∂t=νf ΔNFR⇒dvdt=νf ΔNFRforce\frac{\partial\mathrm{EPI}}{\partial t} = \nu_f \, \Delta\mathrm{NFR} \quad \Rightarrow \quad \frac{dv}{dt} = \nu_f \, \Delta\mathrm{NFR}_{\mathrm{force}}∂t∂EPI​=νf​ΔNFR⇒dtdv​=νf​ΔNFRforce​

Substituting νf=1/m\nu_f = 1/mνf​=1/m yields F=maF = maF=ma under the inertial reading; departures introduce corrections proportional to ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣.

Regime refinement. The bare nodal equation is first order in time, so taken literally (EPI as a position-like coordinate, ΔNFR\Delta\mathrm{NFR}ΔNFR as force) it yields the overdamped drift law q˙=νf F\dot{q} = \nu_f\,Fq˙​=νf​F — velocity proportional to force, with νf\nu_fνf​ acting as a mobility, not an inverse mass. The genuine inertial Newtonian regime (q¨=F/m\ddot{q} = F/mq¨​=F/m, second order) demonstrated below — Keplerian orbits and the symplectic integrators of §2.5 — is realized through the second-order emergent symplectic substrate (Hamiltonian flow), not through the first-order nodal equation alone. Both regimes are empirically grounded but structurally distinct; see ../AGENTS.md §"Smooth-Trajectory Correspondence" and §"Emergent Symplectic Substrate".

2.4 Force Interpretation

Classical forceTNFR mechanismTelemetry observable
GravityPhase-coherence gradient−∇Φs-\nabla\Phi_s−∇Φs​ along trajectories
FrictionCoherence stabilizer (IL operator)Reduction of high-frequency ΔNFR\Delta\mathrm{NFR}ΔNFR
Harmonic restoringPhase-gradient confinement$

2.5 Integration Scheme

Symplectic integrators (Verlet/Yoshida 4th-order) in src/tnfr/dynamics/symplectic.py preserve structural invariants analogously to Liouville's theorem.

Workflow:

  1. Select integrator order; record in run metadata.
  2. Verify ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣ and KϕK_\phiKϕ​ remain within canonical thresholds during integration.
  3. Export telemetry (C(t)C(t)C(t), Φs\Phi_sΦs​, ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣) alongside classical observables (qqq, ppp, energy).
  4. Compare against analytic references; flag deviations beyond tolerance.

2.6 Validation

Kepler benchmark (examples/02_physics_regimes/12_classical_mechanics_demo.py): single node in coherence-gradient potential approximating an ellipse with eccentricity e≈0.5e \approx 0.5e≈0.5. Artifacts include trajectory overlays, phase-space loops, and conservation plots (energy/angular momentum drift target <10−4< 10^{-4}<10−4).


3. Inertial Regime (Zero Structural Pressure)

3.1 Regime Conditions

ΔNFR=0⇒∂EPI∂t=0 (co-moving frame)\Delta\mathrm{NFR} = 0 \quad \Rightarrow \quad \frac{\partial\mathrm{EPI}}{\partial t} = 0 \text{ (co-moving frame)}ΔNFR=0⇒∂t∂EPI​=0 (co-moving frame)

Practical checklist:

  • Exclude destabilizers (no OZ/VAL) from operator schedules.
  • Confirm ∣∇ϕ∣<10−4|\nabla\phi| < 10^{-4}∣∇ϕ∣<10−4 and Kϕ≈0K_\phi \approx 0Kϕ​≈0 over the interval.
  • Record initial phase current JϕJ_\phiJϕ​ as the momentum analog; verify C(t)>0.99C(t) > 0.99C(t)>0.99.

3.2 Constant-Velocity Motion

With zero ΔNFR\Delta\mathrm{NFR}ΔNFR, the structural state is frozen and nodes translate uniformly. This is the TNFR analog of Newton's first law: no reorganization pressure implies no change in the structural trajectory.

3.3 Validation

Two-train benchmark (examples/02_physics_regimes/15_train_crossing_demo.py):

ParameterTrain ATrain B
Initial positionx=0x = 0x=0 kmx=600x = 600x=600 km
Velocity+300+300+300 km/h−250-250−250 km/h
Operators[AL, IL, SHA][AL, IL, SHA]

Analytical prediction:

tc=600300+250≈1.0909 h,xc=300⋅tc≈327.27 kmt_c = \frac{600}{300 + 250} \approx 1.0909 \text{ h}, \quad x_c = 300 \cdot t_c \approx 327.27 \text{ km}tc​=300+250600​≈1.0909 h,xc​=300⋅tc​≈327.27 km

Numerical runs match within integration tolerance (<10−3< 10^{-3}<10−3); larger deviations indicate unintended structural forces.


4. Quantum Regime (High-Dissonance Limit)

4.1 Regime Conditions

High phase gradient (∣∇ϕ∣∼π|\nabla\phi| \sim \pi∣∇ϕ∣∼π), boundary reflections, or proximity to phase singularities (vortices). The classical approximation breaks down; discrete resonant modes emerge.

4.2 Observable Mapping

Quantum quantitySymbolTNFR analogueNotes
Wavefunctionψ\psiψComplex field Ψ=Kϕ+iJϕ\Psi = K_\phi + iJ_\phiΨ=Kϕ​+iJϕ​Curvature + current components
EnergyEEEStructural frequency νf\nu_fνf​Domain-specific proportionality
PotentialV(x)V(x)V(x)Φs(x)\Phi_s(x)Φs​(x)Identical boundary conditions
Quantum numbernnnWinding number www∮∇ϕ=2πw\oint \nabla\phi = 2\pi w∮∇ϕ=2πw
Collapse—Decoherence via IL/SHAGrammar U2 enforcement

4.3 Quantization Mechanism

  1. Evolution: Nodes follow ∂EPI/∂t=νf ΔNFR\partial\mathrm{EPI}/\partial t = \nu_f \, \Delta\mathrm{NFR}∂EPI/∂t=νf​ΔNFR.
  2. Boundary feedback: Reflections inside finite domains superimpose outgoing and incoming phase waves.
  3. Interference: Coherent modes form when accumulated phase matches 2πw2\pi w2πw (w∈Zw \in \mathbb{Z}w∈Z); otherwise ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣ spikes and coherence degrades.
  4. Selection: Stabilizers drive the system toward minimal ΔNFR\Delta\mathrm{NFR}ΔNFR, retaining only resonant modes.

Quantized spectra arise from the boundary conditions and resonant mode selection described above, without invoking additional axioms beyond the nodal equation. Superposition of EPI states is the default behavior of linear wave dynamics; "collapse" is the decoherence process where environmental coupling selects eigenstates (grammar rule U2).

4.4 Validation

One-dimensional cavity benchmark (examples/02_physics_regimes/13_quantum_mechanics_demo.py): define cavity length LLL, initialize with random νf\nu_fνf​ and phase profile (C(t0)>0.6C(t_0) > 0.6C(t0​)>0.6), integrate until νf\nu_fνf​ converges. Expected outcome: discrete νn\nu_nνn​ proportional to n2n^2n2 (linear dispersion) or nnn (other media).


5. Structural Uncertainty and Interference

5.1 Uncertainty Relation

For wave packets occupying time window ΔtEPI\Delta t_{\mathrm{EPI}}ΔtEPI​ with structural frequency spread Δνf\Delta\nu_fΔνf​:

ΔtEPI⋅Δνf≥K(1)\Delta t_{\mathrm{EPI}} \cdot \Delta\nu_f \geq K \tag{1}ΔtEPI​⋅Δνf​≥K(1)

where KKK depends on the analysis window (Gaussian packets yield K≈0.16K \approx 0.16K≈0.16). This emerges from the Fourier relationship between form (EPI) and frequency (νf\nu_fνf​): localizing a pattern in structural space increases its frequency spread, and conversely.

5.2 Two-Path Interference

The double-slit experiment maps to two emission nodes executing [AL, RA] into a propagation medium. Receiving nodes integrate Ψ=Kϕ+iJϕ\Psi = K_\phi + iJ_\phiΨ=Kϕ​+iJϕ​ and report per-pixel telemetry:

  • Constructive bands: Δϕ≈0\Delta\phi \approx 0Δϕ≈0 → increased C(t)C(t)C(t) and SiSiSi.
  • Destructive bands: Δϕ≈π\Delta\phi \approx \piΔϕ≈π → elevated ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣ and reduced C(t)C(t)C(t).

Interference is described entirely through phase-coupled dynamics. No wave/particle duality narrative is invoked; only structural metrics.

5.3 Validation

examples/02_physics_regimes/14_uncertainty_and_interference.py generates: scatter of σt\sigma_tσt​ vs. σf\sigma_fσf​ with constant-product reference line, 2D detector intensity maps, and fringe-spacing line profiles.

Note: The example demonstrates qualitative uncertainty behavior (constant σt⋅σf\sigma_t \cdot \sigma_fσt​⋅σf​ product) but does not validate the product against a specific analytical bound. The double-slit section is incomplete. No dedicated test module exists.


6. Thermodynamic Laws from Phase Dynamics

Note: This section describes a demonstration-level correspondence. The example 17_thermodynamics_demo.py implements a Kuramoto model where "temperature" is defined as ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣, but does not extract a time constant or validate quantitatively against Newton's law of cooling. No dedicated test module exists. Promotion to verified status requires: (a) extraction of decay constant kkk from simulation, (b) quantitative comparison with the analytical form T(t)=Tenv+(T0−Tenv)e−ktT(t) = T_{\mathrm{env}} + (T_0 - T_{\mathrm{env}})e^{-kt}T(t)=Tenv​+(T0​−Tenv​)e−kt, and (c) a dedicated test file.

6.1 Observable Mapping

Thermodynamic quantityTNFR interpretationSymbol
Heat (QQQ)Incoherent phase noiseσϕ\sigma_\phiσϕ​
Temperature (TTT)Local phase-gradient variance$\mathrm{Var}(
Entropy (SSS)Structural decoherenceS∝1/C(t)S \propto 1/C(t)S∝1/C(t)
EquilibriumPhase synchronizationΔϕ→0\Delta\phi \to 0Δϕ→0

6.2 Zeroth Law — Resonant Transitivity

If node A and node C satisfy ∣ϕA−ϕC∣≤Δϕmax⁡|\phi_A - \phi_C| \leq \Delta\phi_{\max}∣ϕA​−ϕC​∣≤Δϕmax​, and node B satisfies the same relation with C, then ∣ϕA−ϕB∣|\phi_A - \phi_B|∣ϕA​−ϕB​∣ automatically respects the bound. Coupling operators (UM, RA) enforce this check before activation per grammar rule U3.

6.3 First Law — Structural Balance

Structural current is conserved up to explicit operator work:

ΔEtotal=ΔEcoherent+ΔEincoherent\Delta E_{\mathrm{total}} = \Delta E_{\mathrm{coherent}} + \Delta E_{\mathrm{incoherent}}ΔEtotal​=ΔEcoherent​+ΔEincoherent​

In closed experiments, the sum over JϕJ_\phiJϕ​ remains constant. This accounts for how resonance-preserving work (coherent) and decohering work (incoherent) partition the same nodal update.

6.4 Second Law — Passive Desynchronization

Without stabilizers (IL, THOL), random perturbations drive the network toward larger ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣ and reduced coherence. Operators lacking closure steps predictably lose C(t)C(t)C(t), producing the familiar time arrow without additional hypotheses.

6.5 Validation

Coffee-cup cooling benchmark: 2D lattice with a high-νf\nu_fνf​, random-phase central patch (sample) surrounded by an aligned-phase, low-νf\nu_fνf​ outer ring (bath). Dynamics follow the coupled-oscillator form:

dϕidt=ωi+KN∑j∈N(i)sin⁡(ϕj−ϕi)\frac{d\phi_i}{dt} = \omega_i + \frac{K}{N}\sum_{j \in \mathcal{N}(i)} \sin(\phi_j - \phi_i)dtdϕi​​=ωi​+NK​j∈N(i)∑​sin(ϕj​−ϕi​)

The phase-gradient mismatch decays exponentially:

T(t)=Tenv+(T0−Tenv) e−ktT(t) = T_{\mathrm{env}} + (T_0 - T_{\mathrm{env}}) \, e^{-kt}T(t)=Tenv​+(T0​−Tenv​)e−kt

obtaining a form analogous to Newton's law of cooling from nodal dynamics.


7. Regime Transition Summary

The five regimes form a coherent hierarchy indexed by the degree of structural dissonance:

| Regime | ΔNFR\Delta\mathrm{NFR}ΔNFR | ∣∇ϕ∣|\nabla\phi|∣∇ϕ∣ | Primary telemetry | Governing reduction | |--------|---------------------|----------------|-------------------|-------------------| | Inertial | =0= 0=0 | <10−4< 10^{-4}<10−4 | JϕJ_\phiJϕ​ (momentum) | Constant velocity | | Classical mechanics | Low | →0\to 0→0 | Φs\Phi_sΦs​, JϕJ_\phiJϕ​ | F=maF = maF=ma | | Thermodynamic | Distributed | Moderate | Var(∣∇ϕ∣)\mathrm{Var}(|\nabla\phi|)Var(∣∇ϕ∣), C(t)C(t)C(t) | Cooling laws | | Quantum | High | ∼π\sim \pi∼π | Ψ\PsiΨ, winding number | Discrete eigenvalues | | Uncertainty | High + localized | Broadband | σtσf\sigma_t \sigma_fσt​σf​ product | Fourier bound |

All regimes emerge from the same nodal equation as limiting cases under different parameter conditions. The correspondences to established physics are structural analogies that demonstrate the internal consistency of the TNFR formalism, not derivations of those physical theories from first principles.


8. Implementation Reference

ComponentLocation
Classical mechanics mappersrc/tnfr/physics/classical_mechanics.py
Quantum mechanics modulesrc/tnfr/physics/quantum_mechanics.py
Symplectic integratorssrc/tnfr/dynamics/symplectic.py
Structural field computationsrc/tnfr/physics/fields.py
Kepler benchmarkexamples/02_physics_regimes/12_classical_mechanics_demo.py
Quantum cavity benchmarkexamples/02_physics_regimes/13_quantum_mechanics_demo.py
Uncertainty/interferenceexamples/02_physics_regimes/14_uncertainty_and_interference.py
Two-train kinematicsexamples/02_physics_regimes/15_train_crossing_demo.py

Implementation & Examples

TNFR ↔ Classical Mechanics Dictionary

Originally docs/TNFR_CLASSICAL_MAPPING.md. Consolidated here as the canonical mapping reference.

Scope: Applies to low-dissonance, high-coherence regimes where TNFR reproduces Newtonian behavior (see src/tnfr/dynamics/nbody.py).

TNFR QuantityDefinition (TNFR)Classical AnalogNotes
EPICoherent form (spatial + kinematic state)Generalized coordinates qqq, velocities q˙\dot{q}q˙​Structural Triad
νfReorganization rate (Hz_str)Inertial mass via m=1/νfm = 1/\nu_fm=1/νf​High νf → low inertia
ΔNFRStructural pressureGeneralized force F=−∇UF = -\nabla UF=−∇UHamiltonian-derived
Φ_sInverse-square ΔNFR accumulationPotential energy U(q)U(q)U(q)U6 confinement ↔ potential wells
|∇φ|Local desynchronizationStress/strain rate, tidal gradientsShear force analog
K_φPhase torsionCurvature-induced forces (centripetal)Geometric confinement
ξ_CCorrelation decay scaleInteraction range / mean free pathLarge ξ_C → long-range forces
Ψ = K_φ + i·J_φComplex geometric fieldComplexified action densityHamilton-Jacobi analog
Operator sequencesCanonical transformationsWork/impulse protocolsGrammar U1-U6 ↔ mechanical admissibility

Structural Triad ↔ Phase Space:

  • Form (EPI) → Canonical coordinates (q,p)(q, p)(q,p)
  • Frequency (νf) → Mass/inertia mmm
  • Phase (φ/θ) → Canonical phase (action-angle coordinates)

Field Tetrad ↔ Energetics:

  • Φ_s → potential wells; ΔΦs<π/2\Delta\Phi_s < \pi/2ΔΦs​<π/2 mirrors bounded energy basins
  • |∇φ| → velocity potential gradient (fluid mechanics analog)
  • K_φ → curvature-induced forces (centripetal/Coriolis terms)
  • ξ_C → interaction range; large ξ_C produces long-range coupling analogous to gravitational/electromagnetic interactions, small ξ_C mimics contact forces

Executable Demonstrations

ExampleConcept from this document
11_classical_limit_comparison.pyTNFR vs classical N-body comparison
12_classical_mechanics_demo.pyKeplerian orbits from symplectic integrator
13_quantum_mechanics_demo.pyEmergent quantization from resonant standing waves
14_uncertainty_and_interference.pyStructural uncertainty (ΔForm·Δνf ≥ K), double slit
15_train_crossing_demo.pyFree-particle classical kinematics

Key Source Modules

  • src/tnfr/physics/classical_mechanics.py — Classical limit (Keplerian orbits, Newton's laws)
  • src/tnfr/physics/quantum_mechanics.py — Quantum regime (quantization, superposition)

9. References

  • FUNDAMENTAL_THEORY.md — the structural-field tetrad
  • UNIFIED_GRAMMAR_RULES.md — U1–U6 derivations
  • STRUCTURAL_CONSERVATION_THEOREM.md — Conservation laws
  • TNFR_VARIATIONAL_PRINCIPLE.md — Lagrangian formulation
  • GLOSSARY.md — Operational definitions