sqrtspace/Ubiquity of Space-Time Experiments
2
0
Fork 0
Code Issues Releases

Update README.md

Browse Source
This commit is contained in:
David H. Friedel Jr.
2025-07-21 18:19:21 -04:00
parent 979788de5c
commit 3cbd817d69
1 changed files with 16 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
README.md
View File

@@ -76,6 +76,7 @@ python ollama_spacetime_experiment.py
### Prerequisites ### Prerequisites
- Python 3.8+ (for Python experiments) - Python 3.8+ (for Python experiments)
- .NET Core SDK (for C# maze solver) - .NET Core SDK (for C# maze solver)
- Ollama (optional, for real LLM experiments)
- 2GB free memory for experiments - 2GB free memory for experiments
### Installation ### Installation
@@ -97,6 +98,9 @@ streamlit run dashboard/app.py
cd experiments/maze_solver && dotnet run && cd ../.. cd experiments/maze_solver && dotnet run && cd ../..
cd experiments/checkpointed_sorting && python checkpointed_sort.py && cd ../.. cd experiments/checkpointed_sorting && python checkpointed_sort.py && cd ../..
cd experiments/stream_processing && python sliding_window.py && cd ../.. cd experiments/stream_processing && python sliding_window.py && cd ../..
cd experiments/database_buffer_pool && python sqlite_heavy_experiment.py && cd ../..
cd experiments/llm_kv_cache && python llm_kv_cache_experiment.py && cd ../..
cd experiments/llm_ollama && python ollama_spacetime_experiment.py && cd ../.. # Requires Ollama
``` ```
## Repository Structure ## Repository Structure
@@ -104,11 +108,16 @@ cd experiments/stream_processing && python sliding_window.py && cd ../..
``` ```
├── experiments/ # Core experiments demonstrating tradeoffs ├── experiments/ # Core experiments demonstrating tradeoffs
│ ├── maze_solver/ # C# graph traversal with memory limits │ ├── maze_solver/ # C# graph traversal with memory limits
│ ├── checkpointed_sorting/ # Python external sorting │ ├── checkpointed_sorting/ # Python external sorting with O(√n) space
│ └── stream_processing/ # Python sliding window vs full storage │ ├── stream_processing/ # Python sliding window vs full storage
│ ├── database_buffer_pool/ # SQLite experiments with different cache sizes
│ ├── llm_kv_cache/ # Simulated LLM attention mechanism tradeoffs
│ ├── llm_ollama/ # Real LLM experiments with Ollama models
│ └── measurement_framework.py # Shared profiling and analysis tools
├── dashboard/ # Interactive Streamlit visualizations ├── dashboard/ # Interactive Streamlit visualizations
│ └── app.py # 6-page interactive dashboard │ ├── app.py # 6-page interactive dashboard
└── FINDINGS.md # Verified experimental results │ └── requirements.txt # Dashboard dependencies
└── FINDINGS.md # Verified experimental results with statistical analysis
``` ```
## Interactive Dashboard ## Interactive Dashboard