LearningModel Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.IDisposablePublic NotInheritable Class LearningModel
Implements IDisposable- Herança
- 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:
- Carregue o modelo usando um dos construtores Load*.
- Enumerar InputFeatures e OutputFeatures e associar ao modelo.
- 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. |