LearningModel Klasse

Referenz

Definition

Namespace:: Windows.AI.MachineLearning

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Stellt ein trainiertes Machine Learning-Modell dar.

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

Vererbung: Object Platform::Object IInspectable LearningModel

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert: IClosable IDisposable

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract	Windows.AI.MachineLearning.MachineLearningContract (eingeführt in v1.0)

Beispiele

Im folgenden Beispiel wird ein Modell geladen und damit eine Auswertungssitzung erstellt.

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

Hinweise

Dies ist das Standard-Objekt, das Sie für die Interaktion mit Windows ML verwenden. Sie verwenden sie zum Laden, Binden und Auswerten trainierter ONNX-Modelle:

Laden Sie das Modell mithilfe eines der Load*-Konstruktoren.
Führen Sie die InputFeatures und OutputFeatures auf, und binden Sie sie an Ihr Modell.
Erstellen Sie eine LearningModelSession , und evalaute.

Windows Server

Um diese API unter Windows Server verwenden zu können, müssen Sie Windows Server 2019 mit Desktopoberfläche verwenden.

Threadsicherheit

Diese API ist threadsicher.

Eigenschaften

Author	Der Name des Modellautors.
Description	Eine Beschreibung des Modells.
Domain	Die Domäne des Modells.
InputFeatures	Eine Liste der Eingabefeatures des Modells.
Metadata	Die rohe <Zeichenfolge, Zeichenfolgenmetadaten> aus dem ONNX-Modell.
Name	Der Name des Modells.
OutputFeatures	Eine Liste der Ausgabefeatures des Modells.
Version	Die Version des Modells.

Methoden

Close()	Gibt das ONNX-Modell im Arbeitsspeicher frei. Nach dem Aufrufen dieses Objekts können Sie keine weiteren LearningModelSession-Objekte erstellen.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
LoadFromFilePath(String, ILearningModelOperatorProvider)	Lädt ein ONNX-Modell aus einer Datei auf den Datenträger.
LoadFromFilePath(String)	Lädt ein ONNX-Modell aus einer Datei auf den Datenträger.
LoadFromStorageFileAsync(IStorageFile, ILearningModelOperatorProvider)	Lädt ein ONNX-Modell asynchron aus einer IStorageFile-Datei .
LoadFromStorageFileAsync(IStorageFile)	Lädt ein ONNX-Modell asynchron aus einer IStorageFile-Datei .
LoadFromStream(IRandomAccessStreamReference, ILearningModelOperatorProvider)	Lädt ein ONNX-Modell aus einem Stream.
LoadFromStream(IRandomAccessStreamReference)	Lädt ein ONNX-Modell aus einem Stream.
LoadFromStreamAsync(IRandomAccessStreamReference, ILearningModelOperatorProvider)	Lädt ein ONNX-Modell asynchron aus einem Stream.
LoadFromStreamAsync(IRandomAccessStreamReference)	Lädt ein ONNX-Modell asynchron aus einem Stream.

Gilt für:

Freigeben über