LearningModelSession Constructeurs

Définition

Espace de noms:

Windows.AI.MachineLearning

Surcharges

LearningModelSession(LearningModel)	Crée une session à l’aide de l’appareil par défaut.
LearningModelSession(LearningModel, LearningModelDevice)	Crée une session à l’aide de l’appareil spécifié.
LearningModelSession(LearningModel, LearningModelDevice, LearningModelSessionOptions)	Crée une session à l’aide de l’appareil spécifié et d’options d’inférence supplémentaires.

LearningModelSession(LearningModel)

Crée une session à l’aide de l’appareil par défaut.

public:
 LearningModelSession(LearningModel ^ model);

 LearningModelSession(LearningModel const& model);

public LearningModelSession(LearningModel model);

function LearningModelSession(model)

Public Sub New (model As LearningModel)

Paramètres

model

LearningModel

Modèle Machine Learning entraîné pour cette session.

Exemples

L’exemple suivant charge un modèle et crée une session d’évaluation avec celui-ci.

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;
    }
}

Remarques

Windows Server

Pour utiliser cette API sur Windows Server, vous devez utiliser Windows Server 2019 avec Expérience de bureau.

Sécurité des threads

Cette API est thread-safe.

LearningModelSession(LearningModel, LearningModelDevice)

Crée une session à l’aide de l’appareil spécifié.

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)

Paramètres

model

LearningModel

Modèle Machine Learning entraîné pour cette session.

deviceToRunOn

LearningModelDevice

Appareil d’évaluation de la session.

Exemples

L’exemple suivant charge un modèle, sélectionne l’appareil sur lequel évaluer le modèle et crée une session d’évaluation.

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;
    }
}

Remarques

Windows Server

Pour utiliser cette API sur Windows Server, vous devez utiliser Windows Server 2019 avec Expérience de bureau.

Sécurité des threads

Cette API est thread-safe.

LearningModelSession(LearningModel, LearningModelDevice, LearningModelSessionOptions)

Crée une session à l’aide de l’appareil spécifié et d’options d’inférence supplémentaires.

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)

Paramètres

model

LearningModel

Modèle Machine Learning entraîné pour cette session.

deviceToRunOn

LearningModelDevice

Appareil d’évaluation de la session.

learningModelSessionOptions

LearningModelSessionOptions

Options utilisées pour configurer la création et l’évaluation de session.

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1903 (introduit dans 10.0.18362.0)
API contract	Windows.AI.MachineLearning.MachineLearningContract (introduit dans v2.0)

Exemples

L’exemple suivant charge un modèle et configure une session d’évaluation à l’aide de 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;
    }
}