LearningModelSession クラス

定義

名前空間:

Windows.AI.MachineLearning

機械学習モデルを評価するために使用されます。

public ref class LearningModelSession sealed : IClosable

/// [Windows.Foundation.Metadata.Activatable(Windows.AI.MachineLearning.ILearningModelSessionFactory, 65536, "Windows.AI.MachineLearning.MachineLearningContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.AI.MachineLearning.MachineLearningContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.AI.MachineLearning.ILearningModelSessionFactory2, 131072, "Windows.AI.MachineLearning.MachineLearningContract")]
class LearningModelSession final : IClosable

[Windows.Foundation.Metadata.Activatable(typeof(Windows.AI.MachineLearning.ILearningModelSessionFactory), 65536, "Windows.AI.MachineLearning.MachineLearningContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.AI.MachineLearning.MachineLearningContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.AI.MachineLearning.ILearningModelSessionFactory2), 131072, "Windows.AI.MachineLearning.MachineLearningContract")]
public sealed class LearningModelSession : System.IDisposable

function LearningModelSession(model, deviceToRunOn, learningModelSessionOptions)

Public NotInheritable Class LearningModelSession
Implements IDisposable

継承

Object Platform::Object IInspectable LearningModelSession

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装

IClosable IDisposable

Windows の要件

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

例

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

private async Task LoadModelAsync(string _modelFileName)
{
    LearningModel _model;
    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 the evaluation session with the model
        _session = new LearningModelSession(_model);

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

注釈

Windows Server

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

スレッド セーフ

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

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1903	18362	LearningModelSession(LearningModel,LearningModelDevice,LearningModelSessionOptions)

コンストラクター

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

プロパティ

Device	セッションの評価デバイスを返します。
EvaluationProperties	モデルの評価を制御するプロパティのセット。
Model	このセッションのトレーニング済みの機械学習モデルを返します。

メソッド

Close()	現在の LearningModelSession を閉じます。
Dispose()	アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
Evaluate(LearningModelBinding, String)	バインドにバインドされた特徴値を使用して、機械学習モデル を評価します。
EvaluateAsync(LearningModelBinding, String)	バインドに既にバインドされている特徴値を使用して、機械学習モデルを非同期的に評価 します。
EvaluateFeatures(IMap<String,Object>, String)	特徴量の特徴値を使用して機械学習モデルを評価 します。
EvaluateFeaturesAsync(IMap<String,Object>, String)	特徴量の特徴値を使用して、機械学習モデルを非同期的に評価 します。

こちらもご覧ください

• Windows ML
• Windows ML のサンプル (GitHub)