LearningModel Classe

Definição

Namespace:

Windows.AI.MachineLearning

Representa um modelo de machine learning treinado.

public ref class LearningModel sealed : IClosable

/// [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)]
class LearningModel final : IClosable

[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)]
public sealed class LearningModel : System.IDisposable

Public NotInheritable Class LearningModel
Implements IDisposable

Herança

Object Platform::Object IInspectable LearningModel

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable

Requisitos do Windows

Família de dispositivos	Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract	Windows.AI.MachineLearning.MachineLearningContract (introduzida na v1.0)

Exemplos

O exemplo a seguir carrega um modelo e cria uma sessão de avaliação com ele.

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

Comentários

Esse é o objeto main que você usa para interagir com o Windows ML. Use-o para carregar, associar e avaliar modelos ONNX treinados:

1. Carregue o modelo usando um dos construtores Load*.
2. Enumerar InputFeatures e OutputFeatures e associar ao modelo.
3. Crie um LearningModelSession e evalaute.

Windows Server

Para usar essa API no Windows Server, você deve usar o Windows Server 2019 com a Experiência desktop.

Acesso thread-safe

Essa API é thread-safe.

Propriedades

Author	O nome do autor do modelo.
Description	Uma descrição do modelo.
Domain	O domínio do modelo.
InputFeatures	Uma lista dos recursos de entrada do modelo.
Metadata	A cadeia de caracteres bruta <, metadados de cadeia de caracteres> do modelo ONNX.
Name	O nome do modelo.
OutputFeatures	Uma lista dos recursos de saída do modelo.
Version	A versão do modelo.

Métodos

Close()	Libera o modelo ONNX na memória. Depois de chamar isso, você não pode criar mais objetos LearningModelSession .
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
LoadFromFilePath(String)	Carrega um modelo ONNX de um arquivo em disco.
LoadFromFilePath(String, ILearningModelOperatorProvider)	Carrega um modelo ONNX de um arquivo em disco.
LoadFromStorageFileAsync(IStorageFile)	Carrega um modelo ONNX de um IStorageFile de forma assíncrona.
LoadFromStorageFileAsync(IStorageFile, ILearningModelOperatorProvider)	Carrega um modelo ONNX de um IStorageFile de forma assíncrona.
LoadFromStream(IRandomAccessStreamReference)	Carrega um modelo ONNX de um fluxo.
LoadFromStream(IRandomAccessStreamReference, ILearningModelOperatorProvider)	Carrega um modelo ONNX de um fluxo.
LoadFromStreamAsync(IRandomAccessStreamReference)	Carrega um modelo ONNX de um fluxo de forma assíncrona.
LoadFromStreamAsync(IRandomAccessStreamReference, ILearningModelOperatorProvider)	Carrega um modelo ONNX de um fluxo de forma assíncrona.

Confira também

• Windows ML
• Exemplos do Windows ML (Github)