診断

診断設定では以下のことが可能です。

• 異なる処理設定を使用して、再キャプチャすることなく frame に対して処理を再実行（ reprocess() ）する

• キャプチャ中に追加の診断データとデバッグデータを収集する

これは、点群やカラー画像に問題が発生した場合に役立ちます。

Tip

高品質の点群のキャプチャ に関するガイドラインを参照してください。

この設定を有効にすると、追加データが .zdf ファイルに保存されます。.zdf ファイルを Zivid サポートチームに送信すると、より適切なサポートとより徹底的なトラブルシューティングが可能になります。

Settings Diagnostics API

C++

Zivid::Settings::Diagnostics

C#

new Zivid.NET.Settings { Diagnostics = .. }

Python

zivid.settings.diagnostics

C++

source

std::cout << "Configuring settings for 2D+3D capture" << std::endl;
auto settings = Zivid::Settings{ Zivid::Settings::Acquisitions{
                                     Zivid::Settings::Acquisition{ Zivid::Settings::Acquisition{} } },
                                 Zivid::Settings::Color{ Zivid::Settings2D{
                                     Zivid::Settings2D::Acquisitions{ Zivid::Settings2D::Acquisition{} } } } };

std::cout << "Enabling diagnostics" << std::endl;
settings.set(Zivid::Settings::Diagnostics::Enabled::yes);

std::cout << "Capturing 2D+3D frame" << std::endl;
const auto frame = camera.capture2D3D(settings);

const auto dataFile = "FrameWithDiagnostics.zdf";
std::cout << "Saving frame with diagnostic data to file: " << dataFile << std::endl;
frame.save(dataFile);

C#

source

Console.WriteLine("Configuring settings for 2D+3D capture");
var settings = new Zivid.NET.Settings
{
    Acquisitions = { new Zivid.NET.Settings.Acquisition { } },
    Color = new Zivid.NET.Settings2D { Acquisitions = { new Zivid.NET.Settings2D.Acquisition { } } }
};

Console.WriteLine("Enabling diagnostics");
settings.Diagnostics.Enabled = true;

Console.WriteLine("Capturing 2D+3D frame");
using (var frame = camera.Capture2D3D(settings))
{
    var dataFile = "FrameWithDiagnostics.zdf";
    Console.WriteLine("Saving frame with diagnostic data to file: " + dataFile);
    frame.Save(dataFile);
}

Python

source

print("Configuring settings for 2D+3D capture")
settings = zivid.Settings(
    acquisitions=[zivid.Settings.Acquisition()],
    color=zivid.Settings2D(acquisitions=[zivid.Settings2D.Acquisition()]),
)

print("Enabling diagnostics")
settings.diagnostics.enabled = True

print("Capturing 2D+3D frame")
frame = camera.capture_2d_3d(settings)
data_file = "FrameWithDiagnostics.zdf"
print(f"Saving frame with diagnostic data to file: {data_file}")
frame.save(data_file)

Zivid API の詳細については APIリファレンス をご覧ください。

Settings2D Diagnostics API

Diagnostics can also be enabled for 2D-only captures. When enabled, the additional data will be saved in the .zdf file together with the 2D frame. The resulting .zdf file contains a Frame2D and must be loaded using the Frame2D API; see 2D 画像キャプチャプロセス for the save and load workflow.

C++

Zivid::Settings2D::Diagnostics

C#

new Zivid.NET.Settings2D { Diagnostics = .. }

Python

zivid.Settings2D.diagnostics

C++

source

std::cout << "Configuring settings for 2D capture" << std::endl;
auto settings2D = Zivid::Settings2D{ Zivid::Settings2D::Acquisitions{ Zivid::Settings2D::Acquisition{} } };

std::cout << "Enabling 2D diagnostics" << std::endl;
settings2D.set(Zivid::Settings2D::Diagnostics::Enabled::yes);

std::cout << "Capturing 2D frame" << std::endl;
const auto frame2D = camera.capture2D(settings2D);

const auto dataFile2D = "Frame2DWithDiagnostics.zdf";
std::cout << "Saving 2D frame with diagnostic data to file: " << dataFile2D << std::endl;
frame2D.save(dataFile2D);

C#

source

Console.WriteLine("Configuring settings for 2D capture");
var settings2D = new Zivid.NET.Settings2D
{
    Acquisitions = { new Zivid.NET.Settings2D.Acquisition { } }
};

Console.WriteLine("Enabling 2D diagnostics");
settings2D.Diagnostics.Enabled = true;

Console.WriteLine("Capturing 2D frame");
using (var frame2D = camera.Capture2D(settings2D))
{
    var dataFile2D = "Frame2DWithDiagnostics.zdf";
    Console.WriteLine("Saving 2D frame with diagnostic data to file: " + dataFile2D);
    frame2D.Save(dataFile2D);
}

Python

source

print("Configuring settings for 2D capture")
settings_2d = zivid.Settings2D(acquisitions=[zivid.Settings2D.Acquisition()])

print("Enabling 2D diagnostics")
settings_2d.diagnostics.enabled = True

print("Capturing 2D frame")
frame_2d = camera.capture_2d(settings_2d)
data_file_2d = "Frame2DWithDiagnostics.zdf"
print(f"Saving 2D frame with diagnostic data to file: {data_file_2d}")
frame_2d.save(data_file_2d)

注釈

診断により、キャプチャ時間、RAM 使用量、および .zdf ファイルのサイズが増加します。

Tip

Zivid のサポートチームに問題を報告する際は、診断機能を有効にすることをお勧めします。

バージョン履歴

SDK	変更点
2.18.0	Added diagnostics support for 2D captures (Settings2D::Diagnostics).
2.6	診断 API が追加されました。