LearningModel Classe

Definizione

Spazio dei nomi:

Windows.AI.MachineLearning

Rappresenta un modello di Machine Learning sottoposto a training.

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

Ereditarietà

Object Platform::Object IInspectable LearningModel

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IClosable IDisposable

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
API contract	Windows.AI.MachineLearning.MachineLearningContract (è stato introdotto in v1.0)

Esempio

Nell'esempio seguente viene caricato un modello e viene creata una sessione di valutazione.

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

Commenti

Questo è l'oggetto principale usato per interagire con Windows ML. È possibile usarlo per caricare, associare e valutare i modelli ONNX sottoposti a training:

1. Caricare il modello usando uno dei costruttori Load*.
2. Enumerare inputFeatures e OutputFeatures e associarlo al modello.
3. Creare un learningModelSession e evalaute.

Windows Server

Per usare questa API in Windows Server, è necessario usare Windows Server 2019 con Esperienza desktop.

Thread safety

Questa API è thread-safe.

Proprietà

Author	Nome dell'autore del modello.
Description	Descrizione del modello.
Domain	Dominio del modello.
InputFeatures	Elenco delle funzionalità di input del modello.
Metadata	Stringa non elaborata <, metadati stringa> del modello ONNX.
Name	Nome del modello.
OutputFeatures	Elenco delle funzionalità di output del modello.
Version	Versione del modello.

Metodi

Close()	Rilascia il modello ONNX in memoria. Dopo aver chiamato questa operazione, non è possibile creare altri oggetti LearningModelSession .
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
LoadFromFilePath(String)	Carica un modello ONNX da un file su disco.
LoadFromFilePath(String, ILearningModelOperatorProvider)	Carica un modello ONNX da un file su disco.
LoadFromStorageFileAsync(IStorageFile)	Carica un modello ONNX da un IStorageFile in modo asincrono.
LoadFromStorageFileAsync(IStorageFile, ILearningModelOperatorProvider)	Carica un modello ONNX da un IStorageFile in modo asincrono.
LoadFromStream(IRandomAccessStreamReference)	Carica un modello ONNX da un flusso.
LoadFromStream(IRandomAccessStreamReference, ILearningModelOperatorProvider)	Carica un modello ONNX da un flusso.
LoadFromStreamAsync(IRandomAccessStreamReference)	Carica un modello ONNX da un flusso in modo asincrono.
LoadFromStreamAsync(IRandomAccessStreamReference, ILearningModelOperatorProvider)	Carica un modello ONNX da un flusso in modo asincrono.

Vedi anche

• Windows ML
• Esempi di Windows ML (GitHub)