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: factorization-lab/demos/snapshot_integration_demo.py

snapshot_integration_demo.py

TNFR Partition Snapshot Integration Demo

Demonstrates complete snapshot integration with factorization pipeline. Shows state capture at key verification points for reproducibility and analysis.

Source Code

python
"""
TNFR Partition Snapshot Integration Demo

Demonstrates complete snapshot integration with factorization pipeline.
Shows state capture at key verification points for reproducibility and analysis.
"""

import sys
import time
from pathlib import Path

sys.path.append(str(Path(__file__).parent.parent))

from snapshot_system import (
    NodalState,
    PartitionSnapshotManager,
    PartitionState,
    StructuralFieldSnapshot,
    create_mock_network_topology,
    create_mock_nodal_state,
    create_mock_structural_fields,
)


class MockFactorizationEngine:
    """Mock factorization engine for demonstration."""

    def __init__(self, modulus_n: int, snapshot_manager: PartitionSnapshotManager):
        self.modulus_n = modulus_n
        self.snapshot_manager = snapshot_manager
        self.node_count = 10
        self.partition_strategy = "spectral_paley_snapshot_demo"

        # Initialize system state
        self.nodal_states = [create_mock_nodal_state(i) for i in range(self.node_count)]
        self.structural_fields = create_mock_structural_fields(self.node_count)
        self.network_topology = create_mock_network_topology(self.node_count)

        # Performance tracking
        self.start_time = time.time()
        self.verification_confidence = 0.5
        self.coherence_evolution = []

        print(f"🔧 Initialized factorization engine for n={modulus_n}")

    def run_verification_with_snapshots(self) -> tuple[bool, list[str]]:
        """Run complete verification with snapshot capture at each stage."""

        snapshot_ids = []
        stages = [
            ("initialization", "System initialization and network setup"),
            ("partitioning", "Partition boundary identification"),
            ("spectral_analysis", "Eigenvalue decomposition and clustering"),
            ("verification", "Structural coherence verification"),
            ("completion", "Final result validation and cleanup"),
        ]

        print(
            f"\n🚀 Starting verification for n={self.modulus_n} with snapshot capture"
        )

        for i, (stage_name, description) in enumerate(stages):
            print(f"\n📸 Stage {i+1}/{len(stages)}: {stage_name}")
            print(f"   {description}")

            # Simulate stage processing
            self._simulate_verification_stage(stage_name, i)

            # Capture snapshot
            snapshot_id = self._capture_stage_snapshot(stage_name, i)
            snapshot_ids.append(snapshot_id)

            print(f"   ✅ Snapshot captured: {snapshot_id}")

        # Final analysis
        success = self.verification_confidence > 0.8
        final_coherence = (
            self.coherence_evolution[-1] if self.coherence_evolution else 0
        )

        print(f"\n🎯 Verification {'SUCCEEDED' if success else 'FAILED'}")
        print(f"   Final coherence: {final_coherence:.3f}")
        print(f"   Confidence: {self.verification_confidence:.3f}")

        return success, snapshot_ids

    def _simulate_verification_stage(self, stage_name: str, stage_index: int):
        """Simulate verification stage with realistic state changes."""

        # Simulate different behaviors per stage
        if stage_name == "initialization":
            # Start with lower coherence
            coherence = 0.65
            self._update_nodal_states(coherence_target=coherence)

        elif stage_name == "partitioning":
            # Create partition boundaries, slight coherence improvement
            coherence = 0.72
            self._create_partition_boundaries()
            self._update_nodal_states(coherence_target=coherence)

        elif stage_name == "spectral_analysis":
            # Spectral clustering improves organization
            coherence = 0.81
            self._update_spectral_properties()
            self._update_nodal_states(coherence_target=coherence)

        elif stage_name == "verification":
            # Verification process with slight variation
            coherence = 0.83 + (0.1 if self._is_factorizable() else -0.15)
            self._update_verification_metrics(coherence)
            self._update_nodal_states(coherence_target=coherence)

        elif stage_name == "completion":
            # Final state depends on success
            coherence = self.coherence_evolution[-1] + 0.02
            self._finalize_verification(coherence)
            self._update_nodal_states(coherence_target=coherence)

        # Record coherence evolution
        self.coherence_evolution.append(coherence)

        # Simulate processing time
        time.sleep(0.1)

    def _update_nodal_states(self, coherence_target: float):
        """Update nodal states to reflect current verification stage."""

        for i, node_state in enumerate(self.nodal_states):
            # Adjust structural frequency based on coherence
            node_state.structural_frequency = 0.5 + (coherence_target * 1.2)

            # Update phase relationships
            node_state.phase = (node_state.phase + 0.1) % (2 * 3.14159)

            # Adjust ΔNFR based on coherence (lower is better)
            node_state.dnfr_magnitude = max(0.05, 0.8 - coherence_target)

            # Update stability based on coherence
            node_state.stability_index = min(0.95, coherence_target + 0.1)

            # Set appropriate operator
            if coherence_target > 0.8:
                node_state.last_operator = "coherence"
            elif coherence_target < 0.7:
                node_state.last_operator = "dissonance"
            else:
                node_state.last_operator = "coupling"

            node_state.operator_timestamp = time.time()

    def _create_partition_boundaries(self):
        """Create realistic partition state based on factorization structure."""

        # For demonstration, create two partitions
        mid_point = self.node_count // 2

        partition_1 = PartitionState(
            partition_id=f"partition_1_{self.modulus_n}",
            boundary_nodes=[mid_point - 1, mid_point],
            internal_nodes=list(range(0, mid_point - 1)),
            coherence_ratio=0.78,
            phase_gradient=0.15,
            curvature_delta=0.22,
            coupling_strength=0.72,
            fragmentation_risk=0.12 if self._is_factorizable() else 0.3,
            operator_sequence=["emission", "coupling", "resonance"],
        )

        partition_2 = PartitionState(
            partition_id=f"partition_2_{self.modulus_n}",
            boundary_nodes=[mid_point, mid_point + 1],
            internal_nodes=list(range(mid_point + 1, self.node_count)),
            coherence_ratio=0.74,
            phase_gradient=0.18,
            curvature_delta=0.28,
            coupling_strength=0.68,
            fragmentation_risk=0.15 if self._is_factorizable() else 0.35,
            operator_sequence=["reception", "coupling", "coherence"],
        )

        self.partition_states = [partition_1, partition_2]

    def _update_spectral_properties(self):
        """Update network topology with spectral analysis results."""

        # Simulate eigenvalue changes from spectral clustering
        self.network_topology.algebraic_connectivity = 0.6
        self.network_topology.spectral_gap = 0.35

        # Better clustering after spectral analysis
        self.network_topology.clustering_coefficient = 0.25

        if self._is_factorizable():
            # Factorizable numbers show clearer component separation
            self.network_topology.resonant_components = 2
            self.network_topology.fragmented_regions = 0
        else:
            # Prime numbers remain more integrated
            self.network_topology.resonant_components = 1
            self.network_topology.fragmented_regions = 0

    def _update_verification_metrics(self, coherence: float):
        """Update verification confidence based on structural analysis."""

        if self._is_factorizable():
            # Clear factor structure increases confidence
            self.verification_confidence = 0.85 + (coherence - 0.8) * 2
        else:
            # Prime numbers show lower confidence
            self.verification_confidence = 0.65 + (coherence - 0.8) * 1.5

        # Clamp confidence to valid range
        self.verification_confidence = max(0.0, min(1.0, self.verification_confidence))

    def _finalize_verification(self, coherence: float):
        """Finalize verification state."""

        # Update structural fields for final state
        self.structural_fields.phi_s_global = 1.1 + (coherence - 0.8) * 2
        self.structural_fields.energy_density = 2.2 + coherence * 1.5

        if self._is_factorizable() and self.verification_confidence > 0.8:
            # Successful factorization
            self.structural_fields.topological_charge = 0.4
            self.structural_fields.symmetry_breaking = 0.2
        else:
            # No clear factor structure
            self.structural_fields.topological_charge = 0.1
            self.structural_fields.symmetry_breaking = 0.05

    def _capture_stage_snapshot(self, stage_name: str, stage_index: int) -> str:
        """Capture snapshot of current verification state."""

        # Performance metrics
        elapsed_time = (time.time() - self.start_time) * 1000  # ms
        performance_metrics = {
            "coherence": (
                self.coherence_evolution[-1] if self.coherence_evolution else 0.5
            ),
            "sense_index": 0.6 + (stage_index * 0.05),  # Gradual improvement
            "confidence": self.verification_confidence,
            "dnfr_budget": max(10.0, 100.0 - (stage_index * 20)),  # Budget consumption
            "iterations": stage_index + 1,
            "elapsed_ms": elapsed_time,
            "memory_mb": 35.0 + (stage_index * 5),
            "cpu_percent": 20.0 + (stage_index * 8),
        }

        # Determine candidate factor
        candidate_factor = None
        if (
            stage_name == "completion"
            and self._is_factorizable()
            and self.verification_confidence > 0.8
        ):
            candidate_factor = self._get_candidate_factor()

        # Create snapshot
        return self.snapshot_manager.create_snapshot(
            verification_stage=stage_name,
            modulus_n=self.modulus_n,
            candidate_factor=candidate_factor,
            partition_strategy=self.partition_strategy,
            nodal_states=self.nodal_states,
            partition_states=getattr(self, "partition_states", []),
            structural_fields=self.structural_fields,
            network_topology=self.network_topology,
            performance_metrics=performance_metrics,
        )

    def _is_factorizable(self) -> bool:
        """Check if current modulus is factorizable (for demo purposes)."""

        # Simple factorability check for demo
        test_factors = [7, 11, 13, 17, 19]
        return any(self.modulus_n % factor == 0 for factor in test_factors)

    def _get_candidate_factor(self) -> int:
        """Get candidate factor for successful factorization."""

        test_factors = [7, 11, 13, 17, 19]
        for factor in test_factors:
            if self.modulus_n % factor == 0:
                return factor
        return 7  # Fallback


def demonstrate_snapshot_integration():
    """Run complete snapshot integration demonstration."""

    print("TNFR PARTITION SNAPSHOT INTEGRATION DEMO")
    print("=" * 60)
    print("Demonstrating state capture during factorization verification")

    # Create snapshot manager
    demo_db_path = Path("integration_demo_snapshots.db")
    snapshot_manager = PartitionSnapshotManager(demo_db_path)

    # Test with different numbers (factorizable and prime)
    test_numbers = [77, 91, 143, 89, 97]  # Mix of composites and primes

    all_results = []

    for modulus_n in test_numbers:
        print(f"\n" + "=" * 60)
        print(f"TESTING n = {modulus_n}")
        print("=" * 60)

        # Create factorization engine
        engine = MockFactorizationEngine(modulus_n, snapshot_manager)

        # Run verification with snapshots
        success, snapshot_ids = engine.run_verification_with_snapshots()

        # Analyze trajectory
        analysis = snapshot_manager.analyze_trajectory_coherence(snapshot_ids)

        print(f"\n📊 TRAJECTORY ANALYSIS:")
        print(f"   Coherence trend: {analysis['coherence_trend']:.4f}")
        print(f"   Coherence range: {analysis['coherence_range']}")
        print(f"   Final coherence: {analysis['final_coherence']:.3f}")
        print(f"   Snapshots captured: {len(snapshot_ids)}")

        # Store results
        all_results.append(
            {
                "modulus_n": modulus_n,
                "success": success,
                "snapshot_count": len(snapshot_ids),
                "coherence_trend": analysis["coherence_trend"],
                "final_coherence": analysis["final_coherence"],
                "snapshot_ids": snapshot_ids,
            }
        )

        # Export trajectory for this number
        export_path = Path(f"trajectory_{modulus_n}.json")
        snapshot_manager.export_trajectory_data(snapshot_ids, export_path)
        print(f"   📁 Trajectory exported: {export_path}")

    # Summary analysis
    print(f"\n" + "=" * 60)
    print("INTEGRATION DEMO SUMMARY")
    print("=" * 60)

    successful_factorizations = sum(1 for r in all_results if r["success"])
    total_snapshots = sum(r["snapshot_count"] for r in all_results)

    print(f"Numbers tested: {len(test_numbers)}")
    print(f"Successful factorizations: {successful_factorizations}")
    print(f"Total snapshots captured: {total_snapshots}")
    print(f"Average snapshots per number: {total_snapshots / len(test_numbers):.1f}")

    # Show coherence trend analysis
    positive_trends = sum(1 for r in all_results if r["coherence_trend"] > 0)
    print(f"Numbers with positive coherence trend: {positive_trends}")

    # Best and worst performers
    best_result = max(all_results, key=lambda x: x["final_coherence"])
    worst_result = min(all_results, key=lambda x: x["final_coherence"])

    print(
        f"\n🏆 Best performance: n={best_result['modulus_n']} (C={best_result['final_coherence']:.3f})"
    )
    print(
        f"🔍 Needs improvement: n={worst_result['modulus_n']} (C={worst_result['final_coherence']:.3f})"
    )

    # List all available snapshots
    print(f"\n📸 SNAPSHOT DATABASE CONTENTS:")
    all_snapshots = snapshot_manager.list_snapshots(limit=50)

    by_number = {}
    for snapshot in all_snapshots:
        n = snapshot["modulus_n"]
        if n not in by_number:
            by_number[n] = []
        by_number[n].append(snapshot)

    for n in sorted(by_number.keys()):
        snapshots = by_number[n]
        print(f"   n={n}: {len(snapshots)} snapshots")
        for snapshot in snapshots:
            stage = snapshot["verification_stage"]
            coherence = snapshot["overall_coherence"]
            print(f"     - {stage}: C={coherence:.3f}")

    print(f"\n✅ Integration demo completed successfully!")
    print(f"   Database: {demo_db_path}")
    print(f"   Contains {len(all_snapshots)} total snapshots")

    # Cleanup database for demo
    import os

    if demo_db_path.exists():
        os.remove(demo_db_path)
        print(f"   🧹 Demo database cleaned up")

    return True


if __name__ == "__main__":
    success = demonstrate_snapshot_integration()
    print(f"\nDemo {'completed successfully' if success else 'failed'}")
    exit(0 if success else 1)