練)
Spirula Studio 安裝教程三步在 Windows、Linux 與 macOS 上跑通 3DGS 訓(xùn)練【免費(fèi)下載鏈接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studio先說(shuō)好我不打算一上來(lái)講架構(gòu)咱們先把軟件跑起來(lái)跑的時(shí)候順便把每步為什么這么做講清楚。Spirula Studio 是一個(gè)開源的 3D 高斯?jié)姙R3D Gaussian Splatting訓(xùn)練工具Python、PyTorch、COLMAP 這些統(tǒng)統(tǒng)不用裝輸入素材 → splat 模型 → 帶紋理網(wǎng)格整條鏈路被塞進(jìn)一個(gè)自包含的二進(jìn)制里。因此 Spirula Studio 安裝這件事相當(dāng)輕整篇教程其實(shí)只回答兩個(gè)問(wèn)題你要現(xiàn)成包還是自己編你的顯卡是 NVIDIA 還是別的先拿現(xiàn)成包三步啟動(dòng)最省事的路線三步進(jìn) Releases 發(fā)布頁(yè)按你的系統(tǒng)Windows / Linux / macOS取對(duì)應(yīng)安裝包解壓雙擊啟動(dòng) GUI選數(shù)據(jù)集開訓(xùn)。完事。如果你在用一臺(tái)不帶顯示器的機(jī)器比如遠(yuǎn)程服務(wù)器同一套二進(jìn)制也帶命令行模式怎么部署看下面無(wú)頭與遠(yuǎn)程那一節(jié)。源碼路線一Vulkan 還是 CUDA先選計(jì)算后端現(xiàn)成包對(duì)不上你的環(huán)境或者想開關(guān)某些功能時(shí)走源碼構(gòu)建。動(dòng)手前先回答后端問(wèn)題。**Vulkan推薦**是跨廠商路線NVIDIA 與 AMD也包括 Intel 和 Apple 的顯卡都能跑且是 macOS 上唯一的選擇。它的構(gòu)建更快、二進(jìn)制更小SfM 重建、視頻抽幀和 AI 分割也一并打包在內(nèi)不必另配外部工具。Windows 和 Linux 上要先裝 Vulkan SDKmacOS 可以跳過(guò)這一步——CMake 會(huì)自動(dòng)獲取 MoltenVK 并做靜態(tài)鏈接編出的二進(jìn)制拷到任何一臺(tái) Mac 都能直接跑。CUDA則是 NVIDIA 專屬的傳統(tǒng)路線需要裝 CUDA 工具包Windows 與 Linux 支持macOS 不支持。兩者在訓(xùn)練與網(wǎng)格化上的功能完全一致速度差距通常只有幾個(gè)百分點(diǎn)按機(jī)器里插的什么卡選就行。后端定了之后三個(gè)平臺(tái)的依賴大同小異列給你編譯器Windows 用 Visual Studio 2022含 C 工具集或 GCC/ClangLinux 用 gcc/gmacOS 用 Xcode 命令行工具CMake NinjaVS 里一般自帶腳本會(huì)自己找Linux 與 macOS 需要自行安裝Vulkan SDKVulkan 后端在 Windows 與 Linux 上必備macOS 不需要CUDA 工具包僅 CUDA 后端要macOS 不支持python3可選。缺失時(shí)代碼生成步驟會(huì)被跳過(guò)生成文件已隨倉(cāng)庫(kù)提交沒有 python3 照樣能構(gòu)建。源碼路線二三個(gè)平臺(tái)的構(gòu)建命令克隆一次代碼即可git clone https://gitcode.com/GitHub_Trending/sp/spirula-studio cd spirula-studioWindowsMSVC在cmd或開發(fā)者命令提示符里執(zhí)行.\build_develop.bat -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功的產(chǎn)物是build_vulkan\spirula.exe。想走 CUDA 后端把命令里的-DSS_BACKENDvulkan換成-DSS_BACKENDcuda最終產(chǎn)物變?yōu)閎uild_cuda\spirula.exe。兩個(gè)細(xì)節(jié)腳本會(huì)自己通過(guò) vswhere 找到 VS 并調(diào)用 vcvars64CMake/Ninja 不在 PATH 時(shí)則回退到 VS 自帶的版本。另外別自己帶-B——構(gòu)建目錄由腳本按后端名取改了對(duì)不上。Linuxbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功產(chǎn)物為build_vulkan/spirula。無(wú)顯示器的服務(wù)器加-DSS_BUILD_GUIOFF只出命令行工具——產(chǎn)物不依賴顯卡驅(qū)動(dòng)里的圖形庫(kù)也不會(huì)拉取任何 GUI 依賴。macOSApple Siliconbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON cmake --build build --target macos_app cmake --build build --target macos_dmgmacOS 這邊有個(gè)特殊之處它只有一個(gè)后端所以構(gòu)建目錄是統(tǒng)一的build/沒有build_vulkan/一說(shuō)。產(chǎn)物除了build/spirula之外還會(huì)打包出可雙擊的Spirula Studio.app和.dmg磁盤映像。Spirula Studio 無(wú)頭部署與遠(yuǎn)程 GPU 訓(xùn)練 兩種很常見的用法放在一起說(shuō)遠(yuǎn)程 GPU 服務(wù)器在服務(wù)器上跑spirula train它默認(rèn)會(huì)在一個(gè) HTTP 端口上提供 3D 預(yù)覽頁(yè)面本地用ssh -L轉(zhuǎn)發(fā)端口后瀏覽器里就能看到訓(xùn)練進(jìn)度——服務(wù)器本身不必裝圖形環(huán)境純無(wú)頭構(gòu)建構(gòu)建階段加-DSS_BUILD_GUIOFF產(chǎn)物只有命令行工具更輕、依賴更少。關(guān)鍵開關(guān)-DSS_ENABLE_PATENTEDON 到底做什么 上面每條命令都帶了-DSS_ENABLE_PATENTEDON。它開啟進(jìn)程內(nèi) GPU 視頻解碼啟用后抽幀速度快約 15 倍系統(tǒng)側(cè)也不需要調(diào)用 ffmpeg不啟用時(shí)抽幀會(huì)回退到系統(tǒng)的 ffmpeg。為什么這個(gè)開關(guān)默認(rèn)關(guān)著因?yàn)樯婕?H.264 / H.265 / AV1 編解碼解析邏輯存在第三方專利授權(quán)問(wèn)題是否開啟請(qǐng)自行確認(rèn)所在地區(qū)的合規(guī)要求。原理細(xì)節(jié)見 docs/build.md。Spirula Studio 安裝驗(yàn)證跑這兩條命令確認(rèn)構(gòu)建或安裝完成后打開終端執(zhí)行spirula --version spirula --helpWindows 下對(duì)應(yīng)spirula.exe --version與spirula.exe --help。兩條命令都能正常應(yīng)答說(shuō)明安裝完成。再直接敲spirula而不帶任何參數(shù)它會(huì)直接進(jìn)入圖形界面左側(cè)是數(shù)據(jù)集選擇與訓(xùn)練參數(shù)面板中間是 3D 預(yù)覽區(qū)看到它們就穩(wěn)了。Spirula Studio 構(gòu)建報(bào)錯(cuò)速查你大概率會(huì)碰上的幾個(gè)問(wèn)題 Windows 報(bào)vcvars64.bat not found說(shuō)明 VS 里沒裝 C 桌面開發(fā)的工作負(fù)載。在 VS 中補(bǔ)裝它或者直接改用開發(fā)者命令提示符運(yùn)行構(gòu)建腳本會(huì)自動(dòng)探測(cè) VS 的安裝位置。Vulkan 后端 CMake 配置失敗原因多數(shù)是同一個(gè)Vulkan SDK 沒就位。在 Windows 或 Linux 上裝好它再重新配置macOS 則無(wú)需任何 SDK。斷網(wǎng)時(shí) GUI 構(gòu)建失敗GUI 首次構(gòu)建需要聯(lián)網(wǎng)下載 GLFW 與 Dear ImGui一次性。完全離線的環(huán)境加-DSS_BUILD_GUIOFF繞過(guò)即可。并行編譯被 OOM 殺掉不用自己加-j。構(gòu)建腳本啟動(dòng)前會(huì)估算可用內(nèi)存并換算出并發(fā)數(shù)按約 750MB/任務(wù)計(jì)不會(huì)超出機(jī)器承受能力。macOS 上網(wǎng)格化只跑單核OpenMP 沒被找到。先brew install libomp——它是 keg-only 的CMake 默認(rèn)找不到而構(gòu)建腳本會(huì)自動(dòng)探測(cè)到該庫(kù)的所在位置并傳給 CMake。nvcc 編譯報(bào)錯(cuò)CUDA 版本與編譯器不匹配。腳本默認(rèn)挑機(jī)器里裝的最新版 CUDA不是你想要的那一個(gè)時(shí)傳-DCMAKE_CUDA_COMPILER...指定別家版本。中文路徑顯示為方塊全量 CJK 字體還沒下載。首次用到中文時(shí) GUI 會(huì)提示你下載并緩存屬正常行為。裝完之后丟素材進(jìn)去就能訓(xùn)練到這一步把照片或視頻放進(jìn)數(shù)據(jù)集目錄即可——內(nèi)置 SfM 會(huì)先做完重建再直接開訓(xùn)任何外部工具都不必再裝。想再深入一點(diǎn)全部構(gòu)建選項(xiàng)見 cmake/SsOptions.cmake雙后端架構(gòu)設(shè)計(jì)見 docs/backends.md兩個(gè)入口腳本是 build_develop.bash 與 build_develop.bat?!久赓M(fèi)下載鏈接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studio創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考