LearningModelSessionOptions.OverrideNamedDimension(String, UInt32) Método

Definição

Namespace:

Windows.AI.MachineLearning

Fornece a capacidade de substituir dimensões de entrada nomeadas de um Modelo de Aprendizagem para valores concretos.

public:
 virtual void OverrideNamedDimension(Platform::String ^ name, unsigned int dimension) = OverrideNamedDimension;

void OverrideNamedDimension(winrt::hstring const& name, uint32_t const& dimension);

public void OverrideNamedDimension(string name, uint dimension);

function overrideNamedDimension(name, dimension)

Public Sub OverrideNamedDimension (name As String, dimension As UInteger)

Parâmetros

name

String

Platform::String

winrt::hstring

O nome da dimensão de entrada a ser definida.

dimension

UInt32

unsigned int

uint32_t

O valor concreto a ser atribuído à dimensão especificada.

Requisitos do Windows

Família de dispositivos	Windows 10, version 2104 (introduzida na 10.0.20348.0)
API contract	Windows.AI.MachineLearning.MachineLearningContract (introduzida na v4.0)

Exemplos

void SetNamedDimensionOverrides(LearningModel model) {
    // Create LearningModelSessionOptions
    auto options = LearningModelSessionOptions();

    // Override a named input dimension to a concrete value
    options->OverrideNamedDimension(L"dimension_name", 256);

    // Create session
    LearningModelSession session = nullptr;
    session = LearningModelSession(model, LearningModelDeviceKind::GPU, options);
}

Comentários

O uso dessa API pode gerar melhorias de desempenho, pois permite a pré-alocação de tensores durante a criação da sessão que, de outra forma, seriam alocados durante a avaliação do modelo.