LearningModel Kelas

Definisi

Ruang nama:

Windows.AI.MachineLearning

Mewakili model pembelajaran mesin terlatih.

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

Warisan

Object Platform::Object IInspectable LearningModel

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IClosable IDisposable

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1809 (diperkenalkan dalam 10.0.17763.0)
API contract	Windows.AI.MachineLearning.MachineLearningContract (diperkenalkan dalam v1.0)

Contoh

Contoh berikut memuat model dan membuat sesi evaluasi dengannya.

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

Keterangan

Ini adalah objek utama yang Anda gunakan untuk berinteraksi dengan Windows ML. Anda menggunakannya untuk memuat, mengikat, dan mengevaluasi model ONNX terlatih:

1. Muat model menggunakan salah satu konstruktor Load*.
2. Hitung InputFeatures dan OutputFeatures dan ikat ke model Anda.
3. Buat LearningModelSession dan evalaute.

Windows Server

Untuk menggunakan API ini di Windows Server, Anda harus menggunakan Windows Server 2019 dengan Pengalaman Desktop.

Keamanan utas

API ini aman untuk utas.

Properti

Author	Nama penulis model.
Description	Deskripsi model.
Domain	Domain model.
InputFeatures	Daftar fitur input model.
Metadata	String mentah <, metadata string> dari model ONNX.
Name	Nama model.
OutputFeatures	Daftar fitur output model.
Version	Versi model.

Metode

Close()	Merilis model ONNX dalam memori. Setelah memanggil ini, Anda tidak dapat membuat objek LearningModelSession lagi.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola.
LoadFromFilePath(String)	Memuat model ONNX dari file pada disk.
LoadFromFilePath(String, ILearningModelOperatorProvider)	Memuat model ONNX dari file pada disk.
LoadFromStorageFileAsync(IStorageFile)	Memuat model ONNX dari IStorageFile secara asinkron.
LoadFromStorageFileAsync(IStorageFile, ILearningModelOperatorProvider)	Memuat model ONNX dari IStorageFile secara asinkron.
LoadFromStream(IRandomAccessStreamReference)	Memuat model ONNX dari aliran.
LoadFromStream(IRandomAccessStreamReference, ILearningModelOperatorProvider)	Memuat model ONNX dari aliran.
LoadFromStreamAsync(IRandomAccessStreamReference)	Memuat model ONNX dari aliran secara asinkron.
LoadFromStreamAsync(IRandomAccessStreamReference, ILearningModelOperatorProvider)	Memuat model ONNX dari aliran secara asinkron.

Lihat juga

• Windows ML
• Sampel Windows ML (GitHub)