Function: start_dump_args

Applicability

Product	Supported (√/x)
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas training products	√
Atlas inference products	x
Atlas 200I/500 A2 inference products	x

Function Usage

Enables the operator statistics function. This API must be used in pair with Function: stop_dump_args to export the operator information files to the directory specified by path. One shape corresponds to one operator information file, which contains the operator type, operator attributes, and operator input and output information such as format, data type, and shape.

Application scenario: For example, if you want to collect statistics on the operators involved in the execution of a model, you can call the acl.op.start_dump_args API before the model execution and call the acl.op.stop_dump_args API after the model execution. After the successful acl.op.start_dump_args call, an operator information file for each operator shape is generated in the directory specified by path.

Prototype

C Prototype

aclError aclopStartDumpArgs(uint32_t dumpType, const char *path)

Python Function

ret = acl.op.start_dump_args(dump_type, path)

Parameter Description

Parameter	Description
dumpType	Int, type of dump information. Currently, only ACL_OP_DUMP_OP_AICORE_ARGS is supported, indicating that information about all operators is collected. ACL_OP_DUMP_OP_AICORE_ARGS = 0x00000001
path	Str, path for storing dump files. The path can be an absolute path or a relative path (relative to the directory where the executable file of the application is located). Ensure that the path exists or can be created.

Parameter

Description

dumpType

Int, type of dump information.

Currently, only ACL_OP_DUMP_OP_AICORE_ARGS is supported, indicating that information about all operators is collected.

ACL_OP_DUMP_OP_AICORE_ARGS = 0x00000001

path

Str, path for storing dump files. The path can be an absolute path or a relative path (relative to the directory where the executable file of the application is located). Ensure that the path exists or can be created.

Return Value Description

Return Value	Description
ret	Int, error code: 0 on success; else, failure.

Restrictions

This API can be used only in the single-operator API execution scenario. Otherwise, dump files cannot be generated.

The Atlas inference products does not support this API.

The Atlas 200/500 A2 Inference Product does not support this API.

The Atlas training products does not support this API.

The Atlas A2 training products/Atlas A2 inference products does not support this API.

Parent topic: Single-Operator Model Execution