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/tests/test_snapshot_system.py

test_snapshot_system.py

Test Suite for TNFR Partition Invariant Snapshot Schema

Validates snapshot creation, storage, retrieval, and analysis capabilities. Tests integrity, compression, trajectory analysis, and reproducibility.

Source Code

python
"""
Test Suite for TNFR Partition Invariant Snapshot Schema

Validates snapshot creation, storage, retrieval, and analysis capabilities.
Tests integrity, compression, trajectory analysis, and reproducibility.
"""

import json
import sys
import tempfile
import time
import unittest
from pathlib import Path

import numpy as np

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

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


class TestSnapshotDataStructures(unittest.TestCase):
    """Test snapshot data structure integrity."""

    def test_nodal_state_creation(self):
        """Test NodalState dataclass creation and validation."""

        nodal_state = NodalState(
            node_id=5,
            epi_vector=[0.1, 0.2, 0.3],
            structural_frequency=1.5,
            phase=0.8,
            theta=1.2,
            dnfr_magnitude=0.3,
            coupling_count=4,
            last_operator="coherence",
            operator_timestamp=time.time(),
            stability_index=0.7,
        )

        self.assertEqual(nodal_state.node_id, 5)
        self.assertEqual(len(nodal_state.epi_vector), 3)
        self.assertGreater(nodal_state.structural_frequency, 0)
        self.assertIn(
            nodal_state.last_operator,
            ["coherence", "dissonance", "emission", "reception"],
        )

    def test_partition_state_creation(self):
        """Test PartitionState dataclass creation and validation."""

        partition_state = PartitionState(
            partition_id="test_partition",
            boundary_nodes=[1, 3, 5],
            internal_nodes=[0, 2, 4, 6],
            coherence_ratio=0.85,
            phase_gradient=0.12,
            curvature_delta=0.25,
            coupling_strength=0.7,
            fragmentation_risk=0.1,
            operator_sequence=["emission", "coupling", "coherence"],
        )

        self.assertEqual(partition_state.partition_id, "test_partition")
        self.assertEqual(len(partition_state.boundary_nodes), 3)
        self.assertLessEqual(partition_state.coherence_ratio, 1.0)
        self.assertGreaterEqual(partition_state.fragmentation_risk, 0.0)

    def test_structural_field_snapshot_creation(self):
        """Test StructuralFieldSnapshot with TNFR tetrad fields."""

        snapshot = StructuralFieldSnapshot(
            phi_s_global=1.2,
            phi_s_distribution=[0.5, 0.6, 0.7],
            phase_gradient_field=[0.1, 0.15, 0.12],
            curvature_field=[0.2, 0.18, 0.22],
            coherence_length=5.0,
            coherence_field=[0.8, 0.75, 0.82],
            energy_density=2.5,
            topological_charge=0.3,
            symmetry_breaking=0.1,
        )

        # Validate TNFR tetrad components
        self.assertIsInstance(snapshot.phi_s_global, float)  # Φ_s global
        self.assertEqual(len(snapshot.phase_gradient_field), 3)  # |∇φ| field
        self.assertEqual(len(snapshot.curvature_field), 3)  # K_φ field
        self.assertGreater(snapshot.coherence_length, 0)  # ξ_C > 0

        # Validate derived invariants
        self.assertGreater(snapshot.energy_density, 0)  # ℰ > 0
        self.assertIsInstance(snapshot.topological_charge, float)  # 𝒬
        self.assertIsInstance(snapshot.symmetry_breaking, float)  # 𝒮


class TestSnapshotCompression(unittest.TestCase):
    """Test snapshot compression and decompression."""

    def setUp(self):
        """Set up test data."""

        self.nodal_states = [create_mock_nodal_state(i) for i in range(5)]
        self.partition_states = [
            PartitionState(
                partition_id="test_partition",
                boundary_nodes=[1, 2],
                internal_nodes=[0, 3, 4],
                coherence_ratio=0.8,
                phase_gradient=0.1,
                curvature_delta=0.2,
                coupling_strength=0.7,
                fragmentation_risk=0.05,
                operator_sequence=["emission", "coherence"],
            )
        ]
        self.structural_fields = create_mock_structural_fields(5)
        self.network_topology = create_mock_network_topology(5)

        self.test_snapshot = VerificationSnapshot(
            snapshot_id="test_snap_001",
            timestamp=time.time(),
            verification_stage="testing",
            modulus_n=35,
            candidate_factor=5,
            partition_strategy="test_strategy",
            nodal_states=self.nodal_states,
            partition_states=self.partition_states,
            structural_fields=self.structural_fields,
            network_topology=self.network_topology,
            overall_coherence=0.85,
            sense_index=0.72,
            verification_confidence=0.9,
            dnfr_budget_remaining=75.0,
            convergence_iterations=3,
            elapsed_time_ms=1200.0,
            memory_usage_mb=32.5,
            cpu_usage_percent=45.2,
            state_hash="test_hash",
        )

    def test_compression_roundtrip(self):
        """Test compression and decompression preserve data."""

        # Compress
        compressed_data = SnapshotCompressor.compress_snapshot(self.test_snapshot)
        self.assertIsInstance(compressed_data, bytes)
        self.assertGreater(len(compressed_data), 0)

        # Decompress
        recovered_snapshot = SnapshotCompressor.decompress_snapshot(compressed_data)

        # Validate recovery
        self.assertEqual(recovered_snapshot.snapshot_id, self.test_snapshot.snapshot_id)
        self.assertEqual(recovered_snapshot.modulus_n, self.test_snapshot.modulus_n)
        self.assertEqual(
            len(recovered_snapshot.nodal_states), len(self.test_snapshot.nodal_states)
        )
        self.assertAlmostEqual(
            recovered_snapshot.overall_coherence, self.test_snapshot.overall_coherence
        )

        # Validate nested structures
        self.assertEqual(len(recovered_snapshot.partition_states), 1)
        self.assertEqual(
            recovered_snapshot.partition_states[0].partition_id, "test_partition"
        )
        self.assertAlmostEqual(
            recovered_snapshot.structural_fields.phi_s_global,
            self.test_snapshot.structural_fields.phi_s_global,
        )

    def test_compression_efficiency(self):
        """Test compression achieves reasonable size reduction."""

        import pickle

        # Raw pickle size
        raw_size = len(pickle.dumps(self.test_snapshot))

        # Compressed size
        compressed_data = SnapshotCompressor.compress_snapshot(self.test_snapshot)
        compressed_size = len(compressed_data)

        # Should achieve some compression
        compression_ratio = compressed_size / raw_size
        self.assertLess(compression_ratio, 1.0)  # Some compression achieved
        self.assertGreater(
            compression_ratio, 0.3
        )  # Not too aggressive to maintain speed


class TestPartitionSnapshotManager(unittest.TestCase):
    """Test snapshot manager functionality."""

    def setUp(self):
        """Set up test manager with temporary database."""

        self.temp_dir = tempfile.mkdtemp(prefix="test_snapshot_db_")
        self.db_path = Path(self.temp_dir) / "test_snapshots.db"
        self.manager = PartitionSnapshotManager(self.db_path)

        # Test data
        self.nodal_states = [create_mock_nodal_state(i) for i in range(10)]
        self.partition_states = [
            PartitionState(
                partition_id="part_A",
                boundary_nodes=[2, 5, 8],
                internal_nodes=[0, 1, 3, 4, 6, 7, 9],
                coherence_ratio=0.82,
                phase_gradient=0.14,
                curvature_delta=0.21,
                coupling_strength=0.68,
                fragmentation_risk=0.08,
                operator_sequence=["emission", "coupling", "resonance", "coherence"],
            )
        ]
        self.structural_fields = create_mock_structural_fields(10)
        self.network_topology = create_mock_network_topology(10)
        self.performance_metrics = {
            "coherence": 0.82,
            "sense_index": 0.75,
            "confidence": 0.88,
            "elapsed_ms": 1500.0,
            "memory_mb": 48.2,
            "cpu_percent": 32.5,
        }

    def tearDown(self):
        """Clean up test files."""

        import shutil

        shutil.rmtree(self.temp_dir, ignore_errors=True)

    def test_snapshot_creation_and_retrieval(self):
        """Test creating and retrieving snapshots."""

        # Create snapshot
        snapshot_id = self.manager.create_snapshot(
            verification_stage="initialization",
            modulus_n=77,
            candidate_factor=None,
            partition_strategy="spectral_paley",
            nodal_states=self.nodal_states,
            partition_states=self.partition_states,
            structural_fields=self.structural_fields,
            network_topology=self.network_topology,
            performance_metrics=self.performance_metrics,
        )

        self.assertIsInstance(snapshot_id, str)
        self.assertTrue(snapshot_id.startswith("snap_"))

        # Retrieve snapshot
        retrieved_snapshot = self.manager.load_snapshot(snapshot_id)
        self.assertIsNotNone(retrieved_snapshot)
        self.assertEqual(retrieved_snapshot.modulus_n, 77)
        self.assertEqual(retrieved_snapshot.verification_stage, "initialization")
        self.assertEqual(len(retrieved_snapshot.nodal_states), 10)

    def test_snapshot_listing_and_filtering(self):
        """Test listing snapshots with filtering."""

        # Create multiple snapshots
        for i, stage in enumerate(["init", "partition", "verify", "complete"]):
            self.manager.create_snapshot(
                verification_stage=stage,
                modulus_n=77 + i,
                candidate_factor=7 if stage == "complete" else None,
                partition_strategy="spectral_paley",
                nodal_states=self.nodal_states,
                partition_states=self.partition_states,
                structural_fields=self.structural_fields,
                network_topology=self.network_topology,
                performance_metrics=self.performance_metrics,
            )

        # List all snapshots
        all_snapshots = self.manager.list_snapshots()
        self.assertEqual(len(all_snapshots), 4)

        # Filter by modulus
        filtered_snapshots = self.manager.list_snapshots(modulus_n=79)
        self.assertEqual(len(filtered_snapshots), 1)
        self.assertEqual(filtered_snapshots[0]["verification_stage"], "verify")

        # Filter by stage
        stage_snapshots = self.manager.list_snapshots(verification_stage="complete")
        self.assertEqual(len(stage_snapshots), 1)
        self.assertEqual(stage_snapshots[0]["modulus_n"], 80)

    def test_trajectory_analysis(self):
        """Test verification trajectory analysis."""

        # Create trajectory snapshots
        modulus_n = 91
        strategy = "test_strategy"
        snapshot_ids = []

        for i, stage in enumerate(["init", "partition", "verify", "complete"]):
            # Simulate coherence improvement
            metrics = self.performance_metrics.copy()
            metrics["coherence"] = 0.7 + (i * 0.05)  # Increasing coherence

            snapshot_id = self.manager.create_snapshot(
                verification_stage=stage,
                modulus_n=modulus_n,
                candidate_factor=7 if stage == "complete" else None,
                partition_strategy=strategy,
                nodal_states=self.nodal_states,
                partition_states=self.partition_states,
                structural_fields=self.structural_fields,
                network_topology=self.network_topology,
                performance_metrics=metrics,
            )
            snapshot_ids.append(snapshot_id)

        # Get trajectory
        trajectory = self.manager.get_verification_trajectory(modulus_n, strategy)
        self.assertEqual(len(trajectory), 4)

        # Analyze trajectory
        analysis = self.manager.analyze_trajectory_coherence(trajectory)

        self.assertEqual(analysis["trajectory_length"], 4)
        self.assertGreater(analysis["coherence_trend"], 0)  # Positive trend
        self.assertAlmostEqual(analysis["final_coherence"], 0.85, places=2)
        self.assertEqual(analysis["coherence_range"], (0.7, 0.85))

    def test_trajectory_export(self):
        """Test trajectory data export."""

        # Create test trajectory
        snapshot_ids = []
        for stage in ["init", "verify"]:
            snapshot_id = self.manager.create_snapshot(
                verification_stage=stage,
                modulus_n=35,
                candidate_factor=None,
                partition_strategy="test_export",
                nodal_states=self.nodal_states[:3],  # Smaller for export test
                partition_states=self.partition_states,
                structural_fields=self.structural_fields,
                network_topology=create_mock_network_topology(3),
                performance_metrics=self.performance_metrics,
            )
            snapshot_ids.append(snapshot_id)

        # Export trajectory
        export_path = Path(self.temp_dir) / "test_export.json"
        success = self.manager.export_trajectory_data(snapshot_ids, export_path)

        self.assertTrue(success)
        self.assertTrue(export_path.exists())

        # Validate export content
        with open(export_path, "r") as f:
            export_data = json.load(f)

        self.assertEqual(export_data["metadata"]["trajectory_length"], 2)
        self.assertEqual(export_data["metadata"]["modulus_n"], 35)
        self.assertEqual(len(export_data["snapshots"]), 2)

    def test_integrity_verification(self):
        """Test snapshot integrity checking."""

        # Create snapshot
        snapshot_id = self.manager.create_snapshot(
            verification_stage="integrity_test",
            modulus_n=143,
            candidate_factor=11,
            partition_strategy="integrity_check",
            nodal_states=self.nodal_states,
            partition_states=self.partition_states,
            structural_fields=self.structural_fields,
            network_topology=self.network_topology,
            performance_metrics=self.performance_metrics,
        )

        # Retrieve and verify integrity (should succeed)
        snapshot = self.manager.load_snapshot(snapshot_id)
        self.assertIsNotNone(snapshot)
        self.assertEqual(snapshot.modulus_n, 143)

        # Test hash computation consistency
        hash1 = self.manager._compute_state_hash(snapshot)
        hash2 = self.manager._compute_state_hash(snapshot)
        self.assertEqual(hash1, hash2)  # Deterministic hashing

    def test_cleanup_old_snapshots(self):
        """Test cleanup of old snapshots."""

        # Create test snapshots
        for i in range(3):
            self.manager.create_snapshot(
                verification_stage="cleanup_test",
                modulus_n=100 + i,
                candidate_factor=None,
                partition_strategy="cleanup",
                nodal_states=self.nodal_states,
                partition_states=self.partition_states,
                structural_fields=self.structural_fields,
                network_topology=self.network_topology,
                performance_metrics=self.performance_metrics,
            )

        # Verify snapshots exist
        initial_count = len(self.manager.list_snapshots())
        self.assertEqual(initial_count, 3)

        # Cleanup (very old threshold to not delete our test data)
        deleted_count = self.manager.cleanup_old_snapshots(
            max_age_hours=0.001
        )  # 3.6 seconds

        # Should not delete recent snapshots
        final_count = len(self.manager.list_snapshots())
        self.assertEqual(final_count, 3)  # No deletion for recent snapshots


class TestSnapshotUtilities(unittest.TestCase):
    """Test utility functions for snapshot creation."""

    def test_mock_nodal_state_creation(self):
        """Test mock nodal state utility."""

        # Coherent state
        coherent_state = create_mock_nodal_state(5, coherent=True)
        self.assertEqual(coherent_state.node_id, 5)
        self.assertGreater(coherent_state.structural_frequency, 1.0)
        self.assertEqual(coherent_state.last_operator, "coherence")
        self.assertGreater(coherent_state.stability_index, 0.5)

        # Dissonant state
        dissonant_state = create_mock_nodal_state(7, coherent=False)
        self.assertEqual(dissonant_state.node_id, 7)
        self.assertLess(dissonant_state.structural_frequency, 0.5)
        self.assertEqual(dissonant_state.last_operator, "dissonance")
        self.assertLess(dissonant_state.stability_index, 0.5)

    def test_mock_structural_fields_creation(self):
        """Test mock structural fields utility."""

        fields = create_mock_structural_fields(8)

        # Validate tetrad fields
        self.assertGreater(fields.phi_s_global, 0)  # Φ_s > 0
        self.assertEqual(len(fields.phi_s_distribution), 8)
        self.assertEqual(len(fields.phase_gradient_field), 8)  # |∇φ|
        self.assertEqual(len(fields.curvature_field), 8)  # K_φ
        self.assertGreater(fields.coherence_length, 0)  # ξ_C > 0

        # Validate invariants
        self.assertGreater(fields.energy_density, 0)  # ℰ > 0
        self.assertIsInstance(fields.topological_charge, float)
        self.assertIsInstance(fields.symmetry_breaking, float)

    def test_mock_network_topology_creation(self):
        """Test mock network topology utility."""

        topology = create_mock_network_topology(6)

        self.assertEqual(topology.node_count, 6)
        self.assertEqual(len(topology.adjacency_matrix), 6)
        self.assertEqual(len(topology.adjacency_matrix[0]), 6)
        self.assertGreater(topology.edge_count, 0)

        # Ring topology properties
        self.assertEqual(topology.clustering_coefficient, 0.0)  # No triangles in ring
        self.assertGreater(topology.characteristic_path_length, 0)
        self.assertEqual(topology.resonant_components, 1)  # Single component


def run_snapshot_tests():
    """Run all snapshot system tests."""

    # Create test suite
    loader = unittest.TestLoader()
    suite = unittest.TestSuite()

    # Add test classes
    suite.addTests(loader.loadTestsFromTestCase(TestSnapshotDataStructures))
    suite.addTests(loader.loadTestsFromTestCase(TestSnapshotCompression))
    suite.addTests(loader.loadTestsFromTestCase(TestPartitionSnapshotManager))
    suite.addTests(loader.loadTestsFromTestCase(TestSnapshotUtilities))

    # Run tests
    runner = unittest.TextTestRunner(verbosity=2)
    result = runner.run(suite)

    # Summary
    tests_run = result.testsRun
    failures = len(result.failures)
    errors = len(result.errors)

    print(f"\n" + "=" * 60)
    print(f"SNAPSHOT SYSTEM TEST SUMMARY")
    print(f"=" * 60)
    print(f"Tests run: {tests_run}")
    print(f"Failures: {failures}")
    print(f"Errors: {errors}")
    print(f"Success rate: {((tests_run - failures - errors) / tests_run * 100):.1f}%")

    if failures == 0 and errors == 0:
        print("✅ All snapshot system tests passed!")
        return True
    else:
        print("❌ Some tests failed - check output above")
        return False


if __name__ == "__main__":
    success = run_snapshot_tests()
    exit(0 if success else 1)