demos README - zfifteen/unified-framework GitHub Wiki

Demo Scripts

This directory contains demonstration scripts showcasing the Z-Framework's capabilities and practical applications.

Contents

Core Demonstrations

  • simple_demo.py - Basic Z-Framework demonstration with key mathematical concepts
  • scripts/demo_z_framework.py - Comprehensive framework demonstration with multiple use cases
  • cli_demo.py - Command-line interface demonstration for interactive usage
  • scripts/demo_kbllm.py - Knowledge base LLM integration demonstration per KBLLM.txt

API and Scoring Demonstrations

  • scripts/demo_api_scoring.py - API scoring system demonstration with performance metrics
  • start_api_server.py - API server startup script for web service demonstration

Prime Analysis Demonstrations

  • prime_geodesic_demo.py - Geodesic prime analysis demonstration with visualization
  • prime_compression_demo.py - Prime compression algorithms and efficiency demonstration
  • simple_compression_example.py - Basic prime compression example with clear explanations

Demo Framework

Per KBLLM.txt practical applications and demonstration protocols:

Educational Demonstrations

  • Mathematical Concepts: Interactive examples of golden ratio transformations
  • Geometric Visualizations: 5D helical embeddings and prime spiral demonstrations
  • Statistical Validation: Live examples of bootstrap analysis and confidence intervals

Practical Applications

  • Prime Generation: Enhanced density prediction algorithms in action
  • Compression Algorithms: Geometric prime compression techniques
  • API Integration: Web service demonstrations and scoring systems

Knowledge Base Integration

  • KBLLM Demonstration: Token-chain structured knowledge processing examples
  • Cross-Domain Validation: Physical-discrete domain bridging demonstrations
  • Framework Integration: Core module usage patterns and best practices

Usage

Running Demonstrations

# Basic framework demonstration
python docs/demos/simple_demo.py

# Comprehensive framework showcase
python scripts/demo_z_framework.py

# Prime geodesic analysis
python docs/demos/prime_geodesic_demo.py

# Knowledge base LLM integration
python scripts/demo_kbllm.py

Requirements

  • Python 3.8+
  • Core Z-Framework dependencies (numpy, scipy, matplotlib, mpmath, sympy)
  • Access to src/ modules via PYTHONPATH

Educational Value

These demonstrations provide hands-on experience with:

  • Core Mathematical Concepts: Direct interaction with Z-Framework axioms
  • Practical Implementation: Real-world usage patterns and applications
  • Visualization Tools: Interactive and static visualizations of mathematical concepts
  • Performance Analysis: Computational efficiency and optimization demonstrations

Integration with Framework

These demo scripts integrate with the main Z-Framework components documented in the KBLLM knowledge base:

  • Core Axioms: c-invariance, v/c distortion effects, T(v/c) measurement units
  • Mathematical Discoveries: Prime clustering, golden ratio optimizations, zeta correlations
  • Computational Methods: High-precision arithmetic, parallel processing, statistical validation
  • Practical Applications: Prime generation, geodesic visualization, compression algorithms

Each demonstration is designed to showcase specific aspects of the unified mathematical framework while maintaining educational clarity and computational accuracy.