Oscillating Brane Dark Matter Theory

A revolutionary cosmological theory where the universe is a vibrating 4D membrane in 5D space. Dark matter oscillations create dark energy, resolve the S₈ tension, and naturally produce MOND-like effects. Testable predictions for Euclid and PTA.

View the Project on GitHub Teleadmin-ai/oscillating-brane-DM

CLAUDE.md - Project Information for AI Assistants

Project Overview

This is the Oscillating Brane Dark Matter Theory project - a revolutionary cosmological theory where the universe is conceptualized as a vibrating 4D membrane in 5D space.

Repository Information

GitHub Authentication

When working with this repository, use GitHub CLI (gh) for authentication. The user has personal access tokens configured.

Important Notes:

  1. The GitHub user is Teleadmin-ai (not Teleadmin)
  2. Always use gh commands for GitHub operations
  3. For git push/pull, the remote is already configured with authentication

Project Structure

oscillating-brane-DM/
├── _posts/              # Blog posts explaining the theory (dark theme)
├── _layouts/            # Jekyll layouts (including custom dark.html)
│   ├── dark.html       # Main layout with videos and dark theme
│   ├── default.html    # Standard Jekyll layout
│   └── post.html       # Blog post layout
├── assets/
│   ├── css/            # Custom styling
│   │   └── dark-theme.css  # Complete dark theme implementation
│   ├── js/             # JavaScript for video carousel
│   └── videos/         # Local MP4 files for visual content
├── plots/              # Generated scientific figures
├── scripts/            # Python computational tools
│   ├── brane_dynamics.py      # Membrane oscillation calculations
│   ├── brane_oscillation_1d.py # 1D radion field evolution prototype
│   ├── einstein_5d_toy.py     # 2D prototype for 5D Einstein equations (NEW)
│   ├── growth_factor.py       # Structure formation calculations
│   ├── bayesian_analysis.py   # Model comparison
│   ├── bayesian_priors_table.py # Prior specifications for Bayesian analysis (NEW)
│   ├── pbh_cmb_opacity.py     # PBH impact on CMB optical depth (NEW)
│   ├── analyse_posterior.py   # MCMC diagnostics and trace plots (NEW)
│   ├── mcmc_diagnostics.py    # Convergence diagnostics (NEW)
│   ├── plot_2d_results.py     # 2D prototype visualization (NEW)
│   ├── kk_spectrum.py         # Kaluza-Klein mode analysis
│   ├── pta_echo.py           # Gravitational wave predictions
│   ├── generate_figures.py    # Figure generation script
│   └── generate_pdf.py        # PDF generation with Unicode fixes
├── docs/               # Technical documentation
│   ├── theoretical_foundations.md  # Rigorous mathematical framework with 1100+ lines
│   ├── theory_v4_complete.md      # Complete theory v4
│   ├── foundations_parts/         # Split mathematical framework
│   │   ├── part1_mathematical_framework.md
│   │   ├── part2_comparative_predictions.md
│   │   ├── part3_current_limitations.md
│   │   └── part4_development_roadmap.md
│   ├── posterior_table.tex        # MCMC posterior statistics table (NEW)
│   └── einstein_2d_table.tex      # 2D prototype results table (NEW)
├── data/               # Posterior samples and analysis results
├── output/             # Generated PDFs (NEW)
├── .github/            # GitHub Actions workflows (NEW)
│   └── workflows/
│       ├── ci.yml              # Main CI pipeline
│       ├── python-lint.yml     # Code quality checks
│       └── weekly-report.yml   # Automated reports
├── index.md           # Homepage
├── theory.md          # Complete theoretical framework
├── predictions.md     # Observational predictions
├── chronology.md      # Cosmic timeline (new)
├── tools.md           # Tools documentation
├── about.md           # About page with disclaimer
├── CNAME              # Custom domain configuration
├── requirements.txt   # Python dependencies
├── Gemfile            # Ruby dependencies for Jekyll
└── _config.yml        # Jekyll configuration

Jekyll/GitHub Pages Configuration

Current Setup

Common Issues & Solutions

  1. YAML Syntax Errors: Always quote wildcards in _config.yml: ```yaml exclude:
    • “*.py”
    • “*.npz” ```
  2. Theme Not Working: Must use officially supported GitHub Pages themes:
    • jekyll-theme-minimal ✓
    • minima ✗ (not in the official list for automated builds)
  3. CSS Not Loading: Use the correct path: 
    <link rel="stylesheet" href="/assets/css/style.css?v=1815cbfb36cc7f3569e290cb8a1bae5fe9f0b0a4">

Key Technical Parameters

The theory’s fundamental parameters:

Python Scripts

The repository includes comprehensive computational tools:

Core Physics Simulations

  1. brane_dynamics.py - Membrane oscillation calculations (fixed dimensional consistency)
  2. brane_oscillation_1d.py - 1D prototype for radion field evolution with energy conservation
  3. einstein_5d_toy.py - 2D prototype solving simplified 5D Einstein equations
  4. growth_factor.py - Structure formation with oscillating w(z) (improved lookback time)
  5. kk_spectrum.py - Kaluza-Klein mode analysis
  6. pta_echo.py - Gravitational wave predictions

Analysis and Validation

  1. bayesian_analysis.py - Model comparison and Bayesian evidence calculation
  2. bayesian_priors_table.py - Complete prior specifications with sensitivity analysis
  3. pbh_cmb_opacity.py - PBH contributions to CMB optical depth (Ali-Haïmoud 2017)
  4. analyse_posterior.py - Comprehensive MCMC diagnostics with trace/corner plots
  5. mcmc_diagnostics.py - Gelman-Rubin R̂ and effective sample size calculations

Visualization and Output

  1. plot_2d_results.py - Generate publication-quality plots from 2D prototype
  2. generate_figures.py - Scientific visualization generation
  3. generate_pdf.py - PDF generation with Unicode artifact cleaning

Blog Post Topics

  1. The Universe as a Vibrating Membrane - Introduction to the cosmic membrane paradigm
  2. How Dark Matter Makes the Universe Vibrate - Microscopic excitation mechanism
  3. Cosmic Chronology: From Inflation to the Current Beat - Evolution of brane tension
  4. Experimental Tests: Where to Seek the Truth - Observational predictions and tests

Recent Updates and Known Issues

O3 Pro Conformity Check Implementation (2025-07-04)

Following O3 Pro’s comprehensive theoretical analysis and conformity check:

GitHub Actions Setup (2025-07-04)

Theoretical Foundations Document (2025-07-04)

1D Prototype Implementation (2025-07-04)

CSS Implementation Details

O3 Pro Final Audit Implementation (2025-07-04)

Following O3 Pro’s final audit, all critical points have been addressed:

Code Quality and CI/CD (2025-07-04)

PDF Generation Improvements (2025-07-05)

GitHub Actions & CI/CD

Workflows

  1. CI (ci.yml): Main pipeline running on push
    • Runs Python simulations (brane_dynamics.py, brane_oscillation_1d.py)
    • Builds Jekyll site
    • Generates PDF documentation
    • Uploads artifacts (plots, PDFs)
  2. Python Linting (python-lint.yml): Code quality checks
    • flake8 for syntax errors
    • black for formatting
    • isort for import ordering
  3. Weekly Reports (weekly-report.yml): Automated Monday reports
    • Runs all simulations
    • Generates progress summary

Common Commands

# Run tests locally
python scripts/brane_dynamics.py
python scripts/brane_oscillation_1d.py

# Generate PDF
python scripts/generate_pdf.py

# Build Jekyll site locally
bundle exec jekyll build
bundle exec jekyll serve

Key Results and Findings

Bayesian Evidence

Numerical Validations

Observational Compatibility

Maintenance Tasks

Contact