エラーコードリファレンス
概要
MipMapEngine SDKは標準化されたエラーコードシステムを使用して、開発者が問題を迅速に特定し解決することを支援します。エラーコードは、再構築インターフェースエラー、ライセンスエラー、ファイルI/Oエラー、GPUエラーなど複数のカテゴリに分かれています。
再構築インターフェースエラーコード (ReconstructFull/ReconstructAT/Reconstruct3D)
コアロジッククラス
| エラーコード | 説明 |
|---|---|
| 0 | 再構築成功 |
| 1000 | 再構築失敗、原因についてはログを解析してください |
| 1001 | ユーザーがキャンセル |
| 1002 | 座標系エラー |
| 1003 | AT結果が空です |
| 1004 | 点群結果が空です |
| 1005 | メッシュ結果が空です |
| 1006 | ナディア画像が不十分、2D製品を生成できません |
ライセンスクラス
| エラーコード | 説明 |
|---|---|
| 2000 | ライセンスエラー |
| 2001 | ライセンス列挙に失敗しました |
| 2002 | 一致するライセンスが見つかりません |
| 2003 | ライセンスが期限切れです |
| 2004 | このバージョンにはライセンスが適用されません |
| 2005 | ライセンス機能モジュールの不一致 |
| 2006 | ライセンスでサポートされる最大画像数を超過しました |
ファイルI/Oクラス
| エラーコード | 説明 |
|---|---|
| 3000 | ファイル読み取り/書き込みエラー |
| 3001 | JSONフィールド解析エラー |
コンピューティングデバイスドライバークラス
| エラーコード | 説明 |
|---|---|
| 4000 | GPUデバイスエラー、GPUがNVIDIAでありドライバーバージョンが要件を満たしているか確認してください |
ライセンスエンジンエラーコード
| エラーコード | 説明 |
|---|---|
| 0 | 成功 |
| 0x00000040 | ネットワークエラー |
| 0x0000004A | ネットワークリクエストタイムアウト |
| 0x05000004 | サーバーが見つかりません |
| 0x13000051 | ライセンスにはオンラインアクティベーションが必要です |
| 0x02000003 | 接続に失敗しました、Virboxソフトウェアがインストールされていないかネットワークに接続されていません |
| 0x51005001 | 認証コードステータスの照会中に例外が発生しました |
| 0x51005002 | 認証コード交換リクエスト中に例外が発生しました |
| 0x51005003 | 認証コードが存在しません |
| 0x51005004 | 認証コードライセンス控除に失敗しました |
| 0x51005013 | バインドできません（ライセンスが期限切れです） |
| 0x51005014 | バインドできません（認証コードの同時デバイス制限に達しました） |
| 0x51005015 | バインドできません（認証コードの累積デバイス制限に達しました） |
| 0x51005018 | 認証コードターミナルのアンバインドに失敗しました、ソフトウェアサプライヤーにお問い合わせください |
| 0x51005019 | サーバーがバインドレコードを見つけることができません、ソフトウェアサプライヤーにお問い合わせください |
| 0x51005021 | ライセンスがロックされているため認証コードライセンスをバインドできません、ソフトウェアサプライヤーにお問い合わせください |
| 0x51005025 | 認証コードがバインドを許可しません |
| 0x51005033 | 一時的にライセンスをアクティベートできません、ユーザーツールを最新バージョンにアップグレードする必要があります |
| 0x51005034 | ソフトウェアサプライヤーがこのデバイスの使用権を取り消しました、現在の認証コードは再度バインドできません、ソフトウェアサプライヤーにお問い合わせください |
| 0x5100612F | 認証コードが存在しません、認証コードが正しいか確認してください |
| 0x51006130 | 無効なハードウェア情報データ |
| 0x51006134 | 認証コードライセンス控除に失敗しました、ソフトウェアサプライヤーにお問い合わせください |
| 0x5100502C | アンバインドできません（バインドされていません） |
エラー診断フロー
一般的な解決策
ライセンスエラー (2000-2006)
-
ライセンスステータスを確認:
license_engine -enum -
ライセンス有効期限を検証:
license_engine -query -
ライセンスを更新:
- 新しい認証コードについてソフトウェアサプライヤーに連絡
- ライセンスアクティベーションツールを使用して更新
GPUエラー (4000)
-
GPUドライバーを確認:
nvidia-smi -
ドライバーを更新:
- 最新のNVIDIAドライバーをダウンロード
- ドライバーバージョン >= 470.xxであることを確認
-
CUDAを検証:
nvcc --version
ファイルI/Oエラー (3000-3001)
-
権限を確認:
ls -la /path/to/file
chmod 755 /path/to/file -
JSON形式を検証:
task_json_check.exe -task_json config.json -
ディスク容量を確認:
df -h
エラー予防のベストプラクティス
-
事前確認:
- 再構築前にライセンスを検証
- GPUの可用性とメモリを確認
- 入力データ品質を検証
-
監視:
- GPUメモリ使用量を監視
- 再構築の進行状況を追跡
- ログファイルを定期的に確認
-
リソース管理:
- 十分なディスク容量を確保（入力データサイズの3倍以上）
- GPUメモリを利用可能に保つ（4GB以上推奨）
- 不要なアプリケーションを閉じる
-
データ検証:
- 適切な画像オーバーラップを使用（60-80%）
- GPS/EXIFデータの精度を検証
- 座標系の一貫性を確認