aclmdlQuerySize

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product / Atlas A3 inference product	√
Atlas A2 training product / Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	√

Function Usage

Obtains the weight memory size and workspace size required for model execution.

If the memory is managed by the user, before the allocation, you need to call this API to query the sizes of the workspace and weight memory required for model execution to avoid memory waste. If the shape of the input data is uncertain, you cannot call this API to query the memory size. As a result, you cannot manage the memory during model loading. Therefore, you need to call aclmdlLoadFromFile or aclmdlLoadFromMem to allow the system to manage the memory.

Prototype

      
           aclError aclmdlQuerySize(const char *fileName, size_t *workSize, size_t *weightSize)

Parameters

Parameter	Input/Output	Description
fileName	Input	Pointer to the model file path, which contains the file name. The user who runs the application must have the permission to access the directory. The model file is an OM model file. For details about how to obtain the OM model file, see "Command-Line Options > Basic Options > General Options > --mode" in the ATC.
workSize	Output	Pointer to the workspace size required for model execution, in bytes. The workplace is device memory, which needs to be allocated and freed by the user.
weightSize	Output	Pointer to the weight memory size required for model execution, in bytes. The workplace is device memory, which needs to be allocated and freed by the user.

Parameter

Input/Output

Description

fileName

Input

Pointer to the model file path, which contains the file name. The user who runs the application must have the permission to access the directory.

The model file is an OM model file.

For details about how to obtain the OM model file, see "Command-Line Options > Basic Options > General Options > --mode" in the ATC.

workSize

Output

Pointer to the workspace size required for model execution, in bytes.

The workplace is device memory, which needs to be allocated and freed by the user.

weightSize

Output

Pointer to the weight memory size required for model execution, in bytes.

The workplace is device memory, which needs to be allocated and freed by the user.

Returns

0 on success; else, failure. For details, see aclError.

Example

For details about the API call sequence and sample code, see Loading a Model.

Parent topic: Model Execution