How carlsr9001/wh-falsify works
Project type and purpose
• This is a scientific simulation and diagnostic pipeline (“Wormhole Analog Lab”) for generating, analyzing, and visualizing synthetic traversable wormhole experiments.
• It provides a CLI entry point for running simulations, a Python package (wormhole_proof) implementing the core dynamics and analysis, a suite of standalone analysis scripts, and a FastAPI-based visualization server.
File structure
• Top-level CLI scripts:
• run_smooth.py, debug_run.py, debug_run_default.py
• Experiment artifacts (JSON/MD outputs) organized under gr_suite*/, relativistic_suite* directories
• scripts/ folder: standalone analysis helpers (e.g. gr_hotspot_report.py, gr_metric_analysis.py, run_gr_suite.py, run_relativistic.py)
• wormhole_proof/ package:
• core/ (simulation engine, sweep, smoothing)
• analysis/ (relativistic diagnostics)
• wireframe/ (FastAPI server, static viewer, projection logic)
• config.py, report.py, visualization.py, experiment.py
• tests/ for unit tests, and requirements.txt for dependencies
README for additional insights
• The wireframe server uses FastAPI to serve interactive 3D/high-D views.
• Artifacts folder is version-controlled for reproducibility.
Detail without over-splitting
• Logical component (CLI entry, simulation engine, analysis library, report generator, visualization service, artifact storage, tests).
• Don’t hesitate to break out submodules (e.g. core/benchmarks, analysis/relativistic.py) if they play a distinct role in your workflow.
• Keep the focus on the essential architectural elements and their interactions rather than every single file.