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_OPERATORS.md

STRUCTURAL_OPERATORS.md

TNFR Structural Operators

Complete Specification of the 13 Canonical Operators

Status: CANONICAL — All operators derived from the nodal equation
Date: March 2026
Version: 0.0.3.3
Prerequisite: FUNDAMENTAL_THEORY.md §2 (Nodal Equation), UNIFIED_GRAMMAR_RULES.md (Grammar U1–U6)


Table of Contents

  1. Scope and Motivation
  2. Operator Algebra from the Nodal Equation
  3. The Operator Taxonomy
  4. Generators
  5. Integrator
  6. Stabilizers
  7. Destabilizers
  8. Coupling and Propagation
  9. Transformers
  10. Closure and Regime Operators
  11. Canonical Compositions
  12. Per-Operator Energy Bounds
  13. Postcondition Contracts
  14. Operator Constants Reference
  15. Implementation Reference
  16. Summary
  17. Experimental Operator-Tetrad Synergies

1. Scope and Motivation

Structural operators are the exclusive mechanism for modifying node state in TNFR networks. No direct mutation of EPI, νf\nu_fνf​, θ\thetaθ, or ΔNFR\Delta\text{NFR}ΔNFR is permitted outside the operator algebra. This constraint is not a coding convention; it follows from the physics of the nodal equation:

∂EPI∂t=νf⋅ΔNFR(t)(NE)\frac{\partial \text{EPI}}{\partial t} = \nu_f \cdot \Delta\text{NFR}(t) \tag{NE}∂t∂EPI​=νf​⋅ΔNFR(t)(NE)

Each operator implements a specific transformation of the right-hand side of (NE). The 13 operators collectively span the space of physically meaningful structural transformations on a TNFR graph: creation, integration, stabilization, destabilization, coupling, propagation, freezing, dimensional change, self-organization, phase transformation, regime transition, and multi-scale recursion.

1.1 Why Exactly 13

The operator count is not arbitrary. The 13 operators arise from exhaustive enumeration of independent transformations of the structural triad (EPI,νf,ϕ)(\text{EPI}, \nu_f, \phi)(EPI,νf​,ϕ) subject to:

  1. Nodal equation compatibility: Every transformation must be expressible as a modification of νf\nu_fνf​, ΔNFR\Delta\text{NFR}ΔNFR, or the coupling structure.
  2. Grammar closure: The set must include generators (U1a), closures (U1b), stabilizers (U2), destabilizers (U2), coupling operators (U3), bifurcation triggers and handlers (U4), and multi-scale operators (U5).
  3. Irreducibility: No operator can be decomposed as a sequence of other operators without loss of physical semantics.

1.2 Conventions

Throughout this document:

  • Glyph codes (AL, EN, IL, ...) reference the structural symbols.
  • English names (Emission, Reception, Coherence, ...) are the public API identifiers.
  • Operator gain magnitudes are operational parameters (only π\piπ is a genuine structural scale); the engine-configuration tier in canonical.py is calibrated, not derived.
  • Grammar roles reference rules U1–U6 from UNIFIED_GRAMMAR_RULES.md.
  • Energy bounds reference the Lyapunov analysis from STRUCTURAL_STABILITY_AND_DYNAMICS.md.

2. Operator Algebra from the Nodal Equation

2.1 Structural Triad

Each node iii carries three irreducible attributes:

AttributeSymbolDomainUnits
FormEPIi\text{EPI}_iEPIi​BEPI\mathcal{B}_{\text{EPI}}BEPI​ (Banach space)—
Frequencyνf,i\nu_{f,i}νf,i​R+\mathbb{R}^+R+Hz_str
Phaseϕi\phi_iϕi​ (or θi\theta_iθi​)[0,2π)[0, 2\pi)[0,2π

The derived quantity ΔNFRi\Delta\text{NFR}_iΔNFRi​ (structural pressure) drives evolution. Every operator acts on one or more of (EPI,νf,ϕ,ΔNFR)(\text{EPI}, \nu_f, \phi, \Delta\text{NFR})(EPI,νf​,ϕ,ΔNFR).

2.2 Operator as Transformation

An operator O^\hat{O}O^ maps the node state σi=(EPIi,νf,i,ϕi,ΔNFRi)\sigma_i = (\text{EPI}_i, \nu_{f,i}, \phi_i, \Delta\text{NFR}_i)σi​=(EPIi​,νf,i​,ϕi​,ΔNFRi​) to a new state:

O^:σi↦σi′=(EPIi′,νf,i′,ϕi′,ΔNFRi′)\hat{O}: \sigma_i \mapsto \sigma_i' = (\text{EPI}_i', \nu_{f,i}', \phi_i', \Delta\text{NFR}_i')O^:σi​↦σi′​=(EPIi′​,νf,i′​,ϕi′​

subject to:

  1. Nodal equation: The resulting state must be consistent with ∂EPI/∂t=νf⋅ΔNFR\partial\text{EPI}/\partial t = \nu_f \cdot \Delta\text{NFR}∂EPI/∂t=νf​⋅ΔNFR.
  2. Grammar constraints: The operator must satisfy its role within U1–U6.
  3. Contracts: Pre-conditions and post-conditions specific to each operator.

2.3 Composition

Operators compose into sequences [O^1,O^2,…,O^n][\hat{O}_1, \hat{O}_2, \ldots, \hat{O}_n][O^1​,O^2​,…,O^n​] applied left-to-right. Grammar validation operates on the full sequence. The grammar is not commutative: the order of operators affects validity and outcome.


3. The Operator Taxonomy

The 13 operators partition into functional classes defined by their effect on the nodal equation:

| Class | Operators | Effect on ∣ΔNFR∣|\Delta\text{NFR}|∣ΔNFR∣ | Grammar Roles | |-------|-----------|-------------------------------|---------------| | Generators | AL, NAV, REMESH | Create or activate EPI | U1a | | Integrator | EN | Integrates external input | — | | Stabilizers | IL, THOL | Reduce ∣ΔNFR∣|\Delta\text{NFR}|∣ΔNFR∣ | U2 (negative feedback) | | Destabilizers | OZ, VAL | Increase ∣ΔNFR∣|\Delta\text{NFR}|∣ΔNFR∣ | U2 (positive feedback) | | Coupling | UM, RA | Phase synchronization | U3 | | Transformers | ZHIR, THOL | Bifurcation-driven change | U4a, U4b | | Closure | SHA, NAV, REMESH, OZ | Terminate sequences | U1b | | Simplifier | NUL | Reduces dimensionality | — |

Some operators appear in multiple classes. THOL is simultaneously a stabilizer (U2) and a transformer (U4b). NAV and REMESH serve as both generators (U1a) and closures (U1b). OZ is both a destabilizer (U2) and closure (U1b). This multiplicity reflects the richness of their physics.


4. Generators

Generators create EPI from null or dormant states. Grammar rule U1a requires that any sequence beginning from EPI=0\text{EPI} = 0EPI=0 must start with a generator.

Physics: At EPI=0\text{EPI} = 0EPI=0, the nodal equation ∂EPI/∂t=νf⋅ΔNFR\partial\text{EPI}/\partial t = \nu_f \cdot \Delta\text{NFR}∂EPI/∂t=νf​⋅ΔNFR is undefined — there is no structural form to evolve. A generator bootstraps the system into a state where evolution can proceed.

4.1 Emission (AL)

Physics: Foundational activation of nodal resonance. Creates EPI from vacuum via resonant emission.

Transformation:

EPI′=EPI+b,νf′>0,ΔNFR′>0\text{EPI}' = \text{EPI} + b, \qquad \nu_f' > 0, \qquad \Delta\text{NFR}' > 0EPI′=EPI+b,νf′​>0,ΔNFR′>0

where b=1/(π⋅e)≈0.117b = 1/(\pi \cdot e) \approx 0.117b=1/(π⋅e)≈0.117 is the canonical emission amplitude.

Activation threshold: EPI<EPIthreshold\text{EPI} < \text{EPI}_{\text{threshold}}EPI<EPIthreshold​ where EPIthreshold≈0.33\text{EPI}_{\text{threshold}} \approx 0.33EPIthreshold​≈0.33 (operational free magnitude — the AL contract fixes the channel and sign, not this threshold).

Key constants:

ConstantValueDerivation
Emission amplitude bbb1/(πe)≈0.1171/(\pi e) \approx 0.1171/(πe)≈0.117Transcendental base
Activation threshold≈0.33\approx 0.33≈0.33operational (free)

Properties:

  • Irreversible: Sets an immutable activation flag. Re-emission increments an activation counter but preserves the original timestamp.
  • Genealogical: Maintains structural lineage tracking (origin timestamp, parent references, derived node list).
  • Latency-aware: Detects and clears silence (SHA) latency state on reactivation.

Grammar: Generator (U1a).

Contract:

  • Pre: EPI<0.8\text{EPI} < 0.8EPI<0.8 (activation threshold).
  • Post: EPI>0\text{EPI} > 0EPI>0, νf>0\nu_f > 0νf​>0, activation flag set.

4.2 Transition (NAV)

Physics: Controlled regime shift. Navigates between attractor states (dormant → active → resonant) with regime-specific parameter adjustment.

Transformation (regime-dependent):

Regimeνf\nu_fνf​ changeθ\thetaθ shiftΔNFR\Delta\text{NFR}ΔNFR reduction
Latent → Active+20%+0.1+0.1+0.1−30%-30\%−30%
Active → Activeconfigurable+0.2+0.2+0.2−20%-20\%−20%
Resonant → Active−5%-5\%−5%+0.15+0.15+0.15−10%-10\%−10%

Regime detection:

regime={latentif νf<0.05 or latent flag setresonantif EPI>0.5 and νf>0.8activeotherwise\text{regime} = \begin{cases} \text{latent} & \text{if } \nu_f < 0.05 \text{ or latent flag set} \\ \text{resonant} & \text{if } \text{EPI} > 0.5 \text{ and } \nu_f > 0.8 \\ \text{active} & \text{otherwise} \end{cases}regime=⎩⎨⎧​latentresonantactive​if νf​<0.05 or latent flag setif EPI>0.5 and ν

Properties:

  • Latency recovery: When transitioning from latent state, verifies EPI drift against preserved snapshot (tolerance: 1% for established nodes, 0.3300.3300.330 for initial nodes).
  • Regime traceability: Records origin regime, before/after state, and phase shift in telemetry.

Grammar: Generator (U1a), Closure (U1b).

Contract:

  • Pre: Valid regime state detectable.
  • Post: Smooth transition without coherence collapse; latency attributes cleared if applicable.

4.3 Recursivity (REMESH)

Physics: Propagates fractal pattern echoes across nested EPIs. Enforces multi-scale identity by linking current structure to prior states.

Transformation:

EPI(t)←α⋅EPI(t)+(1−α)⋅EPI(t−τ)\text{EPI}(t) \leftarrow \alpha \cdot \text{EPI}(t) + (1 - \alpha) \cdot \text{EPI}(t - \tau)EPI(t)←α⋅EPI(t)+(1−α)⋅EPI(t−τ)

where α=0.5\alpha = 0.5α=0.5 (weighted average preserving energy exactly: ΔE=0\Delta E = 0ΔE=0).

Properties:

  • Depth parameter: Recursion depth ≥1\geq 1≥1 (validated at construction; raises error if <1< 1<1).
  • Multi-scale coherence: For depth >1> 1>1, collective coherence must satisfy C≥1/(π+1)≈0.2413C \geq 1/(\pi + 1) \approx 0.2413C≥1/(π+1)≈0.2413 (U5 requirement).
  • Energy-neutral: The α=0.5\alpha = 0.5α=0.5 weighted average is exactly isometric (ΔE=0\Delta E = 0ΔE=0).

Grammar: Generator (U1a), Closure (U1b).

Contract:

  • Pre: Parent EPI properly formed; depth ≥1\geq 1≥1.
  • Post: Nested structure maintained; parent identity preserved.

Asymptotic limit — REMESH-∞ (N15, May 2026):

The two-stage canonical recurrence (β=(1−α)2\beta = (1-\alpha)^2β=(1−α)2, γ=α(1−α)\gamma = \alpha(1-\alpha)γ=α(1−α), δ=α\delta = \alphaδ=α, defaults τl=4\tau_l = 4τl​=4, τg=8\tau_g = 8τg​=8) admits a well-defined asymptotic operator as τg→∞\tau_g \to \inftyτg​→∞:

R∞:=lim⁡τg→∞Rτl,τg,α=Pker⁡(I−R)\mathcal{R}_\infty := \lim_{\tau_g \to \infty} \mathcal{R}_{\tau_l, \tau_g, \alpha} = P_{\ker(I - \mathcal{R})}R∞​:=limτg​→∞​Rτl​,τg​,α​=Pker(I−R)​

The limit exists as a bounded self-adjoint orthogonal projection on H2(D)H^2(D)H2(D) (the Hilbert space of EPI histories with geometric weight). Its fixed-point subspace is spanned by Fourier modes at frequencies ωk=2πk/lcm(τl,τg)\omega_k = 2\pi k / \mathrm{lcm}(\tau_l, \tau_g)ωk​=2πk/lcm(τl​,τg​) — a uniform resonant lattice with spectral density ρ=lcm(τl,τg)/π\rho = \mathrm{lcm}(\tau_l, \tau_g) / \piρ=lcm(τl​,τg​)/π.

Conservation under R∞\mathcal{R}_\inftyR∞​: The projected Noether charge Q∞Q_\inftyQ∞​ is exactly conserved; the projected energy V∞≥0V_\infty \ge 0V∞​≥0 is monotone and decays at Cesàro O(1/n)O(1/n)O(1/n) when τg/τl∈Q\tau_g / \tau_l \in \mathbb{Q}τg​/τl​∈Q (default case: 8/4=28/4 = 28/4=2).

Catalog-completeness consequence: The 13-operator TNFR catalog is closed under the REMESH-∞ limit. No 14th operator is required for the asymptotic projection, its conservation structure, or its spectral characterization. TNFR universality is structural/operational (same R∞\mathcal{R}_\inftyR∞​ form across all networks reaching the limit) and NOT spectral (no direct match to Riemann, Kolmogorov k−5/3k^{-5/3}k−5/3, or RMT GUE/GOE).

Full derivation: REMESH_INFINITY_DERIVATION.md §§1–23 (W1 existence, W2 conservation + Lyapunov, W3 spectrum + final verdict). Commit anchors: W1 a1f298fd, W2 badac156, W3 48b0574a.


5. Integrator

5.1 Reception (EN)

Physics: Captures and integrates incoming resonance from the network environment. Reduces ΔNFR\Delta\text{NFR}ΔNFR via structured integration of external signals.

Transformation:

EPI′=(1−m)⋅EPI+m⋅EPIin\text{EPI}' = (1 - m) \cdot \text{EPI} + m \cdot \text{EPI}_{\text{in}}EPI′=(1−m)⋅EPI+m⋅EPIin​

where m=1/(π+1)≈0.2413m = 1/(\pi + 1) \approx 0.2413m=1/(π+1)≈0.2413 is the canonical mixing fraction (transcendental correspondence).

Key constants:

ConstantValueDerivation
Mixing fraction mmm1/(π+1)≈0.24131/(\pi + 1) \approx 0.24131/(π+1)≈0.2413Transcendental π correspondence
Contraction ratem(1−m)≈0.183m(1 - m) \approx 0.183m(1−m)≈0.183Energy mixing contraction

Properties:

  • Source detection: Detects emission sources within configurable distance (default: 2 hops) via detect_emission_sources().
  • Monotonic coherence: Does not reduce C(t)C(t)C(t) (energy mixing contraction ensures this).
  • Source telemetry: Records detected sources in metadata for analysis.

Grammar: Integrator (no active destabilizer/stabilizer role).

Contract:

  • Pre: Active structure with capacity; external sources available.
  • Post: External resonance integrated; C(t)C(t)C(t) not reduced.

6. Stabilizers

Stabilizers provide negative feedback that ensures the convergence integral ∫νf⋅ΔNFR dt\int \nu_f \cdot \Delta\text{NFR}\,dt∫νf​⋅ΔNFRdt remains bounded. Grammar rule U2 requires that every destabilizer ({OZ, ZHIR, VAL}) be compensated by a stabilizer ({IL, THOL}).

6.1 Coherence (IL)

Physics: Stabilizes structural form through negative feedback. The primary mechanism for ensuring bounded evolution.

Transformation:

ΔNFR′=ΔNFR⋅(1−ρ)\Delta\text{NFR}' = \Delta\text{NFR} \cdot (1 - \rho)ΔNFR′=ΔNFR⋅(1−ρ)

where ρ≈0.3\rho \approx 0.3ρ≈0.3 is the canonical pressure reduction factor (from IL_DNFR_FACTOR≈0.7\text{IL\_DNFR\_FACTOR} \approx 0.7IL_DNFR_FACTOR≈0.7).

Phase locking (optional):

θ′=θ+λ⋅wrap ⁣(θˉN−θ)\theta' = \theta + \lambda \cdot \text{wrap}\!\left(\bar{\theta}_{\mathcal{N}} - \theta\right)θ′=θ+λ⋅wrap(θˉN​−θ)

where λ≈0.3\lambda \approx 0.3λ≈0.3 is the phase locking coefficient and θˉN\bar{\theta}_{\mathcal{N}}θˉN​ is the circular mean of neighbor phases.

Key constants:

ConstantValueDerivation
ΔNFR reduction factor0.750.750.75operational glyph factor (IL stabiliser; free magnitude)
Contraction rate ρ\rhoρ1−f2≈0.4381 - f^2 \approx 0.4381−f2≈0.438Energy contraction from glyph factor (f=0.75f = 0.75f=0.75)
Phase locking λ\lambdaλ≈0.3\approx 0.3≈0.3Configurable coupling strength

Properties:

  • Monotonic C(t)C(t)C(t): Global coherence must not decrease (except within explicit dissonance tests).
  • Phase alignment: Optional circular averaging drives neighborhood synchronization.
  • Telemetry: Records C(t)C(t)C(t) before/after, ΔNFR reduction factors, and phase locking events.

Grammar: Stabilizer (U2); Bifurcation Handler (U4a).

Contract:

  • Pre: Active structure exists.
  • Post: ∣ΔNFR∣|\Delta\text{NFR}|∣ΔNFR∣ reduced; C(t)C(t)C(t) non-decreasing.

6.2 Self-Organization (THOL)

Physics: Autonomous emergence via bifurcation. Creates sub-EPIs when the structural acceleration exceeds the bifurcation threshold, implementing operational fractality.

Bifurcation detection:

∂2EPI∂t2=EPI(t)−2 EPI(t−1)+EPI(t−2)(finite difference)\frac{\partial^2 \text{EPI}}{\partial t^2} = \text{EPI}(t) - 2\,\text{EPI}(t-1) + \text{EPI}(t-2) \tag{finite difference}∂t2∂2EPI​=EPI(t)−2EPI(t−1)+EPI(t−2)(finite difference)

When ∣∂2EPI/∂t2∣>τ|\partial^2\text{EPI}/\partial t^2| > \tau∣∂2EPI/∂t2∣>τ (bifurcation threshold), sub-EPIs are spawned.

Sub-EPI creation:

EPIsub=EPIparent⋅0.3+contributionmetabolic\text{EPI}_{\text{sub}} = \text{EPI}_{\text{parent}} \cdot 0.3 + \text{contribution}_{\text{metabolic}}EPIsub​=EPIparent​⋅0.3+contributionmetabolic​

where 0.30.30.3 is the operational fractal scaling factor (a free parameter). The parent EPI receives a 10% emergence contribution: EPIparent′=EPIparent+0.1⋅EPIsub\text{EPI}_{\text{parent}}' = \text{EPI}_{\text{parent}} + 0.1 \cdot \text{EPI}_{\text{sub}}EPIparent′​=EPIparent​+0.1⋅EPIsub​.

Key constants:

ConstantValueDerivation
Fractal scale≈0.3\approx 0.3≈0.3Operational fractal nesting (free parameter)
Emergence contribution0.100.100.10Parent EPI increment fraction
Collective coherence min1/(π+1)≈0.24131/(\pi + 1) \approx 0.24131/(π+1)≈0.2413U5 requirement
Sub-νf\nu_fνf​ damping0.950.950.95Child inherits 95% of parent frequency
Bifurcation threshold τ\tauτconfigurable (default 0.10.10.1)From graph configuration

Properties:

  • Autopoietic: Creates independent sub-nodes with hierarchy metadata (bifurcation level, hierarchy path, parent reference).
  • Metabolic integration: When enabled, captures network signals and metabolizes them into sub-EPI values.
  • Collective coherence enforcement: Ensemble must maintain C≥1/(π+1)≈0.2413C \geq 1/(\pi+1) \approx 0.2413C≥1/(π+1)≈0.2413 (U5).
  • Depth-limited: Maximum nesting depth prevents unbounded recursion (default: 5 levels).

Grammar: Stabilizer (U2); Bifurcation Handler (U4a); Transformer (U4b).

Contract:

  • Pre: Sufficient EPI history (≥3\geq 3≥3 points); νf>0\nu_f > 0νf​>0; elevated ΔNFR\Delta\text{NFR}ΔNFR.
  • Post: Sub-EPIs spawned (if bifurcation); parent identity preserved; collective coherence ≥0.2413\geq 0.2413≥0.2413.

7. Destabilizers

Destabilizers increase ∣ΔNFR∣|\Delta\text{NFR}|∣ΔNFR∣, driving the system away from equilibrium. Grammar rule U2 requires that destabilizers be compensated by stabilizers to ensure integral convergence.

7.1 Dissonance (OZ)

Physics: Injects controlled instability by amplifying structural pressure. Probes bifurcation readiness by elevating ∣ΔNFR∣|\Delta\text{NFR}|∣ΔNFR∣.

Transformation:

ΔNFR′=f⋅ΔNFR\Delta\text{NFR}' = f \cdot \Delta\text{NFR}ΔNFR′=f⋅ΔNFR

where f=2.0f = 2.0f=2.0 is the operational amplification factor (OZ destabiliser; free magnitude — the contract fixes only the sign f>1f > 1f>1).

Bifurcation trigger: When ∂2EPI/∂t2>τ\partial^2\text{EPI}/\partial t^2 > \tau∂2EPI/∂t2>τ, the system enters a bifurcation-active state requiring a handler (IL or THOL per U4a).

Key constants:

ConstantValueDerivation
Amplification factor fff2.02.02.0operational (OZ destabiliser; free)
Expansion rate κ\kappaκf2−1=3.0f^2 - 1 = 3.0f2−1=3.0Energy expansion from glyph factor (f=2.0f = 2.0f=2.0)

Properties:

  • Network propagation: Optional cascading to neighbors via phase-weighted, uniform, or frequency-weighted modes.
  • Bifurcation detection: Monitors ∂2EPI/∂t2\partial^2\text{EPI}/\partial t^2∂2EPI/∂t2 against threshold τ\tauτ.
  • Telemetry: Records propagation events, affected nodes, and bifurcation flags.

Grammar: Destabilizer (U2); Bifurcation Trigger (U4a); Closure (U1b).

Contract:

  • Pre: Sufficient EPI/νf\nu_fνf​; ΔNFR\Delta\text{NFR}ΔNFR below critical.
  • Post: ∣ΔNFR∣|\Delta\text{NFR}|∣ΔNFR∣ increased; bifurcation flag set if acceleration exceeds τ\tauτ.

7.2 Expansion (VAL)

Physics: Increases structural degrees of freedom. Elevates EPI and νf\nu_fνf​ by a canonical scaling factor derived from the four fundamental constants.

Transformation:

EPI′=fVAL⋅EPI,fVAL=VAL_scale=1.05\text{EPI}' = f_{\text{VAL}} \cdot \text{EPI}, \qquad f_{\text{VAL}} = \text{VAL\_scale} = 1.05EPI′=fVAL​⋅EPI,fVAL​=VAL_scale=1.05

Key constants:

ConstantValueDerivation
Scale factor fVALf_{\text{VAL}}fVAL​1.051.051.05operational (VAL expansion; free)
Expansion rate κ\kappaκf2−1≈0.139f^2 - 1 \approx 0.139f2−1≈0.139Energy scaling
Min EPI1/(2π)≈0.1591/(2\pi) \approx 0.1591/(2π)≈0.159minimum structural base (π-fraction, tunable)
Min coherencesin⁡(π/3)≈0.866\sin(\pi/3) \approx 0.866sin(π/3)≈0.86660° harmonic coherence
Bifurcation threshold1/(π+1)≈0.24131/(\pi + 1) \approx 0.24131/(π+1)≈0.2413Detection threshold

Grammar: Destabilizer (U2).

Contract:

  • Pre: EPI above minimum; coherence above 0.866; bounded ΔNFR\Delta\text{NFR}ΔNFR.
  • Post: Dimensionality increased; requires IL/THOL compensation. Avoid VAL→\to→VAL chaining.

8. Coupling and Propagation

Coupling operators establish and utilize phase-synchronized links between nodes. Grammar rule U3 requires phase compatibility verification: ∣ϕi−ϕj∣≤Δϕmax⁡|\phi_i - \phi_j| \leq \Delta\phi_{\max}∣ϕi​−ϕj​∣≤Δϕmax​.

8.1 Coupling (UM)

Physics: Synchronizes phases across neighbors, establishing structural links for resonance exchange.

Transformation:

ϕi′→ϕj′,∣ϕi−ϕj∣≤Δϕmax⁡\phi_i' \to \phi_j', \qquad |\phi_i - \phi_j| \leq \Delta\phi_{\max}ϕi′​→ϕj′​,∣ϕi​−ϕj​∣≤Δϕmax​

Compatibility threshold: π/(π+1)≈0.7585\pi/(\pi+1) \approx 0.7585π/(π+1)≈0.7585 (the high-coherence gate, complement of the fragmentation threshold 1/(π+1)1/(\pi+1)1/(π+1)).

Key constants:

ConstantValueDerivation
Compatibility thresholdπ/(π+1)≈0.7585\pi/(\pi+1) \approx 0.7585π/(π+1)≈0.7585high-coherence gate
Phase push1/(π+1)≈0.2411/(\pi + 1) \approx 0.2411/(π+1)≈0.241Same physics as EN mixing
ΔNFR\Delta\text{NFR}ΔNFR reduction0.150.150.15Phase sync pressure relief

Properties:

  • Phase verification mandatory: Antiphase (∣ϕi−ϕj∣>Δϕmax⁡|\phi_i - \phi_j| > \Delta\phi_{\max}∣ϕi​−ϕj​∣>Δϕmax​) produces destructive interference; coupling is forbidden.
  • EPI identity preserving: Form is not modified; only phase alignment changes.
  • νf\nu_fνf​ synchronization: Optional frequency alignment across coupled nodes.

Grammar: Coupling (U3); requires phase verification.

Contract:

  • Pre: Active EPI and νf\nu_fνf​ above thresholds; ∣ϕi−ϕj∣≤Δϕmax⁡|\phi_i - \phi_j| \leq \Delta\phi_{\max}∣ϕi​−ϕj​∣≤Δϕmax​; network edges exist.
  • Post: Phase spread narrowed; EPI identity preserved; links established.

8.2 Resonance (RA)

Physics: Propagates coherent patterns through phase-aligned nodes. Amplifies network alignment while preserving pattern identity.

Transformation:

νf′=(1+a)⋅νf,a=0.05 (amplification factor)\nu_f' = (1 + a) \cdot \nu_f, \qquad a = 0.05 \text{ (amplification factor)}νf′​=(1+a)⋅νf​,a=0.05 (amplification factor)

EPI is propagated without identity change. The resonance threshold for detection is ≈0.198\approx 0.198≈0.198 (operational; free detection sensitivity).

Key constants:

ConstantValueDerivation
Amplification factor aaa0.050.050.05Moderate amplification
Expansion rate κ\kappaκ(1+a)2−1≈0.103(1+a)^2 - 1 \approx 0.103(1+a)2−1≈0.103Energy amplification bound
Resonance threshold≈0.198\approx 0.198≈0.198Detection threshold (operational, free)

Properties:

  • Identity preservation: EPI is circulated without alteration — the defining contract of resonance.
  • Phase order parameter: Computes synchronization quality across propagation range.
  • Global C(t)C(t)C(t) increase: Network coherence increases through propagation.

Grammar: Propagation (U3); requires phase verification.

Contract:

  • Pre: Coherent EPI; active edges; adequate phase alignment.
  • Post: Global C(t)C(t)C(t) raised; EPI identity preserved; νf\nu_fνf​ moderately amplified.

9. Transformers

Transformers execute structural bifurcations — qualitative state changes that require both threshold energy (from prior destabilizers) and a stable base (from prior coherence). Grammar rule U4b requires recent destabilizer context (∼3\sim 3∼3 operations) and prior IL for ZHIR.

9.1 Mutation (ZHIR)

Physics: Controlled phase transformation. When the structural velocity ∣∂EPI/∂t∣|\partial\text{EPI}/\partial t|∣∂EPI/∂t∣ exceeds a threshold ξ\xiξ, the phase undergoes a discontinuous transition θ→θ′\theta \to \theta'θ→θ′.

Phase transformation:

θ′=θ+0.3⋅ΔNFR\theta' = \theta + 0.3 \cdot \Delta\text{NFR}θ′=θ+0.3⋅ΔNFR

The mutation is threshold-gated: it only activates when the system has accumulated sufficient structural pressure through prior destabilizers.

Bifurcation monitoring: Computes ∂2EPI/∂t2\partial^2\text{EPI}/\partial t^2∂2EPI/∂t2 and flags bifurcation potential when it exceeds τ\tauτ.

Key constants:

ConstantValueDerivation
νf\nu_fνf​ viability threshold≈0.489\approx 0.489≈0.489Mutation viability condition (operational, free)
Phase shift coefficient0.30.30.3ΔNFR-proportional phase shift
Energy bound $\Delta E$

Grammar: Transformer (U4b); Bifurcation Trigger (U4a).

Contract:

  • Pre: νf≥\nu_f \geqνf​≥ viability threshold; ∣∂EPI/∂t∣>ξ|\partial\text{EPI}/\partial t| > \xi∣∂EPI/∂t∣>ξ; prior IL required (stable base); recent destabilizer within ∼3\sim 3∼3 ops.
  • Post: Phase θ\thetaθ shifted; EPI identity preserved (qualitative nature unchanged); bifurcation potential flagged if ∂2EPI/∂t2>τ\partial^2\text{EPI}/\partial t^2 > \tau∂2EPI/∂t2>τ.

10. Closure and Regime Operators

10.1 Silence (SHA)

Physics: Freezes structural evolution by suppressing νf\nu_fνf​. With νf→0\nu_f \to 0νf​→0, the nodal equation yields ∂EPI/∂t≈0\partial\text{EPI}/\partial t \approx 0∂EPI/∂t≈0 regardless of ΔNFR\Delta\text{NFR}ΔNFR.

Transformation:

νf′=νf⋅fSHA≈0.9⋅νf→0,fSHA=SHA_VF_FACTOR=0.9\nu_f' = \nu_f \cdot f_{\text{SHA}} \approx 0.9 \cdot \nu_f \to 0, \qquad f_{\text{SHA}} = \text{SHA\_VF\_FACTOR} = 0.9νf′​=νf​⋅fSHA​≈0.9⋅νf​→0,fSHA​=SHA_VF_FACTOR=0.9

EPI is preserved via latency snapshot.

Key constants:

ConstantValueDerivation
νf\nu_fνf​ suppression factor0.90.90.9Structural continuity (operational, SHA_VF_FACTOR)
Energy bound $\Delta E$

Properties:

  • Latency state: Activates a latent flag with timestamped EPI snapshot.
  • EPI preservation: Drift tolerance of 1% for established nodes, 0.3300.3300.330 for initial nodes.
  • Reactivation protocol: AL or NAV recovery verifies silence duration and EPI drift, then clears latency attributes.

Grammar: Closure (U1b).

Contract:

  • Pre: Existing EPI; ΔNFR\Delta\text{NFR}ΔNFR not at critical levels.
  • Post: νf→0\nu_f \to 0νf​→0; EPI remains invariant; latent flag set with snapshot.

10.2 Contraction (NUL)

Physics: Densifies and consolidates structural form by reducing dimensionality. Compresses νf\nu_fνf​ while increasing local ΔNFR\Delta\text{NFR}ΔNFR density.

Transformation:

νf′=fNUL⋅νf,fNUL=NUL_scale=0.9\nu_f' = f_{\text{NUL}} \cdot \nu_f, \qquad f_{\text{NUL}} = \text{NUL\_scale} = 0.9νf′​=fNUL​⋅νf​,fNUL​=NUL_scale=0.9

Local ΔNFR\Delta\text{NFR}ΔNFR density increases due to compression:

ΔNFRdensity′=1λ⋅ΔNFRdensity≈1.111⋅ΔNFRdensity,λ=NUL_scale=0.9\Delta\text{NFR}_{\text{density}}' = \frac{1}{\lambda} \cdot \Delta\text{NFR}_{\text{density}} \approx 1.111 \cdot \Delta\text{NFR}_{\text{density}}, \qquad \lambda = \text{NUL\_scale} = 0.9ΔNFRdensity′​=λ1​⋅ΔNFRdensity​≈1.111⋅ΔNFRdensity​,λ=NUL_scale=0.9

Key constants:

ConstantValueDerivation
Scale factor0.90.90.9Same operational ν_f step as SHA (NUL_scale)
Densification factor1/λ≈1.1111/\lambda \approx 1.1111/λ≈1.111Geometric volume ratio (1/NUL_scale)

Grammar: Simplifier (no active grammar role; supports VAL reversals).

Contract:

  • Pre: Non-trivial EPI (not ≈0\approx 0≈0).
  • Post: Dimensionality reduced; pressure density increased. Avoid NUL→\to→NUL chaining.

11. Canonical Compositions

Operators combine into validated sequences that implement higher-level structural behaviors. All compositions must satisfy grammar rules U1–U6.

11.1 Four Fundamental Patterns

PatternSequenceEffectUse case
Bootstrap[AL, EN, IL, SHA]Create → Integrate → Stabilize → CloseNetwork initialization
Stabilize[IL, SHA]Stabilize → CloseConsolidation after changes
Explore[OZ, ZHIR, IL]Destabilize → Transform → StabilizeBreaking local optima
Propagate[RA, UM]Resonate → CoupleSpreading coherence

11.2 Extended Compositions

NameSequenceDescription
Bifurcated base[AL, EN, IL, OZ, ZHIR, IL, SHA]Exploration with mutation and stabilization
Bifurcated collapse[AL, OZ, NUL, IL, SHA]Stress testing with contraction recovery
Theory system[AL, NAV, UM, RA, IL, SHA]Cognitive consolidation via coupling and resonance
Full deployment[AL, UM, RA, OZ, ZHIR, IL, SHA]Integration pipeline with exploration
Minimal stabilizer[AL, IL, SHA]Shortest valid bootstrap-stabilize-close
Contained crisis[AL, EN, IL, OZ, SHA]Crisis containment through intervention
Phase lock[AL, EN, IL, OZ, ZHIR, SHA]Synchronization through mutation
Resonance peak hold[AL, EN, IL, RA, SHA]Peak detection and maintenance

11.3 Grammar Validation of Compositions

Every composition above satisfies:

  • U1a: Starts with generator (AL or NAV).
  • U1b: Ends with closure (SHA, NAV, REMESH, or OZ).
  • U2: Destabilizers (OZ, ZHIR, VAL) compensated by stabilizers (IL, THOL).
  • U3: Coupling (UM, RA) has phase verification.
  • U4a: Bifurcation triggers (OZ, ZHIR) accompanied by handlers (IL, THOL).
  • U4b: Transformers (ZHIR, THOL) have recent destabilizer context and prior IL.

12. Per-Operator Energy Bounds

The structural energy functional E=12∑i[Φs2+∣∇ϕ∣2+Kϕ2+Jϕ2+JΔNFR2]E = \frac{1}{2}\sum_i \left[\Phi_s^2 + |\nabla\phi|^2 + K_\phi^2 + J_\phi^2 + J_{\Delta\text{NFR}}^2\right]E=21​∑i​[Φs2​+∣∇ϕ∣2+Kϕ2​+J serves as a Lyapunov candidate. It is emergent: built entirely from the tetrad fields, it contains no EPI\text{EPI}EPI or νf\nu_fνf​ term (measured: scaling EPI\text{EPI}EPI or νf\nu_fνf​ on every node leaves EEE unchanged; the phase θ\thetaθ and the pressure ΔNFR\Delta\text{NFR}ΔNFR do enter it). Consequently each operator's energy role is its canonical grammar U2 role, derived from config.physics_derivation — not a separate energy algebra.

12.1 Energy Classes (= Grammar U2 Role)

ClassOperatorsMechanism
Stabiliser (ΔE≤0\Delta E \leq 0ΔE≤0)IL, THOLReduce $
Destabiliser (ΔE≤κE\Delta E \leq \kappa EΔE≤κE)OZ, ZHIR, VALRaise $
Neutral (ΔE≈0\Delta E \approx 0ΔE≈0)AL, EN, RA, REMESH (EPI/form); UM, SHA, NUL, NAVAct on the form (LHS), capacity, phase, or controlled channel that the pressure functional does not penalise by its grammatical role

12.2 Energy Rate Table

OperatorClassPressure factorRate
ILStabiliserf=0.75f = 0.75f=0.75 (operational)ρ=1−f=0.25\rho = 1 - f = 0.25ρ=1−f=0.25
THOLStabiliseraccel =0.10= 0.10=0.10ρ≈0.100\rho \approx 0.100ρ≈0.100
OZDestabiliserf=2.0f = 2.0f=2.0 (operational)κ=f−1=1.0\kappa = f - 1 = 1.0κ=f−1=1.0
ZHIRDestabiliserθ\thetaθ-shift =0.30= 0.30=0.30κ≈0.300\kappa \approx 0.300κ≈0.300
VALDestabiliserνf\nu_fνf​-scale ≈1.068\approx 1.068≈1.068κ≈0.068\kappa \approx 0.068κ≈0.068
AL, EN, RA, REMESHNeutral— (write EPI, the LHS)000
UM, SHA, NUL, NAVNeutral— (phase / capacity / controlled)000

Dual-lever note: the energy/Lyapunov role (stabiliser/destabiliser, the sign of the ∣ΔNFR∣|\Delta\text{NFR}|∣ΔNFR∣ feedback) is distinct from the dual-lever (§17.1, which RHS factor an operator modulates). VAL engages the capacity lever yet is a U2 destabiliser; NAV engages the pressure lever yet is U2-neutral (controlled trajectory). See src/tnfr/physics/lyapunov.py.

12.3 Grammar U2 Lyapunov Theorem

For any U2-compliant sequence (destabilizers compensated by stabilizers):

∑opsΔEop≤0\sum_{\text{ops}} \Delta E_{\text{op}} \leq 0ops∑​ΔEop​≤0

This guarantees that grammar-compliant evolution is Lyapunov-stable with respect to the structural energy functional.

Proof: See STRUCTURAL_STABILITY_AND_DYNAMICS.md §1.3 and STRUCTURAL_CONSERVATION_THEOREM.md §8.


13. Postcondition Contracts

Every operator has a postcondition contract anchored to the direct effect on node state (the nodal dynamics ∂EPI/∂t=νf⋅ΔNFR\partial\text{EPI}/\partial t = \nu_f\cdot\Delta\text{NFR}∂EPI/∂t=νf​⋅ΔNFR, anchored to TNFR.pdf §2.2.1). The canonical contract layer src/tnfr/operators/operator_contracts.py is the single source of truth — it records each operator's primary_channel (one nodal-equation channel: EPI\text{EPI}EPI / νf\nu_fνf​ / θ\thetaθ / ΔNFR\Delta\text{NFR}ΔNFR), scale (NODE for twelve operators, NETWORK for the U5 operator REMESH), and postcondition. The proactive audit (audit_operator_contracts), the reactive integrity monitor (POSTCONDITIONS, src/tnfr/physics/integrity.py), and the introspection metadata all derive from this spec. The monitor supports three modes: OFF (production), OBSERVE (log violations), ENFORCE (raise exceptions).

#OperatorGlyphChannelPostcondition
1EmissionALEPIEPI\text{EPI}EPI not decreased (∂EPI/∂t≥0\partial\text{EPI}/\partial t \ge 0∂EPI/∂t≥0)
2ReceptionENEPIC(t)C(t)C(t) not decreased (coherent integration)
3CoherenceILΔNFR\Delta\text{NFR}ΔNFRC(t)C(t)C(t) non-decreasing; $
4DissonanceOZΔNFR\Delta\text{NFR}ΔNFR$
5CouplingUMθ\thetaθPhase compatibility $
6ResonanceRAEPIEPI structural identity (sign/kind) preserved
7SilenceSHAνf\nu_fνf​EPI preserved over time; νf\nu_fνf​ frozen
8ExpansionVALνf\nu_fνf​νf\nu_fνf​ not decreased (capacity added)
9ContractionNULνf\nu_fνf​νf\nu_fνf​ not increased (capacity removed)
10Self-OrganizationTHOLΔNFR\Delta\text{NFR}ΔNFRGlobal form preserved; sub-EPIs created (if bifurcation)
11MutationZHIRθ\thetaθPhase θ\thetaθ changed when ΔEPI/Δt>ξ\Delta\text{EPI}/\Delta t > \xiΔEPI/Δt>ξ
12TransitionNAVΔNFR\Delta\text{NFR}ΔNFRControlled trajectory; no coherence collapse
13RecursivityREMESHEPI (network)Nested structure maintained; parent identity preserved

14. Operator Constants Reference

Operator gain magnitudes are free operational parameters: each operator's contract fixes its channel and sign (the canonical content), not its numeric magnitude, so the values below are operational calibrations. Only π\piπ is a genuine structural scale; φ,γ,e\varphi, \gamma, eφ,γ,e are not structural scales and no longer appear in the engine. The authoritative, current values live in src/tnfr/constants/canonical.py and the contracts in operators/operator_contracts.py; the engine-configuration tier (cache, FFT, optimization, performance) is calibrated to operational targets, not derived.

14.1 The structural scale

SymbolNameValueRole
π\piπPi3.1415926535897933.1415926535897933.141592653589793the one genuine structural scale: bounds the phase sector ($

14.2 Operator gain magnitudes (operational)

Free operational parameters (the contract fixes channel + sign, not magnitude). Representative current values:

ConstantValueUsed by
EN / THOL collective-coherence fraction1/(π+1)≈0.2411/(\pi + 1) \approx 0.2411/(π+1)≈0.241EN mixing, UM phase push, THOL/VAL threshold (π-derived)
SHA / NUL frequency factor0.90.90.9SHA suppression, NUL compression (νf→0.9 νf\nu_f \to 0.9\,\nu_fνf​→0.9νf​)
NUL densification factor1/0.9≈1.1111/0.9 \approx 1.1111/0.9≈1.111NUL (1/λ1/\lambda1/λ geometric volume-ratio)
VAL scale factor1.051.051.05VAL expansion (νf→1.05 νf\nu_f \to 1.05\,\nu_fνf​→1.05νf​)
AL emission boost0.100.100.10AL creation
THOL fractal scale0.30.30.3Sub-EPI scaling

The complete, authoritative set lives in src/tnfr/constants/canonical.py; among them the only genuine structural scale is the phase scale π\piπ (the 1/(π+1)1/(\pi+1)1/(π+1) entry above is the one π-derived value).

14.3 Constant-Operator-Grammar Traceability

The canonical content of each operator is its channel and sign (its contract), not its gain magnitude. The gains above are free operational parameters; the channel / grammar mapping is:

text
OZ   (ΔNFR ↑, amplification)   →  U2 (destabilizer)
IL   (ΔNFR ↓, reduction)       →  U2 (stabilizer), U4a (handler)
EN   (EPI, mixing)             →  integrator
VAL  (νf ↑, expansion)         →  U2 (destabilizer)
SHA  (νf → 0, suppression)     →  U1b (closure)
ZHIR (θ, mutation)             →  U4b (transformer)
THOL (sub-EPI, self-org)       →  U2 (stabilizer), U4b (transformer)
AL   (EPI from vacuum)         →  U1a (generator)

Source: src/tnfr/constants/canonical.py and src/tnfr/operators/operator_contracts.py (the contract source of truth: channel, sign, scale, postcondition).


15. Implementation Reference

15.1 Source Modules

ModuleContent
src/tnfr/operators/definitions.pyFacade: imports all 13 operator classes
src/tnfr/operators/definitions_base.pyOperator abstract base class with __call__ workflow
src/tnfr/operators/emission.pyAL implementation
src/tnfr/operators/reception.pyEN implementation
src/tnfr/operators/coherence.pyIL implementation
src/tnfr/operators/dissonance.pyOZ implementation
src/tnfr/operators/coupling.pyUM implementation
src/tnfr/operators/resonance.pyRA implementation
src/tnfr/operators/silence.pySHA implementation
src/tnfr/operators/expansion.pyVAL implementation
src/tnfr/operators/contraction.pyNUL implementation
src/tnfr/operators/self_organization.pyTHOL implementation
src/tnfr/operators/mutation.pyZHIR implementation
src/tnfr/operators/transition.pyNAV implementation
src/tnfr/operators/recursivity.pyREMESH implementation
src/tnfr/operators/nodal_equation.pyNodal equation validation
src/tnfr/operators/canonical_patterns.pyCanonical sequence definitions
src/tnfr/operators/introspection.pyOperatorMeta metadata registry
src/tnfr/operators/operator_contracts.pyCanonical contract layer (single source of truth: channel × scale × postcondition)
src/tnfr/operators/grammar_canon.pyCanonical grammar spec (U1–U6 role table, structural typology, glyphic macros)
src/tnfr/operators/grammar.pyGrammar validation (public API facade)
src/tnfr/operators/grammar_dynamics.pyIncremental grammar-aware dynamics
src/tnfr/operators/grammar_application.pyPre-validated operator application
src/tnfr/physics/integrity.py13/13 postcondition verification
src/tnfr/physics/lyapunov.pyPer-operator energy bounds
src/tnfr/constants/canonical.pyAll derived constants

15.2 Base Operator Workflow

The Operator.__call__(G, node, **kw) method implements the canonical execution pipeline:

  1. Precondition validation: Operator-specific checks via _validate_preconditions().
  2. State capture: Records (EPI,νf,ΔNFR,θ)(\text{EPI}, \nu_f, \Delta\text{NFR}, \theta)(EPI,νf​,ΔNFR,θ) before application.
  3. Integrity snapshot (pre): _integrity_monitor.before_operator().
  4. Grammar-enforced application: Applies via apply_glyph_with_grammar() (U1–U6).
  5. Integrity evaluation (post): _integrity_monitor.after_operator() — verifies postconditions.
  6. Nodal equation validation (optional): Checks ∣∂EPI/∂tmeasured−νf⋅ΔNFR∣≤ϵ|\partial\text{EPI}/\partial t_{\text{measured}} - \nu_f \cdot \Delta\text{NFR}| \leq \epsilon∣∂EPI/∂tmeasured​−νf​⋅ΔNFR∣≤ϵ.
  7. Metrics collection: Operator-specific telemetry via _collect_metrics().

15.3 Executable Demonstrations

ExampleOperators demonstrated
04_operator_sequences.pyAll 13 operators, canonical compositions
10_simplified_sdk_showcase.pySDK-level operator usage
29_lyapunov_stability_demo.pyAll 13 energy bounds, Lyapunov stability
36_grammar_violation_detector.pyGrammar enforcement across sequences

15.4 SDK Entry Points

python
from tnfr.sdk import TNFR

net = TNFR.create(20).ring().evolve(5)

# Grammar-aware evolution (proactive U1-U6 enforcement)
net.evolve_grammar_aware(steps=10)

# Integrity check (13/13 postconditions)
report = net.integrity_check()

# One-line self-optimization (auto operator selection)
from tnfr.sdk.fluent import TNFRNetwork
TNFRNetwork(G).focus(node).auto_optimize().execute()

16. Summary

The 13 canonical TNFR operators form a complete, irreducible algebra for structural transformations governed by the nodal equation ∂EPI/∂t=νf⋅ΔNFR(t)\partial\text{EPI}/\partial t = \nu_f \cdot \Delta\text{NFR}(t)∂EPI/∂t=νf​⋅ΔNFR(t).

Key results:

  1. Completeness: The operators span all independent transformations of the structural triad (EPI,νf,ϕ)(\text{EPI}, \nu_f, \phi)(EPI,νf​,ϕ) compatible with the nodal equation.
  2. Irreducibility: No operator decomposes into a composition of others without loss of physical semantics.
  3. Grammar closure: The operator set satisfies all grammar roles required by U1–U6.
  4. Constants: Operator gain magnitudes in canonical.py are operational parameters (only π\piπ is a genuine structural scale); the engine-configuration tier is calibrated, not derived.
  5. Lyapunov stability: Grammar-compliant sequences reduce structural energy (∑ΔE≤0\sum \Delta E \leq 0∑ΔE≤0).
  6. Runtime verification: 13/13 postcondition contracts enforced by the structural integrity monitor.
  7. Canonical compositions: Standard patterns (Bootstrap, Stabilize, Explore, Propagate) encode common structural workflows.
  8. Dual-lever structure: Operators act through νf\nu_fνf​ (capacity) or ΔNFR\Delta\text{NFR}ΔNFR (pressure), explaining why grammar requires both U2 and U4.
  9. Operator-tetrad coupling: Each operator has a characteristic fingerprint across the four tetrad fields, confirming the tetrad is a complete basis for diagnosing operator effects.
  10. Linear Φs\Phi_sΦs​ response: Structural potential responds linearly to ΔNFR\Delta\text{NFR}ΔNFR perturbations (∣r∣=1.000|r| = 1.000∣r∣=1.000), confirming its 0th-order nature in the derivative tower.

17. Experimental Operator-Tetrad Synergies

Computational experiments (Examples 37–39, seed 42, n=20n=20n=20, Erdos-Renyi p=0.25p=0.25p=0.25) reveal how the 13 operators couple to the structural field tetrad and conservation quantities. These findings are empirically reproducible and derive from the nodal equation.

17.1 Operator Lever Classification

The nodal equation ∂EPI/∂t=νf⋅ΔNFR(t)\partial\text{EPI}/\partial t = \nu_f \cdot \Delta\text{NFR}(t)∂EPI/∂t=νf​⋅ΔNFR(t) has two independent factors. Each operator modulates EPI evolution through predominantly one of these "levers":

LeverOperatorsMechanism
νf\nu_fνf​ (capacity)UM, SHA, VALModify reorganization frequency
ΔNFR\Delta\text{NFR}ΔNFR (pressure)IL, OZ, THOL, ZHIR, NAVModify reorganization pressure
BothNULChanges frequency and pressure simultaneously
NeutralAL, EN, RA, REMESHAffect EPI directly or leave state unchanged

This dual-lever structure is why grammar requires both U2 (convergence of ∫νf⋅ΔNFR dt\int \nu_f \cdot \Delta\text{NFR}\,dt∫νf​⋅ΔNFRdt) and U4 (bifurcation control): different operators control different factors of the integrand.

Example: NAV (Transition) produces the largest single ΔNFR\Delta\text{NFR}ΔNFR change (d=−0.444d = -0.444d=−0.444), consistent with its role as a regime-shift operator.

17.2 Operator-Tetrad Fingerprint Matrix

Each operator has a characteristic coupling profile to the four tetrad fields. Measured as percentage change per field after single operator application on a random 20-node network:

| Operator | Φs\Phi_sΦs​ (%) | ∣∇φ∣|\nabla\varphi|∣∇φ∣ (%) | KφK_\varphiKφ​ (%) | ξC\xi_CξC​ (%) | |----------|-------------|----------------------|-----------------|-------------| | IL (Coherence) | +7.8 | −0.5-0.5−0.5 | 0.0 | −2.1-2.1−2.1 | | OZ (Dissonance) | +7.8 | −0.5-0.5−0.5 | 0.0 | −2.1-2.1−2.1 | | UM (Coupling) | −73.7-73.7−73.7 | +2.5 | −8.1-8.1−8.1 | +31.4 | | NAV (Transition) | −331.9-331.9−331.9 | +45.1 | 0.0 | +187.4 | | SHA (Silence) | 0.0 | 0.0 | 0.0 | 0.0 |

Key findings:

  1. UM (Coupling) has the richest tetrad coupling: it modifies all four fields simultaneously, consistent with its role as a phase-synchronization operator (U3).
  2. NAV (Transition) dominates Φs\Phi_sΦs​: its −332%-332\%−332% structural potential change is the largest single-operator perturbation, matching its physics as a regime-shift operator.
  3. SHA (Silence) is tetrad-neutral: νf→0\nu_f \to 0νf​→0 freezes evolution without affecting field state, confirming its closure role (U1b).
  4. IL and OZ produce identical tetrad signatures: this is analyzed in §17.3.

17.3 IL-OZ Tetrad Symmetry

Observation: Coherence (IL) and Dissonance (OZ) produce identical energy functional changes (dE=−0.011dE = -0.011dE=−0.011) and identical tetrad field perturbations when applied to the same initial state.

Interpretation: Both operate exclusively via the ΔNFR\Delta\text{NFR}ΔNFR lever with the same magnitude ∣d(ΔNFR)∣=0.0096|d(\Delta\text{NFR})| = 0.0096∣d(ΔNFR)∣=0.0096, but with different physical semantics:

  • IL reduces ∣ΔNFR∣|\Delta\text{NFR}|∣ΔNFR∣ via negative feedback (stabilizer contract).
  • OZ increases ∣ΔNFR∣|\Delta\text{NFR}|∣ΔNFR∣ via positive feedback (destabilizer contract).

The identical tetrad response occurs because the tetrad fields depend on the absolute state of (φi,ΔNFRi)(\varphi_i, \Delta\text{NFR}_i)(φi​,ΔNFRi​) across the network, and a single-node perturbation of the same magnitude produces the same global field response regardless of sign. This symmetry breaks under repeated application: cumulative IL drives toward equilibrium while cumulative OZ drives toward divergence, as required by U2.

17.4 Structural Potential Linear Response

Result: Coherence-length ξC\xi_CξC​ and structural potential Φs\Phi_sΦs​ show a perfectly linear response to ΔNFR\Delta\text{NFR}ΔNFR perturbation magnitude (Pearson ∣r∣=1.000|r| = 1.000∣r∣=1.000).

ΔNFRinit\Delta\text{NFR}_{\text{init}}ΔNFRinit​d(Φs)d(\Phi_s)d(Φs​)d(ξC)d(\xi_C)d(ξC​)
0.01−0.001-0.001−0.001−0.16-0.16−0.16
0.05−0.007-0.007−0.007−0.85-0.85−0.85
0.10−0.014-0.014−0.014−

Φs\Phi_sΦs​ response is linear across the full range, confirming the 0th-order (aggregation) nature of the structural potential from the derivative tower (§ Minimal Structural Degrees). The ξC\xi_CξC​ response transitions from linear to strongly nonlinear above ΔNFR≈0.3\Delta\text{NFR} \approx 0.3ΔNFR≈0.3, consistent with critical phenomena near the correlation divergence.

17.5 Complete Causal Chain

The experimental data confirm a unidirectional causal chain:

Operator→(νf,ΔNFR)→∂EPI∂t→Tetrad Fields→(E,Q)\text{Operator} \to (\nu_f, \Delta\text{NFR}) \to \frac{\partial\text{EPI}}{\partial t} \to \text{Tetrad Fields} \to (E, Q)Operator→(νf​,ΔNFR)→∂t∂EPI​→Tetrad Fields→(E,Q)

The tetrad fields are diagnostics of nodal equation dynamics, not independent dynamical variables. This is evidenced by:

  • Emission (AL) modifies EPI directly (+0.117+0.117+0.117) without changing any tetrad field or conservation quantity.
  • Coupling (UM) modifies (νf,ΔNFR)(\nu_f, \Delta\text{NFR})(νf​,ΔNFR), which propagates to all four tetrad fields and both conservation quantities (dE=−13.45dE = -13.45dE=−13.45, dQ=+7.62dQ = +7.62dQ=+7.62).

17.6 Grammar-Energy Landscape

Grammar-compliant sequences produce net energy descent across all four canonical patterns (Bootstrap, Stabilize, Explore, Propagate). The energy trajectory through a sequence traces a landscape that Grammar U2 constrains to be bounded.

Lyapunov verification (seed 42): The first Lyapunov cumulative product for a Bootstrap+Explore+Stabilize sequence is λ=1.288\lambda = 1.288λ=1.288 (not contractive over the full sequence), but the net energy change is dE=−9.59dE = -9.59dE=−9.59 (descent). This confirms that Lyapunov contractivity is sufficient but not necessary for energy descent — grammar compliance provides the stronger guarantee.

17.7 Executable Demonstrations

ExampleExperimentKey metric
examples/02_physics_regimes/37_operator_tetrad_synergy.pyFingerprint matrix, energy signatures, safety envelope, Noether conservationPer-operator tetrad coupling (%)
examples/02_physics_regimes/38_grammar_energy_landscape.pyEnergy landscape, Lyapunov bounds, canonical pattern comparisonEnergy trajectory E(t)E(t)E(t) through sequence
examples/02_physics_regimes/39_nodal_equation_decomposition.pyLever classification, causal chain, waveform trajectory, response functionsνf\nu_fνf​ vs ΔNFR\Delta\text{NFR}ΔNFR per operator

All experiments use seed 42 for reproducibility (Invariant #6).


Cross-References

  • Nodal equation derivation: FUNDAMENTAL_THEORY.md §2
  • Grammar rules U1–U6: UNIFIED_GRAMMAR_RULES.md
  • Energy bounds and Lyapunov stability: STRUCTURAL_STABILITY_AND_DYNAMICS.md §1
  • Conservation laws: STRUCTURAL_CONSERVATION_THEOREM.md
  • Variational formulation: TNFR_VARIATIONAL_PRINCIPLE.md
  • Structural field tetrad: FUNDAMENTAL_THEORY.md §3
  • Canonical constants: src/tnfr/constants/canonical.py
  • Operator-tetrad synergy experiment: examples/02_physics_regimes/37_operator_tetrad_synergy.py
  • Grammar-energy landscape experiment: examples/02_physics_regimes/38_grammar_energy_landscape.py
  • Nodal equation decomposition experiment: examples/02_physics_regimes/39_nodal_equation_decomposition.py
  • Glossary: GLOSSARY.md
)
rad
,
Δ
NFRi′​
)
f
​
>
0.8
otherwise
​
ϕ
2
​
+
JΔNFR2​
]
1.91-1.91
−1.91
0.30−0.042-0.042−0.042−9.83-9.83−9.83
0.50−0.071-0.071−0.071−35.1-35.1−35.1
0.80−0.113-0.113−0.113−1464-1464−1464