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

STRUCTURAL_STABILITY_AND_DYNAMICS.md

Structural Stability and Dynamics

This document collects the stability analysis, phase transition theory, lifecycle dynamics, and integrity monitoring that emerge from the nodal equation ∂EPI/∂t=νf⋅ΔNFR(t)\partial\mathrm{EPI}/\partial t = \nu_f \cdot \Delta\mathrm{NFR}(t)∂EPI/∂t=νf​⋅ΔNFR(t). Each section corresponds to a verified implementation in the codebase.

Status: CANONICAL — All results derived from the nodal equation and validated computationally.


1. Lyapunov Stability Analysis

1.1 Energy Functional

The structural energy functional serves as a Lyapunov candidate:

E[G]=12∑i[Φs(i)2+∣∇ϕ∣(i)2+Kϕ(i)2+Jϕ(i)2+JΔNFR(i)2]E[G] = \frac{1}{2}\sum_i \left[\Phi_s(i)^2 + |\nabla\phi|(i)^2 + K_\phi(i)^2 + J_\phi(i)^2 + J_{\Delta\mathrm{NFR}}(i)^2\right]E[G]=21​i∑​[Φs​(i)2+∣∇ϕ∣(i)2+Kϕ​(i)

For grammar-compliant evolution: dE/dt≤0dE/dt \le 0dE/dt≤0 (Lyapunov stability).

1.2 Per-Operator Lyapunov Role

The structural energy functional EEE above is emergent: it is built entirely from the tetrad fields (Φs,∣∇ϕ∣,Kϕ,Jϕ,JΔNFR)(\Phi_s, |\nabla\phi|, K_\phi, J_\phi, J_{\Delta\mathrm{NFR}})(Φs​,∣∇ϕ∣,Kϕ​,Jϕ​,JΔNFR​) and contains no EPI\mathrm{EPI}EPI or νf\nu_fνf​ term. Measured directly: scaling the form EPI\mathrm{EPI}EPI or the capacity νf\nu_fνf​ on every node leaves EEE unchanged (ΔE=0\Delta E = 0ΔE=0), while the phase θ\thetaθ (through ∣∇ϕ∣,Kϕ,Jϕ|\nabla\phi|, K_\phi, J_\phi∣∇ϕ∣,Kϕ​,Jϕ​) and the structural pressure ΔNFR\Delta\mathrm{NFR}ΔNFR (through Φs,JΔNFR\Phi_s, J_{\Delta\mathrm{NFR}}Φs​,JΔNFR​) do enter it. The coherence C(t)=1/(1+mean∣ΔNFR∣+mean∣dEPI∣)C(t) = 1/(1 + \mathrm{mean}|\Delta\mathrm{NFR}| + \mathrm{mean}|\mathrm{dEPI}|)C(t)=1/(1+mean∣ΔNFR∣+mean∣dEPI∣) likewise responds to the pressure channel. Both Lyapunov candidates share one structural-pressure channel, ∣ΔNFR∣|\Delta\mathrm{NFR}|∣ΔNFR∣.

Consequently each operator's Lyapunov role is its canonical grammar U2 role, derived from config.physics_derivation (the single source of truth, identical to the U2 stabiliser/destabiliser classification) — not a separate energy algebra. An operator contracts the Lyapunov functional iff it provides negative feedback on ∣ΔNFR∣|\Delta\mathrm{NFR}|∣ΔNFR∣, and expands it iff it raises ∣ΔNFR∣|\Delta\mathrm{NFR}|∣ΔNFR∣. The contraction/expansion rate is the operator's own structural-pressure factor.

Stabilisers (ΔE≤0\Delta E \le 0ΔE≤0 — reduce ∣ΔNFR∣|\Delta\mathrm{NFR}|∣ΔNFR∣)

OperatorPressure factorContraction rate ρ\rhoρ
IL (Coherence)f=0.75f = 0.75f=0.75 (operational)ρ=1−f=0.25\rho = 1 - f = 0.25ρ=1−f=0.25
THOL (Self-organization)accel =0.10= 0.10=0.10ρ≈0.100\rho \approx 0.100ρ≈0.100

Destabilisers (ΔE≤κ⋅E\Delta E \le \kappa \cdot EΔE≤κ⋅E — raise ∣ΔNFR∣|\Delta\mathrm{NFR}|∣ΔNFR∣)

OperatorPressure factorExpansion rate κ\kappaκ
OZ (Dissonance)f=2.0f = 2.0f=2.0 (operational)κ=f−1=1.0\kappa = f - 1 = 1.0κ=f−1=1.0
ZHIR (Mutation)θ\thetaθ-shift =0.30= 0.30=0.30κ≈0.300\kappa \approx 0.300κ≈0.300
VAL (Expansion)νf\nu_fνf​-scale ≈1.068\approx 1.068≈1.068κ≈0.068\kappa \approx 0.068κ≈0.068

Neutral (ΔE≈0\Delta E \approx 0ΔE≈0 by grammatical role)

OperatorsChannelWhy neutral
AL, EN, RA, REMESHEPI (the form, LHS)Write the left-hand side of the nodal equation, absent from EEE
UMθ\thetaθ (phase)Coupling via U3 phase sync; no net $
SHAνf\nu_fνf​ (capacity)Freezes νf\nu_fνf​, absent from EEE
NULνf\nu_fνf​ + ΔNFR\Delta\mathrm{NFR}ΔNFRPulls both levers; net role not a pure stabiliser/destabiliser
NAVΔNFR\Delta\mathrm{NFR}ΔNFR (controlled)Controlled trajectory, excluded from the U2 destabiliser set

Dual-lever vs Lyapunov role: The dual-lever structure (STRUCTURAL_OPERATORS.md §17.1) classifies operators by which right-hand-side factor of the nodal equation they modulate — the capacity lever νf\nu_fνf​ (UM, SHA, VAL), the pressure lever ΔNFR\Delta\mathrm{NFR}ΔNFR (IL, OZ, THOL, ZHIR, NAV), both (NUL), or neither/the form on the LHS (AL, EN, RA, REMESH). The Lyapunov role above is the grammar U2 role (stabiliser/destabiliser), which depends on the sign of the ∣ΔNFR∣|\Delta\mathrm{NFR}|∣ΔNFR∣ feedback: VAL engages the capacity lever yet is a U2 destabiliser, while NAV engages the pressure lever yet is U2-neutral because its trajectory is controlled. The two classifications are related but distinct. See example 39 and src/tnfr/physics/lyapunov.py.

1.3 Grammar U2 Lyapunov Theorem

Grammar rule U2 (CONVERGENCE & BOUNDEDNESS) requires that every destabiliser be accompanied by a stabiliser. The formal proof shows that the net energy change across a grammar-compliant sequence is non-positive:

∑opsΔEop≤0(for any U2-compliant sequence)\sum_{\text{ops}} \Delta E_{\text{op}} \le 0 \quad\text{(for any U2-compliant sequence)}ops∑​ΔEop​≤0(for any U2-compliant sequence)

This confirms Lyapunov stability for the full 13-operator algebra.

Refinement: The formal bound ∑ΔEop≤0\sum \Delta E_{\text{op}} \le 0∑ΔEop​≤0 is sufficient but not necessary for energy descent. Experimental observation (example 38) shows grammar-compliant sequences with cumulative Lyapunov product Π≈1.288\Pi \approx 1.288Π≈1.288 (formally non-contractive) that still achieve net energy decrease (ΔE=−9.59\Delta E = -9.59ΔE=−9.59). The multiplicative bound is conservative because operator interactions on the shared graph state are nonlinear.

1.4 Spectral Gap Characterisation

The algebraic connectivity λ1\lambda_1λ1​ of the graph Laplacian controls the relaxation time:

QuantityExpressionPhysical meaning
Relaxation timeτ=1/λ1\tau = 1/\lambda_1τ=1/λ1​Time for diffusive equilibration
Mixing timetmix∼ln⁡(N)/λ1t_{\text{mix}} \sim \ln(N)/\lambda_1tmix​∼ln(N)/λ1​Time to reach near-equilibrium
Cheeger boundh2/(2dmax⁡)≤λ1h^2/(2d_{\max}) \le \lambda_1h2/(2dmax​)≤λ1​Lower bound from expansion

Implementation: src/tnfr/physics/lyapunov.py — OperatorStabilityClass, OperatorEnergyBound, LyapunovPerOperator, analyze_spectral_gap().


2. Phase Transitions

2.1 Order Parameter

The symmetry breaking field S\mathcal{S}S serves as the order parameter for phase transitions:

S(i)=(∣∇ϕ∣2−Kϕ2)+(Jϕ2−JΔNFR2)\mathcal{S}(i) = \left(|\nabla\phi|^2 - K_\phi^2\right) + \left(J_\phi^2 - J_{\Delta\mathrm{NFR}}^2\right)S(i)=(∣∇ϕ∣2−Kϕ2​)+(Jϕ2​−JΔNFR2​)

2.2 Phase Classification

The phase is decided by the sampling-noise z-score of the symmetry breaking, z=∣⟨S⟩∣/SEz = |\langle\mathcal{S}\rangle| / \mathrm{SE}z=∣⟨S⟩∣/SE with SE=Var(S)/N\mathrm{SE} = \sqrt{\mathrm{Var}(\mathcal{S})/N}SE=Var(S)/N​ — the statistical significance measured from the system itself. The only cut is z=1z = 1z=1 (one sampling sigma); likewise zχz_\chizχ​ for the chirality field.

PhaseConditionPhysical meaning
NON_LIFEz≤1z \le 1z≤1⟨S⟩\langle\mathcal{S}\rangle⟨S⟩ within sampling noise of zero (symmetric)
LIFEz>1z > 1z>1 AND zχ>1z_\chi > 1zχ​>1significant symmetry breaking + homochirality
CRITICALz>1z > 1z>1 AND zχ≤1z_\chi \le 1zχ​≤1broken magnitude, no preferred handedness

2.3 Critical Exponent (measured observable)

Near the critical point the order parameter follows a power law:

∣⟨S⟩∣∼∣p−pc∣β|\langle\mathcal{S}\rangle| \sim |p - p_c|^{\beta}∣⟨S⟩∣∼∣p−pc​∣β

The exponent β\betaβ is an observable to be measured (fit_critical_exponent), not a derived universal constant. A measurement across sweep protocols gives protocol-dependent values, so there is no universal closed-form exponent. The constant γ/π≈0.1837\gamma/\pi \approx 0.1837γ/π≈0.1837 is retained only as a calibrated reference / noise-floor scale (TIER-2), not a prediction of the nodal equation.

2.4 Constants

ConstantValueStatus
Reference scale≈π/16≈0.196\approx \pi/16 \approx 0.196≈π/16≈0.196Heuristic early-warning (operational, not a derived universal exponent)
Noise floor≈0.034\approx 0.034≈0.034Calibrated detection threshold (operational)
Chirality threshold≈0.155\approx 0.155≈0.155Calibrated TIER-2 reference (operational)

2.5 Susceptibility

The structural susceptibility diverges at the critical point:

χS(t)=N⋅Var⁡(S)\chi_{\mathcal{S}}(t) = N \cdot \operatorname{Var}(\mathcal{S})χS​(t)=N⋅Var(S)

2.6 Critical Exponent Fitting

For systems near the transition, the critical exponent can be fit from the scaling law ∣⟨S⟩∣∼∣p−pc∣γfit|\langle\mathcal{S}\rangle| \sim |p - p_c|^{\gamma_{\text{fit}}}∣⟨S⟩∣∼∣p−pc​∣γfit​. The theoretical prediction γfit→γ/π\gamma_{\text{fit}} \to \gamma/\piγfit​→γ/π serves as validation.

Implementation: src/tnfr/physics/phase_transition.py — Phase enum, PhaseTransitionTelemetry, PhaseSnapshot, compute_order_parameter(), classify_phase(), detect_phase_transition(), fit_critical_exponent().


3. Self-Sustaining Dynamics and Autopoiesis

3.1 Autopoietic Coefficient

The autopoietic coefficient measures a system's capacity for self-generation relative to external driving:

A(t)=⟨G(EPI)⋅∂EPI/∂t⟩⟨∣ΔNFRext∣2⟩A(t) = \frac{\langle G(\mathrm{EPI}) \cdot \partial\mathrm{EPI}/\partial t\rangle}{\langle|\Delta\mathrm{NFR}_{\text{ext}}|^2\rangle}A(t)=⟨∣ΔNFRext​∣2⟩⟨G(EPI)⋅∂EPI/∂t⟩​

where the self-generation function follows logistic growth:

G(EPI)=γ ∥EPI∥(1−∥EPI∥EPImax⁡)G(\mathrm{EPI}) = \gamma\,\|\mathrm{EPI}\|\left(1 - \frac{\|\mathrm{EPI}\|}{\mathrm{EPI}_{\max}}\right)G(EPI)=γ∥EPI∥(1−EPImax​∥EPI∥​)

3.2 Self-Sustaining Threshold

A(t)>1.0  ⟹  Self-sustaining dynamicsA(t) > 1.0 \implies \text{Self-sustaining dynamics}A(t)>1.0⟹Self-sustaining dynamics

When A>1A > 1A>1, the system generates more structural change through self-organisation than through external forcing — the defining property of autopoietic systems in the sense of Maturana & Varela.

3.3 Auxiliary Indices

IndexDefinitionInterpretation
Vitality ViV_iVi​γ ∥EPI∥(1−∥EPI∥/EPImax⁡)\gamma\,\|\mathrm{EPI}\|(1 - \|\mathrm{EPI}\|/\mathrm{EPI}_{\max})γ∥EPI∥(1−∥EPI∥/EPImax​)Self-generation capacity
Self-Organisation SSS$\varepsilon,\partial G/\partial|\mathrm{EPI}|
Stability Margin MMM(∥EPI∥−EPImax⁡/2)/EPImax⁡(\|\mathrm{EPI}\| - \mathrm{EPI}_{\max}/2)/\mathrm{EPI}_{\max}(∥EPI∥−EPImax​/2)/

3.4 Self-Sustaining Threshold Detection

The threshold time tselft_{\text{self}}tself​ is found by interpolation at the A(t)=1.0A(t) = 1.0A(t)=1.0 crossing. The LifeTelemetry dataclass records the complete trajectory (Vi(t),A(t),S(t),M(t))(V_i(t), A(t), S(t), M(t))(Vi​(t),A(t),S(t),M(t)).

Implementation: src/tnfr/physics/life.py — detect_life_emergence(), LifeTelemetry dataclass.


4. Node Lifecycle

4.1 Lifecycle States

Each TNFR node passes through a sequence of canonical states determined by its structural attributes:

StateConditionPhysical meaning
DORMANTνf<activation threshold\nu_f < \text{activation threshold}νf​<activation thresholdBelow activation energy
ACTIVATIONνf\nu_fνf​ increasing, ΔNFR\Delta\mathrm{NFR}ΔNFR growingEnergy accumulation
STABILIZATIONHigh C(t)C(t)C(t), low $\Delta\mathrm{NFR}
PROPAGATIONHigh phase couplingPattern spreading via UM/RA
MUTATIONHigh $\Delta\mathrm{NFR}
COLLAPSINGLosing coherenceApproaching dissolution
COLLAPSEDνf→0\nu_f \to 0νf​→0, EPI dissolvedTerminal state

Priority order for classification: mutation > propagation > stabilization > activation > dormant. Collapse is checked first.

4.2 Collapse Conditions

Four canonical collapse reasons, checked in priority order:

Collapse reasonConditionPhysical basis
Frequency failureνf<collapse threshold\nu_f < \text{collapse threshold}νf​<collapse thresholdFundamental reorganisation capacity lost
Extreme dissonance$\Delta\mathrm{NFR}
Network decouplingPhase coherence below minimumLoss of resonance with neighbours
EPI dissolutionEPI→0\mathrm{EPI} \to 0EPI→0Form completely degraded

4.3 Default Thresholds

ParameterDefaultSource
Activation threshold0.10.10.1 (min νf\nu_fνf​)Operational
Collapse threshold0.010.010.01 (min νf\nu_fνf​)Operational
Bifurcation threshold10.010.010.0 (max $\Delta\mathrm{NFR}
Stabilization ΔNFR\Delta\mathrm{NFR}ΔNFR1.01.01.0Operational
Stabilization coherence0.80.80.8Operational
Propagation coupling0.70.70.7Operational
Mutation ΔNFR\Delta\mathrm{NFR}ΔNFR5.05.05.0Operational (ZHIR threshold, free parameter)

Implementation: src/tnfr/operators/lifecycle.py — LifecycleState, CollapseReason, get_lifecycle_state(), check_collapse_conditions().


5. Internal Hamiltonian Construction

5.1 Definition

The internal Hamiltonian governs structural evolution:

H^int=H^coh+H^freq+H^coupling\hat{H}_{\text{int}} = \hat{H}_{\text{coh}} + \hat{H}_{\text{freq}} + \hat{H}_{\text{coupling}}H^int​=H^coh​+H^freq​+H^coupling​

5.2 Components

Coherence potential (attractive interaction):

H^coh=−C0∑i,jwij ∣i⟩⟨j∣\hat{H}_{\text{coh}} = -C_0 \sum_{i,j} w_{ij}\,|i\rangle\langle j|H^coh​=−C0​i,j∑​wij​∣i⟩⟨j∣

where wijw_{ij}wij​ is the coherence weight from structural similarity and C0=−1.0C_0 = -1.0C0​=−1.0 (attractive).

Frequency operator (diagonal):

H^freq=∑iνf,i ∣i⟩⟨i∣\hat{H}_{\text{freq}} = \sum_i \nu_{f,i}\,|i\rangle\langle i|H^freq​=i∑​νf,i​∣i⟩⟨i∣

Each node's νf\nu_fνf​ becomes its diagonal energy.

Coupling Hamiltonian (topology):

H^coupling=J0∑(i,j)∈E(∣i⟩⟨j∣+∣j⟩⟨i∣)\hat{H}_{\text{coupling}} = J_0 \sum_{(i,j) \in E} \left(|i\rangle\langle j| + |j\rangle\langle i|\right)H^coupling​=J0​(i,j)∈E∑​(∣i⟩⟨j∣+∣j⟩⟨i∣)

All components are N×NN \times NN×N Hermitian matrices (NNN = number of nodes).

5.3 Time Evolution

The unitary time evolution operator:

U(t)=exp⁡(−i H^int t / ℏstr)U(t) = \exp\left(-i\,\hat{H}_{\text{int}}\,t\,/\,\hbar_{\text{str}}\right)U(t)=exp(−iH^int​t/ℏstr​)

Propagates states: ∣ψ(t)⟩=U(t)∣ψ(0)⟩|\psi(t)\rangle = U(t)|\psi(0)\rangle∣ψ(t)⟩=U(t)∣ψ(0)⟩.

5.4 Energy Spectrum

The eigenvalue equation:

H^int∣ϕn⟩=En∣ϕn⟩\hat{H}_{\text{int}}|\phi_n\rangle = E_n|\phi_n\rangleH^int​∣ϕn​⟩=En​∣ϕn​⟩

gives stationary states ∣ϕn⟩|\phi_n\rangle∣ϕn​⟩ with energies EnE_nEn​ (maximally stable configurations).

5.5 ΔNFR from Hamiltonian

The ΔNFR\Delta\mathrm{NFR}ΔNFR operator follows from the Hamiltonian commutator:

ΔNFR=iℏstr H^int\Delta\mathrm{NFR} = \frac{i}{\hbar_{\text{str}}}\,\hat{H}_{\text{int}}ΔNFR=ℏstr​i​H^int​

Per-node: ΔNFRn=(i/ℏstr)⟨n∣[H^int,ρn]∣n⟩\Delta\mathrm{NFR}_n = (i/\hbar_{\text{str}})\langle n|[\hat{H}_{\text{int}}, \rho_n]|n\rangleΔNFRn​=(i/ℏstr​)⟨n∣[H^int​,ρn​]∣n⟩ where ρn=∣n⟩⟨n∣\rho_n = |n\rangle\langle n|ρn​=∣n⟩⟨n∣.

Implementation: src/tnfr/operators/hamiltonian.py — InternalHamiltonian class with get_spectrum(), time_evolution_operator(), compute_delta_nfr_operator().


6. Structural Integrity Monitor

6.1 Purpose

The integrity monitor verifies postconditions of all 13 canonical operators after each application. This closes the loop between theoretical contracts and runtime behaviour.

6.2 Postconditions (13/13 Operators)

OperatorContract verified
AL (Emission)EPI\mathrm{EPI}EPI not decreased (∂EPI/∂t≥0\partial\mathrm{EPI}/\partial t \ge 0∂EPI/∂t≥0)
EN (Reception)C(t)C(t)C(t) not decreased
IL (Coherence)C(t)C(t)C(t) not decreased (outside dissonance test)
OZ (Dissonance)$
UM (Coupling)Phase compatibility $
RA (Resonance)EPI structural identity (sign/kind) preserved
SHA (Silence)EPI preserved over time; νf\nu_fνf​ frozen
VAL (Expansion)νf\nu_fνf​ not decreased (capacity added)
NUL (Contraction)νf\nu_fνf​ not increased (capacity removed)
THOL (Self-org)Global form preserved; sub-EPIs created
ZHIR (Mutation)Phase θ\thetaθ changed when ΔEPI/Δt>ξ\Delta\mathrm{EPI}/\Delta t > \xiΔEPI/Δt>ξ
NAV (Transition)Controlled trajectory; no coherence collapse
REMESH (Recursivity)Nested structure maintained; parent identity preserved

6.3 Monitor Modes

ModeBehaviour
OFFNo checking (production performance)
OBSERVELog violations without blocking
ENFORCERaise StructuralIntegrityViolation on failure

6.4 Corrective Suggestions

When a violation is detected in OBSERVE or ENFORCE mode, the monitor provides corrective suggestions (e.g. "apply IL after OZ to restore convergence").

Implementation: src/tnfr/physics/integrity.py — IntegrityReport, IntegritySummary, MonitorMode, StructuralIntegrityViolation, POSTCONDITIONS registry.

Tests: tests/test_integrity.py


Implementation Reference

ModuleContent
src/tnfr/physics/lyapunov.pyPer-operator energy bounds, spectral gap analysis
src/tnfr/physics/phase_transition.pyOrder parameter, phase classification, critical exponent
src/tnfr/physics/life.pyAutopoietic coefficient, self-sustaining threshold detection
src/tnfr/operators/lifecycle.pyNode states, collapse conditions
src/tnfr/operators/hamiltonian.pyInternal Hamiltonian, time evolution, spectrum
src/tnfr/physics/integrity.py13/13 postconditions, monitor modes

Implementation & Examples

SDK Entry Points

python
from tnfr.sdk import TNFR

net = TNFR.create(20).ring().evolve(5)
report = net.integrity_check()    # IntegrityReport (13/13 operators)

Executable Demonstrations

ExampleConcept from this document
29_lyapunov_stability_demo.pyAll 13 operator Lyapunov bounds, energy class taxonomy, U2 net-contractivity proof, spectral gap, self-sustaining dynamics/autopoiesis

Key Source Modules

  • src/tnfr/physics/integrity.py — Structural integrity monitor (13/13 operator postconditions)
  • src/tnfr/physics/conservation.py — Energy functional (Lyapunov candidate)
  • src/tnfr/physics/phase_transition.py — Phase transition detection
  • src/tnfr/operators/lifecycle.py — Node lifecycle management

Cross-References

  • Lyapunov energy in conservation: STRUCTURAL_CONSERVATION_THEOREM.md §8
  • Grammar U2 (convergence): UNIFIED_GRAMMAR_RULES.md
  • Hamiltonian/Lagrangian formulation: TNFR_VARIATIONAL_PRINCIPLE.md
  • Order parameter S\mathcal{S}S: EXTENDED_FIELDS_AND_DERIVED_QUANTITIES.md §3.2
  • Dissipative extensions: DISSIPATIVE_AND_OPEN_SYSTEMS.md
  • Gauge structure: GAUGE_SYMMETRY_AND_UNIFICATION.md
2
+
Jϕ​
(
i
)2
+
JΔNFR​
(
i
)2
]
EPI
max​
Position relative to carrying capacity