LearningModelSession コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
LearningModelSession(LearningModel) |
既定のデバイスを使用してセッションを作成します。 |
LearningModelSession(LearningModel, LearningModelDevice) |
指定したデバイスを使用してセッションを作成します。 |
LearningModelSession(LearningModel, LearningModelDevice, LearningModelSessionOptions) |
指定したデバイスと追加の推論オプションを使用してセッションを作成します。 |
LearningModelSession(LearningModel)
既定のデバイスを使用してセッションを作成します。
public:
LearningModelSession(LearningModel ^ model);
LearningModelSession(LearningModel const& model);
public LearningModelSession(LearningModel model);
function LearningModelSession(model)
Public Sub New (model As LearningModel)
パラメーター
- model
- LearningModel
このセッションのトレーニング済みの機械学習モデル。
例
次の例では、モデルを読み込み、それを使用して評価セッションを作成します。
private async Task LoadModelAsync(LearningModel _model, string _modelFileName, LearningModelSession _session)
{
// Only load the model one time.
if (_model != null) return;
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 and device.
_session = new LearningModelSession(_model);
}
catch (Exception ex)
{
StatusBlock.Text = $"error: {ex.Message}";
_model = null;
}
}
注釈
Windows Server
Windows Server でこの API を使用するには、Windows Server 2019 デスクトップ エクスペリエンスを使用する必要があります。
スレッド セーフ
この API はスレッド セーフです。
適用対象
LearningModelSession(LearningModel, LearningModelDevice)
指定したデバイスを使用してセッションを作成します。
public:
LearningModelSession(LearningModel ^ model, LearningModelDevice ^ deviceToRunOn);
LearningModelSession(LearningModel const& model, LearningModelDevice const& deviceToRunOn);
public LearningModelSession(LearningModel model, LearningModelDevice deviceToRunOn);
function LearningModelSession(model, deviceToRunOn)
Public Sub New (model As LearningModel, deviceToRunOn As LearningModelDevice)
パラメーター
- model
- LearningModel
このセッションのトレーニング済みの機械学習モデル。
- deviceToRunOn
- LearningModelDevice
セッションの評価デバイス。
例
次の例では、モデルを読み込み、モデルを評価するデバイスを選択し、評価セッションを作成します。
private async Task LoadModelAsync(string _modelFileName, bool _useGPU, LearningModelSession _session)
{
LearningModel _model;
try
{
// Load and create the model
var modelFile =
await StorageFile.GetFileFromApplicationUriAsync(new Uri($"ms-appx:///Assets/{_modelFileName}"));
_model = await LearningModel.LoadFromStorageFileAsync(modelFile);
// Select the device to evaluate on
LearningModelDevice device = null;
if (_useGPU)
{
// Use a GPU or other DirectX device to evaluate the model.
device = new LearningModelDevice(LearningModelDeviceKind.DirectX);
}
else
{
// Use the CPU to evaluate the model.
device = new LearningModelDevice(LearningModelDeviceKind.Cpu);
}
// Create the evaluation session with the model and device.
_session = new LearningModelSession(_model, device);
}
catch (Exception ex)
{
StatusBlock.Text = $"error: {ex.Message}";
_model = null;
}
}
注釈
Windows Server
Windows Server でこの API を使用するには、Windows Server 2019 デスクトップ エクスペリエンスを使用する必要があります。
スレッド セーフ
この API はスレッド セーフです。
適用対象
LearningModelSession(LearningModel, LearningModelDevice, LearningModelSessionOptions)
指定したデバイスと追加の推論オプションを使用してセッションを作成します。
public:
LearningModelSession(LearningModel ^ model, LearningModelDevice ^ deviceToRunOn, LearningModelSessionOptions ^ learningModelSessionOptions);
LearningModelSession(LearningModel const& model, LearningModelDevice const& deviceToRunOn, LearningModelSessionOptions const& learningModelSessionOptions);
public LearningModelSession(LearningModel model, LearningModelDevice deviceToRunOn, LearningModelSessionOptions learningModelSessionOptions);
function LearningModelSession(model, deviceToRunOn, learningModelSessionOptions)
Public Sub New (model As LearningModel, deviceToRunOn As LearningModelDevice, learningModelSessionOptions As LearningModelSessionOptions)
パラメーター
- model
- LearningModel
このセッションのトレーニング済みの機械学習モデル。
- deviceToRunOn
- LearningModelDevice
セッションの評価デバイス。
- learningModelSessionOptions
- LearningModelSessionOptions
セッションの作成と評価の構成に使用されるオプション。
Windows の要件
デバイス ファミリ |
Windows 10, version 1903 (10.0.18362.0 で導入)
|
API contract |
Windows.AI.MachineLearning.MachineLearningContract (v2.0 で導入)
|
例
次の例では、モデルを読み込み、 LearningModelSessionOptions を使用して評価セッションを構成します。
private LearningModelSessionOptions CreateSessionOptions()
{
var options = new LearningModelSessionOptions();
// Disable constant batch size optimizations
options.BatchSizeOverride = 0;
return options;
}
private async Task LoadModelAsync(string modelFileName)
{
LearningModel model;
LearningModelDevice device;
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 default LearningModelDevice.
device = new LearningModelDevice(LearningModelDeviceKind.Default);
// Create LearningModelSessionOptions with necessary options set.
LearningModelSessionOptions options = CreateSessionOptions();
// Create the evaluation session with the model and LearningModelSessionOptions.
session = new LearningModelSession(model, device, options);
}
catch (Exception ex)
{
StatusBlock.Text = $"error: {ex.Message}";
model = null;
}
}