Spirula Studio训练配置完全手册TrainConfig的每个标志位都意味着什么【免费下载链接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.项目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studioSpirula Studio 是一款开源的 3D Gaussian Splatting3D高斯泼溅训练工具用一个自包含的二进制就能完成照片/视频 → 泼溅 → 带纹理网格的完整流程支持 Vulkan 与 CUDA 双后端。它的训练入口是spirula train命令全部配置标志位集中定义在 TrainConfig.h 这一张表里。本手册带你逐段读懂这些标志位新手只需记住 6 个关键参数进阶用户则可按需精调。一、先看全局12 个分组 × 4 个熟练度档位所有标志位按功能分为12 个分组section并在源码中统一标注了 4 个档位tier这直接决定了--help和 GUI 默认显示哪些参数档位含义新手建议basic首次训练必需的核心参数约 20 个✅ 只需关注这些advanced经常需要浏览的进阶参数 遇到瓶颈时查阅expertwarmup、学习率调度、正则化内部细节高级用户stub已解析但尚未实现默认隐藏忽略即可12 个分组依次为运行与输出run、数据集dataset、场景位置scene、泼溅模型splats、细节与泼溅数detail、图像损失loss、几何与表面geometry、泼溅形状shape、相机与色彩校正correction、色彩空间colorspace、速度与内存perf、学习率rates。二、快速上手最少 3 个参数就能开始训练spirula train --data ./my_scene --quality high只需记住三条命名规则解析器实现见 main.cpp--data是唯一必填参数指向数据集文件夹COLMAP、Nerfstudio、Metashape 三种目录结构都自动识别-和_等价--sh-degree与--sh_degree完全相同布尔值必须带值例如--warp-to-pinhole 11/0、true/false 均可。三、新手最该记住的 6 个标志位标志位默认值含义--data必填数据集文件夹--qualitymedium细节水平low/medium/high/ultra一键决定泼溅数上限和训练时长--cap-max1000000泼溅数量上限最主要的质量旋钮调高更精细但文件更大、渲染更慢--num-iterations30000训练迭代次数--sh-degree3颜色细节球谐阶数越高视角移动时反射和明暗越真实但更占内存、文件更大0 表示与视角无关的平面色--train-resolution-divisor0训练图片的整数倍降采样显存紧张时调大以提速省显存--quality是一个宏开关它会自动联动设置cap-max和num-iterationslow → 20万/1.5万medium → 100万/3万high → 300万/5万ultra → 1000万/8万。你手动指定的值永远不会被宏覆盖——这正是它安全的原因。四、预设选场景比调参数更聪明比起逐个调标志位先选对**预设preset**往往更有效。在命令名后直接写预设名即可spirula train in-the-wild --data ./scene预设适用场景3dgs通用大多数数据集的默认选择360-camera360°/超广角鱼眼相机拍的原始畸变图像画面中能看到圆形边界in-the-wild网络照片、光照差异极大、未遮罩杂物、长焦拍摄的数据集centered-object环绕单个已遮罩物体拍摄背景不参与重建hdr高动态范围场景默认训练线性 ACEScg 泼溅保留动态范围synthetic恒定曝光的合成渲染数据集meshing为网格化训练优先保证网格几何质量而非泼溅本身的观感预设本质上只是一组默认值覆盖写在 TrainConfig.h 的train_apply_preset中选完预设后你仍可继续用命令行覆盖任意单个标志位。五、进阶篇质量与几何的关键开关标志位可选值作用--distraction-robustnessoff/mild/strong忽略照片间移动的行人、车辆不再为它们分配泼溅代价是细节敏感度略降--floater-suppressionoff/mild/strong抑制漂浮物伪影让每个像素只对应一个表面--depth-distortion-reg浮点数深度畸变正则化让表面更锐利、更贴合--primitive3dgs/mip/3dgut泼溅形状3dgs与主流查看器兼容性最好mip在视角距离差异大时减少锯齿3dgut更精确处理广角/畸变镜头网格化几何更干净--max-screen-size默认0.3限制单个泼溅在屏幕上能占多大防止出现刺眼的大色块六、损失与色彩决定像不像的参数图像损失--ssim-lambda默认 0.2--l1-weight默认 1.0--alpha-loss-weight默认 0.1共同决定渲染图与原图的对比方式曝光与白平衡校正--use-bilateral-grid默认开会自适应补偿每张照片的曝光差异--use-ppisp默认开建模镜头的响应曲线——这两项是 Spirula Studio 出图不偏色、不发暗的关键色彩空间--image-color-is-linear、--splat-color-gamut如Rec.709、ACEScg决定输入照片与输出泼溅分别用线性还是显示编码、哪个色域。HDR 预设就是靠它们组合出线性 ACEScg 泼溅的。七、进度查看与断点续训 每次运行都会在输出目录写入一份扁平的config.json每个标志位一个键无嵌套这是后续续训的档案--save-full-checkpoint 1保存可完整恢复的检查点默认关闭--resume outputs/xxx指向某次运行的输出文件夹取其最新检查点或具体的step-*.ckpt文件夹来续训模型和数据集设置沿用原运行而训练时长、保存间隔、查看器设置仍由命令行决定。注意续训要求原运行开启了save-full-checkpoint--steps-per-save默认 2000检查点保存间隔--viewer-port默认 7007训练中启动一个网页查看器远程 GPU 上训练时可转发端口在浏览器里实时看进度用--disable-viewer 1可关闭。八、遇到问题去哪里查途径说明spirula train --help本地化输出所有 basic 档标志位及解释支持多语言GUI 的 All Options 编辑器与--help同源带完整悬浮提示TrainFields.h每个标志位的名称与说明含简体中文翻译TrainConfig.h标志位默认值、分组与档位的唯一事实来源datasets.md数据集目录结构与准备方法常见疑问速答问我改--quality就够了吗多数场景够。它同时锁定泼溅预算和训练时长只有当你想更多泼溅但更短训练这类组合时才需要手动分开设--cap-max和--num-iterations。问想导出网格训练时该怎么配直接用meshing预设它切换到mip泼溅、关闭高阶球谐、并开启深度/法向监督与几何正则目标就是干净的网格表面而非漂亮的泼溅画面。问标志位太多记不住只记 basic 档约 20 个其余等具体问题时再按分组检索即可——--help和源码里的分组结构就是为这种按需查阅设计的。【免费下载链接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.项目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
