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)