{"enrichment":{"faq":[{"a":"3dgs-training-debugger helps diagnose NaN failures by checking learning rate schedules, gradient clipping thresholds, and initialization ranges. Start by reducing your initial learning rate by 50%, enable gradient clipping (typical range 0.0\u20131.0), and verify that camera poses and image data are normalized. If NaNs persist, inspect your densification triggers\u2014over-aggressive Gaussian creation can destabilize gradients. Review loss weighting across RGB, SH, and regularization terms to ensure no component dominates.","q":"How do I fix 3DGS training NaN loss?"},{"a":"3dgs-training-debugger addresses OOM crashes by analyzing batch size, image resolution, and Gaussian count growth. Reduce batch size or image resolution first; even halving resolution frees significant VRAM. Monitor Gaussian population during training\u2014if it grows unchecked, tighten densification thresholds or cap the maximum Gaussian count. Profile memory per training step to isolate whether the bottleneck is model parameters, gradients, or intermediate activations.","q":"What causes CUDA out of memory errors in 3DGS training?"},{"a":"3dgs-training-debugger tackles divergence by examining learning rate decay, optimizer state, and checkpoint integrity. Verify your learning rate schedule doesn't drop too aggressively; a cosine or exponential decay is often more stable than step-based. If resuming from checkpoint, confirm optimizer momentum and adaptive learning rates (Adam's m/v buffers) are loaded correctly. Reduce densification frequency or disable it temporarily to isolate whether Gaussian creation is triggering instability.","q":"How can I resolve training divergence in 3D gaussian splatting?"},{"a":"3dgs-training-debugger identifies artifact sources like over-densified regions, poor SH coefficient initialization, or opacity collapse. Check whether floaters cluster near scene boundaries\u2014this suggests densification is creating Gaussians in low-information regions. Increase regularization weight on opacity to prevent dead Gaussians. Validate that your SH degree matches scene complexity; too low a degree causes banding, too high can overfit. Review camera pose accuracy, as misaligned views cause ghosting.","q":"What fixes 3DGS floaters and artifacts during rendering?"},{"a":"3dgs-training-debugger provides VRAM optimization by profiling memory allocation across stages. Batch size is the primary lever\u2014halving it often cuts memory by 40\u201350%. Reduce image resolution or use progressive resolution training. Implement gradient checkpointing to trade compute for memory. Cap Gaussian count explicitly and monitor densification triggers. For multi-GPU setups, ensure data parallelism doesn't replicate full model state; use gradient accumulation to simulate larger batches without proportional memory cost.","q":"How do I optimize VRAM usage and resolve out-of-memory crashes?"},{"a":"3dgs-training-debugger guides hyperparameter tuning by prioritizing learning rate, densification schedule, and regularization. Start with learning rate 0.0025 for position and 0.0005 for SH; adjust based on loss curve smoothness. Densification frequency (e.g., every 100 steps) and thresholds control Gaussian growth\u2014too frequent causes instability, too sparse leaves artifacts. Balance RGB loss against opacity and scale regularization; typical weights are 1.0 RGB, 0.2 opacity, 0.01 scale. Monitor validation metrics every 1000 steps to catch overfitting early.","q":"What should I tune to improve 3DGS convergence and final quality?"}],"shadow_tags":["training-failure-diagnosis","memory-optimization","convergence-debugging","artifact-analysis","hyperparameter-tuning","distributed-training","novel-method-stability","checkpoint-recovery","runtime-profiling","gradient-debugging"],"summary_rewrite":"Troubleshoot 3D Gaussian Splatting training problems with targeted diagnostics for numerical instability, memory exhaustion, convergence failures, and rendering defects. This skill helps identify root causes and apply fixes to get your 3DGS models training smoothly again."},"files":[{"bytes":28531,"path":"skills/3dgs-training-debugger/SKILL.md","sha256":"79475b2dfc967f68c8cd48860328adbcc9975ef813ef6ad4db77414ae3a0e4b1","url":"https://skillfed.io/files/jaccen/Awesome-Gaussian-Skills/3dgs-training-debugger/b44673b7/SKILL.md"}],"id":"jaccen/Awesome-Gaussian-Skills/3dgs-training-debugger","links":{"html":"https://skillfed.io/jaccen/Awesome-Gaussian-Skills/3dgs-training-debugger","md":"https://skillfed.io/jaccen/Awesome-Gaussian-Skills/3dgs-training-debugger.md","repo":"https://github.com/jaccen/Awesome-Gaussian-Skills"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":9,"language":"TypeScript","last_updated":"2026-07-26","license":"Apache-2.0","name":"3dgs-training-debugger","publisher":"jaccen","stars":129},"relations":{"similar":[{"id":"jaccen/Awesome-Gaussian-Skills/nerf-to-3dgs-migrator"},{"id":"jaccen/Awesome-Gaussian-Skills/3dgs-paper-reader"},{"id":"jaccen/Awesome-Gaussian-Skills/3dgs-code-reviewer"},{"id":"jaccen/Awesome-Gaussian-Skills/cad-mesh-3dgs"},{"id":"jaccen/Awesome-Gaussian-Skills/3dgs-spatial-agent"},{"id":"jaccen/Awesome-Gaussian-Skills/3dgs-experiment-planner"},{"id":"jaccen/Awesome-Gaussian-Skills/3dgs-mcp-renderer"},{"id":"jaccen/Awesome-Gaussian-Skills/3dgs-articulated-reasoner"},{"id":"jaccen/Awesome-Gaussian-Skills/3dgs-compression-deploy"},{"id":"Aradotso/devtools-skills/clipgstream-dynamic-scene-reconstruction"}]},"slug":{"owner":"jaccen","repo":"Awesome-Gaussian-Skills","skill":"3dgs-training-debugger"},"version":"b44673b7"}