LearningModelSession コンストラクター

定義

名前空間:

Windows.AI.MachineLearning

オーバーロード

LearningModelSession(LearningModel)	既定のデバイスを使用してセッションを作成します。
LearningModelSession(LearningModel, LearningModelDevice)	指定したデバイスを使用してセッションを作成します。
LearningModelSession(LearningModel, LearningModelDevice, LearningModelSessionOptions)	指定したデバイスと追加の推論オプションを使用してセッションを作成します。

LearningModelSession(LearningModel)

既定のデバイスを使用してセッションを作成します。

public:
 LearningModelSession(LearningModel ^ model);

 LearningModelSession(LearningModel const& model);

public LearningModelSession(LearningModel model);

function LearningModelSession(model)

Public Sub New (model As LearningModel)

パラメーター

model

LearningModel

このセッションのトレーニング済みの機械学習モデル。

例

次の例では、モデルを読み込み、それを使用して評価セッションを作成します。

private async Task LoadModelAsync(LearningModel _model, string _modelFileName, LearningModelSession _session)
{
    // Only load the model one time.
    if (_model != null) return;

    try
    {
        // Load and create the model
        var modelFile = 
            await StorageFile.GetFileFromApplicationUriAsync(new Uri($"ms-appx:///Assets/{_modelFileName}"));
        _model = await LearningModel.LoadFromStorageFileAsync(modelFile);

        // Create the evaluation session with the model and device.
        _session = new LearningModelSession(_model);
    }
    catch (Exception ex)
    {
        StatusBlock.Text = $"error: {ex.Message}";
        _model = null;
    }
}

注釈

Windows Server

Windows Server でこの API を使用するには、Windows Server 2019 デスクトップ エクスペリエンスを使用する必要があります。

スレッド セーフ

この API はスレッド セーフです。

LearningModelSession(LearningModel, LearningModelDevice)

指定したデバイスを使用してセッションを作成します。

public:
 LearningModelSession(LearningModel ^ model, LearningModelDevice ^ deviceToRunOn);

 LearningModelSession(LearningModel const& model, LearningModelDevice const& deviceToRunOn);

public LearningModelSession(LearningModel model, LearningModelDevice deviceToRunOn);

function LearningModelSession(model, deviceToRunOn)

Public Sub New (model As LearningModel, deviceToRunOn As LearningModelDevice)

パラメーター

model

LearningModel

このセッションのトレーニング済みの機械学習モデル。

deviceToRunOn

LearningModelDevice

セッションの評価デバイス。

例

次の例では、モデルを読み込み、モデルを評価するデバイスを選択し、評価セッションを作成します。

private async Task LoadModelAsync(string _modelFileName, bool _useGPU, LearningModelSession _session)
{
    LearningModel _model;

    try
    {
        // Load and create the model
        var modelFile = 
            await StorageFile.GetFileFromApplicationUriAsync(new Uri($"ms-appx:///Assets/{_modelFileName}"));
        _model = await LearningModel.LoadFromStorageFileAsync(modelFile);

        // Select the device to evaluate on
        LearningModelDevice device = null;
        if (_useGPU)
        {
            // Use a GPU or other DirectX device to evaluate the model.
            device = new LearningModelDevice(LearningModelDeviceKind.DirectX);
        }
        else
        {
            // Use the CPU to evaluate the model.
            device = new LearningModelDevice(LearningModelDeviceKind.Cpu);
        }

        // Create the evaluation session with the model and device.
        _session = new LearningModelSession(_model, device);

    }
    catch (Exception ex)
    {
        StatusBlock.Text = $"error: {ex.Message}";
        _model = null;
    }
}

注釈

Windows Server

Windows Server でこの API を使用するには、Windows Server 2019 デスクトップ エクスペリエンスを使用する必要があります。

スレッド セーフ

この API はスレッド セーフです。

LearningModelSession(LearningModel, LearningModelDevice, LearningModelSessionOptions)

指定したデバイスと追加の推論オプションを使用してセッションを作成します。

public:
 LearningModelSession(LearningModel ^ model, LearningModelDevice ^ deviceToRunOn, LearningModelSessionOptions ^ learningModelSessionOptions);

 LearningModelSession(LearningModel const& model, LearningModelDevice const& deviceToRunOn, LearningModelSessionOptions const& learningModelSessionOptions);

public LearningModelSession(LearningModel model, LearningModelDevice deviceToRunOn, LearningModelSessionOptions learningModelSessionOptions);

function LearningModelSession(model, deviceToRunOn, learningModelSessionOptions)

Public Sub New (model As LearningModel, deviceToRunOn As LearningModelDevice, learningModelSessionOptions As LearningModelSessionOptions)

パラメーター

model

LearningModel

このセッションのトレーニング済みの機械学習モデル。

deviceToRunOn

LearningModelDevice

セッションの評価デバイス。

learningModelSessionOptions

LearningModelSessionOptions

セッションの作成と評価の構成に使用されるオプション。

Windows の要件

デバイス ファミリ	Windows 10, version 1903 (10.0.18362.0 で導入)
API contract	Windows.AI.MachineLearning.MachineLearningContract (v2.0 で導入)

例

次の例では、モデルを読み込み、 LearningModelSessionOptions を使用して評価セッションを構成します。

private LearningModelSessionOptions CreateSessionOptions()
{
    var options = new LearningModelSessionOptions();

    // Disable constant batch size optimizations
    options.BatchSizeOverride = 0;

    return options;
}

private async Task LoadModelAsync(string modelFileName)
{
    LearningModel model;
    LearningModelDevice device;
    LearningModelSession session;

    try
    {
        // Load and create the model.
        var modelFile = 
            await StorageFile.GetFileFromApplicationUriAsync(new Uri($"ms-appx:///Assets/{modelFileName}"));
        model = await LearningModel.LoadFromStorageFileAsync(modelFile);

        // Create default LearningModelDevice.
        device = new LearningModelDevice(LearningModelDeviceKind.Default);

        // Create LearningModelSessionOptions with necessary options set.
        LearningModelSessionOptions options = CreateSessionOptions();

        // Create the evaluation session with the model and LearningModelSessionOptions.
        session = new LearningModelSession(model, device, options);

    }
    catch (Exception ex)
    {
        StatusBlock.Text = $"error: {ex.Message}";
        model = null;
    }
}