@@ -880,6 +880,96 @@ Improvement: 1.00× (already optimal)
880880
881881---
882882
883+ ## Development Workflow & Results
884+
885+ ### Analysis Framework
886+
887+ The repository provides tools for automated analysis and optimization:
888+
889+ ``` bash
890+ # Parameter sweeps with caching
891+ python run_analysis.py sweep-xi --xi 50 100 200 --cache --plot
892+ python run_analysis.py sweep-materials --xi 100 --cache --plot
893+
894+ # Geometry optimization
895+ python optimize_geometry.py --xi 100 --resolution 41 --method Nelder-Mead
896+ python optimize_geometry.py --grid-search --grid-range -0.1 0.1 --grid-steps 5
897+ ```
898+
899+ ### Domain Convergence
900+
901+ ** Key finding** : Solver accuracy depends on domain padding. Recommendation from systematic study:
902+
903+ - ** Minimum padding** : ≥2.5× characteristic length
904+ - ** Tested at 61³ resolution** : ~ 7.1% Δτ variation across padding factors [ 1.0, 3.0]
905+ - ** Convergence** : Δτ stable to <1% for padding ≥2.5
906+ - ** Default** : 3× padding used in production runs
907+
908+ See ` examples/domain_bc_sweep.py ` for details.
909+
910+ ### Result Caching
911+
912+ ** Performance boost** : ~ 250-600× speedup on cache hits for typical 41³ grids.
913+
914+ The framework implements SHA256-based caching of Poisson solutions:
915+ - ** Key** : Hash of {ξ, Φ₀, grid params, mass config}
916+ - ** Storage** : NPZ (φ field) + JSON (metadata) in ` results/cache/ `
917+ - ** Invalidation** : Automatic on parameter mismatch
918+
919+ ``` bash
920+ # Enable caching in any script
921+ python examples/geometric_cavendish.py --cache
922+
923+ # Cache management
924+ make cache-info # Print cache statistics
925+ make cache-clean # Clear all cached results
926+ ```
927+
928+ ** Example timings** (Intel i7, 41³ grid):
929+ - First run: ~ 4.3 s (compute)
930+ - Cache hit: ~ 0.02 s (load from disk)
931+ - Improvement: ** 215×**
932+
933+ ### Publication-Quality Plotting
934+
935+ All analysis scripts support ` --plot ` for automatic figure generation:
936+
937+ ``` bash
938+ python run_analysis.py sweep-xi --xi 50 100 200 --cache --plot
939+ # Generates: results/analysis/xi_sweep_YYYYMMDD_HHMMSS_plot.{png,pdf}
940+ ```
941+
942+ ** Features** :
943+ - Multi-panel sweep plots with cache indicators
944+ - Material comparison bar charts
945+ - Optimization convergence traces
946+ - 3D landscape visualization
947+ - Consistent publication styling (high DPI, LaTeX fonts)
948+ - Multi-format output (PNG + PDF)
949+
950+ See ` src/visualization/plot_utils.py ` for plot customization.
951+
952+ ### Testing & Quality
953+
954+ ``` bash
955+ make test # Run full test suite (23 tests)
956+ make quick-bench # Fast performance check
957+ pytest -q # Direct pytest invocation
958+ ```
959+
960+ ** Test coverage** :
961+ - ✅ Coherence invariance (5 tests)
962+ - ✅ Conservation laws (4 tests)
963+ - ✅ Field equations (6 tests)
964+ - ✅ Interface matching (1 test)
965+ - ✅ Newtonian limits (1 test)
966+ - ✅ Parameterization (3 tests)
967+ - ✅ Volume averaging (3 tests)
968+
969+ ** Status** : 23/23 passing, 0 warnings (as of Oct 2025)
970+
971+ ---
972+
883973## References
884974
885975** Non-minimal coupling in gravity** :
0 commit comments