{"id":44937151,"url":"https://github.com/space-cadet/qc-diffusion-code","last_synced_at":"2026-02-18T07:33:16.780Z","repository":{"id":311271433,"uuid":"1043220372","full_name":"space-cadet/qc-diffusion-code","owner":"space-cadet","description":"React App for in browser simulation of classical random walks and diffusion equations","archived":false,"fork":false,"pushed_at":"2026-02-09T15:27:59.000Z","size":28194,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-09T19:50:00.891Z","etag":null,"topics":["diffusion","diffusive-process","finite-velocity-diffusion","random-walk","react","telegraph-equation","typescript"],"latest_commit_sha":null,"homepage":"https://qc-diffusion.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/space-cadet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-23T11:46:09.000Z","updated_at":"2026-02-09T15:28:04.000Z","dependencies_parsed_at":"2025-08-23T18:26:16.220Z","dependency_job_id":"cff3d762-54e3-4db7-ba3f-e5308decd63c","html_url":"https://github.com/space-cadet/qc-diffusion-code","commit_stats":null,"previous_names":["space-cadet/qc-diffusion-code"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/space-cadet/qc-diffusion-code","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/space-cadet%2Fqc-diffusion-code","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/space-cadet%2Fqc-diffusion-code/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/space-cadet%2Fqc-diffusion-code/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/space-cadet%2Fqc-diffusion-code/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/space-cadet","download_url":"https://codeload.github.com/space-cadet/qc-diffusion-code/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/space-cadet%2Fqc-diffusion-code/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29572427,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T06:19:27.422Z","status":"ssl_error","status_checked_at":"2026-02-18T06:18:44.348Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["diffusion","diffusive-process","finite-velocity-diffusion","random-walk","react","telegraph-equation","typescript"],"created_at":"2026-02-18T07:33:16.166Z","updated_at":"2026-02-18T07:33:16.775Z","avatar_url":"https://github.com/space-cadet.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QC-Diffusion Code Implementation\n\nAdvanced computational simulation system demonstrating finite velocity diffusion in quantum cosmology through stochastic random walk derivations.\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Live Demo](#live-demo)\n- [Key Features](#key-features)\n- [Research Contributions](#research-contributions)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Physics Implementation](#physics-implementation)\n- [Architecture](#architecture)\n- [Development](#development)\n- [Testing](#testing)\n- [Deployment](#deployment)\n- [Documentation](#documentation)\n- [Authors](#authors)\n\n## Overview\n\nThis project implements sophisticated computational tools for studying finite velocity diffusion phenomena in quantum cosmological models. The work extends traditional diffusion equations to incorporate relativistic constraints and quantum mechanical effects, with emphasis on demonstrating the stochastic origins of telegraph equations through Continuous Time Random Walk (CTRW) simulations.\n\n## Live Demo\n\n- **Production Deployment**: [Vercel](https://qc-diffusion-code.vercel.app)\n- **Repository**: [GitHub](https://github.com/space-cadet/qc-diffusion-code)\n\n## Key Features\n\n### Physics Engine\n- Continuous Time Random Walk (CTRW) implementation with exponential collision timing\n- Strategy pattern supporting multiple physics approaches (CTRW, Simple, Lévy, Fractional)\n- WebGL GPU-accelerated PDE solving with 100x performance improvement\n- Real-time density profile calculations with 2D spatial binning\n- Observer pattern for numerical observables with lazy evaluation\n\n### User Interface\n- Professional React Grid Layout with draggable panels\n- Real-time parameter controls with immediate visual feedback\n- Dual visualization modes: particle simulation and graph networks\n- Comprehensive state persistence across browser sessions\n- Distribution controls (uniform, gaussian, ring, stripe, grid patterns)\n\n### Production Features\n- Monorepo architecture with pnpm workspace configuration\n- Comprehensive Jest testing with mathematical verification\n- TypeScript strict mode across entire codebase\n- Automated CI/CD with Vercel deployment\n\n## Research Contributions\n\n### Theoretical Advances\n- Numerical demonstration of random walk convergence to telegraph equation\n- Coordinate system alignment between physics simulation and rendering spaces\n- Density profile analysis for telegraph equation verification\n- Strategy-agnostic boundary condition framework\n\n### Technical Innovations\n- Low-level particle control eliminating animation conflicts\n- Modular physics engine enabling runtime strategy switching\n- WebGL fragment shader PDE implementations\n- Complete simulation state restoration with auto-save functionality\n\n## Installation\n\n### Prerequisites\n- Node.js 18+\n- pnpm 8+\n- Python 3.9+ (for backend)\n\n### Setup\n```bash\n# Clone repository\ngit clone https://github.com/space-cadet/qc-diffusion-code.git\ncd qc-diffusion-code\n\n# Install dependencies\npnpm install\n\n# Start development server\ncd frontend\npnpm dev\n\n# Optional: Start backend for WebSocket features\ncd ../backend\npython -m venv .venv\nsource .venv/bin/activate  # Windows: .venv\\Scripts\\activate\npip install -r requirements.txt\npython main.py\n```\n\n## Usage\n\n### Basic Simulation\n1. Navigate to the Random Walk tab\n2. Adjust physics parameters (collision rate, jump length, velocity)\n3. Select particle distribution pattern\n4. Click Start to begin simulation\n5. Monitor real-time density evolution and telegraph equation comparison\n\n### Advanced Features\n- Switch between continuum and graph simulation modes\n- Adjust boundary conditions (periodic, reflective, absorbing)\n- Export simulation data in multiple formats\n- Save and restore simulation sessions\n\n## Physics Implementation\n\n### CTRW Mathematics\nThe Continuous Time Random Walk implementation follows:\n- Collision times: τ ~ Exponential(λ)\n- Jump lengths: Fixed step size a\n- Velocity: v = a/⟨τ⟩\n- Diffusion coefficient: D = v²/(2λ)\n\n### Telegraph Equation\nIn appropriate scaling limits, the random walk converges to:\n```\n∂²u/∂t² + 2λ∂u/∂t = v²∇²u\n```\n\n### Strategy Pattern\nMultiple physics implementations:\n- CTRWStrategy: Exponential collision timing\n- SimpleStrategy: Basic random walk\n- LévyStrategy: Power-law jump distributions\n- FractionalStrategy: Memory-dependent walks\n\n## Architecture\n\n### Frontend Structure\n```\nfrontend/src/\n├── components/          # UI components with state persistence\n├── physics/             # Physics engine with strategy pattern\n│   ├── strategies/      # Physics implementation strategies\n│   ├── observables/     # Observer pattern observables\n│   └── utils/           # Mathematical utilities\n├── stores/              # Zustand state management\n├── webgl/               # GPU-accelerated PDE solvers\n└── hooks/               # Custom React hooks\n```\n\n### Monorepo Configuration\n```\npackages/\n├── graph-core/          # Graph theory utilities\n└── graph-ui/            # Graph visualization components\n```\n\n## Development\n\n### Code Standards\n- TypeScript strict mode\n- ESLint with scientific computing rules\n- Comprehensive JSDoc documentation\n- Jest testing with mathematical verification\n\n### Build System\n- Vite with WebGL optimization\n- pnpm workspace for monorepo management\n- Automated dependency management\n- Production optimization for Vercel deployment\n\n## Testing\n\n```bash\n# Run all tests\npnpm test\n\n# Frontend unit tests\ncd frontend \u0026\u0026 pnpm test\n\n# Physics verification tests\ncd frontend \u0026\u0026 pnpm test -- physics\n```\n\nTest coverage includes:\n- Unit tests for physics strategies\n- Integration tests for UI components\n- Mathematical verification against analytical solutions\n- Performance benchmarks\n\n## Deployment\n\n### Production Build\n```bash\n# Build for production\npnpm build\n\n# Preview build locally\npnpm preview\n```\n\n### Vercel Configuration\nProduction deployment uses:\n- Monorepo build pipeline\n- Automated dependency resolution\n- WebGL capability detection\n- Performance monitoring\n\n## Documentation\n\nComprehensive documentation available in `memory-bank/`:\n- Technical implementation details\n- Physics mathematical foundations\n- Architecture decision records\n- Development session logs\n\n## Authors\n\n- **Deepak Vaid** - Principal Investigator\n- **Rachel L. Maitra** - Wentworth Institute of Technology\n\n---\n\n*This project demonstrates advanced computational techniques for quantum cosmological research through interactive web-based simulations.*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspace-cadet%2Fqc-diffusion-code","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspace-cadet%2Fqc-diffusion-code","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspace-cadet%2Fqc-diffusion-code/lists"}