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 conceptsscripts/demo_z_framework.py
- Comprehensive framework demonstration with multiple use casescli_demo.py
- Command-line interface demonstration for interactive usagescripts/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 metricsstart_api_server.py
- API server startup script for web service demonstration
Prime Analysis Demonstrations
prime_geodesic_demo.py
- Geodesic prime analysis demonstration with visualizationprime_compression_demo.py
- Prime compression algorithms and efficiency demonstrationsimple_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.