トラブルシューティング

WindowsでPythonパスの `unicodeescape` エラーが出る

Windowsパス C:\Users\... をPython文字列にそのまま書くと、\U などがエスケープとして解釈され、unicodeescape の SyntaxError が発生します。MoGe検証で発生しました。

対応例:

r"C:\path\to\image.jpg" のようにraw文字列にする
"C:/path/to/image.jpg" のようにスラッシュを使う
"C:\\path\\to\\image.jpg" のようにバックスラッシュをエスケープする

`ModuleNotFoundError: No module named 'torch'`

PyTorchがインストールされていません。CUDAを使う場合は、CUDA対応版PyTorchを導入します。

bash

pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118

Depth Anything V2のCUDA 12.4環境では以下の組み合わせが使われました。

bash

pip install torch==2.5.1 torchvision==0.20.1 torchaudio==2.5.1 --index-url https://download.pytorch.org/whl/cu124

`AssertionError: Torch not compiled with CUDA enabled`

CUDA Toolkitが入っていても、PyTorchがCUDA対応版でなければ発生します。MoGe検証では、CUDA対応版PyTorchを入れ直して対応しました。

xFormers導入時にtorchのバージョンが崩れる

Depth Anything V2検証では、pip install xformers によりtorchが2.6.0へアップグレードされ、torchaudio 2.5.1およびtorchvision 0.20.1が要求するtorch 2.5.1と不整合が発生しました。

torch、torchvision、torchaudioのバージョンを揃えて導入します。

bash

pip install torch==2.5.1 torchvision==0.20.1 torchaudio==2.5.1

Windowsで長いパスが原因のインストールエラーが出る

Windowsではデフォルトで長いパスが無効のため、xFormersインストール時に一時ファイルのパスが長すぎるエラーが発生しました。管理者権限PowerShellで LongPathsEnabled を有効化します。

powershell

Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1

VDAの `get_weights.sh` がWindowsで動かない

Windows環境では bash get_weights.sh を直接実行できず、WSL 2 + Ubuntu 22.04で作業しました。

LKGで奥行きが反転する

Apple Depth Proの検証で、奥にある壁が手前に見えるなど、奥行き反転が発生しました。Depth画像をネガポジ反転して改善した例があります。

動画のLKG表示で奥行きが揺れる

Depth Anything V2ではフレーム間で深度の一貫性がなく、映像の奥行きが揺れる課題があります。動画ではVideo Depth Anythingの検証が進められています。

VDAストリーミングを本番利用してよいか

現状は推奨されていません。ストリーミングモードは実験段階で、品質にばらつきがあり、研究・デモ用に限定されています。バッチ処理を基準とします。

← ローカル深度推定 Windows — Depth Anything V2 / Video Depth Anything / Apple Depth Pro / MoGe 検証ガイド概要に戻る

トラブルシューティング ​