Compartilhar via


LearningModel Classe

Definição

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
Implementações

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, ILearningModelOperatorProvider)

Carrega um modelo ONNX de um arquivo em disco.

LoadFromFilePath(String)

Carrega um modelo ONNX de um arquivo em disco.

LoadFromStorageFileAsync(IStorageFile, ILearningModelOperatorProvider)

Carrega um modelo ONNX de um IStorageFile de forma assíncrona.

LoadFromStorageFileAsync(IStorageFile)

Carrega um modelo ONNX de um IStorageFile de forma assíncrona.

LoadFromStream(IRandomAccessStreamReference, ILearningModelOperatorProvider)

Carrega um modelo ONNX de um fluxo.

LoadFromStream(IRandomAccessStreamReference)

Carrega um modelo ONNX de um fluxo.

LoadFromStreamAsync(IRandomAccessStreamReference, ILearningModelOperatorProvider)

Carrega um modelo ONNX de um fluxo de forma assíncrona.

LoadFromStreamAsync(IRandomAccessStreamReference)

Carrega um modelo ONNX de um fluxo de forma assíncrona.

Aplica-se a

Confira também