Context

cuest.bindings.cuestCreate(

*,

parameters: cuest.bindings.cuest.Parameters,

handle: cuest.bindings.cuest.cuestHandle,

) → cuest.bindings.cuest.CuestStatus

Creates a new cuEST handle and its associated resources from a parameter structure.

Ownership of handles or pointers passed into the structure is NOT transferred. Default parameters will construct a generic GPU context.

Requirements:

• A cudaStream alone may be provided, all others may be left NULL.

• If cuBLAS or cuSolver handles are specified, a cudaStream must also be specified.

Parameters

parameters[in]cuestHandleParameters

Parameter structure handle (must not be NULL).

handle[out]cuestHandle

Pointer to opaque cuEST handle for output.

Returns

status[out]cuestStatus_t

• CUEST_STATUS_SUCCESS on success,

• CUEST_STATUS_NULL_POINTER if parameters or handle is NULL,

• CUEST_STATUS_EXCEPTION or CUEST_STATUS_UNKNOWN_ERROR otherwise.

cuest.bindings.cuestDestroy(

*,

handle: cuest.bindings.cuest.cuestHandle,

) → cuest.bindings.cuest.CuestStatus

Destroys a cuEST handle and all associated resources.

Frees memory for GPU resources, quadrature data, solid harmonics coefficients, and rys table.

Parameters

handle[in]cuestHandle

Opaque cuEST handle to destroy (must not be NULL).

Returns

status[out]cuestStatus_t

• CUEST_STATUS_SUCCESS on success,

• CUEST_STATUS_NULL_POINTER if handle is NULL,

• CUEST_STATUS_INVALID_TYPE if handle is not of the cuestHandle_t type,

• CUEST_STATUS_EXCEPTION or CUEST_STATUS_UNKNOWN_ERROR otherwise.

cuest.bindings.cuestSetMathMode(

*,

handle: cuest.bindings.cuest.cuestHandle,

mode: cuestMathMode_t,

) → cuest.bindings.cuest.CuestStatus

Sets the math mode used when cuEST functions are called with this handle.

• CUEST_DEFAULT_MATH_MODE cuEST will use algorithms that are determined heuristically to maximize performance. Some results may use mixed precision arithmetic.

• CUEST_NATIVE_FP64_MATH_MODE cuEST will use FP64 arithmetic everywhere.

Parameters

handle[out]cuestHandle

Opaque cuEST handle (must not be NULL).

mode[in]CuestMathMode

Math mode to set in cuEST handle

Returns

status[out]CuestStatus

• CUEST_STATUS_SUCCESS on success,

• CUEST_STATUS_INVALID_HANDLE if handle is NULL,

• CUEST_STATUS_INVALID_TYPE if handle is not of the cuestHandle_t type,

• CUEST_STATUS_INVALID_ARGUMENT if the cuestMathMode_t is invalid.

• CUEST_STATUS_EXCEPTION or CUEST_STATUS_UNKNOWN_ERROR otherwise.

cuest.bindings.cuestGetMathMode(

*,

handle: cuest.bindings.cuest.cuestHandle,

mode: cuest.bindings.cuest.data_cuestMathMode_t,

) → cuest.bindings.cuest.CuestStatus

Gets the math mode associated with this handle.

Parameters

handle[in]cuestHandle

Opaque cuEST handle (must not be NULL).

mode[out]data_cuestMathMode_t

Math mode to get from the cuEST handle

Returns

status[out]CuestStatus

• CUEST_STATUS_SUCCESS on success,

• CUEST_STATUS_INVALID_HANDLE if handle is NULL,

• CUEST_STATUS_INVALID_TYPE if handle is not of the cuestHandle_t type,

• CUEST_STATUS_EXCEPTION or CUEST_STATUS_UNKNOWN_ERROR otherwise.

cuest.bindings.cuestSetComputeCapabilityTarget(

*,

handle: cuest.bindings.cuest.cuestHandle,

targetMajorVersion: int,

targetMinorVersion: int,

) → cuest.bindings.cuest.CuestStatus

Sets the compute capability target used when cuEST functions are called with this handle.

Parameters

handle[out]cuestHandle

Opaque cuEST handle (must not be NULL).

targetMajorVersion[in]int

Major compute capability version

targetMinorVersion[in]int

Minor compute capability version

Returns

status[out]CuestStatus

• CUEST_STATUS_SUCCESS on success,

• CUEST_STATUS_INVALID_HANDLE if handle is NULL,

• CUEST_STATUS_INVALID_TYPE if handle is not of the cuestHandle_t type,

• CUEST_STATUS_EXCEPTION or CUEST_STATUS_UNKNOWN_ERROR otherwise.

cuest.bindings.cuestGetComputeCapabilityTarget(

*,

handle: cuest.bindings.cuest.cuestHandle,

targetMajorVersion: cuest.bindings.cuest.data_uint32_t,

targetMinorVersion: cuest.bindings.cuest.data_uint32_t,

) → cuest.bindings.cuest.CuestStatus

Gets the compute capability target used when cuEST functions are called with this handle.

Parameters

handle[in]cuestHandle

Opaque cuEST handle (must not be NULL).

targetMajorVersion[out]data_uint32_t

Major compute capability version

targetMinorVersion[out]data_uint32_t

Minor compute capability version

Returns

status[out]CuestStatus

• CUEST_STATUS_SUCCESS on success,

• CUEST_STATUS_INVALID_HANDLE if handle is NULL,

• CUEST_STATUS_INVALID_TYPE if handle is not of the cuestHandle_t type,

• CUEST_STATUS_NULL_POINTER if targetMajorVersion or targetMinorVersion is NULL,

• CUEST_STATUS_EXCEPTION or CUEST_STATUS_UNKNOWN_ERROR otherwise.